Description
This WordPress plugin extends the functionality of both the free and the paid versions of the Beaver Builder Page Builder.
How to use the plugin
To illustrate how the plugin works, let’s suppose that you shall create a row with a message and a button. The row should be visible to each new visitor until she presses the button. When the visitor presses the button, the row will be closed smoothly. The row shall then remain hidden for that particular visitor for a period of time. When the time period is over, the message will be displayed again to the visitor.
Start by creating the row with as you usually do in Beaver Builder’s Page Builder. Add two columns. Put a Text module with the message in the column to the left. Put a Button module in the column to the right. Enter javascript:void(0)
as link in the settings of the button; this prevents the button from doing anything at all.
Next, open the settings page of the row, click on the Advanced tab and scroll down to the Visibility section. Click on the drop-down menu Display. Provided you have installed this plugin, you should now see an option named Row has not been closed
. It means te row will be visible if it has not been closed. Choose that option.
Below the Display drop-down should more settings appear now appear. Fill them out as follows:
- Closing trigger selector: Enter a JQuery selector (or a CSS selector) that targets the button. To assist you, this plugin adds the class
.closing-row
the row, so it is easier to target elements in the row. For this example,.closing-row .fl_button
will do. - Close time: Enter the number of milliseconds the closing animation should take. For a short row, you should probably choose a relative small number, e.g.
500
. For a tall row, you should consider to increase the number to get a smooth transition. - Cookie expiration: Enter the number of days you want the message to be hidden. Enter
0
to just hide it during the current session. to hide it “for ever”, enter a big number, e.g.36525
that corresponds to 100 years. - Cookie domain: Enter the domain of your site. If the home page of your site has the address
https://www.example.com/
, then enterwww.example.com
. If you enter.example.com
(with a dot at the beginning), you allow all subdomains (e.g.dev.example.com
). You can also leave the field completely blank, which all common browsers interpret as the same domain as the visitor are visiting.
Finally, save the row and publish the layout.
Technical description
This plugin prevents Beaver Builder’s page builder to render a row that has the visibility set to Row has not been closed
if the visitors browser are returning a previous set cookie named row_5967cca712431_closed
with 5967cca712431
replaced with the node id of the row.
If rendered, the row is initially hidden by the CSS property display
set to none
. This property will be changed to display the row if the cookie is not set. This last check is carried out by JavaScript.
The reason for this two-step check is caching.
Credits
The plugin uses Scott Hamper’s JavaScript library Cookies.
Screenshots
Installation
Install the plugin the usually way.
FAQ
- Installation Instructions
-
Install the plugin the usually way.
- How can I make a row visible again?
-
When developing your site, you probably want to make a hidden row visible again. To do that, you have to delete the cookie set by this plugin for that row.
The most brutal way is of course to delete all cookies. 🙂 But as a developer you should instead use the web development tool in Firefox or Chrome. Open the tool. In the menubar look for Storage Inspector in Firefox (or just press CTRL + F9) and Application in Chrome. Locate your site’s cookie storage and click on it. You should now see all cookies that your site has put on your computer.
Find a cookie named
row_5967cca712431_closed
where5967cca712431
is replaced with the node id of the closed row. Right-click on it, choose delete and reload the page. The row should now appear again. - Where is the setting page?
-
There is no setting page.
- Does it work with Beaver Builder 1.x and 2.x?
-
Yes! It works both with Beaver Builder 1.x and 2.x.
- Does it work with PowerPack Addon for Beaver Builder?
-
It should, but I have not test it with either the free or paid version of PowerPack Addon for Beaver Builder. If you test, please let me know if it works or not.
- Does it work with Ultimate Addons for Beaver Builder?
-
It should, but I have not test it with either the free or paid version of Ultimate Addons for Beaver Builder. If you test, please let me know if it works or not.
- Does it work with PHP 5?
-
I don’t know. I have not test it with PHP 5. If you test, please let me know if it works or not.
- How can I get help?
-
If you have a questions about the plugin, and cannot find an answer here, start by issues and pull requests. If you still cannot find the answer, feel free to ask in the the plugin’s issue tracker at Github: https://github.com/Kntnt/kntnt-bb-any-term/issues.
- How can I report a bug?
-
If you have found a potential bug, please report it on the plugin’s issue tracker at Github: https://github.com/Kntnt/kntnt-bb-any-term/issues.
- How can I contribute?
-
Contributions to the code or documentation are much appreciated.
If you are unfamiliar with Git, please post it as a new issue on the plugin’s issue tracker at Github: https://github.com/Kntnt/kntnt-bb-any-term/issues.
If you are familiar with Git, please do a pull request.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Kntnt's Row Closer for Beaver Builder Page Builder” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Kntnt's Row Closer for Beaver Builder Page Builder” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
Initial release. Fully functional plugin.