Kevin Behrens

thomstark

Show or hide any portion of post content based on usernames, user roles, capabilities, custom groups, or logged-in status. Construct shortcodes manually or using a point and click UI.
<h4>Mini Update Log</h4>
<ul>
<li>v1.8.2 compat with WordPress 3.9</li>
<li>
v1.8.1 fixed conflict with the Tabify Edit Screen plugin
</li>
<li>
v1.8 added new shortcode handlers for nesting eyesonly shortcodes. also added body classes for logged-in user roles and logged-in usernames.
</li>
<li>
v1.7.1 fixed bug with TinyMCE button where TinyMCE panel is used outside post/page editor.
</li>
<li>
v1.7 added multisite support for username multiselect; fixed bug with role/level dropdown in non-Mozilla browsers.
</li>
<li>
Lots of new features in v1.6, including smooth integration with Role Scoper and Press Permit, thanks to their author Kevin Behrens, who has also now joined the Eyes Only team. Two makes a team, right?
</li>
<li>
As of v1.5, has compatibility with BuddyPress and BBPress forums in conjunction with the bbPress2 shortcode whitelist plugin by Anton Channing.
</li>
<li>
As of v1.4, includes TinyMCE Shortcode Button with Shortcode Generator Modal, with options to restrict access to the Shortcode Button, and to determine its position on the TinyMCE panel.
</li>
<li>
As of v1.3, includes Options page, with options to restrict access to the Meta Box, and to prevent content being hidden from Administrators.
</li>
<li>
As of v1.2, includes Shortcode Generator Meta Box
</li>
<li>
<a href="https://wordpress.org/plugins/eyes-only-user-access-shortcode/changelog/" title="Right-Click to Open in New Window">See full changelog</a>
</li>
</ul>
<h4>The Shortcode</h4>
[eyesonly] [/eyesonly]
or
[eyesonlier] [/eyesonlier]
or
[eyesonliest] [/eyesonliest]
<ul>
<li>
Required attributes: either logged=”in|out” or level=”anyrole, any_capability” or username=”anyusername” or all three
</li>
<li>
Newly integrated attributes: rs_group=”any_Role_Scoper_group(s)” or pp_group=”any_Permit_Press_group(s)”
</li>
<li>
Optional attribute: hide=”yes”
</li>
</ul>
All shortcodes must include at least one of the three required attributes. In some cases, it makes sense to use all of them together.
<ul>
<li>
The ‘logged’ attribute takes one of two values: ‘in’ or ‘out’
</li>
<li>
The ‘level’ attribute takes any user role (including custom roles) or any capability (including custom capabilities). It can take multiple roles and/or capabilities, separated either by spaces or commas.
</li>
<li>
The ‘username’ attribute takes any userlogin (username), or multiple, separated either by spaces or commas.
</li>
<li>
The ‘rs_group’ and ‘pp_group’ attributes can take comma or space-separated lists just like the ‘level’ and ‘username’ attributes. If you have the latest versions of either Role Scoper or Press Permit activated, you’ll get an extra menu in your shortcode generators to filter your content by those custom user groups. This attribute can also be used in combination with any of the others to fine tune your filtering.
</li>
<li>
The ‘hide’ attribute: By default, the shortcode will show the content only to the users specified by the ‘username’, ‘level’ or ‘logged’ attributes. Adding the ‘hide’ attribute will reverse that, and hide the content from the specified users. To hide content from the specified users, use hide=yes or hide=true.
</li>
</ul>
Any other shortcode can be used inside this shortcode.
<h4>Examples</h4>
<ul>
<li>
[eyesonly level=”administrator, customrole, moderate_comments”] Any kind of content. [/eyesonly] This will show the content only to users with the ‘administrator’ role, the ‘customrole’ role, and the ‘moderate_comments’ capability.
</li>
<li>
[eyesonly hide=”yes” logged=”out” level=”subscriber customrole”] Any kind of content. [/eyesonly] This will hide the content from all logged out users, and from anyone with the roles ‘subscriber’ or ‘customrole’.
</li>
<li>
[eyesonly username=”joebob, billyjean” level=”administrator”] Your content. [/eyesonly] This will show the content to all administrators and to the specific users ‘joebob’ and ‘billyjean,’ whether they’re administrators or not.
</li>
<li>
[eyesonly logged=”in”] Content for logged-in users. [/eyesonly][eyesonly logged=”out”] Content for logged-out users. [/eyesonly] This will show different content in the same location on the page depending on a user’s logged-in or out status.
</li>
<li>
[eyesonly level=”administrator”] Content. [/eyesonly] This will show the content only to administrators.
</li>
<li>
[eyesonly hide=”yes” level=”administrator custom_capability”] Content. [/eyesonly] This will hide the content only from administrators and from any role that has the ‘custom_capability’.
</li>
</ul>
<h4>Eyes Only Nesting</h4>
<ul>
<li>Eyes Only allows for nested user access shortcodes up to three levels deep. Example:</li>
</ul>
[eyesonly level=”administrator, editor, author”] Restricted content. [eyesonlier level=”administrator, editor”] Restricteder content. [eyesonliest level=”administrator”] Restrictedest content. [/eyesonliest] More restricteder content. [/eyesonlier] More restricted content. [/eyesonly]
<ul>
<li>It doesn’t matter which order you use them in, just so long as you keep your nested levels straight. </li>
</ul>
<h4>Requirements</h4>
<ul>
<li>
PHP 5.2+
</li>
<li>
WordPress 3.3+
</li>
</ul>

Eyes Only: User Access Shortcode

The plugin does the job. The authors should update compatibility :-)



Works

Show or hide any portion of post content based on usernames, user roles, capabilities, custom groups, or logged-in status.

Morgan Hvidt

Conditional Blocks is a powerful, no code plugin that allows you to control the visibility of any WordPress blocks within the Block Editor (Gutenberg) using advanced display logic.
Replace multiple plugins with our versatile Conditional Blocks, developed for fast paced freelancers and agencies.
🌏 Get the full overview on <a href="https://conditionalblocks.com/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">conditionalblocks.com</a>
<h3>Create Better Sites with Less Plugins 🤩</h3>
Everything is block in modern WordPress development with Full Site Editing (FSE). In plain words, you apply conditional display logic to everything.
Here’s some example use-cases where Conditional Blocks shines.
<ul>
<li>Dynamic headers, navigation and menus,</li>
<li>Cart Messages</li>
<li>CTA & Marketing sections</li>
<li>Restrict content & Access control</li>
<li>Membership content </li>
<li>Content Control </li>
<li>And much more..</li>
</ul>
<h3>What’s Included in Conditional Blocks FREE</h3>
The free version of Conditional Blocks offers 3 visibility conditions + The Conditions API for creating your own conditions .
<ul>
<li>Lockdown condition: 
Hide blocks from everyone, perfect for preparing new content or working on drafts.</li>
<li>User Status: 
Display content exclusively for logged-in or logged-out users, ideal for membership site content.</li>
<li>Responsive designs: 
Control block visibility on mobile, tablet, and desktop screens for responsive designs. 
You can edit the CSS Breakpoints to match your theme too.</li>
<li>Developer Focused: 
Create <a href="https://conditionalblocks.com/docs/developer/custom-conditions/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Custom Visibility Conditions</a> for WordPress Blocks, such as custom user roles or membership levels. You can easily create your own integrations using code snippets.</li>
</ul>
The free version is limited.
Consider joining our PRO community to create better WordPress sites & support development.
<h3>The Full Toolkit with Conditional Blocks Pro ✨</h3>
Conditional Blocks Pro unlocks the full suite of advanced block visibility conditions and integrations, allowing you to create truly dynamic and personalized user experiences:
🎯 Advanced Audience Targeting (Pro)
<ul>
<li>Geolocation: Target or exclude visitors based on their Country or Continent using their IP address. Ideal for region-specific content, offers, or compliance.</li>
<li>User Role: Precisely control visibility for specific user roles (Admin, Editor, Subscriber, WooCommerce Customer, custom roles, etc.).</li>
<li>Device & Browser: Tailor experiences by showing/hiding blocks based on device type (iPhone, Android, Tablet, Desktop) or browser (Chrome, Firefox, Safari, etc.).</li>
<li>Referrer URL: Display unique content to visitors arriving from specific sources like Google, X/Twitter, or other websites.</li>
</ul>
⚙️ Dynamic & Automated Content (Pro)
<ul>
<li>Scheduling: Automate your content calendar! Display blocks only during specific date ranges, times of day, or days of the week – perfect for sales, events, or timely announcements.</li>
<li>Post Meta & Custom Fields: Leverage your existing data by showing or hiding blocks based on post meta or custom field values (including ACF).</li>
<li>URL Query String: Create dynamic landing pages or respond to campaign parameters by controlling visibility based on URL query strings.</li>
<li>HTTP Cookies: Adapt content based on visitor cookie values for advanced tracking or personalization (Pro).</li>
<li>Content Specificity: Target blocks to specific Post IDs, URL paths, Post Types, Taxonomies (like categories or tags), and even specific Terms.</li>
<li>User Meta: Personalize content based on individual user metadata.</li>
<li>Archive Pages: Show or hide blocks specifically on WordPress archive pages.</li>
</ul>
🔌 Powerful Integrations (Pro)
Integrations are automatically available when the supported plugin is active.
<ul>
<li>Advanced Custom Fields (ACF): Create hyper-personalized experiences by controlling block visibility based on your ACF field values. (<a href="https://conditionalblocks.com/docs/acf/field-value/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>WooCommerce: Boost sales and improve shop UX! Show targeted messages based on cart total, products in cart, purchased products, or customer details. (<a href="https://conditionalblocks.com/docs/woocommerce/products-in-cart/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>Easy Digital Downloads (EDD): Enhance your digital store with conditions based on cart value, purchased products, products in cart, or cart item categories. (<a href="https://conditionalblocks.com/docs/edd/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>Paid Memberships Pro (PMPro): Easily restrict content based on membership levels, status, or specific user field data. (<a href="https://conditionalblocks.com/docs/paid-memberships-pro/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>MetaBox: Control block visibility based on the values stored in your MetaBox custom fields. (<a href="https://conditionalblocks.com/docs/metabox/field-value/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>ProfilePress: Restrict content visibility based on users’ active membership plans in ProfilePress. (<a href="https://conditionalblocks.com/docs/profilepress/active-membership-plans/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>FluentCRM: Control block visibility based on FluentCRM user tags and contact lists. Perfect for targeted email marketing follow-ups. (<a href="https://conditionalblocks.com/docs/fluentcrm/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>WP Fusion: Show or hide content based on WP Fusion tags synced from your CRM, enabling deep CRM-driven personalization. (<a href="https://conditionalblocks.com/docs/wp-fusion/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
<li>GTranslate: Display content conditionally based on the visitor’s selected language in GTranslate. (<a href="https://conditionalblocks.com/docs/gtranslate/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Learn More</a>)</li>
</ul>
🚀 Workflow Boosters (Pro)
<ul>
<li>Condition Presets: Save frequently used condition combinations and reuse them across your site with a single click.</li>
<li>Custom PHP Logic: Implement highly specific or complex visibility rules using your own custom PHP functions.</li>
<li>Combine with AND/OR Logic: Build sophisticated visibility rules by grouping multiple conditions with flexible AND/OR logic.</li>
</ul>
<a href="https://conditionalblocks.com/features/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">See all Conditional Blocks Pro features & integrations</a>
<h3>Advanced Usage</h3>
Managing WordPress content via blocks becomes easier when you know the tips & tricks. You can find more on our <a href="https://conditionalblocks.com/blog/" rel="nofollow ugc">blog</a>.
<h3>Draft content on live pages</h3>
Use the Lockdown condition to create draft blocks inside live content, and simply remove the condition when you’re ready to publish. You don’t have to worry about people seeing the content before it’s complete. Using the Lockdown Condition eliminates need to create a separate draft page.
<h3>Apply Conditions to Groups</h3>
One of our favorite methods of managing WordPress content is to use Group Blocks. If you setup a Group Blocks you can set conditions directly the Group, this means that all nested blocks inside the Group will automatically follow the same visibility conditions.
<h3>Design Patterns</h3>
Yes it’s also possible to pre-make dynamic templates using Conditional Blocks. You’ll have to make use of the WordPress Design Patterns. Simply make a patterns as you’ve also done while applying the visibility rules.
The patterns will be ready and be conditionally displayed when you insert it on a page. We personally use the same method on Synced Patterns too. (Previously known as Reusable Blocks in Gutenberg).
<h3>Restrictive content made easy</h3>
Control access to any block by clicking on it within the Block Editor and using the Condition Builder to add visibility rules. Perfect for members-only content.
<h3>Responsive designs simplified</h3>
Effortlessly adapt your blocks for mobile, tablet, or desktop display, automatically showing or hiding content according to screen sizes.
<h3>LEARN MORE</h3>
<ul>
<li><a href="https://conditionalblocks.com/pricing/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Get Pro</a>: See pricing & go Pro today.</li>
<li><a href="https://conditionalblocks.com/docs/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Documentation</a>: Learn how to set up and use our features.</li>
<li><a href="https://conditionalblocks.com/blog?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Blog</a>: Read our guides and tutorials.</li>
<li><a href="https://conditionalblocks.com/?utm_source=wporg&utm_medium=referral&utm_campaign=readme" rel="nofollow ugc">Website</a>: Find out more about us and the PRO version.</li>
<li><a href="https://twitter.com/ConditionalWP" rel="nofollow ugc">X (Twitter)</a>: Follow us on X.</li>
</ul>
<h3>MORE Block Plugins</h3>
<ul>
<li><a href="https://wordpress.org/plugins/find-my-blocks/" rel="ugc">Find My Blocks</a>: Locate all instances of blocks across your WordPress pages.</li>
</ul>
<h3>Compatibility</h3>
Conditional Blocks works with any theme or plugin that uses the WordPress Block Editor (also known as Gutenberg). Block widget & Full Site Editing (FSE) within themes are also supported.
Tested and compatible with:
<ul>
<li>Stackable Blocks</li>
<li>Spectra Blocks</li>
<li>Atomic Blocks</li>
<li>CoBlocks</li>
<li>Editorskit</li>
<li>WooCommerce Blocks (Product Blocks)</li>
<li>Easy Digital Downloads Blocks</li>
<li>Ultimate Addons for Gutenberg</li>
<li>Otter Blocks & Templates</li>
<li>GenerateBlocks</li>
<li>Kadence Blocks</li>
<li>Kadence Theme</li>
<li>Genesis Blocks</li>
<li>Twenty Twenty-Two theme</li>
<li>Twenty Twenty-Four theme</li>
<li>Wabi theme</li>
<li>Poe theme</li>
<li>WooCommerce Storefront</li>
<li>WordPress Site Editor</li>
<li>Gutenberg</li>
<li>WordPress Site Templates</li>
<li>OllieWP theme</li>
</ul>
For support or help with other plugins, please get in touch.

Conditional Blocks – Advanced Content Visibility Control for WordPress

I don't need this plugin very often (in fact, right now, I'm not sure I'm using it at all on my site) but, when I do, it's a lifesaver.

Really, this kind of functionality should be built into the block editor - until then, this is fantastic.

Simple and effective

Easily show/hide WordPress blocks & widgets with powerful, no-code display logic. Perfect for restricting content. Explore advanced scheduling, Ge …

Eyes Only: User Access Shortcode vs Conditional Blocks – Advanced Content Visibility Control for WordPress