Skip to content

Configuring Botelix

This guide covers Botelix global configuration, customizable notice templates, statutory scheme parameters, and theme integration shortcodes.

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.

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.

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:

  1. Fee Label: The text shown on the cart, checkout, and invoice fee line (e.g., Deposit (Pfand), Kaucja zwrotna, Garantie SGR).
  2. Product Notice Template: The notice displayed directly beneath the single product price. You can use {amount} or %s as the numerical placeholder (e.g., incl. {amount} deposit, + {amount} kaucji). Leaving this blank restores the national default string.
  3. 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.

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 24 incurs 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 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.

For stores utilizing visual page builders (such as Elementor, Divi, Beaver Builder) or custom block templates, Botelix provides two layout shortcodes:

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>

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>