Updating from Scroll Triggered Boxes

Boxzilla comes with quite a few improvements over the old Scroll Triggered Boxes plugin, so it makes sense to update to this new plugin if you have a chance to do so.

Here's just a few of the things which are new:

Options to easily exclude a box from certain pages.
Option to show a box after X seconds on a page.
Boxes are now built in JavaScript entirely, removing clutter from your page's HTML.
Exit-intent trigger option.
Time on site trigger option.

However, in order to be able to offer you these new features we had to change or break a couple of things. Here's what exactly...

Not using any of the advanced stuff Scroll Triggered Boxes offered? You can simply skip ahead and start using the new plugin then.

No more "manual" condition

We removed the manual condition option entirely as this option was asking you to enter code in an input field.

If you want advanced control over where a box should be loaded, please use the boxzilla_load_box and boxzilla_load_box_$box_id filters.

add_filter( 'boxzilla_load_box_50', function() {
	return ! is_page( 'checkout' ) && ! is_user_logged_in();
});

Chances are, the improved targeting system removes the need for this condition entirely.

No more "Manual CSS" option

We removed the option to enter custom CSS in a box settings. We believe you're better off adding CSS to your theme stylesheet or using a plugin like Simple Custom CSS instead.

New filter prefix

If you were using any of the available filter or action hooks in the plugin, please replace stb_ with boxzilla_ to ensure your code keeps on working.

Performing the upgrade

To perform the upgrade, simply take the following steps.

1. Download the Boxzilla plugin from WordPress.org.
2. Activate it.
3. Go through your existing boxes to ensure all your settings transferred over.
4. If you were using any of the features described above, please follow the instructions with each change.

Your existing boxes and their settings will automatically be transferred from the old plugin.