DfCartRecovery — Abandoned Cart Recovery for Shopware 6

Overview

DfCartRecovery brings abandoned cart recovery to Shopware 6 (Community Edition), a capability normally reserved for the Commercial plan: cart detection, up to 3 scheduled reminder emails, a unique discount code per customer, a one-click cart restore link and tracking of recovered orders. No external service, no administration build: everything is configured in the plugin settings.

Requirements

• Shopware 6.5, 6.6 or 6.7 (self-hosted Community Edition — Shopware Cloud SaaS not supported)
• PHP 8.1 or higher (8.2+ recommended)
• Active message consumer and scheduled task runner (Shopware’s standard production recommendation)
• Working email sending on the shop (reminders go through Shopware’s native mail service)

Installation

1. Unzip the archive and place the DfCartRecovery folder in custom/plugins/.
2. From the Shopware root, run:

bin/console plugin:refresh
bin/console plugin:install --activate DfCartRecovery
bin/console cache:clear

The scheduled task df_cart_recovery.process is registered automatically and runs every 15 minutes. Make sure your workers are running:

bin/console scheduled-task:run
bin/console messenger:consume async low_priority

Configuration

Go to Extensions → My extensions → DfCartRecovery → Configuration. Three settings cards:

General

• Enable cart recovery — the plugin’s global switch.
• Minimum cart value — carts below this total are ignored (0 = no minimum).
• Data retention (days) — older tracking entries are deleted automatically (30 days by default, see the GDPR section).

Reminder emails

• Number of reminders — 1, 2 or 3 (2 by default).
• Reminder 1 — minutes after cart abandonment (60 by default, i.e. 1 hour).
• Reminder 2 — minutes after reminder 1 (1440 by default, i.e. 24 hours).
• Reminder 3 — minutes after reminder 2 (4320 by default, i.e. 72 hours).

Discount voucher

• Include a unique discount code — enables individual code generation.
• Promotion for generated codes — select the Shopware promotion that will carry the codes (see below).
• Send the code with reminder no. — 2 by default: customers who return after the first email order without a discount.
• Voucher code prefix — CART by default; generated codes look like CART-7F3A91B2.

Setting up the promotion for unique codes

1. In the Shopware admin, open Marketing → Promotions and create a promotion (or reuse an existing one).
2. In the general tab, enable Individual promotion codes.
3. Define the discount (percentage or amount), conditions and validity period as usual.
4. Activate the promotion, then select it in the plugin configuration.

Customising the reminder email

The content is edited in Settings → Email templates, type “Abandoned cart reminder (DataFirefly)”, for each shop language. Available Twig variables:

• firstName / lastName — the customer’s first and last name
• items — cart items, each with label and quantity
• total and currency — cart total and currency code
• recoveryUrl — the cart restore link (place it on the call-to-action button)
• voucherCode — the unique discount code (empty when disabled or on reminders without a code: wrap its block in a Twig condition)
• shopName — the sales channel shop name
• reminderNumber — the current reminder number (1, 2 or 3)

The restore link

Every email contains a unique link of the form /df-cart-recovery/token, generated on the customer’s sales channel domain, in their language. On click, the plugin rebuilds the cart item by item, flags products that became unavailable with a storefront message, timestamps the click and redirects to the cart page. Invalid or expired links redirect to the home page with an explicit message.

Recovery tracking

As soon as an order is placed, the plugin matches the customer’s email against pending abandoned carts: the entry flips to “recovered” with the order id, the date and the number of reminders sent. Reminders stop immediately for that cart. The data lives in the df_cart_recovery table (tokens, statuses, clicks, linked orders) for your SQL or BI reporting.

GDPR and data

• No data leaves your server; no third-party service is called.
• Tracking entries are purged automatically after the configured retention period.
• On uninstall, choose “Remove all app data” to delete the table, the email template and the configuration — or keep them to preserve history.

Troubleshooting

No emails are sent

• Check the scheduled task is running: bin/console scheduled-task:list must show df_cart_recovery.process as scheduled, and your messenger workers must be active.
• Test the shop’s global email sending (Settings → Mailer): the plugin uses the standard mail service.
• Check the minimum cart value and the reminder 1 delay: a cart abandoned 20 minutes ago with a 60-minute delay is not yet eligible.

Guests receive nothing

This is expected: without an email address, no reminder is possible. Guests are tracked as soon as they identify themselves (login or account creation during checkout) — the cart merge updates the entry with their address.

The discount code does not appear in the email

• Check that “Include a unique discount code” is enabled and a promotion is selected.
• The promotion must exist, be active and have individual codes enabled.
• The code is only attached from the configured reminder onwards (the 2nd by default): reminder 1 carries none in the standard setup.

The restore link redirects to the home page

The token is invalid or the entry was purged (retention exceeded) — the customer sees a message inviting them to rebuild their cart. Increase the retention period if your reminder delays are long.