Configuring Botelix
This guide covers Botelix global configuration, customizable notice templates, statutory scheme parameters, and theme integration shortcodes.
Store settings screen
Section titled “Store settings screen”Access global plugin configuration by navigating to WooCommerce > Deposit Return (DRS) in the WordPress admin panel. This page is accessible to administrators and store managers with the manage_woocommerce capability.
All options are saved in the botelix_settings option record.
Core settings
Section titled “Core settings”| Setting | Default | Explanation |
|---|---|---|
| Enable Deposit Scheme | on |
Master switch. When enabled, deposit fees are calculated in the cart, notices render on product pages, and product editor fields are visible. Turning this off pauses calculations without modifying saved product data. |
| Default Scheme | Poland |
Baseline scheme used when cross-border matching is disabled, prior to customer address entry, or for international destinations when the export exemption is disabled. |
| Cross-Border Destination Matching | on |
Dynamically applies the statutory scheme of the customer’s shipping country (or billing country if no separate shipping destination is provided) across 16 supported European nations. |
| Export Exemption | on |
When cross-border matching is enabled, orders shipped outside the 16 supported deposit territories are exempt from deposit fees. |
National scheme cards
Section titled “National scheme cards”Beneath the global settings, Botelix provides a dedicated card for each of the 16 national schemes plus a configurable Custom Scheme. Each card displays its statutory legal basis, taxation classification, and three customizable settings:
- Fee Label: The text shown on the cart, checkout, and invoice fee line (e.g.,
Deposit (Pfand),Kaucja zwrotna,Garantie SGR). - Product Notice Template: The notice displayed directly beneath the single product price. You can use
{amount}or%sas the numerical placeholder (e.g.,incl. {amount} deposit,+ {amount} kaucji). Leaving this blank restores the national default string. - Statutory Rates: Individual rate input fields for each container category recognized under that country’s legislation:
- Single-use plastic bottle (PET)
- Metal beverage can
- Single-use glass bottle
- Reusable glass bottle
If a national scheme does not regulate or cover a specific container type, the corresponding rate field is omitted.
Product editor fields
Section titled “Product editor fields”Under Products > All Products > Edit Product > General tab:
- Scheme override: Force a specific scheme for this product, ignoring the store’s default scheme.
- Packaging container: Select the physical container type. Containers not covered by the active scheme are annotated with a warning label and assessed at zero rate.
- Container units: Multiplier for packages and bundles. For instance, a 24-can case with units set to
24incurs 24 times the unit deposit. - Deposit per container: Optional custom rate overriding the global scheme table for this specific product.
- Crate / outer packaging deposit: Fixed supplementary deposit charged once per product unit (e.g., German Kastenpfand on beverage crates).
Variable products
Section titled “Variable products”Variable products allow container definitions at both the parent and variation levels:
- A variation with no container specified inherits the packaging type, units, and crate settings of the parent product.
- A variation with its own packaging type overrides the parent settings entirely.
- All variations strictly follow the parent product’s scheme override setting.
Layout shortcodes
Section titled “Layout shortcodes”For stores utilizing visual page builders (such as Elementor, Divi, Beaver Builder) or custom block templates, Botelix provides two layout shortcodes:
1. [botelix_deposit]
Section titled “1. [botelix_deposit]”Outputs the formatted deposit notice for the current product context using the active notice template and current customer country scheme.
<!-- Example output --><span class="botelix-deposit-notice">+ 0.25 EUR deposit</span>2. [botelix_packaging_type]
Section titled “2. [botelix_packaging_type]”Displays the official container badge or classification tag (e.g., EINWEG vs MEHRWEG under German packaging rules).
<!-- Example output --><span class="botelix-packaging-badge botelix-packaging-badge--single-use">EINWEG</span>