Download the PHP package oxid-esales/freeshipping-coupons-module without Composer
On this page you can find all versions of the php package oxid-esales/freeshipping-coupons-module. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package freeshipping-coupons-module
OXID Free Shipping Coupons Module
This module introduces a new coupon type, shipfree, designed to balance shipping costs to zero for eligible orders. When applied, this coupon calculates its value based on the current basket’s shipping cost, effectively covering all shipping fees for the user.
Branch compatibility
- b-7.6.x branch is compatible with latest shop compilation 7.6.x resp. b-7.6.x shop compilation branches
- 1.3.x versions (or b-7.5.x branch) are compatible with OXID eShop compilation b-7.5.x
- 1.2.x versions (or b-7.4.x branch) are compatible with OXID eShop compilation b-7.4.x
- 1.1.x versions (or b-7.3.x branch) are compatible with OXID eShop compilation b-7.3.x
- 1.0.x versions (or b-7.2.x branch) are compatible with OXID eShop compilation b-7.2.x
Installation
-
Run the following command to install the latest version of this module:
-
Before activating the module, make sure you run migrations first
- Activate the module through the admin interface or command line:
Development installation on OXID eShop SDK
The installation instructions below are shown for the current SDK for shop 7.6. Make sure your system meets the requirements of the SDK.
-
Ensure all docker containers are down to avoid port conflicts
-
Clone the SDK for the new project
-
Clone the repository to the source directory
- Run the recipe to setup the development environment
You should be able to access the shop with http://localhost.local and the admin panel with http://localhost.local/admin (credentials: [email protected] / admin)
Usage
Configuration:
- Navigate to Shop Settings → Coupon Series → Main.
- Under Discount, select the
shipfreeto enable shipping cost compensation on orders. - Configure the remaining coupon settings as desired.
Usage Notes:
- Zero-value vouchers appear in the cart to ensure
shipfreecoupons are calculated during checkout. - If no delivery fees apply, users will see the error, “The voucher might be wasted if not applied to an order with delivery fees.”
Testing & Limitations:
- Ensure that shipping settings are configured.
- Only one
shipfreecoupon is allowed per basket.
Order confirmation emails
In order to properly display the free shipping voucher value in order confirmation email, you need to change the templates
named order_cust.html.twig and order_owner.html.twig to display the free shipping coupons value and shown in the example below.
bash
Testing
Linting, syntax check, static analysis
Unit/Integration/Acceptance tests
- Install this module in a running OXID eShop
-
Reset the shop's database
-
Run all the tests
- Or the desired suite