You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: readme.txt
+21-21Lines changed: 21 additions & 21 deletions
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Show or hide any WordPress block with ease. Schedule when blocks should be visib
15
15
16
16
Effortlessly create dynamic content in WordPress that will increase conversions, enhance the user experience and improve your own workflow.
17
17
18
-
With this **no-code** solution, control which blocks are visible on your website and who can see them. Schedule content to show or hide at a specific time. Display exclusive promotions to your customers or members. Restrict blocks to specific user roles, screen sizes, query strings, ACF fields, WP Fusion tags and more.
18
+
With this **no-code** solution, control which blocks are visible on your website and who can see them. Schedule content to show or hide at a specific time. Display exclusive promotions to your customers or members. Restrict blocks to specific user roles, screen sizes, query strings, ACF fields, WP Fusion tags, and more.
19
19
20
20
Built exclusively for the Block Editor (Gutenberg), Block Visibility is designed to work with **any** WordPress block. This includes blocks natively provided by WordPress, third-party blocks, and even block-based widgets.
21
21
@@ -37,20 +37,20 @@ It takes just **3 simple steps**:
37
37
38
38
=== Free Features ===
39
39
40
-
**Visibility Controls** determine whether a block should be visible to users on the frontend of your website. Free controls include:
40
+
**Visibility Controls** determine whether a block should be visible to users on the front end of your website. Free controls include:
41
41
42
42
* **Hide** blocks from all users.
43
43
* **Schedule** when content should be visible using a start and end date/time.
44
44
* Conditionally display blocks based on **screen size** (Desktop, Tablet, Mobile, and more)
45
45
* Only show blocks to **logged-in** users.
46
46
* Only show blocks to **logged-out** users.
47
-
* Only show blocks to users with **specific roles** (Administrator, Subscriber, Customer, Member etc.)
47
+
* Only show blocks to users with **specific roles** (Administrator, Subscriber, Customer, Member, etc.)
48
48
* Only show blocks to **specific users**. Great for personalization.
49
49
* Show or hide dynamic blocks based on **URL query strings**. Great for marketing campaigns!
50
50
* **Advanced Custom Fields (ACF):** Control the visibility of block content based on [ACF](https://wordpress.org/plugins/advanced-custom-fields/) fields.
51
51
* **WP Fusion:** Combine Block Visibility with the power of [WP Fusion](https://wordpress.org/plugins/wp-fusion-lite/) to conditionally show or hide content based on data from your favorite CRM or marketing automation platform.
52
52
53
-
**PLUS: Powerful Settings** allow you to customize Block Visibility to your needs, or those of your clients.
53
+
**PLUS: Powerful Settings** allow you to customize Block Visibility to your needs or those of your clients.
54
54
55
55
* Globally disable any visibility control.
56
56
* Restrict visibility controls to specific block types.
@@ -68,12 +68,12 @@ Take Block Visibility to the next level with **[Block Visibility Pro](https://ww
68
68
Here’s a look at what's currently included with Pro:
69
69
70
70
* Visibility Presets allow you to control multiple blocks at once. **NEW 🎉**
71
-
* Show or hide blocks based on their **location** and “attributes” of their location (i.e. post type, taxonomy, archive etc.)
71
+
* Show or hide blocks based on their **location** and “attributes” of their location (i.e. post type, taxonomy, archive, etc.)
72
72
* Advanced **day-of-week** and **time-of-day** controls, which include recursion functionality.
73
73
* Display blocks based on the **referral source** (domain/URL) of a website visitor.
74
74
* Support for all post and user **metadata** (custom fields).
75
-
* **WooCommerce** conditional block logic for shopping cart contents, product details, customer metrics and more.
76
-
* **Easy Digital Downloads** conditional block logic for shopping cart contents, customer metrics and more.
75
+
* **WooCommerce** conditional block logic for shopping cart contents, product details, customer metrics, and more.
76
+
* **Easy Digital Downloads** conditional block logic for shopping cart contents, customer metrics, and more.
77
77
* eCommerce rules for when a customer placed their first/last order, or when specific products were purchased. **NEW 🎉**
78
78
* Access to premium email support.
79
79
* More conditions coming soon...
@@ -87,7 +87,7 @@ While there are countless applications for conditional blocks, here are a few ex
87
87
* Use as a content management tool. Hide new blocks while you are working on them but still keep the page published.
88
88
* Temporarily hide seasonal content on your website rather than having to delete it.
89
89
* Schedule time-sensitive promotional content and/or event information to display automatically.
90
-
* Show or hide specific content on desktops, tablets or mobile devices.
90
+
* Show or hide specific content on desktops, tablets, or mobile devices.
91
91
* Restrict content so it’s only visible to your customers, members or subscribers.
92
92
* Display messaging to logged-out users encouraging them to subscribe to your blog.
93
93
* Create unique marketing campaigns using query string parameters to display personalized messaging ([See it in action](https://www.blockvisibilitywp.com?bv_query=example))
@@ -153,8 +153,8 @@ Stay up-to-date on Block Visibility using the links below. The plugin is also be
153
153
== Screenshots ==
154
154
155
155
1. Quickly and easily hide show or hide blocks on your website.
156
-
2. Schedule blocks using start and end date/time settings. The plugin provides complete block scheduling and work with all Gutenberg blocks, including WooCommerce as seen here. The Pro add-on includes day-of-week and time-of-day recursion functionality.
157
-
3. Show or hide block on mobile devices, tables, desktops and more.
156
+
2. Schedule blocks using start and end date/time settings. The plugin provides complete block scheduling and works with all Gutenberg blocks, including WooCommerce as seen here. The Pro add-on includes day-of-week and time-of-day recursion functionality.
157
+
3. Show or hide block on mobile devices, tablets, desktops, and more.
158
158
4. Control who can see each Gutenberg block with user role restrictions. Great for personalization.
159
159
5. Create unique marketing campaigns using query string parameters to display personalized messaging.
160
160
6. Current integrations include Advanced Custom Fields and WP Fusion. Robust eCommerce integrations for WooCommerce and Easy Digital Downloads are available in the Pro add-on.
@@ -164,7 +164,7 @@ Stay up-to-date on Block Visibility using the links below. The plugin is also be
164
164
165
165
== Installation ==
166
166
167
-
1. You have a couple options:
167
+
1. You have a couple of options:
168
168
* Go to Plugins → Add New and search for "Block Visibility". Once found, click "Install".
169
169
* Download Block Visibility from WordPress.org and make sure the folder is zipped. Then upload via Plugins → Add New → Upload.
170
170
2. Activate the plugin through the 'Plugins' menu in WordPress.
@@ -175,22 +175,22 @@ Stay up-to-date on Block Visibility using the links below. The plugin is also be
175
175
== Frequently Asked Questions ==
176
176
177
177
= Who should use Block Visibility? =
178
-
Block Visibility is a powerful, yet simple, plugin that gives marketing agencies, bloggers, eCommerce websites, and small businesses owners the power to conditionally show or hide blocks on their websites. The need to hide Gutenberg blocks varies. Whether you need to restrict content to certain users like members, or launch a promotional campaign at a specific time with block scheduling, the applications are endless.
178
+
Block Visibility is a powerful, yet simple, plugin that gives marketing agencies, bloggers, eCommerce websites, and small businesses owners the power to conditionally show or hide blocks on their websites. The need to hide Gutenberg blocks varies. Whether you need to restrict content to certain users like members or launch a promotional campaign at a specific time with block scheduling, the applications are endless.
179
179
180
180
If you need dynamic content control, i.e. Gutenberg block control, on your WordPress website, then you need Block Visibility.
181
181
182
182
= Is there a pro/premium version of Block Visibility? =
183
183
Absolutely! [Block Visibility Pro](https://www.blockvisibilitywp.com/?bv_query=readme&utm_source=block_visibility&utm_medium=plugin&utm_campaign=readme) available as an optional paid add-on and includes advanced functionality and third-party integrations.
184
184
185
185
= Do conditional visibility controls really work with any block? (i.e. What is Full Control Mode?) =
186
-
Yes! However, not all block types are enabled by default. Controls are only provided to blocks that can be added directly to a page/post by the block inserter. Therefore, some specialized blocks, such as child blocks, are not included by default. An example being the individual Column block that is part of the larger Columns block.
186
+
Yes! However, not all block types are enabled by default. Controls are only provided to blocks that can be added directly to a page/post by the block inserter. Therefore, some specialized blocks, such as child blocks, are not included by default. An example is the individual Column block that is part of the larger Columns block.
187
187
188
188
That said, you can enable Full Control Mode in the plugin settings. This removes all restrictions and adds conditional visibility controls to every block. You probably will not need Full Control Mode in most cases, but it is there if you do!
189
189
190
-
Furthermore, while this plugin was designed to be compatible with all blocks, the WordPress ecosystem is everexpanding. If you find a conflict with a certain block, please let us know in the plugin support forum and we will investigate. We are committed to bringing visibility block controls to **every** Gutenberg block.
190
+
Furthermore, while this plugin was designed to be compatible with all blocks, the WordPress ecosystem is ever-expanding. If you find a conflict with a certain block, please let us know in the plugin support forum and we will investigate. We are committed to bringing visibility block controls to **every** Gutenberg block.
191
191
192
192
= Can Block Visibility be used with any WordPress theme? =
193
-
Yup, this plugin is not themespecific. You just need to be running the latest version of WordPress (5.5+) and be using the Block Editor (Gutenberg). This plugin provides zero functionality to the Classic Editor.
193
+
Yup, this plugin is not theme-specific. You just need to be running the latest version of WordPress (5.5+) and be using the Block Editor (Gutenberg). This plugin provides zero functionality to the Classic Editor.
194
194
195
195
= Will more conditional visibility controls be added in the future? =
196
196
Yes, and if you have a specific idea of what you would like to see, please submit a feature request in the plugin support forum on WordPress.org.
@@ -199,10 +199,10 @@ Yes, and if you have a specific idea of what you would like to see, please submi
199
199
As of version 1.4.0, Block Visibility is supported in the Site Editor, which is provided by Full Site Editing. Note that you will currently need the Gutenberg plugin and a Full Site Editing theme to make use of this functionality. Full Site Editing is still very much in development and you may find bugs or compatibility issues when using this plugin in the Site Editor. If you do, please let us know in the plugin support forum. We are committed to ensuring 100% compatibility by the time Full Site Editing is included in WordPress core.
200
200
201
201
= Does Block Visibility work with Elementor and other page builders? =
202
-
No. Block Visibility was design specifically for the WordPress Block Editor (Gutenberg), and therefore does no work on pages that are controlled by the Elementor editor or another page builder. As long as you are editing native WordPress “block” content, Block Visibility will work.
202
+
No. Block Visibility was designed specifically for the WordPress Block Editor (Gutenberg) and therefore does not work on pages that are controlled by the Elementor editor or another page builder. As long as you are editing native WordPress “block” content, Block Visibility will work.
203
203
204
204
= Is block visibility controlled using CSS? =
205
-
Visibility is controlled primarily on the server, so if a block should be hidden based on the set block controls, it will not even be rendered. This ensures the plugin does not load any additional resources on the frontend of your site, thereby optimizing performance.
205
+
Visibility is controlled primarily on the server, so if a block should be hidden based on the set block controls, it will not even be rendered. This ensures the plugin does not load any additional resources on the front end of your site, thereby optimizing performance.
206
206
207
207
The **one exception** to this is the Screen Size block controls. Visibility by screen size requires the use of CSS, which is loaded to the frontend of your site if, and only if, these controls are enabled. You can opt to disable this CSS and add the necessary yourself. Visit the plugin [Knowledge Base](https://www.blockvisibilitywp.com/knowledge-base/?bv_query=readme&utm_source=block_visibility&utm_medium=plugin&utm_campaign=readme) to learn more.
208
208
@@ -214,7 +214,7 @@ If you run into a block that is not working with the Screen Size control, there
214
214
215
215
== Changelog ==
216
216
217
-
= 2.3.1 - 2022-02-27 =
217
+
= 2.3.1 - 2022-02-28 =
218
218
219
219
**Fixed**
220
220
@@ -254,13 +254,13 @@ If you run into a block that is not working with the Screen Size control, there
254
254
255
255
* Visibility controls and tools (reset controls, help, etc.) have been separated into two different dropdown menus to reduce menu length.
256
256
* Managing visibility controls can now be done using the "eye" icon whereas tools are managed using the vertical dots icon.
257
-
* Minor changes to labeling has been done throughout the plugin to improve clarity.
257
+
* Minor changes to labeling have been done throughout the plugin to improve clarity.
258
258
259
259
**Removed**
260
260
261
261
* Removed all legacy visibility controls deprecated in version 1.6.0.
262
262
* Removed control reset confirmation modal for a smoother user experience.
263
-
* Removed redundant help/reminder text to simplify user interface.
263
+
* Removed redundant help/reminder text to simplify the user interface.
264
264
265
265
= 2.1.2 - 2021-10-06 =
266
266
@@ -271,7 +271,7 @@ If you run into a block that is not working with the Screen Size control, there
271
271
**Fixed**
272
272
273
273
* Fixed bug in the Date & Time control where timezones with +30 minute offsets were not handled properly. Thanks @ashleyzwp for discovering this issue and opening a support ticket!
274
-
* Fixed bug in Query String control that caused a test failure when multiple strings using same query parameter were used. Thanks Lucian for discovering this issue and opening a support ticket!
274
+
* Fixed bug in Query String control that caused a test failure when multiple strings using the same query parameter were used. Thanks Lucian for discovering this issue and opening a support ticket!
275
275
* Fixed conflict with Sensei (and potentially other third-party plugins) caused by the render_block filter returning `null` when a block is hidden. An empty string is now returned instead. Thanks Ted for discovering this issue and opening a support ticket!
276
276
* Fixed bug caused by admin scripts being enqueued during DOING_AJAX. Thanks Ted for discovering this issue and opening a support ticket!
0 commit comments