PHPackages                             niziou/freegift - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. niziou/freegift

ActiveMagento2-module[Utility & Helpers](/categories/utility)

niziou/freegift
===============

Adobe Commerce free gift module for global and cart price rule gifts.

1.0.0(2mo ago)01[1 issues](https://github.com/niziou/freegift-m2/issues)[1 PRs](https://github.com/niziou/freegift-m2/pulls)OSL-3.0PHPPHP ^8.3 || ^8.4

Since May 6Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/niziou/freegift-m2)[ Packagist](https://packagist.org/packages/niziou/freegift)[ RSS](/packages/niziou-freegift/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

Niziou Free Gift
================

[](#niziou-free-gift)

Magento 2 / Adobe Commerce module that automatically adds one free gift item to qualifying carts. It supports a website-scoped global gift SKU and rule-specific gift SKUs on cart price rules.

Compatibility
-------------

[](#compatibility)

- Adobe Commerce / Magento Open Source 2.4.8-p4 and the 2.4.8 release line
- PHP 8.3 or 8.4
- Composer 2

Adobe lists Adobe Commerce 2.4.8-p4 as the latest stable 2.4.x patch release as of April 24, 2026. Adobe Commerce 2.4.9 is currently listed as beta, so this module targets 2.4.8-p4.

Features
--------

[](#features)

- Website-scope global configuration under Stores > Configuration > Sales > Free Gift.
- Optional free gift fields on cart price rules.
- Rule-specific gift SKU takes priority over the global SKU.
- Adds only simple or virtual products without required options.
- Forces gift quantity to 1, disables discounts for the gift line, and sets the gift price to 0.00.
- Removes obsolete gift items when the cart no longer qualifies or a different rule-specific gift applies.

Installation
------------

[](#installation)

Install with Composer from this repository or copy the module directory to `app/code/Niziou/FreeGift`.

```
bin/magento module:enable Niziou_FreeGift
bin/magento setup:upgrade
bin/magento cache:flush
```

Configuration
-------------

[](#configuration)

1. Create an enabled, in-stock simple or virtual product for the gift.
2. Make sure the product has no required custom options and is assigned to the target website.
3. Go to Stores > Configuration > Sales > Free Gift.
4. Enable the global gift and enter the gift SKU.

For cart price rules, go to Marketing > Cart Price Rules and expand the Free Gift fieldset in the Actions area. Enable the rule gift and enter a gift SKU. When that rule applies to the quote, its SKU overrides the global gift SKU.

Testing
-------

[](#testing)

Run the focused unit suite from the module root:

```
vendor/bin/phpunit -c phpunit.xml.dist
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance85

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

79d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4721776?v=4)[Mateusz Niziołek](/maintainers/niziou)[@niziou](https://github.com/niziou)

---

Top Contributors

[![niziou](https://avatars.githubusercontent.com/u/4721776?v=4)](https://github.com/niziou "niziou (6 commits)")

### Embed Badge

![Health badge](/badges/niziou-freegift/health.svg)

```
[![Health](https://phpackages.com/badges/niziou-freegift/health.svg)](https://phpackages.com/packages/niziou-freegift)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1131.9M16](/packages/mollie-magento2)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1011.8k26](/packages/loki-magento2-components)[buckaroo/magento2

Buckaroo Magento 2 extension

32420.3k8](/packages/buckaroo-magento2)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68357.9k](/packages/run-as-root-magento2-prometheus-exporter)[joseph-leedy/module-custom-fees

Adds configurable custom fees to orders

361.2k](/packages/joseph-leedy-module-custom-fees)[angeo/module-llms-txt

Magento 2 module for AI Engine Optimization (AEO). Generates spec-compliant llms.txt and llms-full.txt per llmstxt.org standard, plus streaming JSONL for vector indexing. Multi-store, multi-website, CLI, cron, async admin UI, Page Builder-aware sanitization, customer-group pricing, atomic writes, ETag/Cache-Control, .md mirrors.

111.1k](/packages/angeo-module-llms-txt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)