Andrés Villarreal

Hide This provides a <code>[hide]</code> shortcode that lets you hide some parts of the content from your posts and pages. You can easily manage inclusions and exclusions for hidden content in three levels: absolute, groups and capabilities, and specific user.
Maybe some part of your post should not be published yet? Or maybe you want to show some specific parts of your content to a certain group or users, let’s say your logged in users or your clients? This plugin may be the solution you need.
It’s very important to note that the content wrapped within the shortcode won’t even be printed as HTML. It will be really, really hidden. There are a lot of great plugins that hide the content via CSS and Javascript, but this is not the case. If you want your content to not be visible, but still printed as HTML, you should try one of those.
Basic usage:
<pre><code>[hide]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
This example will hide that content for all the site visitors. But you can be more specific by using attributes.
Accepted attributes:
<ul>
<li>for: (optional) your rules to hide content. You can use absolute rules (<code>all</code>, <code>none</code>, <code>[!]logged</code>), rules by roles and capabilities (<code>[!]{role}</code>, <code>[!]{role}:[!]{capability}</code>, <code>:[!]{capability}</code>), and rules by specific user (<code>userid:[!]{ID}</code>, <code>useremail:[!]{email}</code>, <code>username:[!]{username}</code>).</li>
<li>exclude: (optional) your rules to show the hidden content to some specific visitor/s. As in for, you can use absolute rules (<code>all</code>, <code>none</code>, <code>[!]logged</code>), rules by roles and capabilities (<code>[!]{role}</code>, <code>[!]{role}:[!]{capability}</code>, <code>:[!]{capability}</code>), and rules by specific user (<code>userid:[!]{ID}</code>, <code>useremail:[!]{email}</code>, <code>username:[!]{username}</code>).</li>
<li>test: (optional) for debugging purposes. The kind of output you expect. Accepts <code>content</code> and <code>empty</code>. Use it wisely, because it prints a message with the result of the test.</li>
</ul>
Some useful examples:
Hide your content to all visitors:
<pre><code>[hide]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content to all visitors, except for a specific user:
<pre><code>[hide for="all" exclude="username:foo"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content to all non-logged visitors:
<pre><code>[hide for="!logged"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content to all logged in visitors:
<pre><code>[hide for="logged"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content to all logged in visitors, except for a specific user:
<pre><code>[hide for="logged" exclude="username:foo"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for some specific role:
<pre><code>[hide for="contributor"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for two specific roles:
<pre><code>[hide for="editor, contributor"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for all visitors except for a specific role:
<pre><code>[hide for="!administrator"]Lorem ipsum dolor sit amet.[/hide]
[hide for="all" exclude="administrator"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for all visitors except for two specific roles:
<pre><code>[hide for="!administrator, !editor"]Lorem ipsum dolor sit amet.[/hide]
[hide for="all" exclude="administrator, editor"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for users with a specific role and a specific capability:
<pre><code>[hide for="some_role:do_a_barrel_roll"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for users with a specific role, not having a specific capability:
<pre><code>[hide for="some_role:!do_a_barrel_roll"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for users with a specific capability:
<pre><code>[hide for=":do_a_barrel_roll"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for a specific user by user name:
<pre><code>[hide for="username:foo"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for a specific user by user ID:
<pre><code>[hide for="userid:42"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for a specific user by user email:
<pre><code>[hide for="useremail:foo@mail.com"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
Hide your content for everyone except for a specific user by user name:
<pre><code>[hide for="username:!foo"]Lorem ipsum dolor sit amet.[/hide]
</code></pre>
You should get the idea by now. Notice how you can use <code>!</code> to deny values such as login status, roles, capabilities and user values.
<h4>Extending</h4>
This plugin offers hooks for filters, so you can modify its functionality or add your own.
<ul>
<li><code>hide_this_attributes</code>: Modify the attributes that the shortcode receives.</li>
<li><code>hide_this_content</code>: Modify the full content that the shortcode prints.</li>
<li><code>hide_this_hide_rules</code>: Modify rules for hiding content.</li>
<li><code>hide_this_show_rules</code>: Modify rules for showing content.</li>
</ul>
<h4>Contribute</h4>
You can make suggestions and submit your own modifications to this plugin on <a href="https://github.com/andrezrv/hide-this" rel="nofollow ugc">Github</a>.

Hide This

This plugin provides a shortcode that lets you hide some parts of the content from your posts and pages.

benwills

The mmbrs plugin allows you to restrict content access using shortcodes.
Content may be restricted based on role, capability, user meta, and logged-in status.
<h3>What makes mmbrs different:</h3>
<ul>
<li>Restriction based on role, capability, user meta, and logged-in status is 
all in one place.</li>
<li>You are able to restrict content based on if a user is=’not’. For 
example, Show this content if a user is not an administrator.</li>
<li>You can pass multiple variables to the roles and capabilities shortcodes. 
For example, Show this content to users who are subscribers, 
contributors, or editors.</li>
<li>By default, any content within these four shortcodes is not displayed in 
feeds. You may also set the showinfeed=’yes’ attribute to show the 
content in feeds.</li>
<li>It is as lean as I could get it, with logic ordering to cut down on 
processing. Which isn’t saying much, but if you’ve got suggestions, I’m 
open to hearing them.</li>
</ul>
<h3>The four mmbrs shortcodes are:</h3>
<ul>
<li>[mmbrs_logged_in]</li>
<li>[mmbrs_roles]</li>
<li>[mmbrs_capabilities]</li>
<li>[mmbrs_user_meta]</li>
</ul>
<h3>[mmbrs_logged_in]</h3>
<blockquote>
[mmbrs_logged_in]Content.[/mmbrs_logged_in]
</blockquote>
<ul>
<li>Attribute: none
<ul>
<li>Shows content to logged in users.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_logged_in is=’not’]Content.[/mmbrs_logged_in]
</blockquote>
<ul>
<li>Attribute: is
<ul>
<li>Optional.</li>
<li>is only accepts not.</li>
<li>Shows content to logged out users.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_logged_in showinfeed=’yes’]Content.[/mmbrs_logged_in]
</blockquote>
<ul>
<li>Attribute: showinfeed
<ul>
<li>Optional.</li>
<li>showinfeed only accepts yes.</li>
<li>Shows content in the feed and ignores all other attributes when displaying in the feed. (If it is not being displayed in a feed, all of the attributes take effect.)</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<h3>[mmbrs_roles]</h3>
<blockquote>
[mmbrs_roles]Content.[/mmbrs_roles]
</blockquote>
<ul>
<li>Attribute: none
<ul>
<li>Returns nothing.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_roles equals=’subscriber’]Content.[/mmbrs_roles]
</blockquote>
<ul>
<li>Attribute: equals
<ul>
<li>Required.</li>
<li>Accepts multiple. e.g. equals=’subscriber,contributor’</li>
<li>Shows content to users with the ‘subscriber’ role.</li>
<li>Case sensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_roles is=’not’ equals=’subscriber’]Content.[/mmbrs_roles]
</blockquote>
<ul>
<li>Attribute: is
<ul>
<li>Optional.</li>
<li>Shows content to users who do not have the ‘subscriber’ role.</li>
<li>is only accepts not.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_roles showinfeed=’yes’]Content.[/mmbrs_roles]
</blockquote>
<ul>
<li>Attribute: showinfeed
<ul>
<li>Optional.</li>
<li>Shows content in the feed and ignores all other attributes when displaying in the feed. (If it is not being displayed in a feed, all of the attributes take effect.)</li>
<li>showinfeed only accepts yes.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<h3>[mmbrs_capabilities]</h3>
<blockquote>
[mmbrs_capabilities]Content.[/mmbrs_capabilities]
</blockquote>
<ul>
<li>Attribute: none
<ul>
<li>Returns nothing.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_capabilities can=’delete_others_posts’]Content.[/mmbrs_capabilities]
</blockquote>
<ul>
<li>Attribute: can
<ul>
<li>Required.</li>
<li>Shows content to users with the ‘delete_others_posts’ capability.</li>
<li>Accepts multiple. e.g. can=’delete_others_posts,edit_others_posts’</li>
<li>Case sensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_capabilities is=’not’ can=’delete_others_posts’]Content.[/mmbrs_capabilities]
</blockquote>
<ul>
<li>Attribute: is
<ul>
<li>Optional.</li>
<li>Shows content to users who do not have the ‘delete_others_posts’ capability.</li>
<li>is only accepts not.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_capabilities showinfeed=’yes’]Content.[/mmbrs_capabilities]
</blockquote>
<ul>
<li>Attribute: showinfeed
<ul>
<li>Optional.</li>
<li>Shows content in the feed and ignores all other attributes when displaying in the feed. (If it is not being displayed in a feed, all of the attributes take effect.)</li>
<li>showinfeed only accepts yes.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<h3>[mmbrs_user_meta]</h3>
<blockquote>
[mmbrs_user_meta]Content.[/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: none
<ul>
<li>Returns nothing.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_user_meta key=’first_name’][/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: key (with no content)
<ul>
<li>Required. (key attribute is required. Content is not required.)</li>
<li>Shows a logged-in user’s first_name meta value.</li>
<li>Does NOT accept multiple values when content is null/empty.</li>
<li>Case sensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_user_meta key=’first_name’]Content.[/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: key (with content)
<ul>
<li>Required. (key attribute is required. Content is not required.)</li>
<li>Shows content to logged-in user with the first_name meta value.</li>
<li>Accepts multiple as OR. e.g. key=’first_name,last_name’</li>
<li>Case sensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_user_meta is=’not’ key=’first_name’]Content.[/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: is
<ul>
<li>Optional.</li>
<li>Shows content to users who do not have the first_name meta value.</li>
<li>is only accepts not.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_user_meta is=’not’ key=’first_name’ equals=’Ben’]Content.[/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: equals
<ul>
<li>Required.</li>
<li>Shows content to users who do not have the first_name user meta of ‘Ben’.</li>
<li>Case sensitive.</li>
</ul>
</li>
</ul>
<blockquote>
[mmbrs_user_meta showinfeed=’yes’]Content.[/mmbrs_user_meta]
</blockquote>
<ul>
<li>Attribute: showinfeed
<ul>
<li>Optional.</li>
<li>Shows content in the feed and ignores all other attributes when displaying in the feed. (If it is not being displayed in a feed, all of the attributes take effect.)</li>
<li>showinfeed only accepts ‘yes’.</li>
<li>Case insensitive.</li>
</ul>
</li>
</ul>
<h4>Other Notes:</h4>
For every shortcode, except [mmbrs_logged_in], if a user is not logged in, the shortcode will return nothing. The exception is when using is=’not’ in [mmbrs_logged_in], as in [mmbrs_logged_in is=’not’]Content.[/mmbrs_logged_in]
By default, everything is hidden from feeds unless showinfeed=’yes’ is defined.
<h4>Motivation for this plugin:</h4>
I wrote this plugin to fill some holes, reduce some unnecessary functions, and fix some minor bugs I found in other plugins. I now use this, and only this, to control all shortcode-based content access on my membership-style websites.
The Members plugin checks roles by checking capabilities. You are not supposed to do that. The proper way of checking roles is included here. Notes on this:
<ul>
<li><a href="https://codex.wordpress.org/Function_Reference/current_user_can#Notes" rel="nofollow ugc">WordPress current_user_can() Notes</a></li>
</ul>
Aside from that, I love and use the Members plugin and suggest you check it out for other role- and capability-based content access management.
I removed a bunch of stuff from the User Meta Shortcodes plugin that I didn’t want. If you want the additional functionality, I recommend that plugin.
In the end, I wanted very clear control of in-post content via shortcodes. I wasn’t finding anything that was totally stripped down. So I wrote this.
<h4>Inspiration and Credits:</h4>
<ul>
<li><a href="https://wordpress.org/plugins/members/" rel="ugc">Members Plugin</a></li>
<li><a href="https://wordpress.org/plugins/user-meta-shortcodes/" rel="ugc">User Meta Shortcodes Plugin</a></li>
<li><a href="http://docs.appthemes.com/tutorials/wordpress-check-user-role-function/" rel="nofollow ugc">AppThemes User Role Function</a></li>
</ul>

mmbrs

Restrict content access using shortcodes; based on roles, capabilities, user meta, and logged in status.

Hide This vs mmbrs