README

This package is part of the OXID Academy Training Development Basics. Please see our website for current training offers in german or english language.

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

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

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

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

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

Activation

You can activate the module in your OXID eShop administration area or via OE Console by running the command oe:module:activate on your CLI:

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

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

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

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';

oxid-academy / product-promotion-banner

Maintainers

Details