Control Overview
The WP Fusion control was built specifically for WP Fusion users and works with both the Lite and paid versions of the plugin. Combining Block Visibility with the power of WP Fusion allows you to conditionally show or hide content based on data from your favorite CRM or marketing automation platform. Not a WP Fusion user? Check out their website to learn more.
This functionality is freely available in the core Block Visibility plugin, which is available on WordPress.org.
Configuration
How to Enable
Begin by installing and activating the WP Fusion plugin. The control will not be available if the plugin is inactive.
Click on any block in the Block Editor and navigate to the Visibility panel. You will notice an ellipsis icon in the Controls Toolbar. See the screenshot below. Click on the ellipsis, and all the available controls will appear. Select “WP Fusion” and the WP Fusion control panel will be added to the block.
While you are at it, make sure the User Role control is also active. The WP Fusion control relies heavily on user roles.
How to Configure
Instructions are always better with examples. Let’s assume you are running a website that offers courses and uses LifterLMS. You have connected WP Fusion to your LMS, and one of the available tags is “Course Complete”. You want to set up a banner that celebrates users that have completed the course.
Steps to Complete
- Navigate to the WP Fusion control settings in the Visibility panel.
- Navigate to the Required Tags (Any) selector.
- Choose the “Course Complete” tag.
The resulting configuration should resemble the screenshot below.
Note that the available fields depend on the User Role control settings. If the User Role control is disabled or is set to Public, only the Required Tags (Not) field will be available. See the screenshot below.
If the User Role control is set to Logged-out, all WP Fusion fields will be disabled. This indicates that the block should only be shown to guests on your website, and logged-out users cannot have any tags.
How to Disable
If you would like to disable the WP Fusion control at the block level, simply click on the ellipsis icon in the “Controls” toolbar and deselect it. The control can also be disabled globally in the plugin’s Visibility Control Settings.
Note that if this control is disabled globally or the WP Fusion plugin is deactivated, any blocks that are actively being hidden by the WP Fusion control will become visible again.
Control Settings
Below are the settings available for the WP Fusion control. As a reminder, to use the Required Tags (Any) or the Required Tags (All) fields, you will need to set the User Role control to Logged-in or User Roles. Below is an overview of how each field works.
Required Tags (Any)
The block will only be shown if the user is logged in and has at least one of the selected tags. This field is disabled if the User Role control is set to Public, Logged-out, or disabled.
Required Tags (All)
The block will only be shown if the user is logged in and, at a minimum, has all of the selected tags. They could have more. This field is disabled if the User Role control is set to Public, Logged-out, or disabled.
Required Tags (Not)
The block will be hidden from logged-in users if they have at least one of the selected tags. If the User Role control is set to Public or is disabled, the block will still display to logged-out users. This field is disabled if the User Role control is set to Logged-out.
Important Notes
The WP Fusion control respects the “Exclude Administrators” setting in the WP Fusion plugin settings. If this setting is enabled, when you preview the selected block while logged in as an Administrator, the content will remain visible regardless of the WP Fusion visibility control settings.