PluginProbe
Boxzilla – WordPress Popup Builder / 3.4.3
Boxzilla – WordPress Popup Builder v3.4.3
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.3, at readme.txt

687 lines 18.8 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.8
7 Stable tag: 3.4.3
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://kb.boxzillaplugin.com/).
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.3 - Jun 24, 2025
133
134 - Rebuild client-side assets with latest Browserslist.
135 - Optimize SVG icon for admin menu.
136 - Remove newsletter sign-up section from admin pages.
137
138
139 #### 3.4.2 - Apr 29, 2025
140
141 - Fix HTML showing because of escaped translation text.
142
143
144 ### 3.4.1 - Mar 24, 2025
145
146 - Bump required PHP version to 7.4 or higher.
147 - Initialize boxes at document.DOMContentLoaded instead of window.load event.
148
149
150 #### 3.4.0 - Jan 03, 2025
151
152 - Remove deprecated Bootstrapper class.
153 - Add link to https://my.boxzillaplugin.com when trying to activate an expired license.
154 - Bump tested WordPress version.
155
156
157 #### 3.3.3 - Oct 07, 2024
158
159 - Fix unclosed element on plugins overview page, breaking the table layout.
160 - Bump license to GPL v3 or higher.
161 - Bump required PHP version to 7.2 or higher.
162
163
164 #### 3.3.2 - Oct 02, 2024
165
166 - The Boxzilla script itself is now deferred for improved client-side performance.
167 - You can now use the Boxzilla JS API before the script has fully loaded.
168 - Minor server side performance improvements by getting rid of unnecessary sprintf calls or string copies.
169 - All i18n function call return values are now HTML escaped.
170 - Verify `Jetpack::is_module_active` exists before method is called.
171
172
173 #### 3.3.1 - May 17, 2024
174
175 - Minor performance improvements to plugin bootstrapping and autoloader implementation.
176 - Fix link in license key form.
177 - Move CSS out of JS file for improved parsing performance.
178 - Move to webpack instead of Gulp for preparing client-side asset files.
179 - Bump required PHP version to 7.0 or later.
180
181
182 #### 3.2.27 - Mar 28, 2023
183
184 - Fix scroll based trigger regression introduced in previous version.
185
186
187 #### 3.2.26 - Mar 21, 2023
188
189 - Check if `administrator` role exists before adding capabilities to it. Thanks [Jaime Martínez](https://jaimemartinez.nl/).
190 - Fix "undefined array key href" warning on PHP8.
191 - Fix PHP8.1 deprecation warnings.
192
193
194 #### 3.2.25 - Apr 20, 2021
195
196 - Change usage of deprecated jQuery.load method.
197 - Add `aria-modal="true"` to overlay element.
198
199
200 #### 3.2.24 - Nov 3, 2020
201
202 - Allow for `#boxzilla-ID` links in `<area>` elements.
203 - Show certain settings even if no trigger is chosen.
204 - Only show auto-hide setting if trigger is set to element or percentage (ie trigger condition can revert).
205
206
207 #### 3.2.23 - Jul 13, 2020
208
209 - Add `aria-label` to close icon to help screen readers.
210
211
212 #### 3.2.22 - Mar 19, 2020
213
214 - Minor code improvements
215 - Check if body element exists before updating class attribute, fixes an issue with some page builders.
216
217
218 #### 3.2.21 - Feb 18, 2020
219
220 - "If post category" or "if post tag" conditionals now apply to any post-type using built-in WP categories or tags.
221
222
223 #### 3.2.20 - Jan 20, 2020
224
225 **Fixes**
226
227 - An issue with the "pageviews" trigger on Safari Mobile where session storage is inaccessible in the beforeunload event.
228
229 **Improvements**
230
231 - 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.
232
233
234 #### 3.2.19 - Dec 30, 2019
235
236 **Fixes**
237
238 - Box rules using "contains" would only check first argument (when using comma-separated value).
239
240 **Improvements**
241
242 - Use a dedicated overlay element per box to prevent issues with multiple boxs showing on a page. Thanks Jason Maurer!
243
244
245 #### 3.2.18 - Dec 2, 2019
246
247 **Fixes**
248
249 - Missing quotes in HTML attribute on "edit box" page.
250
251
252 #### 3.2.17 - Nov 18, 2019
253
254 **Fixes**
255
256 - Notices when checking for updating and not having some add-on plugins installed.
257
258
259
260 #### 3.2.16 - Nov 15, 2019
261
262 **Improvements**
263
264 Roll-back a change in version 3.2.15 that caused an issue with Boxzilla Theme Pack and Boxzilla WooCommerce.
265
266 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.
267
268
269 #### 3.2.15 - Nov 6, 2019
270
271 **Improvements**
272
273 - Add proper SVG icon with neutral color for admin menu.
274 - Use Page Visibility API for time-based triggers (time on site & time on page).
275 - Stop using `supress_filters` when retrieving boxes for a possible performance improvement.
276 - Minor performance improvement in bootstrapping logic.
277 - Add link to [Koko Analytics](https://wordpress.org/plugins/koko-analytics/)
278
279
280 #### 3.2.14 - Aug 7, 2019
281
282 **Fixes**
283
284 - Issue with incorrect argument count for some sites with custom menu's.
285
286
287 #### 3.2.13 - Aug 5, 2019
288
289 **Improvements**
290
291 - Allow more query hash parameters for opening a box.
292 - Allow bypassing animation for opening or closing boxes.
293
294 **Additions**
295
296 - Easily link to boxes from WP Menu's.
297
298
299 #### 3.2.12 - June 7, 2019
300
301 **Improvements**
302
303 - Allow skipping animations when showing, hiding or dismissing a box.
304 - Check for empty box content after running filter hooks, instead of before.
305
306
307 #### 3.2.11 - May 8, 2019
308
309 **Improvements**
310
311 - Update loading configuration when duplicating a box.
312 - Accept query parameters in URL hash for opening a box through a link click or on loading a page.
313
314
315 #### 3.2.10 - February 15, 2019
316
317 **Improvements**
318
319 - Better [exit intent detection](https://boxzillaplugin.com/add-ons/exit-intent/) for mobile devices.
320
321 **Additions**
322
323 - New bulk action to quickly duplicate a box with all of its settings.
324
325
326 #### 3.2.9 - December 5, 2018
327
328 **Improvements**
329
330 - Make sure preview updates with correct color values when applying box styles.
331 - Use small margin of error to prevent iOS scroll bounce from closing box again.
332
333
334 #### 3.2.7 - July 31, 2018
335
336 **Fixes**
337
338 - Issue with boxes with only an iframe, image or video and no text not being loaded.
339
340
341 #### 3.2.6 - June 27, 2018
342
343 **Improvements**
344
345 - Show and/or between rules to help clarify rule logic.
346 - Consistent line endings in main plugin file.
347
348
349 #### 3.2.5 - June 6, 2018
350
351 **Fixes**
352
353 - Some JSON encoders would print Boxzilla config as object, resulting in no boxes actually being loaded.
354
355 **Additions**
356
357 - Add "does not contain" qualifier in URL and referrer conditions.
358
359
360
361 #### 3.2.4 - May 31, 2018
362
363 **Fixes**
364
365 - Boxzilla content replicating parts of the page if other plugins "incorrectly" use `the_content` filter.
366
367
368 #### 3.2.3 - May 29, 2018
369
370 **Improvements**
371
372 - Allow "contains" qualifier in URL and referrer conditions.
373 - Include query string in URL conditions.
374 - Use SVG for the menu ico. Thanks [Kurt Zenisek](https://github.com/KZeni)
375 - Added Czech translations. Thanks [Zdenek Petrbok](https://petrbok.cz/)
376 - Run the_content filter on Boxzilla post content, to enable plugins like Photon.
377 - Ensure content element exists when initialising Boxzilla.
378 - Improvements to licensing related code for [Boxzilla Premium](https://boxzillaplugin.com/pricing/) users.
379
380
381 #### 3.2.2 - March 12, 2018
382
383 **Improvements**
384
385 - Print box contents at an earlier footer hook, so it works with "smart enqueue" methods in other plugins like Mailchimp for WordPress or Maxbuttons.
386
387
388 #### 3.2.1 - March 5, 2018
389
390 **Fixes**
391
392 - Can't use return value in write context error, introduced in v3.2.
393
394
395
396 #### 3.2 - March 5, 2018
397
398 **Fixes**
399
400 - Compatibility with plugins that use JavaScript rendering.
401
402 **Improvements**
403
404 - Skip boxes with empty content.
405
406
407 #### 3.1.23 - December 13, 2017
408
409 **Fixes**
410
411 - 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://kb.boxzillaplugin.com/shortcode-boxzilla-link/).
412
413
414 #### 3.1.22 - November 20, 2017
415
416 **Fixes**
417
418 - Showing box by location hash after page load wasn't working.
419
420 **Improvements**
421
422 - Load `<script>` in box content synchronously so libraries get a chance to load before they're used.
423
424
425 #### 3.1.21 - October 10, 2017
426
427 **Fixes**
428
429 - Ensure that administrators can always edit boxes.
430
431
432 #### 3.1.20 - October 9, 2017
433
434 **Fixes**
435
436 - Screen width condition not working when using WordPress in language other than English.
437
438 **Improvements**
439
440 - Use custom capability type so access to Boxzilla boxes can be modified using a role manager plugin.
441
442
443 #### 3.1.19 - September 20, 2017
444
445 **Improvements**
446
447 - Trigger points based on height (scroll %, element) will now be recalculated when the page height changes.
448
449
450 #### 3.1.18 - September 7, 2017
451
452 **Additions**
453
454 - Added [`[boxzilla_link]` shortcode to generate the correct HTML for a link to show/toggle/hide/dismiss a box](https://kb.boxzillaplugin.com/shortcode-boxzilla-link/).
455
456
457 #### 3.1.17 - August 30, 2017
458
459 **Fixes**
460
461 - IE11 issue with scroll triggered pop-ups never showing up.
462
463
464 #### 3.1.16 - August 2, 2017
465
466 **Fixes**
467
468 - JavaScript error when clicking `<a>` elements without `href` attributes.
469
470
471 #### 3.1.15 - July 26, 2017
472
473 **Additions**
474
475 - Added `[boxzilla-close]text here[/boxzilla-close]` shortcode to insert a link to close the box.
476 - Added setting to hide the close icon.
477 - Added setting to hide or show box for logged-in users.
478
479
480 #### 3.1.14 - July 13, 2017
481
482 **Fixes**
483
484 - IE Edge issue with sliding box animation.
485
486 **Improvements**
487
488 - Don't wait for document.ready event to initialise boxes. Fixes issues with plugins not delegaging AJAX event listeners.
489
490
491 #### 3.1.13 - May 11, 2017
492
493 **Improvements**
494
495 - Allow for script resources in Boxzilla box content (instead of just inline script elements).
496 - Reset box content when box is dismissed, eg to stop YouTube video's from playing.
497
498
499 #### 3.1.12 - April 24, 2017
500
501 **Improvements**
502
503 - Update endpoint URL for license API requests.
504
505
506 #### 3.1.11 - March 22, 2017
507
508 **Fixes**
509
510 - `#boxzilla-321` link not working when link has a nested image element.
511
512 **Improvements**
513
514 - Added the option to show on screens smaller than a certain width.
515 - Improved URL matching for "is url" rule.
516
517
518 #### 3.1.10 - March 8, 2017
519
520 **Fixes**
521
522 - Debugging statement that would log to console on every scroll event.
523
524 **Improvements**
525
526 - Reduced overlay click error margin to 40px (instead of % based).
527 - Minor UX improvements for "edit box" screen.
528
529
530 #### 3.1.9 - February 27, 2017
531
532 **Fixes**
533
534 - Compatibility error with PHP 7.1 because of function name with double underscore prefix.
535
536 **Improvements**
537
538 - Removed autofocus when box shows because of mobile browser issues & popping up keyboard.
539
540 **Additions**
541
542 - Added Romanian language files.
543
544
545 #### 3.1.8 - November 8, 2016
546
547 **Fixes**
548
549 - JS error on sites running HTTPS, introduced by v3.1.7.
550
551
552 #### 3.1.7 - November 8, 2016
553
554 **Fixes**
555
556 - Cookie length value was reset on every plugin update.
557 - Scroll to bottom when closing box in MobileSafari browsers.
558
559 **Improvements**
560
561 - Add CSS class to overlay when box is toggled.
562 - Ask for [plugin review](https://wordpress.org/support/plugin/boxzilla/reviews/#new-post) after 2 weeks of usage.
563
564
565 #### 3.1.6 - October 18, 2016
566
567 **Improvements**
568
569 - Failsafe against including the Boxzilla script twice, to prevent duplicate elements.
570
571
572 #### 3.1.5 - September 6, 2016
573
574 **Fixes**
575
576 - Box cookies were being set for _all_ boxes when dismissing a box using the overlay or ESCAPE key.
577 - Auto-close not working since version 3.1.3
578
579 **Improvements**
580
581 - Prevent default click event action when clicking close icon.
582 - Add helper classes for the [Boxzilla - Theme Pack add-on](https://boxzillaplugin.com/add-ons/theme-pack/).
583
584
585 #### 3.1.4 - August 24, 2016
586
587 **Fixes**
588
589 - `Boxzilla.show(123)` no longer working in previous update.
590
591
592 #### 3.1.3 - August 24, 2016
593
594 **Improvements**
595
596 - Don't trigger any new boxes when a box is currently open.
597 - Fail gracefully when not running PHP 5.3 or higher.
598
599
600 #### 3.1.2 - August 2, 2016
601
602 **Fixes**
603
604 - Exit-Intent not working in Safari & Firefox.
605
606
607 #### 3.1.1 - August 1, 2016
608
609 **Fixes**
610
611 - Scroll triggers not working in IE11.
612
613 **Improvements**
614
615 - Allow `<img>` elements inside links that open boxes.
616 - Better page height detection.
617
618
619 #### 3.1 - July 19, 2016
620
621 **Improvements**
622
623 - Completely removed jQuery dependency, resulting in better performance & smoother animations.
624 - Completely removed CSS file dependency.
625 - Box position is now visually hinted in box settings.
626 - Event binding improvements for [Exit Intent detection](https://boxzillaplugin.com/add-ons/exit-intent/).
627
628 **Additions**
629
630 - 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.
631
632
633 #### 3.0.3 - July 5, 2016
634
635 **Improvements**
636
637 - Add `id` attribute to box element.
638 - Automatically fix links in box content that use HTTP when HTTPS is needed.
639 - Restore global jQuery object after running user scripts, to failsafe errors.
640
641 **Additions**
642
643 - 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.
644
645
646 #### 3.0.2 - June 21, 2016
647
648 **Fixes**
649
650 - Box condition "is post" was not working with an empty value.
651
652 **Improvements**
653
654 - Prevent PHP notice when saving box without changing box rules.
655
656 **Additions**
657
658 - Added French translation files, thanks to Benoit Mercusot.
659
660
661 #### 3.0.1 - May 23, 2016
662
663 **Improvements**
664
665 - You can now use `<script>` tags directly in box content (again).
666
667 **Additions**
668
669 - Add "post tag is / is not" loading condition.
670 - Plugin will now show a notice to deactivate old Scroll Triggered Boxes plugin.
671 - Internal changes to dependency container for use in add-on plugins.
672 - Add-on: [Boxzilla Pageviews Trigger](https://boxzillaplugin.com/add-ons/pageviews/).
673 - Add-on: [Boxzilla WooCommerce](https://boxzillaplugin.com/add-ons/woocommerce/)
674
675
676 #### 3.0 - May 11, 2016
677
678 Initial release of [Boxzilla](https://boxzillaplugin.com/), formerly known as [Scroll Triggered Boxes](https://wordpress.org/plugins/scroll-triggered-boxes/).
679
680 If you're upgrading from the old plugin, please check [updating to Boxzilla from Scroll Triggered Boxes](https://kb.boxzillaplugin.com/updating-from-scroll-triggered-boxes/) for a list of changes you should be aware of.
681
682 == Upgrade Notice ==
683
684 = 2.1 =
685
686 Added autocomplete to box filters & minor bux fixes for filter rules.
687