Groups

Groups is a WordPress plugin that provides group-based user membership management, group-based capabilities and content access control. It integrates standard WordPress capabilities and application-specific capabilities along with an extensive API.

Extensions

New Groups Restrict Categories and Groups Import Export.

  • Groups 404 Redirect allows to redirect visits to pages that are protected by Groups.
  • Groups Blog Protect restricts access to blogs based on group membership.
  • Groups File Access Groups File Access is an extension that allows to provide file download links for authorized users. Access to files is restricted to users by their group membership.
  • Groups Forums provides a powerful and yet light-weight forum system for WordPress sites.
  • Groups Gravity Forms allows to add users to groups automatically, based on form submissions.
  • Groups Import Export – An import and export extension for Groups.
  • Groups Jigoshop Groups integration for Jigoshop that supports memberships and subscriptions.
  • Groups Newsletters helps you to communicate efficiently, providing targeted information to groups of recipients through automated campaigns.
  • Groups Notifications allows to send automatic notifications to group members and the site administrator.
  • Groups PayPal – Sell memberships and subscriptions with Groups and PayPal.
  • Groups Restrict Categories features access restrictions for categories, tags and other WordPress taxonomies, including support for custom post types and taxonomies.
  • Groups Restrict Comments Pro This extension for Groups allows to restrict who can post or read comments based on a user鈥檚 group membership.
  • Groups Subscriptions is a subscription framework for Groups.
  • Groups WooCommerce Groups for WooCommerce is a WordPress plugin that allows you to sell memberships.
  • WooCommerce Group Coupons This extension for WooCommerce uses Groups and WordPress roles to limit the validity of coupons.
  • WooCommerce Groups Newsletters The WooCommerce Groups Newsletters extension lets customers subscribe to newsletters at checkout.

Features

User groups

  • Supports an unlimited number of groups
  • Provides a Registered group which is automatically maintained
  • Users can be assigned to any group
  • Users are added automatically to the Registered group

Groups hierarchy

  • Supports group hierarchies with capability inheritance

Group capabilities

  • Integrates standard WordPress capabilities which can be assigned to groups and users
  • Supports custom capabilities: allows to define new capabilities for usage in plugins and web applications
  • Users inherit capabilities of the groups they belong to
  • Groups inherit capabilities of their parent groups

Access control

  • Built-in access control that allows to restrict access to posts, pages and custom content types to specific groups and users only
  • control access to content by groups: shortcodes allow to control who can access content on posts, show parts to members of certain groups or to those who are not members Shortcodes: [groups_member], [groups_non_member]
  • control access to content by capabilities: show (or do not show) content to users who have certain capabilities Shortcodes: [groups_can], [groups_can_not]

Easy user interface

  • integrates nicely with the standard WordPress Users menu
  • provides an intuitive Groups menu
  • conceptually clean views showing the essentials
  • quick filters
  • bulk-actions where needed, for example apply capabilities to groups, bulk-add users to groups, bulk-remove users from groups

Sensible options

  • administrator overrides can be turned off
  • optional tree view for groups can be shown only when needed
  • provides its own set of permissions
  • cleans up after testing with a “delete all plugin data” option

Access Control

Groups defines some capabilities of its own. The groups_read_post capability is used to restrict access to certain posts or pages to groups (and users) with that capability only.

Framework

  • Solid and sound data-model with a complete API that allows developers to create group-oriented web applications and plugins

Multisite

  • All features are supported independently for each blog in multisite installations

Your opinion counts

You & Groups

Beta-testers and developers who need to integrate group-based features in their plugins and web applications: please use it and provide your feedback.

Feedback

Feedback is welcome!

If you need help, have problems, want to leave feedback or want to provide constructive criticism, please do so here at the Groups plugin page.

Please try to solve problems there before you rate this plugin or say it doesn’t work. There goes a lot of work into providing you with free quality plugins! Please appreciate that and help with your feedback. Thanks!

Twitter

Follow me on Twitter for updates on this and other plugins.

Introduction

Content Access Control

Access restrictions on posts

On posts an pages (and custom content types) a new meta box titles Access restrictions appears. By checking Enforce read access, you can restrict access to the post to groups and users who have the groups_read_post capability. You need to assign this capability to a group and make users members of that group to allow them to see those posts.

Content visibility for members and non-members

The [groups_member] and [groups_non_member] shortcodes are used to limit visibility of content to users who are members of a group or users who are not members of a group. Multiple comma-separated groups can be specified.

Example: Limiting visibility of enclosed content to registered users.

[groups_member group="Registered"]

Only registered users can see this text.

[/groups_member]

Content visibility based on capabilities

The [groups_can] and [groups_can_not] shortcodes limit visibility of enclosed content to those users who have the capability or those who do not have it. Multiple capabilities can be given.

Example: Showing enclosed content to users who can edit_posts (standard WordPress capability).

[groups_can capability=”edit_posts”]

You can see this only if you have the edit_posts capability.

[/groups_can]

Integration in the ‘Users’ menu:

Users – group membership is managed from the standard Users admin view. Users are automatically added to the Registered group. You can add multiple users to other groups here and also remove them.

Sections in the ‘Groups’ menu:

Groups

Here you can:

  • add groups
  • remove groups
  • assign capabilities to groups

Capabilities

This is where you add, remove and manage capabilities.

Capabilities can be assigned to groups and users (1). These capabilities include the standard WordPress capabilities but you can also define additional capabilities for your web-application.

Groups defines some capabilities of its own. The groups_read_post capability is used to restrict access to certain posts or pages to groups (and users) with that capability only.

(1) Assigning capabilities to users is not integrated in the user interface yet but can be done through API calls.

Options

Administrator override :

Administrator overrides can be turned off.

Permissions :

For each role these permissions can be set:

  • Access Groups: see information related to Groups.
  • Administer Groups: complete control over everything related to Groups.
  • Administer Groups plugin options: grants access to make changes on the Groups > Options admin section.

Testing the plugin :

A convenient option is provided to delete all data that has been stored by the Groups plugin. This option is useful if you just need to start from fresh after you have been testing the plugin.

Shortcodes

Please visit the documentation page on shortcodes for up-to-date information: Groups Shortcodes

Download

Download the Groups plugin on WordPress.

1,712 Responses to Groups

  1. Andrei G July 7, 2015 at 5:27 pm #

    Hi,

    I am using currently the Groups plugin with a couple of extensions on a private site that requires login to be viewed. I am looking to create two additional sites that will share possibly the same user and user meta database.

    The idea is that some users will have access to one, two or all sites, depending on what Groups they’re assigned to.

    Is this something that is possible with the Groups plugin or how should I go about it?

    Thanks.

    • kento July 8, 2015 at 3:25 pm #

      Hi Andrei,

      Given that we don’t have a RESTful or similar API integrated in Group yet, you’d have to cook your own solution. I’ve heard someone mention shared database tables but am not sure how stable that would be and how much sense that would make for your setup. You could also build some API points yourself so that when site 2 needs to ask about group membership for a user, it would call site 1 and get the required info. Not a simple task but it could be done, I hope that helps somehow.

      Cheers

  2. Jeff July 14, 2015 at 12:37 am #

    I’m using Groups with the WooCommerce extension, and have run into a problem. It’s possible for someone to order membership (which adds them to a special group) and a physical product in the same order. The provisioning system I’m using for physical products puts the order in “pending” state until the order ships, and the user is not added to the members group immediately.

    I have added these users to the group using the bulk edit feature, but am having issues with ONE user. He is able to see the group-restricted forum (bbpress) fine, but unable to see a group-restricted page (it redirects using the Groups 404 Redirect extension). I’ve had him try on his phone and his computer, and in Safari and Firefox with the same results.

    Any suggestions for clearing up this problem?

    • antonio July 14, 2015 at 10:45 am #

      Hi Jeff,
      in Woocommerce->Groups you can select the status needed to add/remove the user to/from a group.
      Regards,
      Antonio B.

  3. Mario August 8, 2015 at 5:36 pm #

    Hello,

    I am looking to restrict access by custom post type. Restricting access on a post-by-post level will soon become difficult to manage.

    Is there a way to easily restrict access to every post created from a specific custom post type? If so, can this be done with a snippet or a plugin/extension that currently exists?

    • antonio August 10, 2015 at 8:28 am #

      Hi Mario,
      you can use this code as reference (you need to change the ‘Premium’ capability and “posts” by your cuatom post type).
      Kind Regards,
      Antonio B.

      • Mario August 10, 2015 at 9:35 pm #

        Antonio, that’s incredible. Thank you so much!

        • antonio August 11, 2015 at 6:41 am #

          Perfect 馃槈

  4. Ryan August 9, 2015 at 12:11 pm #

    Yes.. I have run into an issue with the Groups Plugin and am trying to get assistance…
    I am using a WordPress Theme Called Directory+

    http://preview.ait-themes.com/index.php?bartype=desktop&theme=directory

    This is basically a business directory theme with features built in to add this functionality. Within the WordPress Admin the theme adds a menu item named “Items” which holds the Business Directory Items/Categories/Locations. For some reason, when I enable the Groups Plugin, this entire “Items” menu disappears from the admin menu. This took me awhile to figure out because I have quite a few plugins. By process of elimination, I was able to determine that when I have the Groups Plugin enabled, this “Items” menu item disappears. As soon as I disable the Groups Plugin, this item comes right back!.

    I am trying to setup the site with WooCommerce Subscriptions to manage members of the organization, whom as part of being a member, receive a page within the business directory for their company. When installing WooCommerce Subscriptions, it says that the Groups Plugin is required so I installed it but then my Business Directory (or “Items”) menu disappeared.

    Please provide any assistance you can… many thanks in advance.

    • kento August 11, 2015 at 12:16 pm #

      Hi Ryan,

      If the items menu disappears, then it might by that you have any restriction set on the root menu item? Otherwise this would be a conflict between the theme and Groups. I would first check if you have any restrictions set and maybe you can ask the theme developer for any guidance on how they are creating the menu to see where a possible conflict may arise.

      Cheers

  5. Denis Miller August 10, 2015 at 10:43 pm #

    Hi, there is a bug :(

    I created the MyPage, set group to ‘newgroup’.
    This group was created.

    Than I went to Groups and deleted newgroup.

    MyPage is disappeared. I see number of pages: 8, but actually I can see only 7, without MyPage.

    I disactivated Groups. And MyPage is there again!

    /Denis

    • antonio August 11, 2015 at 7:05 am #

      Hi Denis,
      I tried that and not occurs to me the same. Please be sure you have the lastest versions.
      Kind regards,
      Antonio B.

  6. Denis Miller August 12, 2015 at 8:17 pm #

    one more page-
    https://site/groups/dairy/forum/

    • antonio August 13, 2015 at 8:29 am #

      Hi Denis,
      that’s true, please have a look at this conversation.
      Thanks,
      Antonio B.

  7. Kevin August 18, 2015 at 6:00 pm #

    I’m currently using Groups with bbPress and the plugin limits forums like a charm! My one question though, is there a way I can get topics and replies to adopt the forums group?

    Even though forums are limited topics are still visible by all!

    • kento August 28, 2015 at 6:53 am #

      Hi Kevin,

      bbPress uses three different post types for forums, topics and replies. Groups does not relate these based on the forum and thus the access restrictions don’t apply to the related topics or replies. It should be possible to make that work, but it would require an integration of bbPress with Groups for that purpose.

      Cheers

  8. whoaloic August 26, 2015 at 7:03 am #

    Hello!

    I use your plugin in an extranet website.
    Each member is registered manually with its group capabilities.
    I have a mailchimp account and I would like to use RSS driven campaigns.
    I already have mailchimp lists where subscribers are registered manually (I don’t use a subscription form because I want to control which user is allowed to see specific content).
    I mean that I use
    My idea is to create mailchimp RSS driven campaigns per mailchimp list.
    So each list matches with each group.
    For example, I get posts with restrict access “Premium” (or capability “premium_read”) so I would like the mailchimp list “Premium” would receive a RSS driven campaign of posts with “premium_read” capability.
    Is it possible to set a capability as a feed ?

    Thank you very much for your help.

    • antonio August 27, 2015 at 8:25 am #

      Hi whoaloic,
      with this code, the feed posts are filtered by groups. Maybe it can help you.
      Kind regards,
      Antonio B.

      • Aj August 27, 2015 at 2:52 pm #

        I’m interested in this topic as well, however, my problem doesn’t have to do with the filtering of the results (though I may come across that issue in the future). Right now I’m just having a hard time getting MailChimp (or Campaign Monitor) to be able to see the RSS feed when it’s behind the password protection of Groups (by itthinx).

        Has anyone found a way around that? Currently when I try to setup an RSS driven campaign, it errors out saying the feed is not valid. Presumably this is because it is behind the Groups password protection and there currently is no method that MailChimp or Campaign Monitor provides to authenticate the RSS feed request.

        If anyone has any ideas about how to get around this, I would greatly appreciate it!

        • antonio August 28, 2015 at 10:38 am #

          H Aj,
          really I don’t know how to identificate in RSS.
          You can try to disable Groups, to check if the error is generated by this plugin.
          Regards,
          Antonio B.

  9. Rob August 27, 2015 at 8:26 am #

    I want to use the plugin with Woocommerce.
    Can I use the plugin to let sellers sell products on the shop?
    they need to ask to be able to sell products and the site manager need to approve them.
    (you give support here, on the plugin page on WordPress or other place?)

    • antonio August 27, 2015 at 9:07 am #

      Hi Rob,
      sorry, I think it’s not your plugin, I think that you need Woocommerce Product Vendors plugin.
      Kind regards,
      Antonio B.

  10. Jean August 28, 2015 at 8:57 pm #

    Pre-purchase question:

    I know there is a group hierarchy, but does it work too with the post restrictions where you use the shortcodes to put the restricted content inbetween?

    • kento September 1, 2015 at 4:33 pm #

      Hi Jean,

      For example, assume the groups Basic and Advanced which is a child group of Basic. If you use the shortcode [groups_member group="Basic"]Content for members of the Basic group[/groups_member], then a member of the Advanced group which does not belong to the Basic group, will not see the enclosed content. If you want a member of either Basic or Advanced to see the content, you would use [groups_member group="Basic,Advanced"]Content for members of the Basic or Advanced group[/groups_member].

      Cheers

  11. Marcus August 31, 2015 at 1:34 am #

    Does explicit membership in a sub-group give implied membership to the parent group?

    I ask because I have a parent group with a number of subgroups. I would like some content to be visible to users who have membership in any of the sub-groups. It would be easiest if I could simply query membership in the parent group, rather than in each of the sub-groups. To do that, do I need to explicitly assign the user membership in the parent group AND the sub-group? Or is sub-group membership sufficient that a query on parent group membership will return true even if I haven’t explicitly granted that user membership?

    • kento September 1, 2015 at 4:23 pm #

      Hi Marcus,

      It depends … capabilities are inherited through subgroups (see Groups Hierarchy) so if you have protected a page by using a capability that is assigned to a parent group, then a member of the child group will be able to access it. But not the other way round.

      Cheers

Trackbacks/Pingbacks

  1. Woocommerce Groups by Sales – light | eggemplo | Premium WordPress Plugins - July 2, 2015

    […] Groups by @itthinx (free plugin) […]

  2. Filtering WordPress Feeds | eggemplo | Premium WordPress Plugins - August 27, 2015

    […] you are using Groups by @itthinx and you need to filter the feeds, this code can help you: function my_feed_filter ( […]

Leave a Reply