First, install and activate Popup Maker. Then, install and activate this plugin.
Upon activating this plugin, you should receive a notice in the WordPress plugin dashboard telling you that the plugin has been activated and a new default popup has been created. You can also check for a “News Match Default Popup” at Popup Maker > All Popups in the WordPress Dashboard.
Once the plugin has created the default popup, if you don’t want to use News Match Popup Basics’ popup suppression features, you can go ahead and uninstall News Match Popup Basics.
Upon activation, the plugin creates a new popup with recommended default settings.
- is not published by default, but requires you to publish it before it becomes active on the site
- is the size “Large” from Popup Maker’s settings
- appears at the center of the bottom of the reader’s screen
- appears by sliding up from the bottom of the screen, over 350 millisenconds
- has a “Close” button
- does not prevent readers from interacting with the page by means of an overlay
- does not have a title
- automatically opens after 25 seconds on the page, because immediate popup appearances can be jarring
- once dismissed by a reader, does not appear again for a year or until the reader clears their browser’s cookies, whichever comes first
- appears on the front page of the site
- uses Popup Maker’s default theme
For more about Popup Maker’s options for popup placement and behavior, read the Popup Maker documentation for the Popup Editor.
Once the popup is created, you can modify the popup just like any other popup. The popup will not appear on your site until you publish it.
In the WordPress Dashboard, under the “Popup Maker” menu item, on the “News Match Popup Basics” page, there is a checkbox that enables MailChimp suppression. There is also a text box to set the
utm_source parameter. MailChimp automatically appends this URL parameter to outbound links in your emails if you have click tracking set up.
From one of the emails you have sent, find a link that contains a
utm_source= parameter and copy the following argument text, up until any
& character, into the text box. For example, a Nerd Alert newsletter sent by INN Labs contained a link that looked like this:
https://example.org/?utm_source=Nerd+Alert&utm_campaign=4d4ecd9f68-EMAIL_CAMPAIGN_2017_10_06&utm_medium=email&utm_term=0_1476113985-4d4ecd9f68-421742753. From that URL, you would copy
Nerd+Alert into the text box.
Once you have provided a
utm_source parameter, checked the checkbox, and saved the settings, any popup that contains an HTML element with an
id attribute equal to
mc_embed_signup, or a CSS selector equal to
When you generate a MailChimp embedded signup form, MailChimp provides HTML by default that looks like this:
News Match Popup Basics uses
#mc_embed_signup as the selector for disabling MailChimp signup forms because that’s what MailChimp uses. You can also apply a filter to
news_match_popup_basics_mailchimp_selector to change the selector; your filter function should accept a string as its first parameter and return a string. There are no other parameters:
/** * Filter to change the News Match Popup Basics mailchimp suppression selector * * @since News Match Popup Basics 0.1.2 * @param string $selector A CSS selector that chooses mailchimp forms within Popup Maker popups; default is '.pum #mc_embed_signup'. * @return string The new selector */ function my_filter( $selector ) return '.pum .class_added_to_all_mailchimp_forms'; add_filter( 'news_match_popup_basics_mailchimp_selector', 'my_filter' );
In the WordPress Dashboard, under the “Popup Maker” menu item, on the “News Match Popup Basics” page, there is a checkbox that enables donation page popup suppression, and a text box that allows you to add the URLs of donation pages on your site.
Once at least one URL has been added to the text box, and the check box has been checked, the News Match Popup Basics plugin will prevent all Popup Maker popups from appearing on pages which have a URL that matches the URL setting. This function pre-empts the Popup Maker conditions: no matter what conditions a popup has for display, that popup will not appear on a page with a matching URL.
We recommend that you use the News Match Donation Shortcode plugin to place donation forms in popups on your site, and on your site’s donation page.
We also recommend you use this plugin’s suppression features to prevent all popups from appearing on your donation and subscription pages.