Abandoned Carts Recovery

Installation #

To install Abandoned Carts, follow these steps:

1. Download & unzip the file and place the abandonedcarts directory into your craft/plugins directory
2. Install plugin in the Craft Control Panel under Settings > Plugins
3. The plugin folder should be named abandonedcarts for Craft to see it.

Abandoned Carts works on Craft 2.5.x. and higher.

Abandoned Carts Overview #

Work in progress

Configuring Abandoned Carts #

You can configure everything through the plugin settings.

It's also possible to override the settings with a config file. There is an example included in abandonedcarts.php.

<?php
return [
    // Supports
    // 1 hour later (recommended).
    // 6 hours later.
    // 10 hours later (recommended).
    // 24 hours later.
    // 36 hours later.
    // 48 hours later.
    // 72 hours later.
    // 96 hours later.
    'interval'               => 1,

    // How far back the plugin will look for abandoned carts
    // In hours
    'maxPastInterval'        => 7 * 24,

    // Where to redirect customer when clicking link in e-mail
    'restoreRedirectUrl'     => '',

    // When someone unsubscribes, they will be redirected here
    'unsubscribeRedirectUrl' => '',

    // Email settings
    'fromName'               => '',
    'fromEmail'              => '',
    'subject'                => '',

    // HTML template
    'template'               => '',

    // Text template
    'templateText'           => '',

    // If you set this, all recovery emails will be sent to that address
    // 'testEmailAddress' => '',

    // If you want a coupon to be applied automatically, use this
    'couponCode'             => '',
];

Using Abandoned Carts #

You need to setup a cron job that either calls the check URL or the console command. Both methods are listed in the settings screen. Recommended interval is 5-10 minutes.

The check will first find any suitable abandoned cart according to the ruleset, and it will then create and run a task. If you have any stalled or long-running tasks in the queue, this might cause problems.

On the plus side, tasks makes it easier to notice if e-mail sending fails.

Qualifying carts #

Abandoned Carts tries it best to qualify if a cart/customer should get an e-mail. The ruleset is modeled on Shopify's research.

The ruleset checks the following:

• If there is an valid email set on the cart
• If a customer has unsubscribed from receiving abandoned cart emails before
• If a order has any items
• If a customer has ordered within the last 24 hours
• If any transactions on the order has failed
• If the total price is above 0
• If at least 1 item in the cart is available for delivery

TODO: Add a more detailed table of the rules, and how they are checked

Email template #

Example HTML and text templates is included in the folder example-email. The templates is passed order (Commerce_OrderModel) and recovery (AbandonedCartsModel).

Abandoned Carts Roadmap #

• Better documentation
• Add top abandoned products
• Detect multiple abandoned carts for email within the interval, and only send e-mail for latest
• Detect if a order isn't possible to ship to the defined customer
• Add analytics widget

Frequently asked questions

Releases