Title: mmbrs
Author: benwills
Published: <strong>2014-يىلى 2-ئۆكتەبىر</strong>
Last modified: 2014-يىلى 2-ئۆكتەبىر

---

قىستۇرما ئىزدە

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/mmbrs.svg)

# mmbrs

 يازغۇچى [benwills](https://profiles.wordpress.org/benwills/)

[چۈشۈر](https://downloads.wordpress.org/plugin/mmbrs.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/mmbrs/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/mmbrs/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/mmbrs/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/mmbrs/#developers)

 [قوللاش](https://wordpress.org/support/plugin/mmbrs/)

## چۈشەندۈرۈش

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.

### What makes mmbrs different:

 * Restriction based on role, capability, user meta, and logged-in status is
    all
   in one place.
 * 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._
 * You can pass multiple variables to the roles and capabilities shortcodes.
    For
   example, _Show this content to users who are subscribers, contributors, or editors.
 * 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.
 * 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.

### The four mmbrs shortcodes are:

 * [mmbrs_logged_in]
 * [mmbrs_roles]
 * [mmbrs_capabilities]
 * [mmbrs_user_meta]

### [mmbrs_logged_in]

> [mmbrs_logged_in]Content.[/mmbrs_logged_in]

 * _Attribute: none_
    - Shows content to logged in users.

> [mmbrs_logged_in is=’not‹]Content.[/mmbrs_logged_in]

 * Attribute: is
    - Optional.
    - **is** only accepts **not**.
    - Shows content to logged out users.
    - Case insensitive.

> [mmbrs_logged_in showinfeed=’yes‹]Content.[/mmbrs_logged_in]

 * Attribute: showinfeed
    - Optional.
    - **showinfeed** only accepts **yes**.
    - 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.)
    - Case insensitive.

### [mmbrs_roles]

> [mmbrs_roles]Content.[/mmbrs_roles]

 * Attribute: none
    - Returns nothing.

> [mmbrs_roles equals=’subscriber‹]Content.[/mmbrs_roles]

 * Attribute: equals
    - Required.
    - Accepts multiple. e.g. equals=’subscriber,contributor‹
    - Shows content to users with the ›subscriber‹ role.
    - Case sensitive.

> [mmbrs_roles is=’not‹ equals=’subscriber‹]Content.[/mmbrs_roles]

 * Attribute: is
    - Optional.
    - Shows content to users who do not have the ›subscriber‹ role.
    - **is** only accepts **not**.
    - Case insensitive.

> [mmbrs_roles showinfeed=’yes‹]Content.[/mmbrs_roles]

 * Attribute: showinfeed
    - Optional.
    - 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.)
    - **showinfeed** only accepts **yes**.
    - Case insensitive.

### [mmbrs_capabilities]

> [mmbrs_capabilities]Content.[/mmbrs_capabilities]

 * Attribute: none
    - Returns nothing.

> [mmbrs_capabilities can=’delete_others_posts‹]Content.[/mmbrs_capabilities]

 * Attribute: can
    - Required.
    - Shows content to users with the ›delete_others_posts‹ capability.
    - Accepts multiple. e.g. **can=’delete_others_posts,edit_others_posts‹**
    - Case sensitive.

> [mmbrs_capabilities is=’not‹ can=’delete_others_posts‹]Content.[/mmbrs_capabilities]

 * Attribute: is
    - Optional.
    - Shows content to users who do not have the ›delete_others_posts‹ capability.
    - **is** only accepts **not**.
    - Case insensitive.

> [mmbrs_capabilities showinfeed=’yes‹]Content.[/mmbrs_capabilities]

 * Attribute: showinfeed
    - Optional.
    - 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.)
    - **showinfeed** only accepts **yes**.
    - Case insensitive.

### [mmbrs_user_meta]

> [mmbrs_user_meta]Content.[/mmbrs_user_meta]

 * Attribute: none
    - Returns nothing.

> [mmbrs_user_meta key=’first_name‹][/mmbrs_user_meta]

 * Attribute: key (with no content)
    - Required. (**key** attribute is required. Content is not required.)
    - Shows a logged-in user’s **first_name** meta value.
    - Does NOT accept multiple values when content is null/empty.
    - Case sensitive.

> [mmbrs_user_meta key=’first_name‹]Content.[/mmbrs_user_meta]

 * Attribute: key (with content)
    - Required. (**key** attribute is required. Content is not required.)
    - Shows content to logged-in user with the **first_name** meta value.
    - Accepts multiple as OR. e.g. **key=’first_name,last_name‹**
    - Case sensitive.

> [mmbrs_user_meta is=’not‹ key=’first_name‹]Content.[/mmbrs_user_meta]

 * Attribute: is
    - Optional.
    - Shows content to users who do not have the **first_name** meta value.
    - **is** only accepts **not**.
    - Case insensitive.

> [mmbrs_user_meta is=’not‹ key=’first_name‹ equals=’Ben‹]Content.[/mmbrs_user_meta]

 * Attribute: equals
    - Required.
    - Shows content to users who do not have the **first_name** user meta of ›Ben‹.
    - Case sensitive.

> [mmbrs_user_meta showinfeed=’yes‹]Content.[/mmbrs_user_meta]

 * Attribute: showinfeed
    - Optional.
    - 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.)
    - **showinfeed** only accepts ›yes‹.
    - Case insensitive.

#### Other Notes:

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.

#### Motivation for this plugin:

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:

 * [WordPress current_user_can() Notes](https://codex.wordpress.org/Function_Reference/current_user_can#Notes)

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.

#### Inspiration and Credits:

 * [Members Plugin](https://wordpress.org/plugins/members/)
 * [User Meta Shortcodes Plugin](https://wordpress.org/plugins/user-meta-shortcodes/)
 * [AppThemes User Role Function](http://docs.appthemes.com/tutorials/wordpress-check-user-role-function/)

 

## ئورنىتىش

 1. Upload **plugin-name.php** to the **/wp-content/plugins/** directory
 2. Activate the plugin through the ›Plugins‹ menu in WordPress

## FAQ

None. Yet.

## باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

## تۆھپىكار ۋە ئىجادكار

«mmbrs» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.

تۆھپىكار

 *   [ benwills ](https://profiles.wordpress.org/benwills/)

[«mmbrs» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/mmbrs)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/mmbrs/)، [SVN خەزىنە](https://plugins.svn.wordpress.org/mmbrs/)
تەكشۈرۈپ ياكى [RSS](https://plugins.trac.wordpress.org/log/mmbrs/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/mmbrs/)گە مۇشتەرى
بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 1.0

 * 2014.10.01
 * Released

## Meta

 *  Version **1.0**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **12 يىل بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10+**
 *  WordPress نەشرى ** 3.3 ياكى يۇقىرى **
 *  **4.0.38** دا سىنالغان
 *  تىل
 * [English (US)](https://wordpress.org/plugins/mmbrs/)
 * بەلگە
 * [access](https://ug.wordpress.org/plugins/tags/access/)[capabilities](https://ug.wordpress.org/plugins/tags/capabilities/)
   [capability](https://ug.wordpress.org/plugins/tags/capability/)[content access](https://ug.wordpress.org/plugins/tags/content-access/)
   [member](https://ug.wordpress.org/plugins/tags/member/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/mmbrs/advanced/)

## دەرىجە

 5/5 يۇلتۇز

 *  [  1 5-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/mmbrs/reviews/?filter=5)
 *  [  0 4-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/mmbrs/reviews/?filter=4)
 *  [  0 3-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/mmbrs/reviews/?filter=3)
 *  [  0 2-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/mmbrs/reviews/?filter=2)
 *  [  0 1-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/mmbrs/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/mmbrs/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/mmbrs/reviews/)

## تۆھپىكار

 *   [ benwills ](https://profiles.wordpress.org/benwills/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/mmbrs/)

## ئىئانە

بۇ قىستۇرمىنىڭ ياخشىلىنىشىنى قوللامسىز؟

 [ بۇ قىستۇرمىغا ئىئانە قىلىش ](http://compassionate.co/)