Getting started with Botelix
This guide walks you through activating Botelix and configuring beverage container deposits (Pfand, kaucja, SGR, zaloha) on your WooCommerce store.
Prerequisites
Section titled “Prerequisites”Before installing Botelix, ensure your environment meets the minimum technical requirements:
- WordPress: 6.5 or newer
- PHP: 8.1 or newer
- WooCommerce: 8.0 or newer
- Store currency: Configured to match the currency of your target deposit scheme (e.g., EUR for Germany, Austria, or Slovakia; PLN for Poland; DKK for Denmark; SEK for Sweden; RON for Romania; HUF for Hungary).
Botelix functions seamlessly with both classic WooCommerce templates and modern block-based Cart and Checkout blocks.
Installation and activation
Section titled “Installation and activation”- In your WordPress admin panel, go to Plugins > Add New and search for Botelix, or upload the plugin archive to
wp-content/plugins/botelix. - Click Activate.
- Botelix is operational immediately with sensible production defaults:
- Deposit scheme: Enabled
- Default national scheme: Poland (or whichever default fits your regional base)
- Cross-border destination matching: Enabled
- Export exemption: Enabled
No preliminary configuration needs to be saved to the database before the plugin begins computing fees.
Configuring your beverage products
Section titled “Configuring your beverage products”Botelix attaches deposit metadata to products and individual variations:
- Open Products > All Products and edit any beverage product.
- Under the Product data panel, open the General tab.
- Locate the Deposit Return Scheme (DRS / Pfand / Kaucja) section:
- Scheme override: Select “Store default scheme” (recommended) or pin the product to a specific national scheme.
- Packaging container: Select the physical container:
- Single-use plastic bottle (PET)
- Metal beverage can (Aluminium/Steel)
- Single-use glass bottle
- Reusable glass bottle
- Container units: Specify how many deposit containers are included in this SKU. For a single bottle, enter
1. For a multipack (e.g., a six-pack of cans), enter6. - Deposit per container: Optional. Leave empty to use the standard statutory rate for your scheme, or enter a specific amount to override the rate for this item.
- Crate / outer packaging deposit: Optional. Enter a crate deposit amount (such as German Kastenpfand, e.g., 1.50 EUR) charged on top of individual bottle fees.
- Click Update to save the product.
For variable products, variations inherit the parent product’s container settings unless explicitly overridden at the variation level.
Storefront experience
Section titled “Storefront experience”Once configured:
- Product pages: A clear deposit notice displays beneath the product price (e.g., “+ 0.25 EUR deposit”), calculated from the statutory rate multiplied by the container units.
- Cart & Checkout: Deposits are grouped and calculated dynamically as an itemized fee line (e.g., “Deposit Return Scheme: 1.50 EUR”), transparently separated from product subheaders.