Layered Popups

Create unique popups

Disclaimer

We are constantly improving our plugin by adding new features and fixing bugs. Please keep the plugin updated and always use latest version. This documentation is related to actual version of the plugin. This documentation is under development.

Glossary

To understand documentation and plugin's functionality please rememeber the following words and phrases:

  • OnLoad popup - the popup, which appears when website's page loaded.
  • OnScroll popup - the popup, which appears when user scroll down website's page.
  • OnExit popup - the popup, which appears when user moves mouse cursor to top edge of browser window, assuming that he/she is going to leave the page.
  • OnInactivity popup - the popup, which appears when user does nothing on your website: popup appears if user doesn't move mouse, doesn't press buttons, doesn't touch screen for certain period of time.
  • OnAdBlockDetected popup - the popup, which appears if users use AdBlock software.
  • Event popup - the popup that you used for certain website event. In simple words, event popup is a common name of OnLoad, OnScroll, OnExit, OnInactivity and OnAdBlockDetected popups.
  • Inline popup - the popup that is embedded into post/page and displayed as a part of their content.
  • OnClick popup - the popup, which appears when user click something: link, button, image, menu item, etc. OnClick popup is not Event popup.

Intro

Internet is full of boring popups. So, it's a time to break this trend. That's why we created "Layered Popups" plugin. With this plugin you can realize your imagination and make unique multi-layers popups. You can create multiple layers with whatever-you-want content and add custom transitions/animations for each layer. You can embed AJAX-ed subscription/contact form which works with 84 email marketing providers (Acelle Mail, ActiveCampaign, ActiveTrail, AgileCRM, Arigato Pro, AvangEmail, AWeber, Benchmark, Campaign Monitor, Campayn, CleverReach, Constant Contact, ConvertKit, Customer.io, Direct Mail for Mac OS X, dotmailer, Drip, E-goi, EasySendy Pro, Elastic Email, EmailOctopus, Emma, E-newsletter by WPMU DEV, eSputnik, FireDrum, Follow-Up Emails, FreshMail, GetResponse, HubSpot, iContact, Interspire, Jetpack Subscriptions, KIRIM.EMAIL, Klaviyo, Klick Tipp, Mad Mimi, Mailautic, Mailbox Marketing, MailChimp, MailerLite, Mailigen, MailJet, MailKitchen, Mailleader, MailPoet (WYSIJA), Mailrelay, Mailster (MyMail), MailWizz, Market Hero, Mautic, Moosend, MPZ Mail, MyNewsletterBuilder, Omnisend, Ontraport (Office Auto Pilot), Perfit, Pipedrive, Rapidmail, RocketResponder, SALESmanago, SG Autorepondeur, SalesAutoPilot (MailMaster), Sendloop, SendGrid, SendPress, SendPulse, SendReach, SendinBlue, Sendlane, Sendy, SimplyCast, SqualoMail, StampReady, StreamSend, Subscribe2, The Newsletter Plugin, TotalSend, Tribulant Newsletters, UniSender, UserEngage, Vision6, Your Mailing List Provider (YMLP), Zoho Campaigns, Zoho CRM) and collect users' names and e-mails. You can raise popup on page load, on exit intent, on scrolling down, on inactivity or show it on click event. Moreover you can use any popup as a part of post/page content and show them inline. Make your website more attractive and pay users attention to certain stuff.

Installation

Layered Popups is a WordPress plugin and it is installed as regular WordPress plugin:

  1. Go to WordPress dashboard and click left side menu "Plugins >> Add New".
  2. Click "Upload" link and upload zip-archive downloaded from CodeCanyon.
  3. Activate uploaded plugin.

If you have any difficulties with uploading zip-archive, please do it manually using FTP:

  1. Use any FTP-client to connect your server.
  2. Unzip archive downloaded from CodeCanyon.
  3. Upload unzipped folder to plugins directory: /wp-content/plugins/
  4. Go to WordPress dashboard, click left side menu "Plugins" and activate uploaded plugin.

Once installed and activated, plugin creates "Layered Popups" menu section in left menu column. All further actions, related to plugin functionality, are done through this menu section.

Settings

All plugin settings can be reached through menu "Layered Popups >> Settings". Please find detailed settings description below.

General Settings

General plugin settings can be reached through menu "Layered Popups >> Settings". Settings page consist of several sections. Please find detailed description of each section below.

OnLoad Settings

These are deprecated parameters. Use Targeting to configure OnLoad popups.

This section allows you to select popup, which appears when website's page loaded. These are site-wide settings. Once configured, popup will be displayed on all pages of website. These settings can be overloaded on appropriate section of post/page/product editor page. OnLoad Settings has the following parameters:

  • Popup or A/B Campaign - select popup or A/B campaign to be displayed when page loaded. You can select different popups/campaigns for desktops/laptops/tablets and for smartphones.
  • Display mode - select how often OnLoad popups must be displayed:
    • Disable popup - the popup will never be displayed.
    • Every time - the popup is displayed every time until the user has submitted a subscription form.
    • Once per session - the popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
    • Once per X days - the popup is displayed once per X days until the user has submitted a subscription form.
    • Only once - the popup is displayed only once.
  • Start delay - the popup can be displayed with certain delay when page loaded. Set delay (in seconds) here.
  • Autoclose delay - the popup can be automatically closed after certain delay. Set delay (in seconds) here.

Please remember that these are site-wide settings. If necessary you can overload them for certain post/page/product on appropriate post/page/product editor.

OnScroll Settings

These are deprecated parameters. Use Targeting to configure OnScroll popups.

This section allows you to select popup, which appears when user scroll down website's page. These are site-wide settings. Once configured, popup will be displayed on all pages of website. These settings can be overloaded on appropriate section of post/page/product editor page. OnScroll Settings has the following parameters:

  • Popup or A/B Campaign - select popup or A/B campaign to be displayed when user scroll down website's page. You can select different popups/campaigns for desktops/laptops/tablets and for smartphones.
  • Display mode - select how often OnScroll popups must be displayed:
    • Disable popup - the popup will never be displayed.
    • Every time - the popup is displayed every time until the user has submitted a subscription form.
    • Once per session - the popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
    • Once per X days - the popup is displayed once per X days until the user has submitted a subscription form.
    • Only once - the popup is displayed only once.
  • Scrolling offset - the popup is displayed when user scroll down to this number of pixels.

Please remember that these are site-wide settings. If necessary you can overload them for certain post/page/product on appropriate post/page/product editor.

OnExit Settings

These are deprecated parameters. Use Targeting to configure OnExit popups.

This section allows you to select popup, which appears when user moves mouse cursor to top edge of browser window, assuming that he/she is going to leave the page. Due to specificity of event these settings are actual for desktops/laptops and not actual for touch screen devices. These are site-wide settings. Once configured, popup will be displayed on all pages of website. These settings can be overloaded on appropriate section of post/page/product editor page. OnExit Settings has the following parameters:

  • Popup or A/B Campaign - select popup or A/B campaign to be displayed when page loaded. Due to specificity of event, popup for tablets/smartphones are not actual.
  • Display mode - select how often OnExit popups must be displayed:
    • Disable popup - the popup will never be displayed.
    • Every time - the popup is displayed every time until the user has submitted a subscription form.
    • Once per session - the popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
    • Once per X days - the popup is displayed once per X days until the user has submitted a subscription form.
    • Only once - the popup is displayed only once.

Please remember that these are site-wide settings. If necessary you can overload them for certain post/page/product on appropriate post/page/product editor.

OnInactivity Settings

These are deprecated parameters. Use Targeting to configure OnInactivity popups.

This section allows you to select popup, which appears when user does nothing on your website. The popup appears if user doesn't move mouse, doesn't press buttons, doesn't touch screen for certain period of time. These are site-wide settings. Once configured, popup will be displayed on all pages of website. These settings can be overloaded on appropriate section of post/page/product editor page. OnInactivity Settings has the following parameters:

  • Popup or A/B Campaign - select popup or A/B campaign to be displayed when user scroll down website's page. You can select different popups/campaigns for desktops/laptops/tablets and for smartphones.
  • Display mode - select how often OnScroll popups must be displayed:
    • Disable popup - the popup will never be displayed.
    • Every time - the popup is displayed every time until the user has submitted a subscription form.
    • Once per session - the popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
    • Once per X days - the popup is displayed once per X days until the user has submitted a subscription form.
    • Only once - the popup is displayed only once.
  • Period of inactivity - the popup is displayed after this period of inactivity (in seconds).

Please remember that these are site-wide settings. If necessary you can overload them for certain post/page/product on appropriate post/page/product editor.

OnAdBlockDetected Settings

These are deprecated parameters. Use Targeting to configure OnAdBlockDetected popups.

This section allows you to select popup, which appears if user uses AdBlock software. These are site-wide settings. Once configured, popup will be displayed on all pages of website. These settings can be overloaded on appropriate section of post/page/product editor page. OnInactivity Settings has the following parameters:

  • Popup or A/B Campaign - select popup or A/B campaign to be displayed if AdBlock detected. You can select different popups/campaigns for desktops and for mobiles.
  • Display mode - select how often OnAdBlockDetected popups must be displayed:
    • Disable popup - the popup will never be displayed.
    • Every time - the popup is displayed every time until the user has submitted a subscription form.
    • Once per session - the popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
    • Once per X days - the popup is displayed once per X days until the user has submitted a subscription form.
    • Only once - the popup is displayed only once.

Please remember that these are site-wide settings. If necessary you can overload them for certain post/page/product on appropriate post/page/product editor.

Mailing Settings

This section appears if you activated either Admin Notification module, or Welcome Mail module. Please read Modules paragraph regarding enabling/disabling modules. Mailing Settings has the following parameters:

  • Sender name - all plugin related e-mail messages are sent using this name as "FROM:" header value.
  • Sender e-mail - all plugin related e-mail messages are sent using this e-mail as "FROM:" header value. Important! Some hosting providers don't allow to send e-mails when sender e-mail address doesn't belong to the same domain (where website installed) or doesn't exists. So, make sure that Sender e-mail address exists and belongs to domain, where website installed.

Miscellaneous

This section has the following parameters:

  • Single subscription. You may use different event popups, inline and OnClick popups at the same time. If "Single subscription" checkbox unticked, different event popups works independently. It means that different event popups don't care, if user already submitted subscription form on other popups. Each event popup keep working according to its "Display mode" setting. But, if "Single subscription" checkbox ticked, all event popups stop working after submitting subscription form on any popup. Example. Website uses popup #1 as OnLoad popup, popup #2 as OnScroll popup, popup #3 as inline popup and popup #4 as OnClick popup. Assume, that user submitted subscription form on inline popup (popup #3). If "Single subscription" checkbox unticked, event popups (popup #1 and popup #2) keep working according to their display modes. However, if "Single subscription" checkbox ticked, event popups (popup #1 and popup #2) won't be displayed anymore.
  • Use event popups only. Obsolete parameter. Do not use it. It will be removed soon.
  • Do not pre-load popups. By default, all active (not blocked) popups are included into webpage HTML-code. If you activate this option, popups won't be included into webpage HTML-code. Popups will be loaded on demand using AJAX-requests. This feature is a perfect solution for page speed loading.
  • CSV column separator. When users submit subscription/contact form, their details are saved to the log (menu "Layered Popups >> Log"). You can export basic data as CSV-file (menu "Layered Popups >> Popups", button "Export CSV"). This parameter is a column separator of CSV-file.
  • Extended e-mail validation. If you turn this option on, the plugin will check MX records according to the host provided within the email address. PHP 5 >= 5.3 required! You also can use 3rd party email verifications services: AlgoCheck (use coupon layeredpopups to get 10% off), Emaillistverify, Hunter, Kickbox, NeverBounce, Proofy.io and TheChecker.co (use coupon layeredpopups to get 5000 email verification credits). Please activate appropriate module on Advanced Settings page.
  • Google Analytics tracking. If you turn this option on, the plugin will send popup events (open popup, submit subscription/contact form) to Google Analytics. Google Analytics must be installed on your website.
  • KISSmetrics tracking. If you turn this option on, the plugin will identify the current person with e-mail address submitted through subscription/contact form. KISSmetrics must be installed on your website.
  • Font Awesome icons. This option allows to enable Font Awesome icons for input fields and submit button.
  • jQuery Mask plugin. This option allows to enable jQuery Mask plugin for phone and custom input fields. For more details please visit jQuery Mask plugin page
  • CSS3 animation. By default plugin uses basic jQuery animations to show/hide layers. You can extend animation effects by using CSS3 animations driven by Animate.css.
  • Reset cookie. Plugin uses cookies for display modes of event popups and for remembering users who submitted subscription form. You can reset cookie value by clicking this button.

reCAPTCHA Settings

You can use Google reCAPTCHA with your subscription/contact forms. Although forms have native protection against of spambots, and using reCAPTCHA is not necessary in most cases, it may be useful, if somebody created spambot spcifically for your website. :-) Sounds incredible? Anyway, this section has the following parameters:

  • Enable reCAPTCHA. Activate reCAPTCHA feature and include appropriate JS library into website's HTML-code. You also can disable JS library loading, if your website already has it.
  • Public key. Get your public key here.
  • Secret key. Get your public key here.

After activating this feature you can use reCAPTCHA with your subscription/contact forms. For more details please read "Creating Popups" chapter.

Social Buttons Settings

This section appears if you activated Social Buttons module on Advanced Settings page. Each social button requires JS-library, provided by appropriate social network. Social Buttons module loads them. If your theme or another plugin already loads some of these libraries, you can turn it off to avoid double loading and conflicts.

Social Media API Settings

This section appears if you activated Subscribe with Social Media module on Advanced Settings page. This section has the following parameters:

  • Disable Facebook SDK loading. "Subsribe with Facebook" feature requires library https://connect.facebook.net/en_US/sdk.js to be included into webpage HTML-code. If your theme or another plugin already includes this file, you can disable double loading of the same library to avoid conflicts.
  • Facebook App ID. "Subsribe with Facebook" feature requires Facebook App ID. You can obtain App ID on Facebook Apps page as it's said in this video tutorial:
  • Disable Google Client Library loading. "Subsribe with Google" feature requires library https://apis.google.com/js/client.jsto be included into webpage HTML-code. If your theme or another plugin already includes this file, you can disable double loading of the same library to avoid conflicts.
  • Google Client ID. "Subsribe with Google" feature requires Google Client ID. To get it, please go to Google Developers Console and create new project as it's said in this video tutorial:
  • Google API Key. "Subsribe with Google" feature requires Google API Key. You already got it when created new projects to get Client ID.

AWeber Connection

This section appears if you activated AWeber Integration module (read Modules paragraph regarding enabling/disabling modules). In this section you can connect website with your AWeber account.

Zoho CRM Connection

This section appears if you activated Zoho CRM Integration module (read Modules paragraph regarding enabling/disabling modules). In this section you can connect website with your Zoho CRM account.

Remote Access

This section appears if you activated Remote Access module on Advanced Settings page. To embed popups into non-WP pages and/or 3rd party websites, you need paste JS-snippet at the end of <body> section (above closing </body>). For more details please read Using with non-WP pages paragraph.

Item Purchase Code

If you want to have access to Popups Library and automatic updates, you need set your Item Purchase Code which you got from Envato (CodeCanyon) when purchased the license. If you don't know what is it, please check this URL: https://help.market.envato.com/hc/en-us/articles/202822600.

Advanced Settings

Advanced plugin settings can be reached through menu "Layered Popups >> Settings", tab "Advanced". Please find detailed description of each parameter below:

  • Plugin modules. Plugin has modular architecture. It easily allows you to enable/disable certain functionality. For example, if you need MailChimp integration, just activate appropriate module and configure your popup. Actual version of the plugin has the following default modules:
    • Social Buttons - this module allows you to add social buttons to your popups. The following buttons are supported: Facebook Like, Google +1, Twitter Tweet, LinkedIn Share.
    • Subscribe with Social Media - this module allows you to add "Subscribe with Facebook" and "Subscribe with Google" buttons to your popups. With this functionality users can use their Facebook/Google account to subscribe to your newsleters. It is good for lazy users who don't want to complete subscription form.
    • Custom Fields - with this module you can create custom fields and use them with subscription/contact form. By default, plugin has only 4 basic fields: name, e-mail, phone # and message. If you activate "Custom Fields" module, you can create as many fields as you wish. The following field types are supported: text field, text area, select option, checkbox and date picker.
    • Custom JavaScript Handlers - with this module you can add your js-snippets to popup events: AfterOpen, BeforeSubmit, AfterSubmitSuccess, AfterSubmitFail and AfterClose. For more details please read this chapter.
    • Admin Notification - this module allows you receive notification by e-mail when somebody submit popup's form. Please pay attention to this paragraph.
    • Welcome Mail - this module sends welcome/thanksgiving e-mail to user who submitted popup's form. Please pay attention to this paragraph.
    • Acelle Mail - this module submit user data to selected Acelle Mail list. Plugin uses Acelle Mail API.
    • Active Campaign Integration - this module submit user data (name and e-mail) to selected Active Campaign list. Plugin uses Active Campaign API.
    • ActiveTrail Integration - this module submit user data to ActiveTrail. Plugin uses their API.
    • AgileCRM Integration - this module submit user data to AgileCRM. Plugin uses AgileCRM API.
    • Arigato Pro Integration - this module submit user data to selected Arigato Pro list.
    • AvangEmail Integration - this module submit user data to selected AvangEmail list.
    • AWeber Integration - this module submit user data (name and e-mail) to selected AWeber list. Plugin uses AWeber API.
    • Benchmark Integration - this module submit user data (name and e-mail) to selected Benchmark list. Plugin uses Benchmark API.
    • Campaign Monitor Integration - this module submit user data (name and e-mail) to selected Campaign Monitor list. Plugin uses Campaign Monitor API.
    • Campayn Integration - this module submit user data to Campayn. Plugin uses Campayn API.
    • CleverReach Integration - this module submit user data to CleverReach. Plugin uses AgileCRM's SOAP API.
    • Constant Contact Integration - this module submit user data (name and e-mail) to selected Constant Contact list. Plugin uses Constant Contact API.
    • ConvertKit Integration - this module submit user data to ConvertKit. Plugin uses ConvertKit API.
    • Customer.io Integration - this module submit user data (name and e-mail) to selected Customer.io list. Plugin uses Customer.io API.
    • Direct Mail Integration - this module submit user data (name and e-mail) to selected Direct Mail list. Plugin uses Direct Mail API.
    • dotmailer Integration - this module submit user data (basic and custom fields) to selected dotmailer address book. Plugin uses dotmailer API.
    • Drip Integration - this module submit user data to selected Drip's campaign. Plugin uses Drip API.
    • E-goi Integration - this module submit user data (name and e-mail) to selected E-goi list. Plugin uses E-goi API.
    • EasySendy Pro Integration - this module submit user data to EasySendy Pro. Plugin uses their API.
    • Elastic Email Integration - this module submit user data (name and e-mail) to selected Elastic Email list. Plugin uses Elastic Email API.
    • EmailOctopus Integration - this module submit user data to selected EmailOctopus list. Plugin uses EmailOctopus API.
    • Emma Integration - this module submit users as Emma's members. Plugin uses Emma API.
    • E-newsletter by WPMU DEV Integration - this module submit user data (name and e-mail) to selected E-newsletter by WPMU DEV groups.
    • eSputnik Integration - this module submit user data to eSputnik. Plugin uses their API.
    • FireDrum Integration - this module submit user data (basic and custom fields) to FireDrum. Plugin uses FireDrum API.
    • Follow-Up Emails Integration - this module submit user e-mail to selected Follow-Up Emails list.
    • FreshMail Integration - this module submit user data (name and e-mail) to selected FreshMail list. Plugin uses FreshMail API.
    • GetResponse Integration - this module submit user data (name and e-mail) to selected GetResponse list. Plugin uses GetResponse API.
    • HubSpot Integration - this module submit user data to HubSpot. Plugin uses HubSpot API.
    • iContact Integration - this module submit user data (name and e-mail) to selected iContact list. Plugin uses iContact API.
    • Interspire Integration - this module submit user data (name and e-mail) to selected Interspire list. Plugin uses Interspire API.
    • Jetpack Subscriptions Integration - this module submit user data to Jetpack Subscriptions.
    • KIRIM.EMAIL Integration - this module submit user data to selected KIRIM.EMAIL list. Plugin uses KIRIM.EMAIL API.
    • Klaviyo Integration - this module submit user data to Klaviyo. Plugin uses their API.
    • Klick Tipp Integration - this module submit user data to selected Klick Tipp list. Plugin uses Klick Tipp API.
    • Mad Mimi Integration - this module submit user data (name and e-mail) to selected Mad Mimi list. Plugin uses Mad Mimi API.
    • Mailautic Integration - this module submit user data (basic and custom fields) to selected Mailautic list. Plugin uses Mailautic API.
    • Mailbox Marketing Integration - this module submit user data (name and e-mail) to selected Mailbox Marketing list.
    • MailChimp Integration - this module submit user data (basic and custom fields) to selected MailChimp list. Plugin uses MailChimp API.
    • MailerLite Integration - this module submit user data (name and e-mail) to selected MailerLite list. Plugin uses MailerLite API.
    • Mailigen Integration - this module submit user data (basic and custom fields) to selected Mailigen list. Plugin uses Mailigen API.
    • MailJet Integration - this module submit user data to selected MailJet's contact list. Plugin uses MailJet's REST API.
    • MailKitchen Integration - this module submit user data (basic and custom fields) to selected MailKitchen list. Plugin uses MailKitchen webservices.
    • Mailleader Integration - this module submit user data to selected Mailleader list. Plugin uses Mailleader API.
    • MailPoet (WISYJA) Integration - this module submit user data (name and e-mail) to selected MailPoet list.
    • Mailrelay Integration - this module submit user data (basic and custom fields) to selected Mailrelay's groups. Plugin uses Mailrelay API.
    • Mailster (formerly MyMail) Integration - this module submit user data to selected Mailster list.
    • MailWizz Integration - this module submit user data (name and e-mail) to selected MailWizz list.
    • Market Hero Integration - this module submit user data to Market Hero. Plugin uses Market Hero API.
    • Mautic Integration - this module submit user data (basic and custom fields) to Mautic contacts list. Plugin uses Mautic API.
    • Moosend Integration - this module submit user data (basic and custom fields) to Moosend contacts list. Plugin uses Moosend API.
    • MPZ Mail Integration - this module submit user data (basic and custom fields) to selected MPZ Mail's group. Plugin uses MPZ Mail API.
    • MyNewsletterBuilder Integration - this module submit user data (basic and custom fields) to selected MyNewsletterBuilder list. Plugin uses MyNewsletterBuilder API.
    • Omnisend Integration - this module submit user data (basic and custom fields) to selected Omnisend list. Plugin uses Omnisend API.
    • Ontraport Integration - this module submit user data (basic and custom fields) to selected Ontraport. Plugin uses Ontraport API.
    • Perfit Integration - this module submit user data (basic and custom fields) to selected Perfit list. Plugin uses Perfit API.
    • Pipedrive Integration - this module submit user data to Pipedrive. Plugin uses their API.
    • Rapidmail Integration - this module submit user data (basic and custom fields) to selected Rapidmail list. Plugin uses Rapidmail API.
    • RocketResponder Integration - this module submit user data to RocketResponder. Plugin uses RocketResponder API.
    • SalesAutoPilot Integration - this module submit user data (name and e-mail) to selected SalesAutoPilot list. Plugin uses SalesAutoPilot API.
    • SALESmanago Integration - this module submit user data to SALESmanago. Plugin uses SALESmanago API.
    • Sendloop Integration - this module submit user data to selected Sendloop list. Plugin uses Sendloop API.
    • SendGrid Integration - this module submit user data to selected SendGrid list. Plugin uses SendGrid API.
    • Sendlane Integration - this module submit user's name and email to selected Sendlane list. Plugin uses Sendlane API.
    • SendPress Integration - this module submit user data (name and e-mail) to selected SendPress list.
    • SendPulse Integration - this module submit user data to selected SendPulse's address book. Plugin uses SendPulse's REST API.
    • SendReach Integration - this module submit user data (name and e-mail) to selected SendReach list. Plugin uses SendReach API.
    • Sendy Integration - this module submit user data (name and e-mail) to selected Sendy list. Plugin uses Sendy API.
    • SG Autorepondeur Integration - this module submit user data to SG Autorepondeur. Plugin uses their API.
    • SimplyCast Integration - this module submit user data to SimplyCast. Plugin uses SimplyCast API.
    • SqualoMail Integration - this module submit user data to selected SqualoMail list. Plugin uses SqualoMail API.
    • StampReady Integration - this module submit user data to selected StampReady list. Plugin uses StampReady API.
    • StreamSend Integration - this module submit user data (basic and custom fields) to selected StreamSend list. Plugin uses StreamSend API.
    • Subscribe2 Integration - this module submit user data to Subscribe2 plugin.
    • The Newsletter Plugin Integration - this module submit user data to The Newsletter Plugin.
    • TotalSend Integration - this module submit user data to TotalSend. Plugin uses TotalSend API.
    • Tribulant Newsletters Integration - this module submit user data to selected Tribulant Newsletters list.
    • UniSender Integration - this module submit user data (basic and custom fields) to selected UniSender list. Plugin uses UniSender API.
    • UserEngage Integration - this module submit user data to UserEngage. Plugin uses their API.
    • Vision6 Integration - this module submit user data to selected Vision6 list. Plugin uses Vision6 API.
    • Your Mailing List Provider Integration - this module submit user data (name and e-mail) to selected YMLP list. Plugin uses YMLP API.
    • Zoho Campaigns Integration - this module submit user data (basic and custom fields) to selected Zoho Campaigns list. Plugin uses Zoho Campaigns API.
    • Zoho CRM Integration - this module submit user data (basic and custom fields) to Zoho CRM as a lead. Plugin uses Zoho CRM API v.2.0.
    • HTML Form Integration - use this module to submit user data as a part of 3rd party HTML form. This module is useful if your newsletter/marketing software or service is not supported by plugin. After activating this module, you can paste HTML form code into certain field and associate form's fields with popups fields. When users submit popup's form their data is also auto-submitted to 3rd party form.
    • Create WordPress User - use this module to create WP user based on data, submitted through popup's form. After activating this module, you can associate WP user fields with popups fields. When users submit popup's form, the new WP user is also created.

    After activation some modules add their settings section on Settings page (menu "Layered Popups >> Settings"). Moreover all of them add their parameters on Popup Editor page. For more details, please read appropriate paragraphs under "Create Popup" chapter.

  • Log subscribers. Activate this option if you want to save subscriber details in local database.
  • Advanced Targeting. Activate this option to enable advanced targeting. You can configure more accurately how and where to display popups. Available starting version 6.10.
  • Inline popups. Activate this option if you want to pull inline popups when page loaded. Activating this option allows you to use different inline popups for desktops/tablets and smartphones.
  • Late Initialization. Activate this option if you get infinite redirection on front side.
  • Async Initialization. Activate this option if you want to initialize event popups asynchronously.
  • Count ipressions. Activate this option if you want to count number of impressions.
  • Enable minification. Plugin goes with normal and minified versions of CSS and JS files. Activate this option if you want to use minified CSS and JS files.
  • Remote access. Starting from version 5.50 you can integrate popups into non-WP pages or 3rd party websites. Tick this checkbox to activate this feature. More details here.
  • Popups Library. As a license owner you have free access to online Popups Library through menu "Layered Popups >> Popups Library". If you don't need it, untick this checkbox.
  • Add-ons. The plugin has several useful add-ons that you can purchase separately. Add-ons list is available through menu "Layered Popups >> Add-Ons". If you don't need this menu item, untick this checkbox.
  • Post meta. The plugin has option to configure event popups for each post/page/product. It adds metabox to their editor. By default this metabox is available for every user who has permissions to edit post/page/product. If you want this metabox to be available for administrators only, tick "Post meta" checkbox.
  • Reset settings. If you want reset all settings and post/page meta into default values, use this feature.
  • Clean database. If you want to delete all tables and records, related to Layered Popups, tick this checbox. Database will be cleaned when you deactivate the plugin.

Popups

All popups can be reached through menu "Layered Popups >> Popups". Plugin goes with over 30 different demo popups, but you always can create your own. By default, pre-defined popups have status "blocked". It means that popups are disabled and can't be used on website. To unblock popup, you need click approriate icon at "Operations" column.

List of popups is organized as a table with several columns:

  • Title. The title of popup is used for your own reference.
  • ID. This unique Popup ID is used to identify popup when using it as OnClick and inline popup.
  • Layers. Number of layers. Each popup consists of one or several layers.
  • Submits. If popup has subscription/contact form, this column shows how many times the form was submitted.
  • Impressions. This column shows how many times the popup was displayed.
  • Operations/actions. You can perform several actions for each popupby clicking appropriate icon.
    • Preview popup. Check how the popup looks at your website. This action doesn't works if the popup is blocked and option "Do not pre-load popups" on Settings page activated. Please rememeber, preview mode loads only one popup. If previewing popup calls second popup (for example, 2-steps opt-in process or "thank you" popup), the second popup won't be displayed.
    • Edit popup. Click icon to edit the popup.
    • Duplicate popup. Click icon if you want to have exact copy of the popup.
    • Export popup details. Export popup as a text file. You can import this file on other website where plugin installed.
    • Export full popup details (including images). Create zipped version of popup. Archive includes popup details and images used with popup.
    • Block popup. Disable popup. Once blocked, the popup can't be used on website.
    • Unblock popup. Enable popup. Once unblocked, the popup can be used on website.
    • Drop counters. Clear values in Submits and Impressions columns.
    • View log. View list of users submitted subscription/contact form.
    • Delete popup. Remove popup from the list.

At the bottom of the list you can find button "Import popup". You can use it to import previously exported popups.

Creating Popups

To create popup, use popup editor (menu: "Layered Popups >> Create Popup").

Editor has of 3 tabs:

  1. General. This tab contains Popup Constructor and parmeters related to popup design.
  2. Mailing. This tab contains paramters for double opt-in, admin notification and thanksgiving e-mail functionality.
  3. Integration. This tab is available when you enable at least one integration module on Advanced Settings page. It contains parameters for marketing provider integration.

Please remember the following philosophy: each popup is a set of layers. There are no primary and/or secondary layers. All of them are equal. Even main widow box is a regular rectangular layer. Keeping this idea in the mind, allows to design unique popups with various shapes and sizes. Creating popup is a process of creating of layers and positioning them properly. (It's like working with Photoshop, if you know what I mean.)

The first thing you have to set is an approximate popup size (parameter Basic size, width and height). This is the size of invisible rectangular frame (basic frame), where you are going to fit popup layers. The frame is positioned on the screen according to Position parameter. At the same time all layers are positioned relatively to top-left corner of that frame.

After that, decide if you need overlay with your popup and set its parameters:

  • Disable overlay. Tick this checkbox to siable overlay. All further overlay parameters will be ignored.
  • Overlay color. Set any color.
  • Overlay opacity. This is overlay transparency level. The value must be in a range [0...1]. 0 - is an invisible overlay. 1 - not transparent overlay.
  • Overlay animation. Set desired overlay animation.
  • AJAX-spinner. Select desired spinner for popup loading. This spinner is displayed while popup is pulling using AJAX (both modes - popup and inline). This option is available only if you activated option "Do not pre-load popups" on General Settings page or "Pull inline popups using AJAX" on Advanced Setings page.
  • Extended closing. Activate this option to allow users closing popup by clicking overlay and pressing ESC-button.
  • Extended submission. Activate this option to allow users submit popup's form by pressing ENTER-button.

The next major step is creating layers.

Layers

Any popup consists of layers. Creating layers is a creating popup elements. Each layer is a DIV-element with certain parameters and content. To create new layer click "+ Add Layer" on Layers List panel. To edit certain layer just click it on Layers List panel. In both cases you will see the Layer Parameters panel (on right side of the screen). It contains list of parameters devided into several groups.

  • Layer Details:
    • Title. This value is used for your own convenience only. When you create layer with main popup background, name it as "Main Background", for example.
    • Content. You can use plain text, HTML and shortcodes. For more details and examples, please read Content paragraph.
    • Size (width x height). The size of the layer. Always set at least width parameter. It is necessary for popup responsiveness.
    • Position. Left and top position of the layer. It is set relatevely to top-left corner of basic frame.
  • Text and Font:
    • Font. Select desired local or Google font.
    • Color. Text color.
    • Color:hover. Text color, when it's hovered, focused or active.
    • Size. Set font size in pixels.
    • Weight. Select desired font weight.
    • Shadow size. You can add shadow to text. Set its size here.
    • Shadow color. Set shadow color here.
    • Alignment. Select desired content alignment.
    • V-Padding. Set vertical padding of content.
    • H-Padding. Set horizontal padding of content.
  • Background:
    • Gradient. Tick checkbox to use gradient bacground. Plugin uses linear gradient.
    • Gradient angle. Set an angle between a horizontal line and the gradient line, going counter-clockwise. More details.
    • Color. Set the background color. If you want transparent layer - leave field empty.
    • Color:hover. Set the color of the background, when it's hovered.
    • Opacity. This is background transparency level. The value must be in a range [0...1]. 0 - is an invisible layer. 1 - not transparent layer.
    • Image URL. URL of the image that is used to fill layer. It is used to fill layer by certain pattern. Do not use this field to display single image. If you want single image, please read Content paragraph.
    • Image repeat. Set how a background image will be repeated. More details.
    • Image repeat. Set the size of the background image. More details.
  • Border:
    • Width. Set the border width.
    • Color. Set the background color. If you want transparent layer - leave field empty.
    • Color:hover. Set the color of the background, when it's hovered.
    • Radius. Specify the border radius.
  • Box Shadow:
    • H-Shadow. The position of the horizontal shadow. Negative values are allowed.
    • V-Shadow. The position of the vertical shadow. Negative values are allowed.
    • Blur. The blur distance.
    • Spread. The size of shadow. Negative values are allowed.
    • Color. The color of the shadow.
    • Inset. Changes the shadow from an outer shadow (outset) to an inner shadow.
  • Animation:
    • Animation. Each layer has its own animation effect. Set it here.
    • Duration. Speed of animation effect (in milliseconds). The lower value the faster animation.
    • Start delay. Layer may appear with some delay (in milliseconds). Set this delay here. Recommended values are between 0 and 2000.
  • Miscellaneous:
    • Scrollbar. If the content is too long, you can add scrollbar to that layer. Please rememeber, layer height must be set.
    • Inline mode. Activate this option if the layer shouldn't be displayed for inline popup. For example, you can tick this checkbox for the layer which contains closing icon.
    • "Confirmation of subscription" layer. If you activate this feature, the layer will appear only after successful submission of subscription/contact form. You can create "Thank you" message and show it only to successfully subscribed users. Do not forget to set Autoclose delay parameter under Native Form Parameters section, otherwise users won't have enough time to read "Thank you" message.
    • Custom style. This style is applied to layer (DIV-element), but not its content. For more details and examples, please read Custom style paragraph.



Content

The purpose and functionality of layer is defined by its content. It is recommended to be familiar with basic HTML. The following types of content are allowed:

  • Plain text.
  • HTML. If you use HTML as a layer content, you are responsible for its responsiveness. JavaScript code is not allowed!
  • Native shortcodes. The full list of supported shortcode are available below. Do not insert several shortcodes into the same layer. Only one shortcode per layer.
  • 3rd party shortcode. Pay attention, JavaScript is not allowed. If 3rd party shortcode generates JavaScript code, it may not work properly.

Below is a list of useful HTML-snippets and native shortcodes:

  • Image is inserted as regular IMG-tag. Do not add width and height attribute. If image width is greater than layer width, it will be reduced to fit layer width. So you can change image size by changing layer width.
    <img src="..." alt="" />
    Example:
    <img src="http://layeredpopups.com/layered-popups-590x300.jpg" alt="" />
  • IFrame (YouTube video, Vimeo video, Google Maps, etc.) is inserted as is. To make it responsive, do not forget to set layer width and height and replace given iframe width and height by "100%".
    <iframe src="..." width="100%" height="100%"></iframe>
    Example:
    <iframe width="100%" height="100%" src="https://www.youtube.com/embed/ShFAeNdiEiA" frameborder="0" allowfullscreen></iframe>
  • Close icon is inserted as the following HTML-code. The important part of these snippets is onclick handler: onclick="return ulp_self_close();" and onclick="return ulp_close_forever();". It runs JavaScript function called ulp_self_close() and ulp_close_forever(), which closes popup.
    <a href="#" onclick="return ulp_self_close();">×</a>
    If you want to use image icon:
    <a href="#" onclick="return ulp_self_close();"><img src="http://url-of-closing-icon-goes-here" alt="" /></a>
    If you want to close popup for 5 days:
    <a href="#" onclick="return ulp_close_forever(5);">Close Popup</a>
    If you want to close popup forever:
    <a href="#" onclick="return ulp_close_forever();">Close Forever</a>
  • Linked button. Linked button is a regular button, which redirects users to certain links, when they click it. The plugin goes with several pre-defined buttons (different colors). Button size, font and text settings are inherited from layer parameters.
    <a href="#" class="ulp-link-button ulp-link-button-red">Hi, I'm red button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-blue">Hi, I'm blue button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-green">Hi, I'm green button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-yellow">Hi, I'm yellow button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-orange">Hi, I'm orange button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-pink">Hi, I'm pink button.</a>
    <a href="#" class="ulp-link-button ulp-link-button-black">Hi, I'm black button.</a>
    
    Example:
    <a href="http://google.com/" target="_blank" class="ulp-link-button ulp-link-button-green">Open Google</a>

The following native shortcodes are related to subscription/contact form elements (input fields, reCAPTCHA and submit button). Input fields and submit button inherit size, font and text settings from layer parameters. All other parameters are configured at Native Form Parameters section on popup editor page. Use only one native shortcode per layer.

  • E-mail field.
    {subscription-email}
    
  • Name field.
    {subscription-name}
  • Phone # field.
    {subscription-phone}
  • Message field.
    {subscription-message}
  • Submit button. Submit button is mandatory for all subscription/contact forms.
    {subscription-submit}
    Although submit button has flexible configuration (at Native Form Parameters section on popup editor page), you also can use custom button or even image as a submit button. Use snippet below. The important part of this snippet is onclick handler: onclick="return ulp_subscribe(this);". It runs JavaScript function called ulp_subscribe(this), which submit form data to server.
    <a href="#" onclick="return ulp_subscribe(this);"><img src="..." /></a>
  • reCAPTCHA. This shortcode is available only if you activated reCAPTCHA on Settings page. Also, don't forget to tick checkbox "reCAPTCHA is mandatory" at Native Form Parameters section on popup editor page.
    {recaptcha}
  • Custom fields. Custom fields are available only if you activated Custom Fileds module on Advanced Settings page. After activation, you can create custom fields at Custom Fields section on popup editor page. Each custom field has its own unique native shortcode.
    {custom-field-XXXX}

The following native shortcodes are related to social buttons (Facebook Like, Google +1, Twitter Tweet and LinkedIn Share). They are available with Social Buttons module activated (on Advanced Settings page). After activation this module, please check Social Buttons Settings section on Settings page and Social Buttons Parameters section on popup editor page.

  • All social buttons. Display all social buttons in single line.
    {social-panel}
  • Facebook Like. Display Facebook Like button.
    {social-facebook-like}
  • Google +1. Display Google +1 button.
    {social-google-plusone}
  • Twitter Tweet. Display Twitter Tweet button.
    {social-twitter-tweet}
  • LinkedIn Share. Display LinkedIn Share button.
    {social-linkedin-share}

The following native shortcodes are related to Subscribe with Social Media feature. They are available with Subscribe with Social Media module activated (on Advanced Settings page). After activation this module, please check Social Media API Settings section on Settings page and "Subscribe with Social Media" Parameters section on popup editor page. Buttons inherit size, font and text settings from layer parameters.

  • Subscribe with Facebook. Display "Subscribe with Facebook" button.
    {subscription-facebook}
  • Subscribe with Google. Display "Subscribe with Google" button.
    {subscription-google}



Custom style

Each layer has custom style parameter. It is applied to layer (DIV-element), but not to its content. Using this parameter requires some CSS knowledge. Below is several useful snippets.

  • Shadow. If you want to add shadow to the layer, use the following snippet. Play with box-shadow property to adjust the shadow. More details here.
    box-shadow: 0 4px 20px #202020;
  • Round corners. If you want to add round corners to the layer, use the following snippet. Play with border-radius property to adjust the corners. More details here.
    border-radius: 5px;
  • Padding. If you want to add padding to the layer, use the following snippet. Play with padding property to adjust the padding. More details here.
    padding: 5px 10px;

You can combine snippets in one line. Example:

box-shadow: 0 4px 20px #202020; padding: 5px 10px;

Native Form Parameters

You can add form elements (input fields and submit button) to popup, using native shortcodes, described in chapter above ("Layers"). Input fields and submit button inherit size, font and text settings from layer parameters. All other parameters are configured at Native Form Parameters section on popup editor page. There are the following parameters:

  • "Name" field placeholder. It specifies a short hint that describes the expected value of the "Name" input field. Placeholder is displayed in the "Name" input field before the user enters a value.
  • "Name" field is mandatory. Activate this option to set "Name" input field as required. Users will not be able to send the form with empty field value.
  • "Phone #" field placeholder. It specifies a short hint that describes the expected value of the "Phone #" input field. Placeholder is displayed in the "Phone #" input field before the user enters a value.
  • "Phone #" field is mandatory. Activate this option to set "Phone #" input field as required. Users will not be able to send the form with empty field value.
  • "Phone number" mask. Select desired phone field mask. You can select one of pre-defined masks or set custom mask. For more details please visit jQuery Mask plugin page.
  • "Message" text area placeholder. It specifies a short hint that describes the expected value of the "Message" text area. Placeholder is displayed in the "Message" text area before the user enters a value.
  • "Message" text area is mandatory. Activate this option to set "Message" input field as required. Users will not be able to send the form with empty field value.
  • "E-mail" field placeholder. It specifies a short hint that describes the expected value of the "E-mail" input field. Placeholder is displayed in the "E-mail" input field before the user enters a value.
  • "E-mail" field is mandatory. Activate this option to set "E-mail" input field as required. Users will not be able to send the form with empty field value.
  • "Submit" button label. The label is displayed on "Submit" button.
  • "Loading" button label. The label is displayed on "Submit" button while sending data to server.
  • Button icon. The icon is displayed on "Submit" button near label. This parameter is available if "Font Awesome" activated on Settings page.
  • Button color. The color of the button.
  • Button size. Activate this option to allow button to inherit layer size. Applied to "Submit" and "Subscribe with Social Media" buttons.
  • Button border radius. The radius of corners of button. Applied to "Submit" and "Subscribe with Social Media" buttons.
  • Button CSS. Custom style of the button. Applied to "Submit" and "Subscribe with Social Media" buttons.
  • Button:hover CSS. Custom style of the button, when mouse pointer is over it. Applied to "Submit" and "Subscribe with Social Media" buttons.
  • Input field border color. The border color of input fields and text areas. Applied to all basic and custom fields.
  • Input field border width. The border color of input fields and text areas. Applied to all basic and custom fields.
  • Input field border radius. The radius of corners of input fields and text areas. Applied to all basic and custom fields.
  • Input field background color. The background color of input fields and text areas. Applied to all basic and custom fields.
  • Add icons to input fields. Activate this feature to add icon to input fields. Applied to all basic and custom fields. This parameter is available if "Font Awesome" activated on Settings page.
  • Input field background opacity. This is input field background transparency level. The value must be in a range [0...1]. 0 - is an invisible. 1 - not transparent. Applied to all basic and custom fields.
  • Input field CSS. Custom style of the button. Applied to all basic and custom fields.
  • reCAPTCHA theme. Two themes are available: dark and light. This parameter is available if reCAPTCHA activated on Settings page.
  • reCAPTCHA is mandatory. Activate this option to set reCAPTCHA as required. Users will not be able to send the form without reCAPTCHA check.
  • Autoclose delay. When subscription/contact form is succesfully submitted, the popup will be automatically closed after this delay. This parameter is useful to display "Thank you" message after successsful subscription. Also check parameter "Confirmation of subscription" layer at "Layers" chapter.
  • Redirect URL. When subscription/contact form is succesfully submitted, user will be redirected to this URL. Leave blank to stay on the same page.
  • Thanksgiving popup. When subscription/contact form is succesfully submitted, thanksgiving popup will be automatically displayed. It is an alternative to "Thank you" message.
  • Cookie lifetime. When subscription/contact form is succesfully submitted, the cookie is set to avoid further appearance. This is cookie lifetime. The parameter applies to event popups only.

Custom Fields

Plugin has feature to use custom fields with subscription/contact form (activate Custom Fields module on Advanced Settings page). The following field types are supported: text field, text area, drop-down list, checkbox and date picker. You can create custom field by clicking "Add Custom Field" button at Custom Fields section on popup editor page. Each custom field has appropriate shortcode like:

{custom-field-XXXX}

Use it to add the field into layer.

Important! By default date picker is disabled. To enable it, please go to General Settings page and activate it under Custom Fields Global Settings section (this section appears when you activate Custom Fields module on Advanced Settings page).

Social Buttons

The following social buttons can be used with the popup: Facebook Like, Google +1, Twitter Tweet and LinkedIn Share. They are added to the popup as an appropriate native shortcode (check Content paragraph of Layers chapter for full list of social related shortcodes). To enable Social Buttons, activate Social Buttons module on Advanced Settings page. After the module activated, check Social Buttons Settings section on General Settings page and configure the following parameters at Social Buttons Parameters section on popup editor page:

  • URL to share/like/etc. The URL attached to social buttons. This URL will be shared/liked/etc. Leave the field blank if you wish to share current URL (where popup is displayed).
  • Social Buttons. This parameter is related to {social-panel} shortcode only. The shortcode displays all social buttons in a single line and you can decide which buttons must be included in that line.
  • Button left/right margin. This parameter is related to {social-panel} shortcode only. The shortcode displays all social buttons in a single line and you can set left/right margin for each button.

Subscribe with Social Media

Together with native subscription form the popup may have "Subscribe with Facebook" and "Subscribe with Google" buttons. When user click such button, the popup takes his/her name and e-mail from appropriate social account. This function is useful for lazy people who don't want to complete subscription form and prefer to click couple buttons. "Subscribe with Facebook" and "Subscribe with Google" buttons are added to the popup as an appropriate native shortcode (check Content paragraph of Layers chapter for full list of social related shortcodes). To enable this feature, activate Subscribe with Social Media module on Advanced Settings page. After the module activated, check Social Media API Settings section on General Settings page (read appropriate chapter in this documentation) and configure the following parameters at "Subscribe with Social Media" Parameters section on popup editor page:

  • Facebook Button label. The label is displayed on "Subscribe with Facebook" button.
  • Facebook Button color. The color of "Subscribe with Facebook" button.
  • Google Button label. The label is displayed on "Subscribe with Google" button.
  • Google Button color. The color of "Subscribe with Google" button.

Buttons inherit size, font and text settings from layer parameters.

Double Opt-In Parameters

This section is located at Mailing Tab of popup editor.

If the popup has subscription/contact form, you can use double opt-in feature. It means that users must confirm their e-mail addresses to be considered as subscribed. How it works?

  1. User submits subscription/contact form.
  2. Plugin sends e-mail message with confirmation link.
  3. User receives e-mail message and click confirmation link.
  4. E-mail is considered as "confirmed".

This section has the following parameters:

  • Enable double opt-in. Tick checkbox to enable double opt-in.
  • Subject. Subject of e-mail confirmation message.
  • Message. The tempate of e-mail confirmation message. You can use the same native shortcodes related to subscription/contact form fields: {subscription-email}, {subscription-name}, etc. (check Content paragraph of Layers chapter for full list of form related shortcodes). Shortcodes are replaced by values of appropriate fields. Also the following technical shortcodes are available in message field:
    • {ip} - the user's IP-address;
    • {user-agent} - the user's User Agent;
    • {url} - the URL, where subscription/contact form was submitted;
    • {popup} - the title of the popup, where subscription/contact form was submitted;
    • {popup-id} - the ID of the popup, where subscription/contact form was submitted.
    • {confirmation-link} - the URL of confiramtion link. This shortcode is mandatory!
  • Thanksgiving message. This message is displayed when users successfully confirmed their e-mail addresses. You can use the same shortcodes as for "Message" parameter.
  • Thanksgiving URL. This is alternate way of thanksgiving message. After submission subscribers are redirected to this URL.

Confirmation message is sent as Text/Html, UTF-8 encoded message, so you can use HTML in message template.

Admin Notification

If the popup has subscription/contact form, you can configure it to send notification to administrator by e-mail. To enable this option, activate Admin Notification module on Advanced Settings page. After the module activated, check Mailing Settings section on General Settings page and configure the following parameters at Admin Notification Parameters section on popup editor page (Mailing Tab):

  • Enable mailing. Tick checkbox to enable admin notification for that popup.
  • Admin e-mail address. Set admin e-mail address. You can set several e-mail addresses, separated by comma.
  • Subject. Subject of admin notification message.
  • Message. The tempate of notification message. You can use the same native shortcodes related to subscription/contact form fields: {subscription-email}, {subscription-name}, etc. (check Content paragraph of Layers chapter for full list of form related shortcodes). Shortcodes are replaced by values of appropriate fields. Also the following technical shortcodes are available in message field:
    • {ip} - the user's IP-address;
    • {user-agent} - the user's User Agent;
    • {url} - the URL, where subscription/contact form was submitted;
    • {popup} - the title of the popup, where subscription/contact form was submitted;
    • {popup-id} - the ID of the popup, where subscription/contact form was submitted.

Admin notification message is sent as Text/Html, UTF-8 encoded message, so you can use HTML in message template.

Welcome E-mail

If the popup has subscription/contact form, you can configure it to send welcome e-mail message to user who submitted the form. To enable this option, activate Welcome Mail module on Advanced Settings page. After the module activated, check Mailing Settings section on General Settings page and configure the following parameters at Welcome E-mail Parameters section on popup editor page (Mailing Tab):

  • Enable mailing. Tick checkbox to enable welcome e-mail for that popup.
  • Subject. Subject of welcome e-mail message.
  • Message. The tempate of welcome e-mail message. You can use the same native shortcodes related to subscription/contact form fields: {subscription-email}, {subscription-name}, etc. (check Content paragraph of Layers chapter for full list of form related shortcodes). Shortcodes are replaced by values of appropriate fields. Also the following technical shortcodes are available in message field:
    • {ip} - the user's IP-address;
    • {user-agent} - the user's User Agent;
    • {url} - the URL, where subscription/contact form was submitted;
    • {popup} - the title of the popup, where subscription/contact form was submitted;
    • {popup-id} - the ID of the popup, where subscription/contact form was submitted.

Welcome e-mail message is sent as Text/Html, UTF-8 encoded message, so you can use HTML in message template.

Marketing Services Integration

The plugin has integration with 84 newsletter and email marketing providers: Acelle Mail, ActiveCampaign, ActiveTrail, AgileCRM, Arigato Pro, AvangEmail, AWeber, Benchmark, Campaign Monitor, Campayn, CleverReach, Constant Contact, ConvertKit, Customer.io, Direct Mail for Mac OS X, dotmailer, Drip, E-goi, EasySendy Pro, Elastic Email, EmailOctopus, Emma, E-newsletter by WPMU DEV, eSputnik, FireDrum, Follow-Up Emails, FreshMail, GetResponse, HubSpot, iContact, Interspire, Jetpack Subscriptions, KIRIM.EMAIL, Klaviyo, Klick Tipp, Mad Mimi, Mailautic, Mailbox Marketing, MailChimp, MailerLite, Mailigen, MailJet, MailKitchen, Mailleader, MailPoet (WYSIJA), Mailrelay, Mailster (MyMail), MailWizz, Market Hero, Mautic, Moosend, MPZ Mail, MyNewsletterBuilder, Omnisend, Ontraport (Office Auto Pilot), Perfit, Pipedrive, Rapidmail, RocketResponder, SALESmanago, SG Autorepondeur, SalesAutoPilot (MailMaster), Sendloop, SendGrid, SendPress, SendPulse, SendReach, SendinBlue, Sendlane, Sendy, SimplyCast, SqualoMail, StampReady, StreamSend, Subscribe2, The Newsletter Plugin, TotalSend, Tribulant Newsletters, UniSender, UserEngage, Vision6, Your Mailing List Provider (YMLP), Zoho Campaigns, Zoho CRM. To enable integration with certain provider, you need activate appropriate module on Advanced Settings. After the module activated, configure appropriate parameters on popup editor page (Integration Tab).

Integration functionality requires CURL to be activated on your server. Most hosting providers have it. If your hosting provider doesn't have CURL, please contact their support and ask to install it.

HTML Form Integration

If your marketing provider is not supported by default, you still can integrate it with Layered Popups, using HTML-form provided by marketing provider. The main idea of such integration is to take values from popup subscription form and re-submit them as a part of 3rd party HTML-form. It is done automatically by HTML Form Integration module (must be activated on Advanced Settings page).

After the module activated, configure appropriate parameters on popup editor page.

  1. Tick checkbox Enable HTML Form.
  2. Paste HTML-form code, provided by marketing provider, into field HTML Form and click Connect Form button.
  3. The plugin parses HTML-code and display its parameters: action URL, method and list of fields.
  4. Associate HTML-form fields with the popup fields. Use the same native shortcodes related to subscription/contact form fields: {subscription-email}, {subscription-name}, etc. (check Content paragraph of Layers chapter for full list of form related shortcodes). The plugin takes the value of associated field and submit it as a value of 3rd party HTML-form.

3rd party form can be submitted either from client side or from server side. Please remember! If you use plugin's native double opt-in, 3rd party form can be submitted only from server side.

Integration functionality requires CURL to be activated on your server. Most hosting providers have it. If your hosting provider doesn't have CURL, please contact their support and ask to install it.

Create WordPress User

Starting version 6.37 we added option to create new WordPress user based on data submitted through popup's form.

To activate this feature, just tick checkbox Activate WP User Integration module on Advanced Settings page. Once activated, this module add new section "WP User Parameters" to Popup Editor, Integration Tab. There you can configure new WP user: set user role and associate user fields with popup fields. Use the same native shortcodes related to subscription/contact form fields: {subscription-email}, {subscription-name}, etc. (check Content paragraph of Layers chapter for full list of form related shortcodes). The plugin takes the value of associated field and submit it as a value of WP user field.

This module also generates password for newly created users. If necessary you can include password into Admin Notification E-mail and Welcome E-mail using shortcode {wpuser-password}.

Custom JavaScript Handlers

Starting version 6.15 we added option to use your own javascript-code for some popup events. It doesn't mean that native javascript handlers are replaced by yours. It means that your javascript-code is executed together with native handlers.

To activate this feature, just tick checkbox Activate "Custom JavaScript Handlers" module on Advanced Settings page. Once activated, this module add new tab JavaScript Handlers to popup editor. There you can put your own javascript-snippets (do not use <script>...</script> tags inside, just put regular javascript-code). At that moment you can add your javascript-code to the following popup events:

  • AfterOpen. This handler is executed when popup opened. Ignored for inline popups.
  • BeforeSubmit. This handler is executed before popup form submitted.
  • AfterSubmitSuccess. This handler is executed when popup form successfully submitted.
  • AfterSubmitFail. This handler is executed popup when form submitted, but some errors happened.
  • AfterClose. This handler is executed when popup completely closed. Ignored for inline popups.

The following variables might be useful in your javascript-code:

  • this.element_id - ID of popup DOM element. This variable is available for all event handlers.
  • this.popup_id - popup ID (exactly the same ID that you see on Popups page in WP dashboard). This variable is available for all event handlers.
  • this.form - object, that contains values of popup form. For example, if you need use values of email, name or custom-field-xxx inside of javascript-code, get them like that this.form['email'], this.form['name'] or this.form['custom-field-xxx']. This variable is available for all event handlers except AfterOpen.
  • this.errors - object, that contains error description when popup form submitted, but some errors happened. This variable is available for AfterSubmitFail and AfterClose events only.
  • this.user_data - object, that can be used to store your data. This variable is available for all event handlers.

Do not use <script>...</script> tags inside (just put regular javascript-code) and make sure your javascript-code doesn't have any syntax errors.

Using Popups

There are several ways how you can use popups on your website.

  1. To raise the popup by clicking certain element (OnClick popup), add the following onclick handler to that element:
    onclick="return ulp_open('OBJECT_ID');"
    OBJECT_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign ID taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns").
    Example:
    <a href="#" onclick="return ulp_open('OBJECT_ID');">Raise the popup</a>
  2. To raise the popup by clicking link or attach it to main menu item (OnClick popup), just use the following URL:
    #ulp-OBJECT_ID
    or
    #ulpx-OBJECT_ID
    OBJECT_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign ID taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns").
    Example:
    <a href="#ulp-OBJECT_ID">Raise the popup</a>
    If you want to raise different popup for desktops/laptops/tablets and smartphones, use URL like that:
    #ulp-OBJECT1_ID*OBJECT2_ID
    OBJECT1_ID and OBJECT2_ID are popups ID taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign ID taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns"). OBJECT1_ID is a popup/campaign for desktops/laptops. OBJECT2_ID is a popup/campaign for mobiles.
    Example:
    <a href="#ulp-OBJECT1_ID*OBJECT2_ID">Raise the popup</a>
  3. You can raise the popup, when website loaded (OnLoad popup). There are 2 ways to do that:
    • If Targeting enabled, create OnLoad target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
    • If Targeting disabled, configure OnLoad Parameters on Settings page to apply them site-wide, or on post/page/product editor to apply them for certain post/page/product only.
  4. You can raise the popup, when users scroll down website's page (OnScroll popup). There are 2 ways to do that:
    • If Targeting enabled, create OnScroll target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
    • If Targeting disabled, configure OnScroll Parameters on Settings page to apply them site-wide, or on post/page/product editor to apply them for certain post/page/product only.
  5. You can raise the popup, when users moves mouse cursor to top edge of browser window, assuming that he/she is going to leave the page (OnExit popup). There are 2 ways to do that:
    • If Targeting enabled, create OnExit target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
    • If Targeting disabled, configure OnExit Parameters on Settings page to apply them site-wide, or on post/page/product editor to apply them for certain post/page/product only.
  6. You can raise the popup, when users does nothing on website for certain period of time (OnInactivity popup). There are 2 ways to do that:
    • If Targeting enabled, create OnInactivity target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
    • If Targeting disabled, configure OnInactivity Parameters on Settings page to apply them site-wide, or on post/page/product editor to apply them for certain post/page/product only.
  7. You can raise the popup, if users use software like AdBlock (OnAdBlockDetected popup) to kindly ask them to include your website into its white list (for example). There are 2 ways to do that:
    • If Targeting enabled, create OnAdBlockDetected target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
    • If Targeting disabled, configure OnAdBlockDetected Parameters on Settings page to apply them site-wide, or on post/page/product editor to apply them for certain post/page/product only.
  8. To embed the popup into post/page and display it as a part of their content, use the following WordPress shortcode:
    [ulp id='POPUP_ID']
    POPUP_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    If you want to have different inline popups for desktops/tablets and smartphones, use the following WordPress shortcode:
    [ulp id='POPUP1_ID*POPUP2_ID']
    POPUP1_ID is a popup ID that will be displayed for desktops/laptops. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    POPUP2_ID is a popup ID that will be displayed for mobiles. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups").
  9. If you want automatically insert inline popup at the beginning or end of post/page/product content, enable "Advanced Targeting" feature on "Advanced Settings" page and create ContentStart (inline) or ContentEnd (inline) target and make it active (drag and drop from Passive area to Active area). While creating target, you can configure how and where it must be displayed.
  10. To embed popup as a sidebar widget, just go to WordPress's Widget page. Drag and drop Layered Popups widget to desired widget area and configure it.
  11. You can lock access to certain links on your website. It means that when user clicks locked link, a popup appears. User must subscribe through this popup. Only after that link become available. You may have many different links locked by the same popup. Once it submitted all these links become available. Wrap your link (link is an <A>-tag, not URL) with shortcodes:
    [ulplinklocker id='POPUP1_ID*POPUP2_ID'] ... [/ulplinklocker]
    POPUP1_ID is a popup ID that will be displayed for desktops/tablets. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    POPUP2_ID is a popup ID that will be displayed for smartphones. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups"). If POPUP1_ID and POPUP2_ID are the same, you can use it like:
    [ulplinklocker id='POPUP_ID'] ... [/ulplinklocker]
    POPUP_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups"). This popup will be used for all devices: desktops/tablets/smartphones.
    Example:
    [ulplinklocker id='POPUP1_ID*POPUP2_ID']<a href="https://layeredpopups.com/">Layered Popups</a>[/ulplinklocker]
    You can wrap paragraph or even whole content with this shortcode. In this case all links in wrapped content will be locked.
  12. Another way to lock links is to construct locking URL manually. Use this method if your link is located in area which doesn't support shortcodes (ex., Menu, footer, etc.).
    In general locking URL looks like:
    #ulp-POPUP_ID:BASE64_ENCODED_ORIGINAL_URL
    POPUP_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    BASE64_ENCODED_ORIGINAL_URL is an original URL encoded using base64 algorithm. There are a lot of free online services that allows to encode/decode using base64 algorithm. For example: https://www.base64encode.org/.
    If you want to have different popups for desktops/tablets and smartphones, use the following locking URL:
    #ulp-POPUP1_ID*POPUP2_ID:BASE64_ENCODED_ORIGINAL_URL
    POPUP1_ID is a popup ID that will be displayed for desktops/tablets. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    POPUP2_ID is a popup ID that will be displayed for smartphones. It's taken from relevant column on Popups page (menu "Layered Popups >> Popups").
    BASE64_ENCODED_ORIGINAL_URL is an original URL encoded using base64 algorithm. There are a lot of free online services that allows to encode/decode using base64 algorithm. For example: https://www.base64encode.org/.
    Example:
    Imagine that we have popup with ID QWERTYUIOP. With this popup we want to lock link which has URL http://website.com/path-to/file.html. Base64 encoded URL would be aHR0cDovL3dlYnNpdGUuY29tL3BhdGgtdG8vZmlsZS5odG1s and locking URL:
    #ulp-QWERTYUIOP:aHR0cDovL3dlYnNpdGUuY29tL3BhdGgtdG8vZmlsZS5odG1s
    Use this URL for your link.

Using Popup with non-WP pages

Starting from version 5.50 you can integrate popups into non-WP pages and/or 3rd party websites. REMEMBER: Plugin must be installed on WordPress! You can't integrate popups into non-WP pages and/or 3rd party websites, if plugin is not installed and activated on WP-driven website. To enable this feature please perform the following steps:

  1. Make sure that your non-WP page (or 3rd party website) loads jQuery version 1.8 or higher.
  2. Make sure that your non-WP page has DOCTYPE. If not, add the following line as a first line of HTML-document:
    <!DOCTYPE html>
  3. Go to Advanced Settings page and tick checkbox Remote Access.
  4. Go to General Settings page, find Remote Access section, copy JS-snippet and paste it into your non-WP page. You need paste it at the end of <body> section (above closing </body> tag).
  5. That's it. Integration finished. :-)

There are several ways how you can use popups on your non-WP pages and/or 3rd party websites.

  1. To raise the popup by clicking certain element (OnClick popup), use the same methods as described in chapter above: Using Popups (method #1 and method #2).
  2. To raise the popup, when website loaded (OnLoad popup), add the following JS-code to your page. It must be inserted below remote.min.js.
    <script>
    ulp_add_event("onload", {
    	popup:			"OBJECT1_ID",
    	popup_mobile:	"OBJECT2_ID",
    	mode:			"every-time",
    	period:			5,
    	delay:			0,
    	close_delay:		0
    });
    </script>
    As you can see function ulp_add_event("onload", ..) accept an object with several parameters:
    • popup, popup_mobile. Popup IDs taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign IDs taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns"). At least one of these parameters must be defined. Popup defined as popup_mobile will be displayed on smartphones only.
    • mode. Select how often OnLoad popup must be displayed. You can use one of the following values:
      • every-time. The popup is displayed every time until the user has submitted a subscription form.
      • once-session. The popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
      • once-period. The popup is displayed once per X days (defined as period parameter) until the user has submitted a subscription form.
      • once-only. The popup is displayed only once.
      • none. The popup will never be displayed.
    • period. Set period (in days) when mode is set as once-period. This parameter is ignored in all other cases.
    • delay. The popup can be displayed with certain delay when page loaded. This parameter defines delay (in seconds).
    • close_delay. The popup can be automatically closed after certain delay. This parameter defines delay (in seconds). Set 0 (zero) or omit parameter to disable this feature.
    Example 1. You want to display popup with ID yoZ8KupKSHejiwyZ once per session, without delays and for all kind of devices (desktops, tablets, smartphones).
    <script>
    ulp_add_event("onload", {
    	popup:			"yoZ8KupKSHejiwyZ",
    	mode:			"once-session"
    });
    </script>
    Example 2. You want to display popup with ID yv4RG8hfkSBb4up9 for smartphones only, every time, with start delay 10 seconds and without autoclosing feature.
    <script>
    ulp_add_event("onload", {
    	popup_mobile:	"yv4RG8hfkSBb4up9",
    	mode:			"every-time",
    	delay:			10
    });
    </script>
    Please rememeber, you can use ulp_add_event("onload", ..) only once per page. If you insert it several times with different parameters, only last one will work.
  3. To raise the popup, when user scroll down website's page (OnScroll popup), add the following JS-code to your page. It must be inserted below remote.min.js.
    <script>
    ulp_add_event("onscroll", {
    	popup:			"OBJECT1_ID",
    	popup_mobile:	"OBJECT2_ID",
    	mode:			"every-time",
    	period:			5,
    	offset:			"600"
    });
    </script>
    As you can see function ulp_add_event("onscroll", ..) accept an object with several parameters:
    • popup, popup_mobile. Popup IDs taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign IDs taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns"). At least one of these parameters must be defined. Popup defined as popup_mobile will be displayed on smartphones only.
    • mode. Select how often OnScroll popup must be displayed. You can use one of the following values:
      • every-time. The popup is displayed every time until the user has submitted a subscription form.
      • once-session. The popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
      • once-period. The popup is displayed once per X days (defined as period parameter) until the user has submitted a subscription form.
      • once-only. The popup is displayed only once.
      • none. The popup will never be displayed.
    • period. Set period (in days) when mode is set as once-period. This parameter is ignored in all other cases.
    • offset. The popup is displayed when user scroll down to this number of pixels. If you want this value to be in %, just add % symbol, like this: offset: "80%".
    Please rememeber, you can use ulp_add_event("onscroll", ..) only once per page. If you insert it several times with different parameters, only last one will work.
  4. To raise the popup, when user moves mouse cursor to top edge of browser window, assuming that he/she is going to leave the page (OnExit popup), add the following JS-code to your page. It must be inserted below remote.min.js.
    <script>
    ulp_add_event("onexit", {
    	popup:			"OBJECT_ID",
    	mode:			"every-time",
    	period:			5
    });
    </script>
    As you can see function ulp_add_event("onexit", ..) accept an object with several parameters:
    • popup. Popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign ID taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns").
    • mode. Select how often OnExit popup must be displayed. You can use one of the following values:
      • every-time. The popup is displayed every time until the user has submitted a subscription form.
      • once-session. The popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
      • once-period. The popup is displayed once per X days (defined as period parameter) until the user has submitted a subscription form.
      • once-only. The popup is displayed only once.
      • none. The popup will never be displayed.
    • period. Set period (in days) when mode is set as once-period. This parameter is ignored in all other cases.
    Please rememeber, you can use ulp_add_event("onexit", ..) only once per page. If you insert it several times with different parameters, only last one will work.
  5. To raise the popup, when user does nothing on website for certain period of time (OnInactivity popup), add the following JS-code to your page. It must be inserted below remote.min.js.
    <script>
    ulp_add_event("onidle", {
    	popup:			"OBJECT1_ID",
    	popup_mobile:	"OBJECT2_ID",
    	mode:			"every-time",
    	period:			5,
    	delay:			60
    });
    </script>
    As you can see function ulp_add_event("onidle", ..) accept an object with several parameters:
    • popup, popup_mobile. Popup IDs taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign IDs taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns"). At least one of these parameters must be defined. Popup defined as popup_mobile will be displayed on smartphones only.
    • mode. Select how often OnInactivity popup must be displayed. You can use one of the following values:
      • every-time. The popup is displayed every time until the user has submitted a subscription form.
      • once-session. The popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
      • once-period. The popup is displayed once per X days (defined as period parameter) until the user has submitted a subscription form.
      • once-only. The popup is displayed only once.
      • none. The popup will never be displayed.
    • period. Set period (in days) when mode is set as once-period. This parameter is ignored in all other cases.
    • delay. The popup is displayed after this period of user's inactivity (in seconds).
    Please rememeber, you can use ulp_add_event("onidle", ..) only once per page. If you insert it several times with different parameters, only last one will work.
  6. To raise the popup, when AdBlock detected (OnAdBlockDetected popup), add the following JS-code to your page. It must be inserted below remote.min.js. Please notice, this is an experimental feature and can be deleted in future releases.
    <script>
    ulp_add_event("onabd", {
    	popup:			"OBJECT1_ID",
    	popup_mobile:	"OBJECT2_ID",
    	mode:			"every-time",
    	period:			5
    });
    </script>
    As you can see function ulp_add_event("onabd", ..) accept an object with several parameters:
    • popup, popup_mobile. Popup IDs taken from relevant column on Popups page (menu "Layered Popups >> Popups"), or A/B campaign IDs taken form relevant column on A/B Campaigns page (menu "Layered Popups >> A/B Campaigns"). At least one of these parameters must be defined. Popup defined as popup_mobile will be displayed on smartphones only.
    • mode. Select how often OnAdBlockDetected popup must be displayed. You can use one of the following values:
      • every-time. The popup is displayed every time until the user has submitted a subscription form.
      • once-session. The popup is displayed once per session until the user has submitted a subscription form. Session is a browser's session. Usually session ends when user close browser. Sometimes it ends when user reboot PC.
      • once-period. The popup is displayed once per X days (defined as period parameter) until the user has submitted a subscription form.
      • once-only. The popup is displayed only once.
      • none. The popup will never be displayed.
    • period. Set period (in days) when mode is set as once-period. This parameter is ignored in all other cases.
    Please rememeber, you can use ulp_add_event("onabd", ..) only once per page. If you insert it several times with different parameters, only last one will work.
  7. To embed the popup into page and display it as a part of its content, use the following HTML shortcode:
    <div class="ulp-inline" data-id="POPUP_ID"></div>
    POPUP_ID is a popup ID taken from relevant column on Popups page (menu "Layered Popups >> Popups").
  8. To lock certain link, use the same method as described in chapter above: Using Popups (method #10).

Popups Library

All license owners have access to online Popups Library directly from WP dashboard (menu "Layered Popups >> Popups Library"). They can import any popup into Popups list and use it. To have access to Popups Library you need set Item Purchase Code into relevant field on Settings page (at the bottom). If you don't know what is Item Purchase Code, please check this URL: https://help.market.envato.com/hc/en-us/articles/202822600.

A/B Campaigns

With this plugin you can create A/B campaigns to perform A/B tests. All A/B campaigns can be reached through menu "Layered Popups >> A/B Campaigns". Each A/B campaign can be used the same way as regular popup (OnClick, OnLoad, OnExit, OnScroll and OnInactivity), so please read "Using Popups" chapter in this documentation.

List of campaigns is organized as a table with several columns:

  • Title. The title of A/B campaign is used for your own reference.
  • ID. This unique Campaign ID is used to identify popup when using it as OnClick popup.
  • Popups. Number of popup included into campaign.
  • Submits. If popups have subscription/contact form, this column shows how many times the form was submitted.
  • Impressions. This column shows how many times popups were displayed.
  • Operations/actions. You can perform several actions for each popupby clicking appropriate icon.
    • Edit campaign. Click icon to edit the campaign.
    • Show campaign statistics. Click icon to view campaign statistics. It displays number of impressions, submissions and CTR for each popup in A/B campaign.
    • Block campaign. Disable campaign. Once blocked, the campaign can't be used on website.
    • Unblock campaign. Enable campaign. Once unblocked, the popup can be used on website.
    • Drop counters. Clear counter for all popups in campaign.
    • Delete popup. Remove popup from the list.

To create A/B campaign, use campaign editor (menu: "Layered Popups >> Create Campaign"). On that page you need complete campaign's title and select popups that you want to include into campaign. You can use campaign the same ways as regular popup (OnClick, OnLoad, OnExit, OnScroll and OnInactivity), so please read "Using Popups" chapter in this documentation.

Targeting

Starting version 6.10 we improved flexibility of settings related to how and where to display popups. We call it "Targeting". To enable this feature just tick checkbox "Advanced Targeting" on Advanced Settings page. After activation, all targets can be reached through menu "Layered Popups >> Targeting".

While creating target you need answer several simple questions: HOW, WHAT, WHEN and WHERE:

  1. First of all decide HOW the popup must be displayed. By other words you need choose what event will trigger the popup. It can be OnLoad, OnScroll, OnExit, OnInactivity, OnAdblockDetected, ContentStart (inline), ContentEnd (inline) events.
  2. Second step is to choose popups that will be displayed for event selected on first step. For better user experience you can choose popups for desktops/laptops and mobiles separately.
  3. After that choose dates and user roles for your target (if necessary).
  4. And finally, choose part of website WHERE you want to see the popup. It can be posts/pages/products and even any custom post types filtered by any available taxonomies.

All targets are combined into 2 groups: active and passive. Active targets are currently applied to website. Passive are passive. You can easily drag and drop targets from one group to another.

Active targets can be sorted (use mouse to sort them). The upper target in the group, the higher priority it has. What is priority and why it is necessary? The answer is simple. If certain page match to several targets simultaneously, then target with higher priority will be applied to this page.

If Targeting is activated, event settings on General Settings page and meta boxes for posts/pages/etc. are disabled, because their functionality is covered by Targeting. If you want them back, just disable Advance Targeting on Advanced Settings page.

Log

Users, who submit subscription/contact form, are stored in local database. Entries in the database contains values of basic and custom fields as well as some technical information: users IP, user agent and URL where form was submitted. This info can be exported as CSV-file for further analysis. The log can be reached through menu "Layered Popups >> Log".

List of subscribers is organized as a table with several columns:

  • Name. The name of subscriber.
  • E-mail. The e-mail address of subscriber.
  • Popup. The title of popup where the form was submitted.
  • Created. The time when the form was submitted. This is server time.
  • Operations/actions. You can perform several actions for each popupby clicking appropriate icon.
    • View details. View full list of users data.
    • Delete record. Remove record from the list.

At the bottom of the list you can find buttons "Delete All Records" and "CSV Export". The purpose of these buttons are obvious. :-)

Updates

We are constantly improving our plugin by adding new features and fixing bugs. Please keep the plugin updated and always use latest version. There are 2 ways to update the plugin:

  1. Manual update. Download latest version of the plugin from CodeCanyon and overwrite exiting files by new ones.
  2. Automtic update. To enable this feature you need put Item Purchase Code on Settings page (at the bottom). After that, updates will be pulled from our servers automatically.

Uninstall

If you want completely uninstall Layered Popups and remove everything related to this plugin, do the following steps:
  1. Tick checkbox "Clean database" on Advanced Settings page (it's available since version 5.87).
  2. Deactivate plugin.
  3. Remove folder /wp-content/plugins/layered-popups.
  4. Remove folder /wp-content/uploads/ulp.
That's it!

Troubleshooting

Confirmation E-mail, Welcome Mail or Admin Notification is not sent
Please notice, plugins never send e-mails by themselves. They delegate this function to WordPress installation by using wp_mail() function. So, the WordPress is responsible for e-mail sending. If you don't receive e-mails, it means that WordPress can't send them. Why it may happen and what to do?
  • By default WordPress uses php mail() function. Probably your hosting provider blocks this function. Please contact their support and ask if they do that.
  • Some hosting providers don't allow to send e-mails when sender e-mail address doesn't belong to the same domain (where website installed) or doesn't exists. So, please go to plugin's Settings page and make sure that Sender E-mail address exists and belongs to domain, where website installed.
  • Also you can configure wp_mail() function to use any 3rd party SMTP server by using free plugins, that adjust wp_mail(): https://wordpress.org/plugins/search.php?q=wp_mail