Magento 2 Newsletter Popup v4.x Configuration

Step-by-Step action:

1. Go to the “Plumrocket” tab in the main menu.
2. Select Newsletter Popup Extension -> “Configuration” section.
3. “Enable Extension”: this option allows you to enable or disable this Newsletter Popup extension.
4. Option “Serial Key”: enter the unique serial key provided to you after the purchase of the extension. Note: In most cases, this field will be pre-filled with a serial key automatically and the green checkmark will be displayed. In order to find and paste your serial key manually, read the Serial Key Activation article.
5. Option “Use Google Analytics Tracking”: allows you to enable or disable Google Analytics Tracking for your popups.
6. “Enable Subscription History“: if enabled, this option allows to save all user interactions with Popups in the Magento database.
7. “Option “Erase Old Subscription History“: allows selecting the period of time after which the Subscription History will be erased.
8. “Disable History for IP addresses”: this option allows you to specify the IP-addresses with the history of records that will not be saved in the Magento database.
9. Option “Cookie Timeout Usage“: allows you to use two different types of cookies: “Global cookie for all popups” and “Separate cookie for each popup”. This way admin will be able to record the time when the popup was closed for each popup independently. When 2or more popups are enabled at the same time, the user will see the 2nd popup after the page refresh even if the 1st popup was just closed.
10. “Newsletter Popup Thumbnail”: indicates if the “Thumbnail Generation” option for the popup is enabled or disabled.
11. The “Find Wkhtmltoimage Tool” button: allows you to locate this tool after installation on the server, or find it in case it was moved within the file system.

Step-by-Step action:

1. Option “Desktop”: allows you to set the width of the Desktop screen for proper display of the Newsletter Popup. By default, it is 992 pixels or greater.
2. Option “Tablet”: allows setting the width of the Tablet screen. By default, it is 768 pixels or greater.
3. Option “Mobile”: allows setting the width of the Mobile device screen. By default, it is less than 768 pixels.

Step-by-Step action:

1. “Reject Subscriptions from Disposable Email Addresses”: if enabled, this option will reject subscription for the email addresses from the list of disposable email services.
2. “Disposable Email Services”: allows you to enter the blacklisted domain names. Newsletter subscriptions will be rejected for the email addresses from these domains.
3. Press the “Save Config” button to save the settings configured.

Step-by-Step action:

1. “Google reCAPTCHA Site Key”: log into your account at google.com/recaptcha to generate your Google reCAPTCHA Site Key.
2. “Google reCAPTCHA Secret Key”: log into your account (by the link provided above) to generate your Google reCAPTCHA Secret Key.

Step-by-Step action:

1. Go to the “Plumrocket” tab in the main menu -> select “Newsletter Popup” extension -> navigate to the “Manage Popups” section.

Step-by-Step action:

1. You can add a new popup by pressing the “Add Popup” button. Please, move to the how to add new popup section to configure it correctly.
2. The “Thumbnail” column allows you to see the thumbnail image of the popup.
3. “ID”: allows you to see and search by the newsletter ID in the grid.
4. The “Name” column indicates the name of the popup.
5. The “Type” column indicates whether it is a popup window or a widget template.
6. The “Views” column allows you to see the number of users’ views of the popup.
7. The “Subscriptions” column allows you to see the number of users that have been subscribed using a specific popup.
8. The “Conversion Rate” column shows the conversion rate of the popup.
9. The “Orders Count” column allows you to see the number of orders made with this popup.
10. The “Total Revenue” column shows the total revenue gained with this popup.
11. The “Start Date” column indicates the Start Date of the Newsletter Popup.
12. The “End Date” column indicates the End Date of the Newsletter Popup.
13. The “Visible in” option allows you to see the store view(s) that the popup is visible in.
14. The “Status” option: shows the status of the popup: “Enabled” or “Disabled”.
15. The “Preview” button opens the popup in a separate window for your review.

If you want to edit a popup, click on it in the grid and follow the “Add New Popup” section instructions to do it correctly.

Step-by-Step action:

1. Go to the “General” tab of the settings.
2. Option “Popup Name”: allows you to specify the Newsletter Popup name.
3. The “Status” option allows you to enable or disable the popup.
4. The “Type” option allows you to specify the popup type: a popup window or a widget template. Please, note: if you select the Widget Template option in this field, you will be creating a Newsletter Popup widget. In order to display the created Newsletter Popup widget on your store, follow the How to Display Newsletter Popup Widgets section in the current article. You can also display it in another way with the default Magento Widget functionality.
5. Option “Use Coupon Code”: allows you to select the Shopping Cart Price Rule with coupon (if any). For more information about the Shopping Cart PriceRules, please read Creating Shopping Cart Price Rules In Magento 2 article.

Step-by-Step actions:

6. Options “Start Date”, “End Date”: allow you to set the Start Date and End Date of the Newsletter Popup.
7. Option “Subscription Success Page”: allows you to select the page where the subscriber will be transferred to after a successful subscription.
8. Option “Send Autoresponder Email”: allows you to send the notification email to the user after a successful subscription.
9. Option “Autoresponder Email Template”: allows you to select the template that will generate a notification email about the successful subscription.

Step-by-Step action:

1. Option “Code Length”: allows you to set the Discount Coupon Code length.
2. Option “Code Format”: allows you to select the Discount Coupon Code format. Possible options are “Alphanumeric”, “Alphabetical” or “Numeric”.
3. “Coupon Expiration Time”: allows you to specify the expiration time of the coupon in days, hours, minutes. Please, note: This option is only available for shopping cart rules with auto-generated coupons.

Information:

After the user has successfully subscribed to the Newsletter and the Coupon Code is generated, you can see the Coupon Expiration Date in the Shopping Cart Rule section.

Step-by-Step action:

1. Option “User Sign-Up Method” allows you to set the way for a customer’s sign-up process. Possible options are “Sign-up for email newsletter only” and “Register customer account & sign-up for newsletter”.
2. Option “Enable form fields“: allows you to select, enable, rename and define the sort order for the additional fields on users sign-up form.

Step-by-Step action:

1. Go to the “Display Settings” tab.
2. Option “Popup theme“: Press the “Choose Theme” button to select the theme for this Popup.
3. Option “Display Popup”: allows you to select the option where the Popup will be displayed. Possible options are: “After time delay“, “When leaving the site (out of focus)”, “On Page Scroll”, “On Mouse over”, “On click”, and “Manually”. Note: If you select the “On Mouse Over” or “On Click” display method – the “CSS Selector” field will appear, where you can enter the “ID” or “Class Name” of the object you want to use to trigger the newsletter popup. For the “Manually” option, please, check our developer guide on How to Manually Display Popups.
4. “Popup Time Delay”: this option allows you to indicate the delay time after which the Popup displays.
5. Option “Cookie Timeout (days)“: allows you to set the time frame for the cookies in days, hours, minutes, seconds. Cookies are used to track whether a user clicked on the “subscribe” or “cancel” button. If the user chooses to cancel the subscription, then the popup will be displayed again only after a specified amount of days. Enter ‘0’ in this field to never display the newsletter popup again after it was closed for the first time.
6. Option “Animation”: allows you to select different animation effects for a popup.

Step-by-Step actions:

7. Option “Visible In”: allows you to choose which Store view(s) the Popup will be visible on.
8. Section “Display Popup Restrictions”: here, you can create special display popup restriction rules. As a result of these rules, the popup will be displayed only if the conditions you’ve created are true or false. Do not add rules if you want to display a popup to all customers on all pages and devices.
9. “Default Product SKU“: if you choose “21. Rectangle”, “22. Orange Wall”, “23. Grey Edge” or “24. Amazing Shapes” template, you can specify the product SKU in this field and output this product on the popup.
10. “Use Current Product for Popup“: set to “No” if you have specified the product SKU in the previous field. Otherwise, set to “Yes” to output the product a customer is currently viewing on the popup window. You can benefit from this option in the following way: set a coupon code and select “When leaving the site (out of focus)” in the “Display Popup” option. In this case, the popup will appear and offer a discount when a customer tries to close the page. This drives the customer to use a coupon code and make a purchase.

Step-by-Step action:

1. Go to the “Text Labels” tab.
2. Option “Title”: allows you to set the title which will be used for Newsletter Popup.
3. Option “Description”: allows you to indicate some description for the Popup if needed.
4. Option “Success Message”: lets you set the message that will show up after the successful subscription. You can use {{coupon_code}} variable to autogenerate a coupon code and {{coupon_expiration_date}} variable to autogenerate the time of the coupon code expiration.
5. Option “Submit Button”: allows you to create a text for the “Submit” button of the Popup.
6. Option “Cancel Button”: lets you create a text for the “Cancel” button of the Popup.

Step-by-Step action:

1. Go to the “Theme Template” tab.
2. Option “HTML Template”: here you can edit the HTML code of the template. The “Insert Image” option allows you to upload images to your theme template.
3. Option “CSS Styles”: here you can edit the CSS Styles code of the template.
4. Press the “Save Popup” button to save your Newsletter Popup.

Step-by-Step action:

1. Navigate to the “Integrations” tab to enable each integration separately for this Newsletter popup.
2. Enable or disable Mailchimp integration for this newsletter popup.
3. “User Subscription Mode”: lets you allow users to subscribe to the list of their choice or automatically subscribe each new user to all Mailchimp lists. Multiple options are available here.
4. Contact Lists allows you to choose the lists in MailChimp that your customers will be able to subscribe to.
5. Enable or disable other Integration for this popup, e.g., Klavio, GetResponse, etc.

Step-by-Step action:

1. This is how your title section will look like.
2. Here is how the description text section will be displayed.
3. This is the signup section of the newsletter popup.
4. This is how the social media login button will be displayed. Note that Newsletter Popup Extension has built-in support of Twitter & Facebook Login extension.

Step-by-Step action:

1. The title text section of this popup theme is also a button that customers can press to show or hide the popup.

Step-by-Step action:

1. Press the “Plumrocket” tab in the menu.
2. Select the “Newsletter Popup” -> “Manage Themes”.

Step-by-Step action:

1. You can add a new theme by pressing the “Add New Theme” button.
2. “Thumbnail” column: allows you to see the thumbnail image of the newsletter popup theme.
3. “Theme Name”: allows you to see the name of the theme.
4. “Updated At” column: shows the date when the popup theme has been updated.
5. “Created At” column: shows the date when the popup theme has been created.
6. The “Type” column shows the type of the newsletter popup theme.
7. The “Preview” button opens the popup in a separate window where you can preview the popup theme.
8. The “Action” column allows you to edit the required theme.

Step-by-Step action:

1. Option “Theme Name”: allows you to specify the name for your new theme.
2. Option “HTML Template”: here you can add and edit the HTML code. The “Insert Image” button allows you to upload and insert images to your new theme.
3. Option “CSS Styles“: allows you to add and edit the CSS Styles code.
4. Press the “Save Theme” button to save your theme.

Step-by-Step action:

1. Go to the “Plumrocket” tab in the main menu.
2. Select “Newsletter Popup” Extension.
3. Press the “History” tab.

Step-by-Step action:

1. In your Magento 2 Admin Panel, go to the “Plumrocket” tab.
2. Select “Newsletter Popup Extension” > “Configuration” section.
3. As you can see, the “Thumbnail Generation” option is disabled by default.

Step-by-Step action:

1. Go to the “Manage Popups” section of the Newsletter Popup extension.
2. Thumbnails of your Newsletter Popups will be available in the grid once this option is enabled.

Step-by-Step action:

1. Go to wkhtmltopdf official page and click on the “Downloads” link .

Step-by-Step action:

1. Choose and download the needed archive from the list.

Step-by-Step action:

1. In your Magento Admin Panel, go to the “Plumrocket tab > “Configuration” section of the Newsletter Popup Extension.
2. You will be able to see that the “Thumbnail Generation” is now enabled.

Step-by-Step actions:

1. Go to the Content tab in the main Magento menu.
2. In the Elements section, select Blocks.
3. In the Blocks grid, find the CMS block where you want to insert a widget.
4. In the Action column of the needed block, click on Select > Edit.

Step-by-Step actions:

1. In the WYSIWYG editor, click on the place where you need to insert a widget.
2. Press the Insert Widget icon.

Step-by-Step actions:

1. “Widget Type“: in this field, select the Newsletter Popup Form.
2. “Widget Template“: select the widget template you have created in Add New Popup section.
3. Press the Insert Widget button to insert the selected widget into the CMS block.

Step-by-Step actions:

1. Here you can see how the inserted widget is displayed in the WYSIWYG editor.
2. Click on the Save button to save your changes.

1. This is how the inserted widget looks in the frontend.