Recycling Deposit Fees PrestaShop Module - User guide

Manage multiple deposit fees across your catalog with full flexibility.

  • Multiple desposits with: different prices, images, settings, and apply them to any product.
  • Stay compliant and promote sustainability with a single module
  • Designed for large catalogs with CSV import options.
Download from Prestashop Addons
Video guide installation and set up

Recycling Deposit is a PrestaShop module designed to automatically manage refundable deposits for beverage containers, such as plastic bottles, glass bottles, and cans. This system is particularly beneficial in regions like Hungary, where a standardized deposit of 50 HUF per single-use container has been implemented since January 1, 2024. Wikipedia

Key Features:

  • Automatic Deposit Application: Seamlessly adds the specified deposit amount to eligible products in the shopping cart.
  • Configurable Settings: Allows administrators to define which products or combinations are subject to the deposit and adjust the deposit amount as needed.
  • Transparent Display: Clearly itemizes the deposit fee in the cart and on invoices, ensuring customers are informed.

Video guide, installation and set up:

What you will find in this guide

User Guide Documentation Downloads

Installation Options and Steps

Option 1: Install via PrestaShop Addons Account

Connect your store to your Addons account and download the module directly.

Option 2: Upload via Back Office

  1. Go to Modules > Module Manager
  2. Click "Upload Module" in the top-right
  3. Select the .zip file
  4. Proceed to configuration (see steps below)

Option 3: Upload via FTP

  1. Extract the module files locally
  2. Upload to the /modules folder on your server
  3. Proceed with configuration from the back office

Intallation Steps:

1) Go to your Prestashop store's admin back office.

2) Navigating to the main left menu option Modules.

‍3) Opening a submenu called "Module Manager."

4) On the Modules section, search for the module named ‘Recycling Deposit’

  • Select the ‘Install’ option to upload and install the module. 

Step-by-step configuration:

Important notes:

1 - This module allows you to manage multiple deposits by reusing a store product as the deposit. This makes the deposit appear as a separate item in the cart, checkout, and invoice.

2 - If you have multi-store enabled, you will be asked to select the corresponding store.

1 - Accessing the module

When accessing the module, a list of all deposits already created is displayed.

If this is the first time you access it, the list will be empty.

List columns:

  • ID (of the product)
  • Deposit Name: in this same column, there is an eye icon that redirects you to the product page related to the deposit.
  • Deposit Price: displayed with and without tax, as well as the applied tax. To modify it, you need to access the product corresponding to this deposit.
  • Associated products
  • Thumbnail
  • Active
  • Display thumbnails
  • Display label

2 - Creating a new Deposit

To create a deposit:

  • 1. Open the main list.
  • 2. Click Add new deposit.
  • 3. Choose whether you want to use an existing product or create a new one.

Option A. Select an existing product

This option is selected by default. Use it when a product that you want to use as the deposit already exists in the catalogue.

  • 1. Enter a few characters or the full product name.
  • 2. Select the correct product.
  • 3. Review the configuration.
  • 4. Save the changes

Option B. Create a new product

Use this option when a product representing the deposit does not yet exist.

When you select it, the following fields are displayed:

  • Reference: nternal code for the new product.
  • Price: Amount that will be added to the cart.
  • Name: Visible name of the deposit.
  • Tax rule: Select the tax rule associated with the deposit, when required.
  • Feature Image: Image representing the deposit.

4 - Display Image in Front Office

  • Description: Option to show or hide the previously uploaded deposit image in the front office.
  • Functionality: When enabled, the image uploaded in the previous step will be visible to customers in the cart and during checkout. It will also appear on the product page label below the action buttons, and on product cards if the corresponding setting is enabled. Disabling this option will hide the image in all these locations, although the deposit will still be applied.

5 - Display deposit label in product cards

  • Description: Toggle to show or hide the per-product deposit price on product cards for applicable products.
  • Functionality: Controls whether the uploaded deposit image (if the ‘Display Image in Front Office’ option is enabled) is displayed alongside the per-product deposit price label on product cards across the site for applicable products. Please note that for combination products, the deposit label will only appear if the featured combination is also subject to the deposit fee.

6 - List of Associated Products/Combinations

After creating the deposit, specify the products to which it applies.

  • 1. Open the deposit that you want to configure..
  • 2. Click the button to associate products.
  • 3. A pop-up window will open.
  • 4. Search for the products that you want to link.
  • 5. Select the relevant products or combinations.
  • 6. Click Save.

You can associate:

  • A complete product.
  • A specific combination.
  • Several combinations of the same product.
  • Different products.
  • Simple products and products with variants.

7 - Bulk imports

The Import tab provides three import types. You can import deposits, manage deposit-to-product associations in bulk, or perform both actions at the same time using a simple CSV file.

This feature is useful when the store has many products and configuring them one by one is not practical.

General workflow

  • 1. Open the Import tab.
  • 2. Prepare the required import file according to the format accepted by the module. For each import type, you can download a sample file showing the accepted structure.
  • 3. Select the import type that you want to run.
  • 4. Select the .csv file to import.
  • 5. Run the import.
  • 6. Review the report generated by the system.
  • 7. Correct any records containing errors.
  • 8. Repeat the import when required.

Customer-Facing Display of Deposits

When the Recycling Deposit module is enabled and configured, customers will observe the following indicators across various stages of their shopping experience:

Product Page

  • Deposit Icon Adjacent to Price: On product pages, an icon representing the deposit will appear next to the product price, signaling to customers that an additional refundable deposit applies to the item.
  • Label Below the Add to Cart Button: Provides customers with more details about the additional cost applied to the given product.

Category Page

  • Deposit Icon Adjacent to Price: On category pages, the recycling deposit icon will appear below the product price, along with the deposit amount assigned to that product, indicating to customers that an additional refundable deposit is being applied to the item.

Shopping Cart Page

  • Icon Next to Applicable Products: In the shopping cart, products with associated deposits will display the deposit icon beside their names, ensuring transparency about additional charges.
  • Separate Deposit Line Item: The cart summary will include a distinct line item detailing the total deposit amount for all applicable products, helping customers understand the breakdown of their total cost.

Checkout Page

  • Consistent Deposit Icon Display: During the checkout process, the deposit icon will continue to appear next to each product that includes a deposit, maintaining clarity throughout the purchasing journey.

Order Confirmation Email

  • Deposit Details Included: The order confirmation email sent to customers will list deposit charges as separate items. These charges will always be displayed individually and will match the total quantity of products that include a deposit, providing a clear and comprehensive summary of the order.

Invoice

  • Itemized Deposit Charges: In the generated invoice, deposit charges will be displayed as separate line items. The number of deposit items will always match the total quantity of products that include a deposit, ensuring customers have a clear and detailed record of all charges.

Order Details Page (Customer Account)

  • Visible Deposit Information: Within the customer's account under order details, deposit charges will be listed as separate items. The number of deposit items will match the quantity of products that include a deposit, ensuring clear and accessible information after purchase.

These features are designed to provide customers with clear and consistent information regarding any additional refundable deposits associated with their purchases, enhancing transparency and trust in your store's operations.

If you need further assistance with configuring these displays or customizing the module to better fit your store's needs, feel free to ask!

F.A.Q.

Here’s a list of common questions related to the module:

1Can customers remove the deposit fee from their cart?
No. The deposit fee is automatically added to the cart as a separate product when applicable, and it cannot be removed by the customer. This ensures that the fee is always correctly applied and cannot be bypassed.
2What happens if the extra product I’m using is removed from the store?
In that case, you’ll need to assign a new extra product in the module’s back office settings. Until you do, the module will stop working in the front office.
3I no longer sell some products or variants that were listed under ‘Products/Variants which will include the extra product’. Do I need to remove them manually?
No. That list automatically reflects only the products (draft or active) currently available in your store’s catalog. Removed items won’t appear.
4I want to increase the price of the recycling deposit fee. Where can I do that?
You can change the deposit fee by updating the price of the product currently set as the ‘Extra product’ in your catalog.
5Can I apply the recycling deposit to specific combinations of a product?
Yes, you can. The deposit fee can be applied to selected combinations only - it doesn’t have to apply to the entire product or all of its combinations.
6Will the deposit fee be applied to pack products?
Yes. If the specified product or variant is included in a pack, the deposit fee will be applied based on its quantity within the pack. For example, if the product appears 3 times in the pack, the deposit fee will be charged 3 times accordingly.
7How will my customers know which products or variants are affected by the deposit fee?
By default, each affected product includes a label on the product page indicating that an additional fee will be added on top of the original price.
On the cart page, customers will also see which products are affected, along with the total extra fee based on the product quantity. For pack products, the label will specify which individual items within the pack carry the deposit fee.
Additionally, if you enable the ‘Display deposit label in product cards’ option, a per-product fee label will appear on product listings. You can also display an icon next to these labels, as well as on product thumbnails during the checkout process.
8The position of the label below the ‘Add to cart’ button on the product page is not right, is it possible to re-position it?
Yes, it's due to the hook order in PrestaShop. To update the order and move the section up or down, go to the settings page of the 'Recycling Deposit' module. In the top right corner, select the 'Manage hooks' option.
On the next page, find the 'displayProductAdditionalInfo' hook in the list, then drag and drop the 'Recycling Deposit' module row to your preferred position. This will update its placement in the front office.
9The position card label is not right, is it possible to re-position it?
Yes, it's due to the hook order in PrestaShop. To update the order and move the section up or down, go to the settings page of the 'Recycling Deposit' module. In the top right corner, select the 'Manage hooks' option.
On the next page, find the ‘displayProductListReviews’ hook in the list, then drag and drop the 'Recycling Deposit' module row to your preferred position. This will update its placement in the front office.