Shopping Cart Promotion Articles
Introduction
With this PepperShop module, the shop can add further articles to customers’ shopping carts based on a rule set or remove them if necessary. This allows actions such as 3 for 2, free giveaways, or more complex implementations where articles should be added to the shopping cart.
How does it work exactly?
First, you edit a PHP class and configure the module’s behavior based on the member variables present there. The linking of individual articles is done via two article additional fields. In the table above, for example, with fields 9 + 10 as standard values preconfigured. Here is a small example:
Article A: DVD “10’000 B.C” with article number ‘dvd002’:
- Additional field 9 = 2
- Additional field 10 = pfeffer003
Article B: PepperShop pepper pod with article number ‘pfeffer003’
Shop behavior with basic configuration (see chapter 3):
- Rule: As soon as at least 2 articles DVD “10’000 B.C.” are in the shopping cart:
- Add one article PepperShop pepper pod to the shopping cart, with weight = 0 kg and price = 0.00.
- For multiples of the quantity values specified in additional field 9 in the shopping cart, a multiple of the promotion article is also added to the shopping cart (or removed again when the quantity changes).
An article editing mask processing requires the assignment of names for these 2 additional fields.
Configuration
Now we open the file {shopdir}/shop/warenkorb_promoartikel.def.php in a suitable editor that can display UNIX line breaks, on Windows e.g. the free program Notepad++. Member variables of the class warenkorb_promoartikel Configuration:
| Member Variable and Default Value | Description Text |
|---|---|
| $promoartikel_modul_aktiv = false | Module activation: Should the shopping cart check at all whether promotion articles should be distributed? (false = deactivated) |
| $zusatzfeld_anzahl_artikel = 9 | Article additional field that defines what the minimum quantity of the article is that must be in the shopping cart. |
| $zusatzfeld_promo_artikel_nr = 10 | Specification of the article number of the promotion article that is added to the shopping cart when minimum quantity or a multiple thereof is in the shopping cart. |
| $promo_gewicht_gleich_null = true | Should the weight of the article be set to 0 kg when it is added to the shopping cart as a promotion article? This is important if no additional shipping costs should arise. Should the price of the article be set to 0.00 when it is added to the shopping cart as a promotion article (=free)? |
| $promo_preis_rabatt_prozent = 0 | Should the price be reduced by this value? (e.g. 50 = 50% price reduction)ATTENTION: Promotion articles cannot be deleted from the shopping cart by the customer! |
| $promoartikel_name_addon = ‘promo’ | Text or translation file key (localetext.inc.php) When the promotion article is added to the shopping cart, what should be written behind its name? |
Installation
System Requirements
To use the Shopping Cart Promotion Articles module, PepperShop v.4.0 Standard or Connect is required. In addition, HTML/PHP knowledge is required. Info: This module is also a prerequisite for coupon processing via ProfitApp Shop module.
Copy and Upload Files
The Shopping Cart Promotion Articles module essentially consists of one additional file that must be copied to your own PepperShop. To do this, first extract the included ZIP archive with the following content:
{shopdir}/shop/warenkorb_promoartikel.def.php | File
This file can be easily uploaded to the web server via FTP or SCP. The placeholder {shopdir} stands for the shop directory on the web server where the file index.php together with README.txt can be found.
Now the module is ready for use, but must be configured first.
Further Help
Do you have questions or need assistance? Do you have special requirements or desire a custom solution for your system? Our support team is happy to help. Support services are charged based on time and material at CHF 195.- / hour. Here is how to reach us:
- Email: support@glarotech.ch
- Phone: +41 (0)71 923 08 58
- Opening Hours: Monday – Friday I 8:00 a.m. – 12:00 p.m. I 1:30 p.m. – 5:00 p.m.
Other Useful Pages
- FAQ (Frequently Asked Questions)
- Modules & Functions
- Interfaces