PluginProbe
Boxzilla – WordPress Popup Builder / 3.4.7
Boxzilla – WordPress Popup Builder v3.4.7
3.4.11 3.4.10 3.4.9 3.4.3 3.4.4 3.4.5 3.4.6 3.4.7 3.4.8 trunk 3.0 3.0.1 3.0.2 3.0.3 3.1 3.1.1 3.1.10 3.1.11 3.1.12 3.1.13 3.1.14 3.1.15 3.1.16 3.1.17 3.1.18 All 72 releases
boxzilla / readme.txt

readme.txt in Boxzilla – WordPress Popup Builder 3.4.7, at readme.txt

713 lines 19.6 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Boxzilla - Pop-Ups for WordPress ===
2 Contributors: Ibericode, DvanKooten, hchouhan, lapzor
3 Donate link: https://boxzillaplugin.com/#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=donate-link
4 Tags: pop-up, pop-ups, modal, call to action
5 Requires at least: 4.6
6 Tested up to: 6.9
7 Stable tag: 3.4.7
8 License: GPL-3.0-or-later
9 License URI: http://www.gnu.org/licenses/gpl-3.0.html
10 Requires PHP: 7.4
11
12 Flexible pop-ups or slide-ins, showing up at just the right time.
13
14 == Description ==
15
16 ### Boxzilla for WordPress
17
18 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.
19
20 #### Some of Boxzilla's features
21
22 - Boxes can contain any content you like.
23 - You can show boxes at various events:
24 - After scrolling down past a certain percentage of the page height.
25 - After scrolling down to a specific page element.
26 - After X seconds on the page.
27 - After X pageviews on the site.
28 - Manually by clicking a link or button
29 - When the user intents to exit your website (Premium)
30 - After X seconds on the site (any page). (Premium)
31 - Customizable box position on the screen.
32 - Animations for showing or hiding boxes.
33 - Page targeting, to only show pop-ups on certain posts or pages.
34 - Full control over how long boxes should stay hidden once they are dismissed.
35 - Customizable box appearance using a simple visual interface.
36 - Only 6 kB of JavaScript is added to your website.
37
38 [Read more about Boxzilla](https://boxzillaplugin.com/#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=description).
39
40 > #### Premium add-ons for Boxzilla
41 >
42 > 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.
43 >
44 > [Browse available add-ons for Boxzilla](https://boxzillaplugin.com/add-ons/#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=description).
45
46 #### Documentation
47
48 Please have a look at the [Boxzilla Knowledge Base](https://boxzillaplugin.com/kb/).
49
50 #### Demo
51
52 There's a [Boxzilla demo site](https://demo.boxzillaplugin.com#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=description) with some examples.
53
54 #### Support
55
56 Please use the [WordPress.org plugin support forums](https://wordpress.org/support/plugin/boxzilla) for community support.
57
58 If you're a [Boxzilla Premium customer](https://boxzillaplugin.com/pricing#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=description), please use our support email for a faster reply.
59
60 == Frequently Asked Questions ==
61
62 = What does this plugin do? =
63
64 Pop-ups. Have a look at the [Boxzilla demo site](https://demo.boxzillaplugin.com/#utm_source=wp-plugin-repo&utm_medium=boxzilla&utm_campaign=description).
65
66 = How to display a form in the box? =
67
68 Boxzilla will work with any plugin that allows for shortcodes, like [MailChimp for WordPress](https://wordpress.org/plugins/mailchimp-for-wp/) or [HTML Forms](https://wordpress.org/plugins/html-forms/).
69
70 = Can I have a box open after clicking a certain link or button? =
71
72 Yes, you can create a link that refers the box ID. For example, if your box has an ID of 94.
73
74 `
75 <a href="#boxzilla-94">Open Box</a>
76 `
77
78 = Can I have a box open right after loading a page? =
79
80 You can configure this in the box settings. Or you can add `#boxzilla-13` to your URL, where 13 is the ID of the box you want to show.
81
82 = Can I customize the appearance of a box =
83
84 Boxzilla comes with a simple interface for customizing the pop-up appearance. But you can also use your own custom CSS if needed.
85
86 `
87 .boxzilla { } /* all boxes */
88 .boxzilla-5 { } /* only the box with ID 5 */
89 `
90
91 = I want to disable auto-paragraphs in the box content =
92
93 All default WordPress filters are added to the `boxzilla_box_content` filter hook. The example below shows how to remove them.
94
95 `
96 remove_filter( 'boxzilla_box_content', 'wptexturize') ;
97 remove_filter( 'boxzilla_box_content', 'convert_smilies' );
98 remove_filter( 'boxzilla_box_content', 'convert_chars' );
99 remove_filter( 'boxzilla_box_content', 'wpautop' );
100 remove_filter( 'boxzilla_box_content', 'do_shortcode' );
101 remove_filter( 'boxzilla_box_content', 'shortcode_unautop' );
102 `
103
104 == Installation ==
105
106 = Installing the plugin =
107
108 1. In your WordPress admin panel, go to *Plugins > New Plugin*, search for *Boxzilla* and click "Install now"
109 1. Alternatively, download the plugin and upload the contents of `boxzilla.zip` to your plugins directory, which usually is `/wp-content/plugins/`.
110 1. Activate the plugin.
111 1. (Optional) Install [add-on plugins for Boxzilla](https://boxzillaplugin.com/add-ons/)
112
113 = Creating a Boxzilla box =
114
115 1. Go to *Boxzilla > Add New*
116 1. Add some content to the box
117 1. (Optional) customize the appearance of the box by changing the *Appearance Settings*
118
119 = Additional Customization =
120
121 Have a look at the [frequently asked questions](https://wordpress.org/plugins/boxzilla/faq/) section for some examples of additional customization.
122
123 == Screenshots ==
124
125 1. A Boxzilla pop-up with a newsletter sign-up form.
126 3. Another Boxzilla pop-up, with different styles.
127 4. Screenshot of the page to manage a Boxzilla pop-up.
128
129 == Changelog ==
130
131
132 ### 3.4.7 - Mar 9, 2026
133
134 - Add uninstall script to clean up all database entries from the plugin
135 - Fix missing closing element in box rule settings
136 - Fix duplicate class attribute on wrapper element on settings page
137 - Fix duplicate id attribute on box width input field
138 - Fix deprecation in call to get_terms()
139 - Various other type fixes, PHPDoc improvements or removal of unused code.
140
141
142 ### 3.4.6 - Feb 10, 2026
143
144 - Bugfix: fire box.interactions.link event for `<img>` clicks inside an `<a>` element (or any nested element inside a hyperlink).
145
146
147 ### 3.4.5 - Sep 25, 2025
148
149 - Mark option as autoloaded for a minor performance gain.
150 - Replace `strtotime('now')` with simpler `time()`
151
152
153 #### 3.4.4 - Aug 07, 2025
154
155 Periodic compatibility check with WordPress nightly.
156
157
158 #### 3.4.3 - Jun 24, 2025
159
160 - Rebuild client-side assets with latest Browserslist.
161 - Optimize SVG icon for admin menu.
162 - Remove newsletter sign-up section from admin pages.
163
164
165 #### 3.4.2 - Apr 29, 2025
166
167 - Fix HTML showing because of escaped translation text.
168
169
170 ### 3.4.1 - Mar 24, 2025
171
172 - Bump required PHP version to 7.4 or higher.
173 - Initialize boxes at document.DOMContentLoaded instead of window.load event.
174
175
176 #### 3.4.0 - Jan 03, 2025
177
178 - Remove deprecated Bootstrapper class.
179 - Add link to https://my.boxzillaplugin.com when trying to activate an expired license.
180 - Bump tested WordPress version.
181
182
183 #### 3.3.3 - Oct 07, 2024
184
185 - Fix unclosed element on plugins overview page, breaking the table layout.
186 - Bump license to GPL v3 or higher.
187 - Bump required PHP version to 7.2 or higher.
188
189
190 #### 3.3.2 - Oct 02, 2024
191
192 - The Boxzilla script itself is now deferred for improved client-side performance.
193 - You can now use the Boxzilla JS API before the script has fully loaded.
194 - Minor server side performance improvements by getting rid of unnecessary sprintf calls or string copies.
195 - All i18n function call return values are now HTML escaped.
196 - Verify `Jetpack::is_module_active` exists before method is called.
197
198
199 #### 3.3.1 - May 17, 2024
200
201 - Minor performance improvements to plugin bootstrapping and autoloader implementation.
202 - Fix link in license key form.
203 - Move CSS out of JS file for improved parsing performance.
204 - Move to webpack instead of Gulp for preparing client-side asset files.
205 - Bump required PHP version to 7.0 or later.
206
207
208 #### 3.2.27 - Mar 28, 2023
209
210 - Fix scroll based trigger regression introduced in previous version.
211
212
213 #### 3.2.26 - Mar 21, 2023
214
215 - Check if `administrator` role exists before adding capabilities to it. Thanks [Jaime Martínez](https://jaimemartinez.nl/).
216 - Fix "undefined array key href" warning on PHP8.
217 - Fix PHP8.1 deprecation warnings.
218
219
220 #### 3.2.25 - Apr 20, 2021
221
222 - Change usage of deprecated jQuery.load method.
223 - Add `aria-modal="true"` to overlay element.
224
225
226 #### 3.2.24 - Nov 3, 2020
227
228 - Allow for `#boxzilla-ID` links in `<area>` elements.
229 - Show certain settings even if no trigger is chosen.
230 - Only show auto-hide setting if trigger is set to element or percentage (ie trigger condition can revert).
231
232
233 #### 3.2.23 - Jul 13, 2020
234
235 - Add `aria-label` to close icon to help screen readers.
236
237
238 #### 3.2.22 - Mar 19, 2020
239
240 - Minor code improvements
241 - Check if body element exists before updating class attribute, fixes an issue with some page builders.
242
243
244 #### 3.2.21 - Feb 18, 2020
245
246 - "If post category" or "if post tag" conditionals now apply to any post-type using built-in WP categories or tags.
247
248
249 #### 3.2.20 - Jan 20, 2020
250
251 **Fixes**
252
253 - An issue with the "pageviews" trigger on Safari Mobile where session storage is inaccessible in the beforeunload event.
254
255 **Improvements**
256
257 - Prepare for upcoming [Mailchimp for WordPress](https://wordpress.org/plugins/mailchimp-for-wp/) plugin update which changes the name of the JS object when a form is submitted without AJAX.
258
259
260 #### 3.2.19 - Dec 30, 2019
261
262 **Fixes**
263
264 - Box rules using "contains" would only check first argument (when using comma-separated value).
265
266 **Improvements**
267
268 - Use a dedicated overlay element per box to prevent issues with multiple boxs showing on a page. Thanks Jason Maurer!
269
270
271 #### 3.2.18 - Dec 2, 2019
272
273 **Fixes**
274
275 - Missing quotes in HTML attribute on "edit box" page.
276
277
278 #### 3.2.17 - Nov 18, 2019
279
280 **Fixes**
281
282 - Notices when checking for updating and not having some add-on plugins installed.
283
284
285
286 #### 3.2.16 - Nov 15, 2019
287
288 **Improvements**
289
290 Roll-back a change in version 3.2.15 that caused an issue with Boxzilla Theme Pack and Boxzilla WooCommerce.
291
292 Please make sure your [Boxzilla plugin license](https://my.boxzillaplugin.com/) is activated and then update Boxzilla Theme Pack and Boxzilla WooCommerce to the latest version.
293
294
295 #### 3.2.15 - Nov 6, 2019
296
297 **Improvements**
298
299 - Add proper SVG icon with neutral color for admin menu.
300 - Use Page Visibility API for time-based triggers (time on site & time on page).
301 - Stop using `supress_filters` when retrieving boxes for a possible performance improvement.
302 - Minor performance improvement in bootstrapping logic.
303 - Add link to [Koko Analytics](https://wordpress.org/plugins/koko-analytics/)
304
305
306 #### 3.2.14 - Aug 7, 2019
307
308 **Fixes**
309
310 - Issue with incorrect argument count for some sites with custom menu's.
311
312
313 #### 3.2.13 - Aug 5, 2019
314
315 **Improvements**
316
317 - Allow more query hash parameters for opening a box.
318 - Allow bypassing animation for opening or closing boxes.
319
320 **Additions**
321
322 - Easily link to boxes from WP Menu's.
323
324
325 #### 3.2.12 - June 7, 2019
326
327 **Improvements**
328
329 - Allow skipping animations when showing, hiding or dismissing a box.
330 - Check for empty box content after running filter hooks, instead of before.
331
332
333 #### 3.2.11 - May 8, 2019
334
335 **Improvements**
336
337 - Update loading configuration when duplicating a box.
338 - Accept query parameters in URL hash for opening a box through a link click or on loading a page.
339
340
341 #### 3.2.10 - February 15, 2019
342
343 **Improvements**
344
345 - Better [exit intent detection](https://boxzillaplugin.com/add-ons/exit-intent/) for mobile devices.
346
347 **Additions**
348
349 - New bulk action to quickly duplicate a box with all of its settings.
350
351
352 #### 3.2.9 - December 5, 2018
353
354 **Improvements**
355
356 - Make sure preview updates with correct color values when applying box styles.
357 - Use small margin of error to prevent iOS scroll bounce from closing box again.
358
359
360 #### 3.2.7 - July 31, 2018
361
362 **Fixes**
363
364 - Issue with boxes with only an iframe, image or video and no text not being loaded.
365
366
367 #### 3.2.6 - June 27, 2018
368
369 **Improvements**
370
371 - Show and/or between rules to help clarify rule logic.
372 - Consistent line endings in main plugin file.
373
374
375 #### 3.2.5 - June 6, 2018
376
377 **Fixes**
378
379 - Some JSON encoders would print Boxzilla config as object, resulting in no boxes actually being loaded.
380
381 **Additions**
382
383 - Add "does not contain" qualifier in URL and referrer conditions.
384
385
386
387 #### 3.2.4 - May 31, 2018
388
389 **Fixes**
390
391 - Boxzilla content replicating parts of the page if other plugins "incorrectly" use `the_content` filter.
392
393
394 #### 3.2.3 - May 29, 2018
395
396 **Improvements**
397
398 - Allow "contains" qualifier in URL and referrer conditions.
399 - Include query string in URL conditions.
400 - Use SVG for the menu ico. Thanks [Kurt Zenisek](https://github.com/KZeni)
401 - Added Czech translations. Thanks [Zdenek Petrbok](https://petrbok.cz/)
402 - Run the_content filter on Boxzilla post content, to enable plugins like Photon.
403 - Ensure content element exists when initialising Boxzilla.
404 - Improvements to licensing related code for [Boxzilla Premium](https://boxzillaplugin.com/pricing/) users.
405
406
407 #### 3.2.2 - March 12, 2018
408
409 **Improvements**
410
411 - Print box contents at an earlier footer hook, so it works with "smart enqueue" methods in other plugins like Mailchimp for WordPress or Maxbuttons.
412
413
414 #### 3.2.1 - March 5, 2018
415
416 **Fixes**
417
418 - Can't use return value in write context error, introduced in v3.2.
419
420
421
422 #### 3.2 - March 5, 2018
423
424 **Fixes**
425
426 - Compatibility with plugins that use JavaScript rendering.
427
428 **Improvements**
429
430 - Skip boxes with empty content.
431
432
433 #### 3.1.23 - December 13, 2017
434
435 **Fixes**
436
437 - Event listener for hyperlinks referencing `#boxzilla-123`. We recommend using `[boxzilla_link]to generate your links though[/boxzilla_link]`. [Here's how that works](https://boxzillaplugin.com/kb/shortcode-boxzilla-link/).
438
439
440 #### 3.1.22 - November 20, 2017
441
442 **Fixes**
443
444 - Showing box by location hash after page load wasn't working.
445
446 **Improvements**
447
448 - Load `<script>` in box content synchronously so libraries get a chance to load before they're used.
449
450
451 #### 3.1.21 - October 10, 2017
452
453 **Fixes**
454
455 - Ensure that administrators can always edit boxes.
456
457
458 #### 3.1.20 - October 9, 2017
459
460 **Fixes**
461
462 - Screen width condition not working when using WordPress in language other than English.
463
464 **Improvements**
465
466 - Use custom capability type so access to Boxzilla boxes can be modified using a role manager plugin.
467
468
469 #### 3.1.19 - September 20, 2017
470
471 **Improvements**
472
473 - Trigger points based on height (scroll %, element) will now be recalculated when the page height changes.
474
475
476 #### 3.1.18 - September 7, 2017
477
478 **Additions**
479
480 - Added [`[boxzilla_link]` shortcode to generate the correct HTML for a link to show/toggle/hide/dismiss a box](https://boxzillaplugin.com/kb/shortcode-boxzilla-link/).
481
482
483 #### 3.1.17 - August 30, 2017
484
485 **Fixes**
486
487 - IE11 issue with scroll triggered pop-ups never showing up.
488
489
490 #### 3.1.16 - August 2, 2017
491
492 **Fixes**
493
494 - JavaScript error when clicking `<a>` elements without `href` attributes.
495
496
497 #### 3.1.15 - July 26, 2017
498
499 **Additions**
500
501 - Added `[boxzilla-close]text here[/boxzilla-close]` shortcode to insert a link to close the box.
502 - Added setting to hide the close icon.
503 - Added setting to hide or show box for logged-in users.
504
505
506 #### 3.1.14 - July 13, 2017
507
508 **Fixes**
509
510 - IE Edge issue with sliding box animation.
511
512 **Improvements**
513
514 - Don't wait for document.ready event to initialise boxes. Fixes issues with plugins not delegaging AJAX event listeners.
515
516
517 #### 3.1.13 - May 11, 2017
518
519 **Improvements**
520
521 - Allow for script resources in Boxzilla box content (instead of just inline script elements).
522 - Reset box content when box is dismissed, eg to stop YouTube video's from playing.
523
524
525 #### 3.1.12 - April 24, 2017
526
527 **Improvements**
528
529 - Update endpoint URL for license API requests.
530
531
532 #### 3.1.11 - March 22, 2017
533
534 **Fixes**
535
536 - `#boxzilla-321` link not working when link has a nested image element.
537
538 **Improvements**
539
540 - Added the option to show on screens smaller than a certain width.
541 - Improved URL matching for "is url" rule.
542
543
544 #### 3.1.10 - March 8, 2017
545
546 **Fixes**
547
548 - Debugging statement that would log to console on every scroll event.
549
550 **Improvements**
551
552 - Reduced overlay click error margin to 40px (instead of % based).
553 - Minor UX improvements for "edit box" screen.
554
555
556 #### 3.1.9 - February 27, 2017
557
558 **Fixes**
559
560 - Compatibility error with PHP 7.1 because of function name with double underscore prefix.
561
562 **Improvements**
563
564 - Removed autofocus when box shows because of mobile browser issues & popping up keyboard.
565
566 **Additions**
567
568 - Added Romanian language files.
569
570
571 #### 3.1.8 - November 8, 2016
572
573 **Fixes**
574
575 - JS error on sites running HTTPS, introduced by v3.1.7.
576
577
578 #### 3.1.7 - November 8, 2016
579
580 **Fixes**
581
582 - Cookie length value was reset on every plugin update.
583 - Scroll to bottom when closing box in MobileSafari browsers.
584
585 **Improvements**
586
587 - Add CSS class to overlay when box is toggled.
588 - Ask for [plugin review](https://wordpress.org/support/plugin/boxzilla/reviews/#new-post) after 2 weeks of usage.
589
590
591 #### 3.1.6 - October 18, 2016
592
593 **Improvements**
594
595 - Failsafe against including the Boxzilla script twice, to prevent duplicate elements.
596
597
598 #### 3.1.5 - September 6, 2016
599
600 **Fixes**
601
602 - Box cookies were being set for _all_ boxes when dismissing a box using the overlay or ESCAPE key.
603 - Auto-close not working since version 3.1.3
604
605 **Improvements**
606
607 - Prevent default click event action when clicking close icon.
608 - Add helper classes for the [Boxzilla - Theme Pack add-on](https://boxzillaplugin.com/add-ons/theme-pack/).
609
610
611 #### 3.1.4 - August 24, 2016
612
613 **Fixes**
614
615 - `Boxzilla.show(123)` no longer working in previous update.
616
617
618 #### 3.1.3 - August 24, 2016
619
620 **Improvements**
621
622 - Don't trigger any new boxes when a box is currently open.
623 - Fail gracefully when not running PHP 5.3 or higher.
624
625
626 #### 3.1.2 - August 2, 2016
627
628 **Fixes**
629
630 - Exit-Intent not working in Safari & Firefox.
631
632
633 #### 3.1.1 - August 1, 2016
634
635 **Fixes**
636
637 - Scroll triggers not working in IE11.
638
639 **Improvements**
640
641 - Allow `<img>` elements inside links that open boxes.
642 - Better page height detection.
643
644
645 #### 3.1 - July 19, 2016
646
647 **Improvements**
648
649 - Completely removed jQuery dependency, resulting in better performance & smoother animations.
650 - Completely removed CSS file dependency.
651 - Box position is now visually hinted in box settings.
652 - Event binding improvements for [Exit Intent detection](https://boxzillaplugin.com/add-ons/exit-intent/).
653
654 **Additions**
655
656 - 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.
657
658
659 #### 3.0.3 - July 5, 2016
660
661 **Improvements**
662
663 - Add `id` attribute to box element.
664 - Automatically fix links in box content that use HTTP when HTTPS is needed.
665 - Restore global jQuery object after running user scripts, to failsafe errors.
666
667 **Additions**
668
669 - When using [Mailchimp for WordPress](https://wordpress.org/plugins/mailchimp-for-wp/) without AJAX, the box will now automatically re-open after reloading the page.
670
671
672 #### 3.0.2 - June 21, 2016
673
674 **Fixes**
675
676 - Box condition "is post" was not working with an empty value.
677
678 **Improvements**
679
680 - Prevent PHP notice when saving box without changing box rules.
681
682 **Additions**
683
684 - Added French translation files, thanks to Benoit Mercusot.
685
686
687 #### 3.0.1 - May 23, 2016
688
689 **Improvements**
690
691 - You can now use `<script>` tags directly in box content (again).
692
693 **Additions**
694
695 - Add "post tag is / is not" loading condition.
696 - Plugin will now show a notice to deactivate old Scroll Triggered Boxes plugin.
697 - Internal changes to dependency container for use in add-on plugins.
698 - Add-on: [Boxzilla Pageviews Trigger](https://boxzillaplugin.com/add-ons/pageviews/).
699 - Add-on: [Boxzilla WooCommerce](https://boxzillaplugin.com/add-ons/woocommerce/)
700
701
702 #### 3.0 - May 11, 2016
703
704 Initial release of [Boxzilla](https://boxzillaplugin.com/), formerly known as [Scroll Triggered Boxes](https://wordpress.org/plugins/scroll-triggered-boxes/).
705
706 If you're upgrading from the old plugin, please check [updating to Boxzilla from Scroll Triggered Boxes](https://boxzillaplugin.com/kb/updating-from-scroll-triggered-boxes/) for a list of changes you should be aware of.
707
708 == Upgrade Notice ==
709
710 = 2.1 =
711
712 Added autocomplete to box filters & minor bux fixes for filter rules.
713