Select “Display Popup Method” = “Manually” in your Magento back-end as shown below:<\/h3>\n\n\n\n![\"Newsletter](\"\/docs\/wp-content\/uploads\/2020\/05\/Newsletter_popup_1.x_devguide_1.jpg\")
<\/a><\/figure>\n\n\n\n“Load” and “Show” newsletter popups using the following JavaScript methods below:<\/h3>\n\n\n\n
There are two available methods: .load() and .show(). “Load” allows to load newsletter popup content from server in background without displaying it. Then “Show” method will display the popup once its loaded.<\/p>\n\n\n\n
<\/div>.load()<\/code><\/pre><\/div>\n\n\n\n\nLoad popup without any arguments. This method is executed automatically when the extension is initialized.<\/p>\n<\/div><\/div>\n\n\n\n
<\/div>.load([id][, callback ])<\/code><\/pre><\/div>\n\n\n\nLoad popup by specified newsletter popup ID. There is no need to check if the popup was already loaded. This method will not load the same popup twice. You can find popup ID by going to your magento back-end, then Plumrocket -> Newsletter Popup -> Manage Newsletter Popups -> column “ID”.<\/p>\n\n\n\n
If supplied, the callback is fired once the newsletter popup is loaded. The callback passed to .load() is guaranteed to be executed after the DOM is ready, so this is usually the best place to attach all other events and run other JavaScript code. It is hard to predict the overall load time of the newsletter popup from server and therefore we strongly suggest to use callback function. If the popup is already loaded on page then the callback will be executed immediately<\/p>\n\n\n\n
callback: function([bool<\/span><\/i> status][, bool<\/span><\/i> just_loaded])<\/span><\/strong><\/p>\n\n\n\nParameters<\/strong><\/p>\n\n\n\nstatus<\/strong> \u2014 returns “true”, if the popup is available to be displayed, otherwise returns “false”. <\/p>\n\n\n\njust_loaded<\/strong> \u2014 returns “true”, if the popup was just loaded during this function call, otherwise returns “false” if it was previously loaded on page.<\/p>\n\n\n\n<\/div>.show()<\/code><\/pre><\/div>\n\n\n\nDisplay popup on page after it was loaded with .load() method. It’s an easy way to display popup without providing any arguments. If on the same page two popups are loaded – one using automatic “Display Popup Method” (such as “after the time delay” or “when leaving the site”) and the second one using the “manual” display method, then the automatically loaded popup will be displayed. If you have loaded two or more popups using “manual” display popup method, then the first loaded popup will be displayed.<\/p>\n\n\n\n
<\/div>.show([id][, callback ])<\/code><\/pre><\/div>\n\n\n\nDisplay popup by specified newsletter popup ID. This newsletter popup must be previously loaded using .load() method. If popup with different “ID” is currently displayed on page while the .show([id]) is being executed, then the previous popup will be hidden and the requested popup is displayed instead. There is no need to check for overlapping popups.<\/p>\n\n\n\n
callback: function([bool<\/span><\/i> status])<\/span><\/strong><\/p>\n\n\n\nParameters<\/strong><\/p>\n\n\n\nstatus<\/strong> \u2014 returns “true”, if the popup exists and displayed on page, otherwise returns “false”.<\/p>\n\n\n\nEXAMPLES:<\/i><\/p>\n\n\n\n
\n Example 1:<\/p>\n \n
Let’s load & display newsletter popup with ID=5 and output a message to the Web Console using our callback function:<\/strong><\/p>\n\n <\/div><script type=\"text\/javascript\">\n newsletterPopup.load(5, function(status, just_loaded) {\n if (just_loaded) {\n console.log('Well done, Sir. The popup was just loaded.');\n \/\/ alert('This is another successful newsletter load message!');\n newsletterPopup.show(5);\n }\n }\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 2:<\/p>\n \n
Load and display any available newsletter popup. Please note that “.load()” method without arguments is not required, it is executed automatically when the extension is initialized.<\/strong><\/p>\n \n <\/div><script type=\"text\/javascript\">\n newsletterPopup.show();\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 3:<\/p>\n \n
Load and display newsletter popup with ID=5 on link click<\/strong><\/p>\n \n <\/div><script type=\"text\/javascript\">\n newsletterPopup.load(5);\n <\/script>\n \n <a href=\"javascript:void(0);\" onclick=\"return newsletterPopup.show(5)\">\n See Newsletter Popup\n <\/a><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 4:<\/p>\n \n
In this example we are trying to display any default newsletter popup on page (no matter what ID). If this attempt was unsuccessful, then we will try to load and show popup ID=3.<\/strong><\/p>\n\n <\/div><script type=\"text\/javascript\">\n newsletterPopup.show(function(status) {\n if (status == false) {\n newsletterPopup.load(3, function(status) {\n newsletterPopup.show();\n });\n }\n });\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nDisplay Multi-step Newsletter Popup<\/h2>\n\n\n\n
In order to display multi-step popups you need to select any popup you’ve created before, and specify another popup that will be displayed after clicking on the element in its HTML code. In order to perform this, add an attribute with popup ID that needs to be displayed to the element (e.g. button or link) required.<\/p>\n\n\n\n
\n Code Example<\/p>\n\n
<\/div>data-npid=\"_POPUP_ID_\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nYou can also use an attribute that records custom subscribers’ actions in the History section.<\/p>\n\n\n\n
\n Code Example<\/p>\n \n
<\/div>data-npaction=\"_DESCRIPTION_TO_HISTORY_\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nUse this attribute with “Cancel” value in order to close the popup and write records to the History section.<\/p>\n\n\n\n
\n Code Example<\/p>\n \n
<\/div>data-npaction=\"Cancel\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n
<\/a><\/figure>\n\n\n\n“Load” and “Show” newsletter popups using the following JavaScript methods below:<\/h3>\n\n\n\n
There are two available methods: .load() and .show(). “Load” allows to load newsletter popup content from server in background without displaying it. Then “Show” method will display the popup once its loaded.<\/p>\n\n\n\n
.load()<\/code><\/pre><\/div>\n\n\n\n\nLoad popup without any arguments. This method is executed automatically when the extension is initialized.<\/p>\n<\/div><\/div>\n\n\n\n
<\/div>.load([id][, callback ])<\/code><\/pre><\/div>\n\n\n\nLoad popup by specified newsletter popup ID. There is no need to check if the popup was already loaded. This method will not load the same popup twice. You can find popup ID by going to your magento back-end, then Plumrocket -> Newsletter Popup -> Manage Newsletter Popups -> column “ID”.<\/p>\n\n\n\n
If supplied, the callback is fired once the newsletter popup is loaded. The callback passed to .load() is guaranteed to be executed after the DOM is ready, so this is usually the best place to attach all other events and run other JavaScript code. It is hard to predict the overall load time of the newsletter popup from server and therefore we strongly suggest to use callback function. If the popup is already loaded on page then the callback will be executed immediately<\/p>\n\n\n\n
callback: function([bool<\/span><\/i> status][, bool<\/span><\/i> just_loaded])<\/span><\/strong><\/p>\n\n\n\nParameters<\/strong><\/p>\n\n\n\nstatus<\/strong> \u2014 returns “true”, if the popup is available to be displayed, otherwise returns “false”. <\/p>\n\n\n\njust_loaded<\/strong> \u2014 returns “true”, if the popup was just loaded during this function call, otherwise returns “false” if it was previously loaded on page.<\/p>\n\n\n\n<\/div>.show()<\/code><\/pre><\/div>\n\n\n\nDisplay popup on page after it was loaded with .load() method. It’s an easy way to display popup without providing any arguments. If on the same page two popups are loaded – one using automatic “Display Popup Method” (such as “after the time delay” or “when leaving the site”) and the second one using the “manual” display method, then the automatically loaded popup will be displayed. If you have loaded two or more popups using “manual” display popup method, then the first loaded popup will be displayed.<\/p>\n\n\n\n
<\/div>.show([id][, callback ])<\/code><\/pre><\/div>\n\n\n\nDisplay popup by specified newsletter popup ID. This newsletter popup must be previously loaded using .load() method. If popup with different “ID” is currently displayed on page while the .show([id]) is being executed, then the previous popup will be hidden and the requested popup is displayed instead. There is no need to check for overlapping popups.<\/p>\n\n\n\n
callback: function([bool<\/span><\/i> status])<\/span><\/strong><\/p>\n\n\n\nParameters<\/strong><\/p>\n\n\n\nstatus<\/strong> \u2014 returns “true”, if the popup exists and displayed on page, otherwise returns “false”.<\/p>\n\n\n\nEXAMPLES:<\/i><\/p>\n\n\n\n
\n Example 1:<\/p>\n \n
Let’s load & display newsletter popup with ID=5 and output a message to the Web Console using our callback function:<\/strong><\/p>\n\n <\/div><script type=\"text\/javascript\">\n newsletterPopup.load(5, function(status, just_loaded) {\n if (just_loaded) {\n console.log('Well done, Sir. The popup was just loaded.');\n \/\/ alert('This is another successful newsletter load message!');\n newsletterPopup.show(5);\n }\n }\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 2:<\/p>\n \n
Load and display any available newsletter popup. Please note that “.load()” method without arguments is not required, it is executed automatically when the extension is initialized.<\/strong><\/p>\n \n <\/div><script type=\"text\/javascript\">\n newsletterPopup.show();\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 3:<\/p>\n \n
Load and display newsletter popup with ID=5 on link click<\/strong><\/p>\n \n <\/div><script type=\"text\/javascript\">\n newsletterPopup.load(5);\n <\/script>\n \n <a href=\"javascript:void(0);\" onclick=\"return newsletterPopup.show(5)\">\n See Newsletter Popup\n <\/a><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n\n Example 4:<\/p>\n \n
In this example we are trying to display any default newsletter popup on page (no matter what ID). If this attempt was unsuccessful, then we will try to load and show popup ID=3.<\/strong><\/p>\n\n <\/div><script type=\"text\/javascript\">\n newsletterPopup.show(function(status) {\n if (status == false) {\n newsletterPopup.load(3, function(status) {\n newsletterPopup.show();\n });\n }\n });\n <\/script><\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nDisplay Multi-step Newsletter Popup<\/h2>\n\n\n\n
In order to display multi-step popups you need to select any popup you’ve created before, and specify another popup that will be displayed after clicking on the element in its HTML code. In order to perform this, add an attribute with popup ID that needs to be displayed to the element (e.g. button or link) required.<\/p>\n\n\n\n
\n Code Example<\/p>\n\n
<\/div>data-npid=\"_POPUP_ID_\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nYou can also use an attribute that records custom subscribers’ actions in the History section.<\/p>\n\n\n\n
\n Code Example<\/p>\n \n
<\/div>data-npaction=\"_DESCRIPTION_TO_HISTORY_\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\nUse this attribute with “Cancel” value in order to close the popup and write records to the History section.<\/p>\n\n\n\n
\n Code Example<\/p>\n \n
<\/div>data-npaction=\"Cancel\"<\/code><\/pre><\/div>\n<\/div><\/p>\n\n\n\n
![\"1](\"\/docs\/wp-content\/uploads\/2020\/05\/1_magento_newsletter_popup_developer_guide_multi-step-popus.jpg\")
<\/a><\/figure>\n\n\n\n