PHPackages                             kodano/module-promotions - 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. [Admin Panels](/categories/admin)
4. /
5. kodano/module-promotions

ActiveMagento2-module[Admin Panels](/categories/admin)

kodano/module-promotions
========================

A Magento 2 module for managing promotions.

1.0.1(1y ago)02MITPHPPHP >=8.1

Since Sep 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/AlexTs556/magento2-promotions)[ Packagist](https://packagist.org/packages/kodano/module-promotions)[ RSS](/packages/kodano-module-promotions/feed)WikiDiscussions main Synced yesterday

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

Magento 2 Promotions Module
===========================

[](#magento-2-promotions-module)

Overview
--------

[](#overview)

The **Promotions** module for Magento 2 provides functionality to manage promotions and their associated groups. This module allows you to interact with promotions and promotion groups via a REST API, offering operations for listing, adding, and deleting data. The API responses are in JSON format, and it integrates with Magento's default Swagger for API documentation and testing.

Features
--------

[](#features)

- **Manage Promotions**: Create, list, and delete promotions.
- **Manage Promotion Groups**: Create, list, and delete promotion groups.
- **Associations**: Link multiple promotions to multiple groups.
- **REST API**: Access and manage promotions and promotion groups through RESTful endpoints.
- **Swagger Integration**: Test and interact with the API via Magento's default Swagger documentation.

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

[](#installation)

### 1. Install via `app/code` Directory

[](#1-install-via-appcode-directory)

1. Clone the repository:

    ```
    git clone https://github.com/AlexTs556/magento2-promotions.git
    ```
2. Copy the module to your Magento installation:

    ```
    cp -R magento2-promotions/ /app/code/Kodano/Promotions/
    ```
3. Enable the module:

    ```
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    ```

### 2. Install via Composer

[](#2-install-via-composer)

1. Add the repository to your `composer.json`:

    ```
    composer require kodano/module-promotions
    ```
2. Enable the module:

    ```
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    ```

Usage
-----

[](#usage)

Once installed, you can access the promotions API through Magento's Swagger UI. The API endpoints available are:

- **List Promotions**: `GET /V1/promotions`
- **Add Promotion**: `POST /V1/promotions`
- **Delete Promotion**: `DELETE /V1/promotions/:promotionId`
- **List Promotion Groups**: `GET /V1/promotion-groups`
- **Add Promotion Group**: `POST /V1/promotion-groups`
- **Delete Promotion Group**: `DELETE /V1/promotion-groups/:groupId`

You can test and interact with these endpoints using the Swagger UI, accessible at `/swagger` in your Magento admin panel.

API Documentation
-----------------

[](#api-documentation)

API documentation is available through Magento's default Swagger interface. Navigate to `/swagger` in your Magento admin panel to view and test the available endpoints.

Support
-------

[](#support)

If you encounter any issues or need support, please open an issue on the [GitHub repository](https://github.com/AlexTs556/magento2-promotions/issues).

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity2

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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

Every ~0 days

Total

2

Last Release

664d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09d46f5fa4756c1bad341b3751495b628b50371b25a1bc3bf1bf2da59a8a26f8?d=identicon)[Alexts](/maintainers/Alexts)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/kodano-module-promotions/health.svg)

```
[![Health](https://phpackages.com/badges/kodano-module-promotions/health.svg)](https://phpackages.com/packages/kodano-module-promotions)
```

###  Alternatives

[hyva-themes/module-magento2-admin

This module aims to make creating grids and forms in the Magento 2 adminhtml area for developers joyful and fast

176381.1k15](/packages/hyva-themes-module-magento2-admin)[magepal/magento2-guest-to-customer

Quickly and easily convert existing guest checkout customers to registered customers.

70180.4k](/packages/magepal-magento2-guest-to-customer)[markshust/magento2-module-ordergrid

The Order Grid module adds more details to the order grid in the admin.

9189.3k](/packages/markshust-magento2-module-ordergrid)[mage-os/theme-adminhtml-m137

M137 Admin Theme

37228.0k](/packages/mage-os-theme-adminhtml-m137)[smile/module-seller

Smile Retailer Suite - Seller Module

13545.5k4](/packages/smile-module-seller)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

1615.9k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

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