Boxzilla Plugin

Boxzilla for WordPress

Boxzilla is a plugin allowing you to add pop-up or slide-in boxes to your WordPress site. Boxes can slide or fade in at any point and can contain whatever content you like.

Some of Boxzilla’s features

• Boxes can contain any content you like.
• You can show boxes at various events:
  • After scrolling down past a certain percentage of the page height.
  • After scrolling down to a specific page element.
  • After X seconds on the page.
  • After X pageviews on the site.
  • Manually by clicking a link or button
  • When the user intents to exit your website (Premium)
  • After X seconds on the site (any page). (Premium)
• Customizable box position on the screen.
• Animations for showing or hiding boxes.
• Page targeting, to only show pop-ups on certain posts or pages.
• Full control over how long boxes should stay hidden once they are dismissed.
• Customizable box appearance using a simple visual interface.
• Only 6 kB of JavaScript is added to your website.

Read more about Boxzilla.

Premium add-ons for Boxzilla

The Boxzilla plugin itself is entirely free. Advanced functionality is available through several paid add-ons. Not only do they extend the core functionality of the plugin, they also help to fund further development of the core (free) plugin.

Browse available add-ons for Boxzilla.

Documentation

Please have a look at the Boxzilla Knowledge Base.

Demo

There’s a Boxzilla demo site with some examples.

Support

Please use the WordPress.org plugin support forums for community support.

If you’re a Boxzilla Premium customer, please use our support email for a faster reply.

Installing the plugin

1. In your WordPress admin panel, go to Plugins > New Plugin, search for Boxzilla and click “Install now”
2. Alternatively, download the plugin and upload the contents of boxzilla.zip to your plugins directory, which usually is /wp-content/plugins/.
3. Activate the plugin.
4. (Optional) Install some add-on plugins for Boxzilla

Creating a Boxzilla box

1. Go to Boxzilla > Add New
2. Add some content to the box
3. (Optional) customize the appearance of the box by changing the Appearance Settings

Additional Customization

Have a look at the frequently asked questions section for some examples of additional customization.

1. 

   A Boxzilla pop-up with a newsletter sign-up form.

2. 

   Another Boxzilla pop-up, with different styles.

3. 

   Screenshot of the page to manage a Boxzilla pop-up.

3.3.1 – May 17, 2024

• Minor performance improvements to plugin bootstrapping and autoloader implementation.
• Fix link in license key form.
• Move CSS out of JS file for improved parsing performance.
• Move to webpack instead of Gulp for preparing client-side asset files.
• Bump required PHP version to 7.0 or later.

3.2.27 – Mar 28, 2023

• Fix scroll based trigger regression introduced in previous version.

3.2.26 – Mar 21, 2023

• Check if administrator role exists before adding capabilities to it. Thanks Jaime Martínez.
• Fix “undefined array key href” warning on PHP8.
• Fix PHP8.1 deprecation warnings.

3.2.25 – Apr 20, 2021

• Change usage of deprecated jQuery.load method.
• Add aria-modal="true" to overlay element.

3.2.24 – Nov 3, 2020

• Allow for #boxzilla-ID links in <area> elements.
• Show certain settings even if no trigger is chosen.
• Only show auto-hide setting if trigger is set to element or percentage (ie trigger condition can revert).

3.2.23 – Jul 13, 2020

• Add aria-label to close icon to help screen readers.

3.2.22 – Mar 19, 2020

• Minor code improvements
• Check if body element exists before updating class attribute, fixes an issue with some page builders.

3.2.21 – Feb 18, 2020

• “If post category” or “if post tag” conditionals now apply to any post-type using built-in WP categories or tags.

3.2.20 – Jan 20, 2020

Fixes

• An issue with the “pageviews” trigger on Safari Mobile where session storage is inaccessible in the beforeunload event.

Improvements

• Prepare for upcoming Mailchimp for WordPress plugin update which changes the name of the JS object when a form is submitted without AJAX.

3.2.19 – Dec 30, 2019

Fixes

• Box rules using “contains” would only check first argument (when using comma-separated value).

Improvements

• Use a dedicated overlay element per box to prevent issues with multiple boxs showing on a page. Thanks Jason Maurer!

3.2.18 – Dec 2, 2019

Fixes

• Missing quotes in HTML attribute on “edit box” page.

3.2.17 – Nov 18, 2019

Fixes

• Notices when checking for updating and not having some add-on plugins installed.

3.2.16 – Nov 15, 2019

Improvements

Roll-back a change in version 3.2.15 that caused an issue with Boxzilla Theme Pack and Boxzilla WooCommerce.

Please make sure your Boxzilla plugin license is activated and then update Boxzilla Theme Pack and Boxzilla WooCommerce to the latest version.

3.2.15 – Nov 6, 2019

Improvements

• Add proper SVG icon with neutral color for admin menu.
• Use Page Visibility API for time-based triggers (time on site & time on page).
• Stop using supress_filters when retrieving boxes for a possible performance improvement.
• Minor performance improvement in bootstrapping logic.
• Add link to Koko Analytics

3.2.14 – Aug 7, 2019

Fixes

• Issue with incorrect argument count for some sites with custom menu’s.

3.2.13 – Aug 5, 2019

Improvements

• Allow more query hash parameters for opening a box.
• Allow bypassing animation for opening or closing boxes.

Additions

• Easily link to boxes from WP Menu’s.

3.2.12 – June 7, 2019

Improvements

• Allow skipping animations when showing, hiding or dismissing a box.
• Check for empty box content after running filter hooks, instead of before.

3.2.11 – May 8, 2019

Improvements

• Update loading configuration when duplicating a box.
• Accept query parameters in URL hash for opening a box through a link click or on loading a page.

3.2.10 – February 15, 2019

Improvements

• Better exit intent detection for mobile devices.

Additions

• New bulk action to quickly duplicate a box with all of its settings.

3.2.9 – December 5, 2018

Improvements

• Make sure preview updates with correct color values when applying box styles.
• Use small margin of error to prevent iOS scroll bounce from closing box again.

3.2.7 – July 31, 2018

Fixes

• Issue with boxes with only an iframe, image or video and no text not being loaded.

3.2.6 – June 27, 2018

Improvements

• Show and/or between rules to help clarify rule logic.
• Consistent line endings in main plugin file.

3.2.5 – June 6, 2018

Fixes

• Some JSON encoders would print Boxzilla config as object, resulting in no boxes actually being loaded.

Additions

• Add “does not contain” qualifier in URL and referrer conditions.

3.2.4 – May 31, 2018

Fixes

• Boxzilla content replicating parts of the page if other plugins “incorrectly” use the_content filter.

3.2.3 – May 29, 2018

Improvements

• Allow “contains” qualifier in URL and referrer conditions.
• Include query string in URL conditions.
• Use SVG for the menu ico. Thanks Kurt Zenisek
• Added Czech translations. Thanks Zdenek Petrbok
• Run the_content filter on Boxzilla post content, to enable plugins like Photon.
• Ensure content element exists when initialising Boxzilla.
• Improvements to licensing related code for Boxzilla Premium users.

3.2.2 – March 12, 2018

Improvements

• Print box contents at an earlier footer hook, so it works with “smart enqueue” methods in other plugins like Mailchimp for WordPress or Maxbuttons.

3.2.1 – March 5, 2018

Fixes

• Can’t use return value in write context error, introduced in v3.2.

3.2 – March 5, 2018

Fixes

• Compatibility with plugins that use JavaScript rendering.

Improvements

• Skip boxes with empty content.

3.1.23 – December 13, 2017

Fixes

• Event listener for hyperlinks referencing #boxzilla-123. We recommend using [boxzilla_link]to generate your links though[/boxzilla_link]. Here’s how that works.

3.1.22 – November 20, 2017

Fixes

• Showing box by location hash after page load wasn’t working.

Improvements

• Load <script> in box content synchronously so libraries get a chance to load before they’re used.

3.1.21 – October 10, 2017

Fixes

• Ensure that administrators can always edit boxes.

3.1.20 – October 9, 2017

Fixes

• Screen width condition not working when using WordPress in language other than English.

Improvements

• Use custom capability type so access to Boxzilla boxes can be modified using a role manager plugin.

3.1.19 – September 20, 2017

Improvements

• Trigger points based on height (scroll %, element) will now be recalculated when the page height changes.

3.1.18 – September 7, 2017

Additions

• Added [boxzilla_link] shortcode to generate the correct HTML for a link to show/toggle/hide/dismiss a box.

3.1.17 – August 30, 2017

Fixes

• IE11 issue with scroll triggered pop-ups never showing up.

3.1.16 – August 2, 2017

Fixes

• JavaScript error when clicking <a> elements without href attributes.

3.1.15 – July 26, 2017

Additions

• Added [boxzilla-close]text here[/boxzilla-close] shortcode to insert a link to close the box.
• Added setting to hide the close icon.
• Added setting to hide or show box for logged-in users.

3.1.14 – July 13, 2017

Fixes

• IE Edge issue with sliding box animation.

Improvements

• Don’t wait for document.ready event to initialise boxes. Fixes issues with plugins not delegaging AJAX event listeners.

3.1.13 – May 11, 2017

Improvements

• Allow for script resources in Boxzilla box content (instead of just inline script elements).
• Reset box content when box is dismissed, eg to stop YouTube video’s from playing.

3.1.12 – April 24, 2017

Improvements

• Update endpoint URL for license API requests.

3.1.11 – March 22, 2017

Fixes

• #boxzilla-321 link not working when link has a nested image element.

Improvements

• Added the option to show on screens smaller than a certain width.
• Improved URL matching for “is url” rule.

3.1.10 – March 8, 2017

Fixes

• Debugging statement that would log to console on every scroll event.

Improvements

• Reduced overlay click error margin to 40px (instead of % based).
• Minor UX improvements for “edit box” screen.

3.1.9 – February 27, 2017

Fixes

• Compatibility error with PHP 7.1 because of function name with double underscore prefix.

Improvements

• Removed autofocus when box shows because of mobile browser issues & popping up keyboard.

Additions

• Added Romanian language files.

3.1.8 – November 8, 2016

Fixes

• JS error on sites running HTTPS, introduced by v3.1.7.

3.1.7 – November 8, 2016

Fixes

• Cookie length value was reset on every plugin update.
• Scroll to bottom when closing box in MobileSafari browsers.

Improvements

• Add CSS class to overlay when box is toggled.
• Ask for plugin review after 2 weeks of usage.

3.1.6 – October 18, 2016

Improvements

• Failsafe against including the Boxzilla script twice, to prevent duplicate elements.

3.1.5 – September 6, 2016

Fixes

• Box cookies were being set for all boxes when dismissing a box using the overlay or ESCAPE key.
• Auto-close not working since version 3.1.3

Improvements

• Prevent default click event action when clicking close icon.
• Add helper classes for the Boxzilla – Theme Pack add-on.

3.1.4 – August 24, 2016

Fixes

• Boxzilla.show(123) no longer working in previous update.

3.1.3 – August 24, 2016

Improvements

• Don’t trigger any new boxes when a box is currently open.
• Fail gracefully when not running PHP 5.3 or higher.

3.1.2 – August 2, 2016

Fixes

• Exit-Intent not working in Safari & Firefox.

3.1.1 – August 1, 2016

Fixes

• Scroll triggers not working in IE11.

Improvements

• Allow <img> elements inside links that open boxes.
• Better page height detection.

3.1 – July 19, 2016

Improvements

• Completely removed jQuery dependency, resulting in better performance & smoother animations.
• Completely removed CSS file dependency.
• Box position is now visually hinted in box settings.
• Event binding improvements for Exit Intent detection.

Additions

• You can now set a cookie after the box is triggered, to prevent consecutively showing the box if a visitor does not explicitly dismiss it.

3.0.3 – July 5, 2016

Improvements

• Add id attribute to box element.
• Automatically fix links in box content that use HTTP when HTTPS is needed.
• Restore global jQuery object after running user scripts, to failsafe errors.

Additions

• When using Mailchimp for WordPress without AJAX, the box will now automatically re-open after reloading the page.

3.0.2 – June 21, 2016

Fixes

• Box condition “is post” was not working with an empty value.

Improvements

• Prevent PHP notice when saving box without changing box rules.

Additions

• Added French translation files, thanks to Benoit Mercusot.

3.0.1 – May 23, 2016

Improvements

• You can now use <script> tags directly in box content (again).

Additions

• Add “post tag is / is not” loading condition.
• Plugin will now show a notice to deactivate old Scroll Triggered Boxes plugin.
• Internal changes to dependency container for use in add-on plugins.
• Add-on: Boxzilla Pageviews Trigger.
• Add-on: Boxzilla WooCommerce

3.0 – May 11, 2016

Initial release of Boxzilla, formerly known as Scroll Triggered Boxes.

If you’re upgrading from the old plugin, please check updating to Boxzilla from Scroll Triggered Boxes for a list of changes you should be aware of.