• Installing the Magento 2 Exit Popup Pro extension
• Set up cron
• Uninstalling the Magento 2 Exit Popup Pro extension
• Extension Compatibility
• Introducing to Magento 2 Exit Popup Pro
• Using Magento Exit Popup Pro
  • Extension Configuration
    • General Settings
    • Translate
  • Creating new popup
    • Newsletter Subscription Form
      • General Settings
      • Popup Settings
      • Content & Colors
      • Discount Coupon
      • Additional Fields
    • Static CMS Block Popup
      • General Settings
      • Popup Settings
    • YES/NO Buttons Popup
      • General Settings
      • Popup Settings
      • Content & Colors
      • Discount Coupon
    • Contact Form Popup
      • General Settings
      • Popup Settings
      • Content & Colors
      • Contact Form Settings
  • Creating new campaign
    • General Settings
    • Popup Settings
    • Conditions

Installing the Magento 2 Exit Popup Pro extension

Command Line Installation

1. Backup your web directory and store database

2. Download the Exit Popup Pro installation package

3. Upload contents of the Exit Popup Pro installation package to your store root directory

4. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder

Run the following command: 

php bin/magento module:enable Aheadworks_ExitPopupPro

then:

php bin/magento setup:upgrade

after:

php bin/magento setup:static-content:deploy -f

5. Flush store cache; log out from the backend and log in again

Composer Installation

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

   1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following commands:

After the command was executed successfully, you can use the composer to install the extension.

To install the extension:

   2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

   3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-exit-popup-pro

if you need to install a specific version, run this command:

composer require aheadworks/module-exit-popup-pro<version>

When prompted, enter Public Key (Username) and Private Key (Password):

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

 To upgrade the extension: 

To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:

composer update aheadworks/module-exit-popup-pro

Updater per version:

composer require aheadworks/module-exit-popup-pro:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Set up cron

If you have already configured cron jobs for your Magento installation then you can skip this step. Read the following instructions on setting cron job for your Magento store: Magento user guide.-

Generally, it would be enough to run in SSH console of your server: 

crontab -e

And insert the following line:  

*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento cron:run
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/update/cron.php
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento setup:cron:run

Remember to confirm the Save request when exiting the installation.

Uninstalling the Magento 2 Exit Popup Pro extension

Since Magento introduced declarative Database you need to be very careful when uninstalling or disabling the module.

Manual Removal

1. Disable the module by executing the following commands:

php bin/magento module:disable Aheadworks_ExitPopupPro
php bin/magento setup:upgrade

2. Remove the extension files from the following folder:

app/code/Aheadworks/ExitPopupPro

Automatic Removal (via Composer)

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_ExitPopupPro

Extension Compatibility

The PHP version depends on your current Magento version. Please, refer to your Magento version

Introducing to Magento 2 Exit Popup Pro

Extension Overview

The Magento 2 Exit Popup extension shows a popup exactly when a customer is about to leave your store. It tracks the user's mouse movement and shows a message right before they close the tab. This helps to stop customers from leaving their carts and encourages them to finish their purchase by offering a discount or a newsletter invite.

Key Features

• Targeted popups for specific pages, store views, and cart conditions

• Unique discount codes generation via Magento Cart Price Rules

• Multiple active campaigns management across different site sections

• Custom input fields to collect additional customer information

• GDPR-compliant consent checkbox for privacy policy acceptance

• Instant coupon display on-screen immediately after subscription

• Flexible design settings for colors and text in the Admin panel
  
  

Using Magento Exit Popup Pro

Extension Configuration 

To enable the extension, go to Stores > Configuration > AHEADWORKS EXTENSIONS > Exit Popup Pro.

Alternatively, you can access the General Settings via: Marketing > Exit Popup Pro by Aheadworks > Popups > Settings.

General Settings

In the General Settings section configure the core behavior of the extension:

• Is Active – set this option to Yes to enable the extension;

• Development Mode – set to Yes to enable detailed error logs;

• Cookie Name – defines the cookie key used to track if the popup was already shown. Changing it will reset the popup display for all visitors.

Translate

 This section allows you to customize the text shown in the popup.

Creating new popup 

 To create a new popup, go to Marketing > Exit Popup Pro by Aheadworks > Popups.

Press the right side of the “Create New Popup” button and then choose the popup content type. There are 4 different types: Newsletter Subscription Form, Static CMS block, YES/NO buttons, Contact form.

Newsletter Subscription Form

Use the Newsletter Subscription Form to collect customer emails. This tool triggers a popup that offers discounts or exclusive content to encourage visitors to join your mailing list.

 To create a popup, go to Marketing > Exit Popup Pro by Aheadworks > Popups > Newsletter Subscription Form.

General Settings

Assign a unique name to the popup in this section. This identifier will be displayed in the general popups list within the Magento Admin panel.

Popup Settings

Disable Auto Position on Mobile Devices – defines the positioning logic for mobile screens:

• No - the extension automatically calculates the optimal position and scales the popup to fit the mobile screen;

• Yes - disables the automatic positioning logic. This option should be enabled if your store design is non-responsive or if you are using custom CSS to position the popup manually.

Content & Colors

• Use the text fields to build a clear and compelling message for your customers.

• Color settings allow you to manage the popup’s color scheme and branding.

• Custom Styles – use this field to apply unique branding via custom CSS. All styles entered here are automatically scoped to the #aw_epp_popup_bg_layer element to ensure the popup's design remains isolated and does not conflict with your store's global CSS.

Discount Coupon

This section allows you to configure automatic coupon generation for users who subscribe via the newsletter popup.

• Is Active – set to "Yes" to enable the discount functionality for the current popup;

• Show in Popup – determine whether the generated coupon code should be displayed to the customer immediately after a successful subscription;

• Cart Price Rule – select a predefined rule from your Magento store (Marketing > Cart Price Rules) that will serve as a template for the generated coupons;

• Code Length – specify the total number of characters for the generated coupon code;

• Code Format – choose the character set for the code;

• Code Prefix – enter a specific string to appear at the beginning of every generated code for easier tracking;

• Code Suffix – enter a specific string to appear at the end of the generated code;

• Dash – specify the character frequency for inserting a dash to improve code readability (e.g., enter "4" to add a dash after every 4 symbols).

Additional Fields

This section allows you to extend the standard newsletter popup by adding custom input fields, such as consent checkboxes, text inputs, or dropdown menus. This can be used to ensure GDPR compliance or to collect specific customer information during the subscription process.

• Field Name – enter a unique internal identifier for the field. This name is used for data mapping and is not visible to the customer;

• Field Label – specify the text that will be displayed to the user. This field supports HTML tags, allowing you to insert links to your Terms and Conditions or Privacy Policy;

• Input Type – select the format of the input field from the dropdown menu:

• Text Field / Textarea – for collecting short or long text responses;

• Drop Down – for providing a list of predefined options;

• Checkbox – typically used for mandatory legal consents or subscription preferences;

• Hidden – for passing background data without showing the field to the user.

• Required – set to "Yes" if the user must fill out this field or check the box before they can submit the form;

• After Email Field – determine the field's position. Set to "Yes" to place this additional field below the email input line;

• Add New Field – click this button to add multiple custom fields to a single popup.

Static CMS Block Popup

The Static CMS Block popup is the most flexible popup type, allowing you to display any custom content created within the standard Magento functional. This type is ideal for seasonal promotions, detailed informational announcements, or complex layouts that include images, links, and custom HTML.

To create a popup, go to Marketing > Exit Popup Pro by Aheadworks > Popups > Static Cms Block.

General Settings

In the General Settings section, configure how the block is identified and selected:

• Enter a unique name to identify the popup in the management grid;

• Static CMS Block – select the desired block from the dropdown list. This list contains all active blocks available in your store.

Popup Settings

Disable Auto Position on Mobile Devices – defines the positioning logic for mobile screens:

• No - the extension automatically calculates the optimal position and scales the popup to fit the mobile screen;

• Yes - disables the automatic positioning logic. This option should be enabled if your store design is non-responsive or if you are using custom CSS to position the popup manually.

YES/NO Buttons Popup

The YES/NO Buttons popup is a high-engagement type designed to offer customers a clear choice between two distinct actions. It is typically used to present an immediate offer or to redirect users to a specific page of the store without requiring any data input.

To create a popup, go to Marketing > Exit Popup Pro by Aheadworks > Popups > YES/NO Buttons.

General Settings

In the General Settings section enter a unique name to identify the popup.

Popup Settings

Disable Auto Position on Mobile Devices – defines the positioning logic for mobile screens:

• No - the extension automatically calculates the optimal position and scales the popup to fit the mobile screen;

• Yes - disables the automatic positioning logic. This option should be enabled if your store design is non-responsive or if you are using custom CSS to position the popup manually.

Content & Colors

• Use the text fields to build a clear and compelling message for your customers. For this popup type, you can specifically customize the call-to-action buttons:

• Use Button YES Text 1 & 2 to define the affirmative response;

• Use Button NO Text 1 & 2 to define the decline option.

• Color settings allow you to manage the popup’s color scheme and branding.

• Custom Styles – use this field to apply unique branding via custom CSS. All styles entered here are automatically scoped to the #aw_epp_popup_bg_layer element to ensure the popup's design remains isolated and does not conflict with your store's global CSS.

Discount Coupon

This section allows you to configure automatic coupon generation for users who subscribe via the newsletter popup.

• Is Active – set to "Yes" to enable the discount functionality for the current popup;

• Show in Popup – determine whether the generated coupon code should be displayed to the customer immediately after a successful subscription;

• Cart Price Rule – select a predefined rule from your Magento store (Marketing > Cart Price Rules) that will serve as a template for the generated coupons;

• Code Length – specify the total number of characters for the generated coupon code;

• Code Format – choose the character set for the code;

• Code Prefix – enter a specific string to appear at the beginning of every generated code for easier tracking;

• Code Suffix – enter a specific string to appear at the end of the generated code;

• Dash – specify the character frequency for inserting a dash to improve code readability (e.g., enter "4" to add a dash after every 4 symbols).

Contact Form Popup

The Contact Form Popup designed to capture customer inquiries and feedback directly within a popup interface. It is typically used to provide a quick communication channel on high-value pages or to offer assistance at the moment of exit intent, allowing users to submit their details and messages without leaving their current page.

To create a popup, go to Marketing > Exit Popup Pro by Aheadworks > Popups > Contact Form.

General Settings

In the General Settings section enter a unique name to identify the popup.

Popup Settings

Disable Auto Position on Mobile Devices – defines the positioning logic for mobile screens:

• No - the extension automatically calculates the optimal position and scales the popup to fit the mobile screen;

• Yes - disables the automatic positioning logic. This option should be enabled if your store design is non-responsive or if you are using custom CSS to position the popup manually.

Content & Colors

• Use the text fields to build a clear and compelling message for your customers. 

• Color settings allow you to manage the popup’s color scheme and branding.

• Custom Styles – use this field to apply unique branding via custom CSS. All styles entered here are automatically scoped to the #aw_epp_popup_bg_layer element to ensure the popup's design remains isolated and does not conflict with your store's global CSS.

Contact Form Settings

This section allows you to configure the automated notification system for all inquiries submitted through the contact popup. This ensures that every lead is correctly routed to your team with the appropriate branding and identification.

• Email Template – select the transactional email template used for outgoing notifications. You can use the default extension template or select a custom one created in the Magento email template manager (Marketing > Communications > Email Templates);

• Sender Name – enter the name that will appear as the sender in your email inbox. This helps you immediately identify that the email came from this specific popup rather than a regular customer or a different store notification;

• Send Emails To – specify the administrator's email address (or multiple addresses) where all submitted contact form data will be delivered;

• Default Subject – define a static subject line for these notification emails to simplify sorting and filtering in your mail client.

Creating new campaign 

Creating campaigns allows you to deliver targeted messages based on specific business goals.

To create a new campaign, go to Marketing > Exit Popup Pro by Aheadworks > Campaigns and press the “Create New Campaign” button.

General Settings

The General Settings section defines the basic rules, visibility, and schedule for your popup campaign.

• Is Active — a toggle switch to enable or disable the current campaign.

• Campaign Name — a text field to enter an internal name for the campaign.

• Start Date / End Date — use the calendar icons to set the specific time frame when the campaign will be active on the store.

• Show in Stores — a multi-select list to choose the specific Store Views where the popup should be displayed.

• Show in Pages — a multi-select list to define the pages where the popup appears. Press and hold the Shift key to select multiple pages.

• Required Params — a text field to specify URL parameters. The popup will only be displayed if the URL matches these flowing parameters. Multiple parameters should be separated by the "&" symbol.

Popup Settings

This section determines the functional behavior and trigger rules for the popup.

• Popup – select the functional type for the campaign.

• Visible on Devices – choose whether the popup should be displayed on All, Mobile, or Desktop devices.

• Show on – select the trigger logic:

• Exit Intent: triggers when a user moves the cursor to leave.

• Page Load: triggers after a specific time.

• Exit Intent & Page Load (Both): triggers based on whichever condition is met first.

• Trigger Delay Time – specify the delay in seconds (only applicable for the "Show on Page Load" trigger).

• Close after Click on Popup Layer – a toggle to allow users to close the popup by clicking on the background overlay outside the window.

• Show again after X Days – set the number of days to wait before showing the popup to the same customer again (cookie-based).

• Show in the Last Tab – enable this to display the popup only when the user is on their final active browser tab. When this option is enabled, the "Show on" settings will be ignored.

Conditions

The Conditions section provides advanced filtering options to control popup visibility based on specific cart attributes or product properties. 

To set a condition, you must follow a two-step selection process:

1. Click the "+" icon to open the first dropdown menu. Here, you select the category of the rule you want to apply. 

2. Define the condition value. Once you have selected a category, click on the three dots ("...") or the highlighted link.

3. A detailed dropdown menu or empty field will appear. Enter the value in the empty field or select the specific parameter you want to use from the list.