My Popup Won't Work - How Can I Fix It?

Overview

Fixing a popup that won’t display, or no longer displays can be complicated. It requires helpful tools, and a systematic approach to evaluate and eliminate possible root causes.  

This article introduces users to several debugging tools, and a progressive approach to assess why a popup will not display and how to resolve the problem.

Article Contents

Recommended Debugging Tools

We recommend two tools to assess popup performance and settings:

  1. The Popup Maker Admin Toolbar
  2. The Popup Maker Debug Mode

Popup Maker Admin Toolbar

This tool is accessible from the WordPress Admin toolbar located on the front end of a site. Users must be logged in as a site Admin to view and use the toolbar.  The toolbar lists popups that are set to 'published' and targeted to activate when a page loads in the browser. 

See the related article below on how to access and use this tool.

Related article:  Popup Maker Admin Introduction

See the related article below to learn about targeting conditions and popup activation.

Related article:  'Targeting' option settings

Popup Maker Debug Mode

Popup Maker includes a set of debugging tools that can be activated either from the plugin Admin or directly in the browser.  The debug tools provide a detailed set of information about popup settings for each published popup activated on page load. The output from this toolset is displayed on the browser Console tab using inspection tools.  

See the related articles below on how to activate the debugging tools and open the browser Console. 

Related article:  How to Enable and Use Popup Maker Debug Tools

Related article:  How to Open Browser Inspection Tools on Your Site

[ Back to top ]


Check #1 -- Inspect the Popup Publication Status and Targeting Conditions

Use the Popup Maker Admin Toolbar to perform this step.

Select the Popup Maker icon in the Admin Toolbar, then select 'Popups' from the drop-down menu. A side menu will display all popups set to 'published' status, and activated to appear on the page loaded in the browser. 

A popup can be published, yet not appear in the Toolbar popup list if the popup targeting conditions are not set to load the popup on the page opened in the browser. 

Confirm publication status for a popup in the WordPress Admin. Go to: 

  • Popup Maker (menu) >>
  • All Popups (submenu) >>
  • Name (primary column) >>
  • {name-of-popup}

Hover of the name of the popup to display the 'Quick Edit' menu option. Select 'Quick Edit' and inspect the 'Status' field. 

If a popup is published and does not appear in the Toolbar list, open the Popup Editor and go to the Popup Settings (box) >> Targeting (option tab) to inspect the popup targeting conditions. 

The easiest way to resolve targeting conditions that may interfere with the display of a popup is to  remove all conditions (restore plugin default). Then add back one set of conditions at a time, and use the toolbar to check that the popup is listed (activated) on a given page or post. 

Once a popup is listed on the Admin Toolbar, it can be previewed using the toolbar menu options.

Related article:  'Targeting' option settings

Related article:  Conditions Introduction

[ Back to top ]


Check #2 -- Inspect the Popup Trigger 

Once the popup is set to 'published' and set to activate in the browser on page load, check the popup trigger.  Visit the front of the site, and select the 'Popup Maker' option in the Admin toolbar. Go to:

'Popup Maker' >> 'Popups' >> {name-of-popup} >> 'Open Popup'. 

If the popup can be opened from the Admin Toolbar menu, but otherwise does not open as expected, check the popup trigger settings in the Popup Editor.  

The popup does not display as expected either because: 

  • no trigger was set on the popup, OR
  • the trigger was not correctly set.   

Consult the related article links below for guidance on how to set a trigger. By default, the plugin includes 2 popup triggers; Auto Open / Time Delay, and Click Open. All other triggers require the purchase of a premium license to extend the Popup Maker plugin. 

Related article:  'Triggers' option settings

Related article:  Trigger: Auto Open / Time Delay

Related article:  Trigger: Click Open -- Overview & Methods

[ Back to top ]


Check #3 -- Inspect the Site Theme to Ensure That 'wp_footer()' is Loading

Open your browser inspection and development tools.  Use the inspection tools' 'Elements' tab to perform this step.

Related article:  How to Open Browser Inspection Tools on Your Site

Screenshot of the browser inspection tools 'Elements' box. Item (1) refers to the JS scripts loaded to display the WP Admin Toolbar. Item (2) refers to the Popup Maker JS scripts loaded in the page footer.

The WordPress function `wp_footer()` fires the action hook do_action( 'wp_footer' ) to which Popup Maker registers its JS scripts. These scripts are essential to display the Popup Admin Toolbar, load popup HTML, and activate popups in the browser.  

If wp_footer() is missing from a theme page or page template, Popup Maker cannot load it's JS scripts. The Popup Admin toolbar disappears, and popup will not activate on a page, even when the popup status is set to 'published'.  Restoring the template or template component that contains wp_footer() should restore popups on a site.

[ Back to top ]


Check #4 -- Inspect for Possible Plugin or Theme Conflicts

Popup Maker is maintained to perform well with WordPress Core and it's ecosystem of plugins and themes. Not every plugin or theme performs as expected with Popup Maker. 

To evaluate a possible conflict between Popup Maker and another plugin or theme, please consult the related article link below. We recommend a problem-solving approach to isolate and identify possible conflicts with a minimum of disruption to an ongoing site. 

Related article:  Test if a Plugin or Theme Interferes with Popup Maker

[ Back to top ]


Check #5 -- Inspect for JavaScript Errors

If the troubleshooting checklist above does not help to identify and resolve the problem, AND the popup is not listed in the browser Console with debug mode activated, then a JavaScript (JS) error could be the source of the problem

Consult the related article below for guidance. 

Related article:  Checking for JavaScript Errors

[ Back to top ]