Skip to content
readme.txt 5.84 KiB
Newer Older
John James Jacoby's avatar
John James Jacoby committed
=== WP User Groups ===
Author:            Triple J Software, Inc.
Author URI:        https://jjj.software
John James Jacoby's avatar
John James Jacoby committed
Donate link:       https://buy.stripe.com/7sI3cd2tK1Cy2lydQR
Plugin URI:        https://wordpress.org/plugins/wp-user-groups/
John James Jacoby's avatar
John James Jacoby committed
License URI:       https://www.gnu.org/licenses/gpl-2.0.html
License:           GPLv2 or later
Contributors:      johnjamesjacoby
Tags:              user, profile, group, taxonomy, term
Requires PHP:      7.2
Requires at least: 5.2
Tested up to:      5.8
Stable tag:        2.5.1
John James Jacoby's avatar
John James Jacoby committed

== Description ==

WP User Groups allows users to be categorized using custom taxonomies & terms.

* "Groups" & "Types" are created by default, and can be overridden
* More user group types can be registered with custom arguments
* Edit users and set their relationships
* Bulk edit many users to quickly assign several at once
* Filter the users list to see which users are in what groups
* Not destructive data storage (plugin can be enabled & disabled without damage)
John James Jacoby's avatar
John James Jacoby committed
* Works great with all WP User & Term plugins (see below)
= Recommended Plugins =
If you like this plugin, you'll probably like these!

* [WP User Profiles](https://wordpress.org/plugins/wp-user-profiles/ "A sophisticated way to edit users in WordPress.")
* [WP User Activity](https://wordpress.org/plugins/wp-user-activity/ "The best way to log activity in WordPress.")
* [WP User Avatars](https://wordpress.org/plugins/wp-user-avatars/ "Allow users to upload avatars or choose them from your media library.")
* [WP User Groups](https://wordpress.org/plugins/wp-user-groups/ "Group users together with taxonomies & terms.")
* [WP User Signups](https://wordpress.org/plugins/wp-user-signups/ "The best way to manage user & site sign-ups in WordPress.")
* [WP Term Authors](https://wordpress.org/plugins/wp-term-authors/ "Authors for categories, tags, and other taxonomy terms.")
* [WP Term Colors](https://wordpress.org/plugins/wp-term-colors/ "Pretty colors for categories, tags, and other taxonomy terms.")
* [WP Term Families](https://wordpress.org/plugins/wp-term-families/ "Associate taxonomy terms with other taxonomy terms.")
* [WP Term Icons](https://wordpress.org/plugins/wp-term-icons/ "Pretty icons for categories, tags, and other taxonomy terms.")
* [WP Term Images](https://wordpress.org/plugins/wp-term-images/ "Pretty images for categories, tags, and other taxonomy terms.")
* [WP Term Locks](https://wordpress.org/plugins/wp-term-locks/ "Protect categories, tags, and other taxonomy terms from being edited or deleted.")
* [WP Term Order](https://wordpress.org/plugins/wp-term-order/ "Sort taxonomy terms, your way.")
John James Jacoby's avatar
John James Jacoby committed
* [WP Term Visibility](https://wordpress.org/plugins/wp-term-visibility/ "Visibilities for categories, tags, and other taxonomy terms.")
* [WP Media Categories](https://wordpress.org/plugins/wp-media-categories/ "Add categories to media & attachments.")
* [WP Pretty Filters](https://wordpress.org/plugins/wp-pretty-filters/ "Makes post filters better match what's already in Media & Attachments.")
* [WP Chosen](https://wordpress.org/plugins/wp-chosen/ "Make long, unwieldy select boxes much more user-friendly.")

== Screenshots ==

1. Menu Items
2. Groups Taxonomy
3. Types Taxonomy
4. User Edit & Assignment
5. Users List
6. Users List (Filtered)
John James Jacoby's avatar
John James Jacoby committed
== Installation ==

1. Download and install using the built in WordPress plugin installer.
1. Activate in the "Plugins" area of your admin by clicking the "Activate" link.
1. Visit "Users > Groups" and create some groups
1. Add users to groups by editing their profile and checking the boxes

== Frequently Asked Questions ==

= Does this create new database tables? =

No. There are no new database tables with this plugin.

= Does this modify existing database tables? =

John James Jacoby's avatar
John James Jacoby committed
No. All of the WordPress core database tables remain untouched.
John James Jacoby's avatar
John James Jacoby committed

= Does this plugin integrate with user roles? =

No. This is best left to plugins that choose to integrate with this plugin.

= Where can I get support? =

John James Jacoby's avatar
John James Jacoby committed
* Community: https://wordpress.org/support/plugin/wp-user-groups
* Development: https://github.com/stuttter/wp-user-groups/discussions
John James Jacoby's avatar
John James Jacoby committed

== Changelog ==

= [2.5.1] - 2021/05/29 =
* Update author info
* Add sponsor link

John James Jacoby's avatar
John James Jacoby committed
= [2.5.0] - 2021/03/23 =
* Improve compatibility with WP User Profiles plugin (props John Blackbourn)

John James Jacoby's avatar
John James Jacoby committed
= [2.4.0] - 2018/10/04 =
* Simplify get and set functions for user terms
* Add support for advanced WP_User_Query arguments
* Fix custom column support in user taxonomies

= [2.3.0] - 2018/10/03 =
John James Jacoby's avatar
John James Jacoby committed
* More descriptive text for bulk actions
* Fix bulk actions not working

John James Jacoby's avatar
John James Jacoby committed
= [2.2.0] - 2018/06/05 =
* Add "Managed" taxonomy type, so users cannot assign their own groups

= [2.1.0] - 2018/04/16 =
John James Jacoby's avatar
John James Jacoby committed
* Add a dedicated nonce for each user taxonomy (thanks Tom Adams!)
= [2.0.0] - 2017/10/24 =
* Fix bug with user filtering
* Fix bug with setting user terms
* Add `exclusive` group argument to use radios instead of checkboxes

= [1.1.0] - 2017/03/28 =
* Change default taxonomy to `user-group` in wp_get_users_of_group()

John James Jacoby's avatar
John James Jacoby committed
= [1.0.0] - 2016/12/07 =
* WordPress 4.7 compatibility
* Improved bulk actions (requires WordPress 4.7)
* Official stable release

= [0.2.1] - 2016/05/25 =
John James Jacoby's avatar
John James Jacoby committed
* Fix bug with user list
* Introduce wp_get_users_of_group() helper function
* Add unique class to administration forms

John James Jacoby's avatar
John James Jacoby committed
= [0.2.0] - 2015/12/23 =
John James Jacoby's avatar
John James Jacoby committed
* Support for WP User Profiles 0.2.0

John James Jacoby's avatar
John James Jacoby committed
= [0.1.9] - 2015/12/21 =
* Fix bug with User Profiles integration

John James Jacoby's avatar
John James Jacoby committed
= [0.1.8] - 2015/11/11 =
John James Jacoby's avatar
John James Jacoby committed
* Support for WP User Profiles 0.1.9

John James Jacoby's avatar
John James Jacoby committed
= [0.1.7] - 2015/11/09 =
John James Jacoby's avatar
John James Jacoby committed
* Update assets & meta

John James Jacoby's avatar
John James Jacoby committed
= [0.1.6] - 2015/10/23 =
* Add support for WP User Profiles

John James Jacoby's avatar
John James Jacoby committed
= [0.1.5] - 2015/10/13 =
* Added `user_group` property to taxonomies
* Added functions for retrieving only user-groups from taxonomies global

John James Jacoby's avatar
John James Jacoby committed
= [0.1.0] - 2015/09/10 =
* Refactor
* Improve asset management
* Styling tweaks

John James Jacoby's avatar
John James Jacoby committed
= [0.1.2] - 2015/09/01 =
John James Jacoby's avatar
John James Jacoby committed
* Namespace default taxonomy IDs

John James Jacoby's avatar
John James Jacoby committed
= [0.1.1] - 2015/08/24 =
* User profile UI uses a mock list-table

John James Jacoby's avatar
John James Jacoby committed
= [0.1.0] - 2015/08/19 =
John James Jacoby's avatar
John James Jacoby committed
* Initial release