Created: 09/2018
Latest updated: 10/2023 – Updated version: 2.1.1
By: VillaTheme
Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!
WooCommerce Coupon Box is a WooCommerce and WordPress email subscription plugin that helps you collect emails from your visitor. Don’t waste your traffic, Email marketing is an old-but-gold marketing channel. The WooCommerce and WordPress email subscription plugins help you turn traffic into email subscribers. The WooCommerce and WordPress email subscription plugins display a subscribe email pop-up to new visitors, offering coupons and asking them to subscribe email, generating and sending a coupon code to the subscribed email address. You can check the subscribed email addresses in the plugin back-end or sync with your email marketing platforms through API.
A popup will appear when users visit your site, offer a discount when they subscribe on the coupon box.
The WooCommerce and WordPress email subscription plugin can send discount coupons to subscribers. You can select to send existing coupons or generate unique coupons.
This plugin integrates some email marketing platforms, allowing subscribed emails to sync to these platforms and perform other marketing strategies as needed. The email marketing platforms available:
ReCaptcha 2: “I’m not a robot” Checkbox. This requires the user to click a checkbox indicating the user is not a robot. This will either pass the user immediately (with No CAPTCHA) or challenge them to validate whether or not they are human. This is the simplest option to integrate with and only requires two lines of HTML to render the checkbox.
ReCaptcha 3: reCAPTCHA v3 allows you to verify if an interaction is legitimate without any user interaction. It is a pure JavaScript API returning a score, giving you the ability to take action in the context of your site: for instance requiring additional factors of authentication, sending a post to moderation, or throttling bots that may be scraping content.
The WooCommerce and WordPress email subscription plugin will automatically send emails to subscribers. Configure the email content as you want.
Subscribed emails from this WooCommerce and WordPress email subscription plugin will be saved in email campaigns.
You can use the coupon box shortcode: [wcb_widget always_visible=1 show_coupon_code=1
] that helps to display subscription forms anywhere you want, this can be substituted for the popup style.
The front-end style of the Coupon Box pop-up to match your site’s style.
Within your support period, you can automatically update the plugin from your Dashboard. After that, you are still able to update the plugin manually.
It is recommended using
1. WordPress 5.0+
2. PHP 7.0+
3. WooCommerce 7.0+
Get the plugin installation package from your account download page and save it to your desktop.
Go to Plugin/ Add New/ Upload Plugin/ Choose file/ select the plugin zip file woocommerce-coupon-box.zip/ click “Install Now“/ click “Active plugin“.
Video Install and Set up WooCommerce Coupon Box:
Done! Let’s start using the plugin.
Go to Dashboard/ Woo Coupon Box/ Settings/ General to configure common settings of Woo Coupon Box.
1. Enable: allow you to enable/disable the plugin.
2. Disable for logged-in users: this option allows you to hide the pop-up from logged-in users. You have already had email addresses of those users.
3. Enable multi language: this option allows you to display the coupon box in multiple languages. This option works with WPML and Polylang now. You need to use that plugin to translate the plugin before enabling this option.
You can see this video on how to show multilanguage for a coupon box with WPML:
4. Ajax endpoint: select the AJAX endpoint. It should be AJAX in most sites.
5. Pop-up trigger: decide which act will make the pop-up appear, there are 4 options for you to choose from
5.1. After initial time: The pop-up will automatically appear after a selected time. Example: with the following settings, the coupon box will appear after a random time between 3 and 10 seconds.
5.2.When users scroll: The pop-up will appear after users scroll the page an amount of the page height.
5.3. When users are about to exit: the pop-up will appear when visitors hover their mouse on the close button of browsers.
5.4. Random one of these above: The plugin will get randomly one trigger.
6. When visitors close coupon box without subscribing: Select how will the coupon box work if visitors close the pop-up without subscribing. There are 2 option for you to choose from:
6.1. Hide the coupon box pop-up
6.2. Minimize the pop-up to the top bar/ bottom bar.
7. Subscription reminder if not subscribe: schedule a time for the pop-up to reappear when visitors close the pop-up without subscribing to their emails.
8. Subscription reminder if subscribe: schedule a time for the pop-up to appear again if visitors have already subscribed to their email.
9. Email campaigns: Select an email campaign where you would like to save the emails. We will talk more about the emails campaign in the next chapters of this guide.
In Coupon tab, you can set up coupons you will send to visitors who subscribe emails in Woo Coupon Box.
In the Email tab, you can configure the email will send to subscribers after they subscribe emails.
1. Enable: To send an email when a customer subscribes on our site with WooCommerce Coupon Box.
2. Email template: Choose available email templates to send different emails for each prize, please use WooCommerce Email Template Customizer or Email Template Customizer for WooCommerce to create and customize your own email template.
If there is no template chosen, default template will be sent out.
1. Fill in your email subject.
2. Fill in the email heading.
3. Set up the email content, you can use shortcodes here.
{coupon_value} – The value of the coupon, can be percentage or currency amount depending on coupon type
{coupon_code} – The code of coupon that will be sent to your subscribers
{date_expires} – From the date that given coupon will no longer be available
{last_valid_date} – That last day that coupon is valid
{site_title} – The title of your website
{shop_now} – The shop now button
4. The shop now button text. Change it as you need, “USE COUPON NOW” maybe
5. The shop now URL, it can be the shop URL.
6. 7. 8. Design the shop now button in emails with text color, font size, and background color.
In the Email API tab, you can sync subscribing emails to some email marketing platforms such as:
1. Enable/Disable MailChimp API.
2. Enable Mailchimp double option to send email to each subscriber to confirm that they subscribe to your list successfully. If they agree to subscribe, the data will be allowed to sync to the Mailchimp contact list.
3. Mailchimp API Key: You need to enter the Mailchimp API key to make it work. Click on the “here” to direct to the page you can create an API key on your Mailchimp account. Copy the API key to the “Mailchimp API Key” box in Woo Coupon Box Setting. Then, Click on the Save button.
4. Choose the Mailchimp list you want to work with Woo Coupon Box and save it again.
1. Enable/Disable Active Campaign API.
2 and 3: Sign in to your Active campaign account, Go to settings/Dashboard/ Developer/ Copy the URL and Key to the Active Campaign API key and Active Campaign API URL boxes in the Woo Coupon Box Settings then click on the Save button.
4. Choose the active campaign list you want to work with Woo Coupon Box.
1. Enable/Disable SendGrid API.
2. Log in your SendGrid account, go to settings/API keys/ Create an API Key then copy the key which has just been created to the SendGrid API Key box in the Woo Coupon Box Enter your SendGrid API Key then click on the Save button,
3. Select a SendGrid list, subscribing emails will be added to this list.
1. Enable/Disable Hubspot API.
2. Hubspot API key: You need to enter the Hubspot API key to make it work. Please follow these steps:
For further information about Access your HubSpot API key
1. Enable/Disable Klaviyo API.
2. Klaviyo API key: You need to enter the Klaviyo API key to make it work. Go to get the API key here.
3. Klaviyo list: Choose the Klaviyo list you want to work with Woo Coupon Box and save it again.
1. Enable/Disable Sendinblue API.
2. Sendinblue API key: You need to enter the Sendinblue API key to make it work.
a. Go to SMTP & API section
b. Create a new API key
c. Copy API key and paste to the Sendinblue API key field in the plugin.
3. Sendinblue list: Choose the Sendinblue list you want to work with Woo Coupon Box and save it again.
To let the MailPoet settings appear on the Email API tab of the WooCommerce Coupon Box plugin, you must install the MailPoet plugin. These steps below:
Step 1: Install the MailPoet plugin
Step 2: Go to the MailPoet website: mailpoet.com and sign up for a plan. Go to Account, Copy the key in your MailPoet settings to use the plan.
Step 3: Go to the MailPoet’s setting in WooCommerce, paste that key.
Step 4: Go to Woo Coupon Box > Mail API, the MailPoet settings will appear there.
Step 5: Enable/Disable Mailpoet API.
Step 6: Choose the Mailpoet list you want to work with Woo Coupon Box and save it again.
To let the Mailster settings appear on the Email API settings, you must install and activate the Mailster plugin. This plugin does not have a free version. The steps are as follows:
Step 1: Install the Mailster – Email Newsletter Plugin for WordPress plugin
Step 2: Now the Mailster settings are available in the Email API settings. You don’t need an API key to use, simply enable Mailster API .
Step 3: Select one Mailster list in
There’ll always be a Default list.
To connect GetResponse, you must have an active GetResponse account. Then follow steps below:
Now you’ll be able to select a campaign list in your GetResponse account in
Then the subscription email will go to your selected list.
This setting helps you protect your website from spam and abuse.
ReCaptcha 2: “I’m not a robot” Checkbox. This requires the user to click a checkbox indicating the user is not a robot. This will either pass the user immediately (with No CAPTCHA) or challenge them to validate whether or not they are human. This is the simplest option to integrate with and only requires two lines of HTML to render the checkbox.
ReCaptcha 3: reCAPTCHA v3 allows you to verify if an interaction is legitimate without any user interaction. It is a pure JavaScript API returning a score, giving you the ability to take action in the context of your site: for instance requiring additional factors of authentication, sending a post to moderation, or throttling bots that may be scraping content.
In the Assign tab, you can select which page where will the Coupon Box pop-up appear.
Important note:
To handle WP’s Conditional Tags, this plugin uses eval() which is very dangerous because it allows the execution of arbitrary PHP code. Therefore, please only fill this field with proper conditional tags which are validated and/or provided by trusted developers.
In the Design tab, click on Go to design now to go the Design page of WooCommerce Coupon Box.
In the Design page
In Update tab, fill in your Envato purchase code to active the auto-update feature.
In Woo Coupon Box/ Email Subscribe, you can check subscribed emails with information for the email address, subscribing time, email campaign, given coupon, info of custom fields (if any) MailChimp list and Active Campaign list, and customer’s IP address.
In Woo Coupon Box/ Email Campaign, you can create new/delete/edit email campaign. By default, you will have an Uncategorized campaign
In Woo Coupon Box/ Export Email, you can export emails by date or by campaigns. Emails addresses will be exported as an excel file.
You can use a shortcode [wcb_widget always_visible=1 show_coupon_code=1]
to display subscription form everywhere.
All parameters:
type
: There’re 2 templates, fill value “1” or “2”
always_visible
: Fill “1” to always show the form, even with logged-in/subscribed users (checked using browser cookies). Otherwise fill “0”
bt_color
: Button color, add color code as value for this parameter
bt_bg_color
: Background color of the button, add color code as value for this parameter
bt_border_radius
: Adjust the corner round, add number of pixel as value for this parameter
input_border_radius
: Border radius of the input field, add number of pixel as value for this parameter
show_coupon_code
: Fill value “1” if you want to show coupon code below Message After Subscribing
show_first_name
: Fill value “1” if you want to show custom field “First name”
show_last_name
: Fill value “1” if you want to show custom field “Last name”
show_mobile
: Fill value “1” if you want to show custom field “Mobile”
show_birthday
: Fill value “1” if you want to show custom field “Birthday”
show_gender
: Fill value “1” if you want to show custom field “Gender”
show_additional
: Fill value “1” if you want to show custom field “Additional field”
An example for a shortcode with full parameter: [wcb_widget always_visible=1 show_coupon_code=1 type=1 show_first_name=1 show_last_name=1 show_mobile=1 show_birthday=1 show_gender=1 show_additional=1 bt_color=#FFFFFF bt_bg_color=#990C31 input_border_radius=20 bt_border_radius=20]
Plugin | Author | Compatible |
---|---|---|
WooCommerce Email Template Customizer | VillaTheme | Fully |
Elementor for shortcode | Elementor | Fully |
WPML | OnTheGoSystems | Fully |
Polylang | WP SYNTEX | Fully |
Thank you for your attention!
If you have any question, please create a topic at our FORUM, we will support within 24 hours.