PHPackages                             oxid-academy/product-promotion-banner - 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. oxid-academy/product-promotion-banner

ActiveOxideshop-module

oxid-academy/product-promotion-banner
=====================================

Shows promotion banner on start page for a selected product.

2.2.2(1y ago)041GPL-3.0-or-laterPHPPHP ^8.1

Since May 13Pushed 1y ago1 watchersCompare

[ Source](https://github.com/oxid-academy/product-promotion-banner)[ Packagist](https://packagist.org/packages/oxid-academy/product-promotion-banner)[ Docs](https://www.oxid-esales.com/ressourcen/academy/)[ RSS](/packages/oxid-academy-product-promotion-banner/feed)WikiDiscussions main Synced 1mo ago

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

OXID Academy Product Promotion Banner
=====================================

[](#oxid-academy-product-promotion-banner)

[![Latest Version](https://camo.githubusercontent.com/78586034b2ea4ef462149d9664a91771c154c628a83924710eb0fdbfa138caee/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f7869642d61636164656d792f70726f647563742d70726f6d6f74696f6e2d62616e6e65723f6c6f676f3d636f6d706f736572266c6162656c3d6c617465737426636f6c6f723d6f72616e6765)](https://packagist.org/packages/oxid-academy/product-promotion-banner)[![PHP Version](https://camo.githubusercontent.com/39b4dc6d88eabe0cbf0470168b356f9595ef14cb9f1765a4ed01b1ba03021f8b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f7869642d61636164656d792f70726f647563742d70726f6d6f74696f6e2d62616e6e6572)](https://github.com/oxid-academy/product-promotion-banner)

This package is part of the **OXID Academy Training Development Basics**. Please see our website for current training offers in [german](https://www.oxid-esales.com/ressourcen/academy/schulungen/) or [english](https://www.oxid-esales.com/en/resources/academy/training-courses/) language.

Description
-----------

[](#description)

This extension is an **OXID eShop Module**. It displays a banner on the start page to promote a specific product. The product is selected in the module settings by entering its item number. You can add more item numbers on the configuration page *Promotion Banner > Product Selection*. A product gots deactivated as soon as the stock falls below ten. Then the next product from the queue is automatically set to the module setting. If no product is left, the setting is empty and the banner will not be display.

EVerytime the product changes an info is written to the `source/log/oxideshop.log`.

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

[](#compatibility)

### Versions

[](#versions)

- 2.x.x version is compatible with OXID eShop 7.1.
- 1.x.x version is compatible with OXID eShop 7.1 and 7.0.

### Branches

[](#branches)

- b-7.1.x branch is compatible with OXID eShop compilation b-7.1.x.
- b-7.0.x branch is compatible with OXID eShop compilation b-7.1.x and b-7.0.x.

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

[](#installation)

### Production

[](#production)

In your shop's root directory, execute the following commands:

```
composer require oxid-academy/product-promotion-banner:^2.0.0
./vendor/bin/oe-eshop-db_migrate migrations:migrate oxacppb
```

### Development

[](#development)

In your shop's root directory, execute the following commands:

```
git clone -b b-7.1.x https://github.com/oxid-academy/product-promotion-banner.git ./EXTENSIONS/product-promotion-banner
composer config repositories.oxac-ppb path ./EXTENSIONS/product-promotion-banner
composer require oxid-academy/product-promotion-banner:dev-b-7.1.x
./vendor/bin/oe-eshop-db_migrate migrations:migrate oxacppb
```

Usage
-----

[](#usage)

### Activation

[](#activation)

You can activate the module in your OXID eShop administration area or via [OE Console](https://docs.oxid-esales.com/developer/en/latest/development/tell_me_about/console.html) by running the command `oe:module:activate` on your CLI:

```
./vendor/bin/oe-console oe:module:activate oxacppb
```

### Configuration

[](#configuration)

You must provide at least an existing item number in the module settings. You can add more item numbers on the configuration page.

Troubleshooting
---------------

[](#troubleshooting)

### Banner Not Displaying

[](#banner-not-displaying)

If the banner is not displaying, verify the following:

- Your module is active.
- You are on the start page of your shop.
- An existing item number is provided in the module settings.
- The matching product is active and available for the current user.

If you still encounter any issues, clear your `source/tmp` directory. You can do this by running the `oe:cache:clear` command:

```
./vendor/bin/oe-console oe:cache:clear
```

### No Log Entries

[](#no-log-entries)

If you do not see corresponding entries in `source/log/oxideshop.log`, open your `source/config.inc.php` file and change your log level to `info` at least:

```
/**
 * String PSR3 log level Psr\Log\LogLevel
 */
$this->sLogLevel = 'info';
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity55

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 ~12 days

Recently: every ~1 days

Total

6

Last Release

669d ago

Major Versions

1.0.0 → 2.0.02024-07-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/093771863de624bba0d2ae1bb0b2e834429daf708f6069296e5573e4af8f0e64?d=identicon)[OXID Academy](/maintainers/OXID%20Academy)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/oxid-academy-product-promotion-banner/health.svg)

```
[![Health](https://phpackages.com/badges/oxid-academy-product-promotion-banner/health.svg)](https://phpackages.com/packages/oxid-academy-product-promotion-banner)
```

PHPackages © 2026

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