PHPackages oxid-esales/freeshipping-coupons-module - 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-esales/freeshipping-coupons-module ActiveOxideshop-module oxid-esales/freeshipping-coupons-module ======================================= v1.2.0(6mo ago)211proprietaryPHPPHP ^8.2CI passing Since Nov 8Pushed 2mo ago2 watchersCompare [ Source](https://github.com/OXID-eSales/freeshipping-coupons-module)[ Packagist](https://packagist.org/packages/oxid-esales/freeshipping-coupons-module)[ RSS](/packages/oxid-esales-freeshipping-coupons-module/feed)WikiDiscussions b-7.5.x Synced 1mo ago READMEChangelogDependencies (18)Versions (12)Used By (0) OXID Free Shipping Coupons Module ================================= [](#oxid-free-shipping-coupons-module) [![Development](https://github.com/OXID-eSales/freeshipping-coupons-module/actions/workflows/trigger.yaml/badge.svg?branch=b-7.5.x)](https://github.com/OXID-eSales/freeshipping-coupons-module/actions/workflows/trigger.yaml)[![Latest Version](https://camo.githubusercontent.com/22cba3e060dc757939ffe69990910a342e827c97f63819049dbe67a58010294b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4f5849442d6553616c65732f667265657368697070696e672d636f75706f6e732d6d6f64756c653f6c6f676f3d636f6d706f736572266c6162656c3d6c617465737426696e636c7564655f70726572656c656173657326636f6c6f723d6f72616e6765)](https://packagist.org/packages/oxid-esales/freeshipping-coupons-module)[![PHP Version](https://camo.githubusercontent.com/711e268303034c1f5fdd2db4f609c9eb3507239a7917ea9c5e5bdd60c5356a58/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f7869642d6573616c65732f667265657368697070696e672d636f75706f6e732d6d6f64756c65)](https://github.com/oxid-esales/freeshipping-coupons-module) [![Quality Gate Status](https://camo.githubusercontent.com/40ad4ee613ffd17a071e1e3c9da96bc1c3a738558936259733545d3cf12b971e/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f667265657368697070696e672d636f75706f6e732d6d6f64756c65266d65747269633d616c6572745f73746174757326746f6b656e3d30303236643237656461333438333732386630393835643434643332373134393237616432663364)](https://sonarcloud.io/dashboard?id=OXID-eSales_freeshipping-coupons-module)[![Coverage](https://camo.githubusercontent.com/901863ef8bec8d1e0c0e1d41c8fa5fa50d5d798aa1cccae51c5d8a7be2ae7f7c/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f667265657368697070696e672d636f75706f6e732d6d6f64756c65266d65747269633d636f76657261676526746f6b656e3d30303236643237656461333438333732386630393835643434643332373134393237616432663364)](https://sonarcloud.io/dashboard?id=OXID-eSales_freeshipping-coupons-module)[![Technical Debt](https://camo.githubusercontent.com/c062883bf4373875ba0228ae1616a7bccd08683f13405913a1c39441854b9078/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f667265657368697070696e672d636f75706f6e732d6d6f64756c65266d65747269633d7371616c655f696e64657826746f6b656e3d30303236643237656461333438333732386630393835643434643332373134393237616432663364)](https://sonarcloud.io/dashboard?id=OXID-eSales_freeshipping-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 -------------------- [](#branch-compatibility) - 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 ============ [](#installation) 1. Run the following command to install the latest version of this module: ``` composer require oxid-esales/freeshipping-coupons-module ^1.3 ``` 3. Before activating the module, make sure you run migrations first ``` vendor/bin/oe-eshop-doctrine_migration migrations:migrate oe_freeshipping ``` 4. Activate the module through the admin interface or command line: ``` vendor/bin/oe-console oe:module:activate oe_freeshipping ``` Development installation on OXID eShop SDK ========================================== [](#development-installation-on-oxid-eshop-sdk) The installation instructions below are shown for the current [SDK](https://github.com/OXID-eSales/docker-eshop-sdk)for shop 7.5. Make sure your system meets the requirements of the SDK. 1. Ensure all docker containers are down to avoid port conflicts 2. Clone the SDK for the new project ``` echo MyProject && git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ && cd $_ ``` 2. Clone the repository to the source directory ``` git clone --recurse-submodules https://github.com/OXID-eSales/freeshipping-coupons-module.git --branch=b-7.5.x ./source ``` 3. Run the recipe to setup the development environment ``` ./source/recipes/setup-development.sh ``` You should be able to access the shop with and the admin panel with (credentials: / admin) ### Usage [](#usage) #### Configuration: [](#configuration) - Navigate to Shop Settings → Coupon Series → Main. - Under Discount, select the `shipfree` to enable shipping cost compensation on orders. - Configure the remaining coupon settings as desired. [![Image alt](./free-ship-coupon.png)](./free-ship-coupon.png) #### Usage Notes: [](#usage-notes) - Zero-value vouchers appear in the cart to ensure `shipfree` coupons 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: [](#testing--limitations) - Ensure that shipping settings are configured. - Only one `shipfree` coupon is allowed per basket. ### Order confirmation emails [](#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. ``` {% for voucher in order.getVoucherList() %} {% set voucherseries = voucher.getSerie() %} {{ voucher.oxvouchers__oxvouchernr.value }} {% if voucherseries.oxvoucherseries__oxdiscounttype.value == "absolute" %} {{ format_price(voucherseries.oxvoucherseries__oxdiscount.value , { currency: currency }) }} {% elseif voucherseries.oxvoucherseries__oxdiscounttype.value == "percentage" %} {{ voucherseries.oxvoucherseries__oxdiscount.value }}% {% elseif voucherseries.oxvoucherseries__oxdiscounttype.value == "shipfree" %} {{ format_price(voucher.oxvouchers__oxdiscount.value , { currency: currency }) }} {% endif %} {% endfor %} ```bash ## Testing ### Linting, syntax check, static analysis ```bash $ composer update $ composer static ``` ### Unit/Integration/Acceptance tests [](#unitintegrationacceptance-tests) - Install this module in a running OXID eShop - Reset the shop's database ``` bin/oe-console oe:database:reset --db-host=db-host --db-port=db-port --db-name=db-name --db-user=db-user --db-password=db-password --force ``` - Run all the tests ``` composer tests-all ``` - Or the desired suite ``` composer tests-unit composer tests-integration composer tests-codeception ``` ### Health Score 41 — FairBetter than 89% of packages Maintenance78 Regular maintenance activity Popularity8 Limited adoption so far Community14 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 ~72 days Recently: every ~85 days Total 6 Last Release 189d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1374817?v=4)[oxid](/maintainers/oxid)[@OxID](https://github.com/OxID) --- Top Contributors [![RahatHameed](https://avatars.githubusercontent.com/u/11661532?v=4)](https://github.com/RahatHameed "RahatHameed (35 commits)")[![hkreuter](https://avatars.githubusercontent.com/u/3692295?v=4)](https://github.com/hkreuter "hkreuter (16 commits)")[![NikolaIvanovski](https://avatars.githubusercontent.com/u/8055347?v=4)](https://github.com/NikolaIvanovski "NikolaIvanovski (8 commits)")[![Sieg](https://avatars.githubusercontent.com/u/98882?v=4)](https://github.com/Sieg "Sieg (7 commits)")[![TitaKoleva](https://avatars.githubusercontent.com/u/22682166?v=4)](https://github.com/TitaKoleva "TitaKoleva (7 commits)")[![freyadrian](https://avatars.githubusercontent.com/u/119357761?v=4)](https://github.com/freyadrian "freyadrian (1 commits)")[![tkcreateit](https://avatars.githubusercontent.com/u/42207462?v=4)](https://github.com/tkcreateit "tkcreateit (1 commits)") --- Tags OXIDmoduleseshop ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/oxid-esales-freeshipping-coupons-module/health.svg) ``` [![Health](https://phpackages.com/badges/oxid-esales-freeshipping-coupons-module/health.svg)](https://phpackages.com/packages/oxid-esales-freeshipping-coupons-module) ``` ### Alternatives [oxid-esales/oxideshop-ce This package contains OXID eShop CE source code. 2381.1M191](/packages/oxid-esales-oxideshop-ce)[ddoe/wysiwyg-editor-module Summernote WYSIWYG Editor for OXID eShop. 19981.7k2](/packages/ddoe-wysiwyg-editor-module)[oxid-esales/gdpr-optin-module This is the GDPR opt-in module for the OXID eShop. 20459.1k2](/packages/oxid-esales-gdpr-optin-module)[oxid-esales/paypal-module This is the PayPal module for the OXID eShop. 36513.5k2](/packages/oxid-esales-paypal-module)[oxid-esales/testing-library OXID eShop testing library 13374.0k10](/packages/oxid-esales-testing-library)[oxid-esales/paymorrow-module This is Paymorrow module for OXID eShop. 18238.2k](/packages/oxid-esales-paymorrow-module) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)