johnhenry / craft-container-deposits
Container deposits for Craft Commerce, each on its own cart line and kept out of VAT and discounts. Set up for Ireland's Re-turn scheme.
Package info
github.com/john-henry/craft-container-deposits
Type:craft-plugin
pkg:composer/johnhenry/craft-container-deposits
Requires
- php: ^8.2 || ^8.3 || ^8.4
- craftcms/cms: ^5.0
- craftcms/commerce: ^5.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
- phpstan/phpstan: ^2.2
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-09-28 13:32:05 UTC
README
Container Deposits for Craft Commerce
Container deposits for Craft Commerce, for Ireland's Re-turn scheme or any other deposit return scheme. Each deposit goes on its own cart line, moves with the quantity, counts every container in a multipack, and stays out of VAT and your discounts.
Features
- Per-variant deposits: Pick a deposit type for any variant, or for a whole product, from a custom field
- Auto-managed line items: Deposits show up as their own line items and keep pace with quantity changes
- Admin-managed deposit list: Keep a list of deposit tiers in the control panel (e.g. €0.15 cans, €0.25 bottles)
- Multipacks handled properly: Tell it how many containers are in a unit and a 6-pack charges six deposits, a tray of 24 charges 24
- Tax-exempt (VAT/sales tax): Deposit line items sit under a dedicated "Container Deposits (No VAT)" tax category
- No discount leakage: Deposits are never promotable or on sale, and they don't count toward a discount's minimum spend or quantity
- Product and invoice display helpers: Twig helpers and example templates for product cards, carts, and Re-turn-shaped producer invoices and till receipts
- Multi-site and multi-store ready: Deposit purchasables propagate to every site out of the box
- Re-turn ready: Matches the official Irish Deposit Return Scheme structure out of the box
Documentation
Full documentation is at johnhenry.ie/plugins/container-deposits/docs.
Requirements
- Craft CMS 5.0 or later
- Craft Commerce 5.0 or later
- PHP 8.2 or later
Accessibility
How accessible the plugin is, what's been checked, and how to report a problem are all in the accessibility statement.
Support
Need a hand? Open an issue on the GitHub Issues page.
License
Proprietary. Copyright (c) 2026 John Henry Donovan.