Differences

This shows you the differences between two versions of the page.

--- plugin:virtualgroup [2010-07-05 16:26] – [virtualgroup plugin] andi
+++ plugin:virtualgroup [2024-01-07 13:51] (current) – Aleksandr
@@ Line 1: / Line 1: @@
-====== virtualgroup plugin ======
+====== virtualgroup Plugin ======
-[[http://www.cosmocode.de/en/wiki/dokuwiki/plugins|{{ http://www.cosmocode.de/_media/en/wiki/dokuwiki/cosmologo.png?recache|A CosmoCode Plugin}}]]
 ---- plugin ----
@@ Line 8: / Line 6: @@
 email      : dokuwiki@cosmocode.de
 type       : action, admin
-lastupdate : 2010-01-15
+lastupdate : 2023-12-13
-compatible : 2009-08-01
+compatible : Frusterick Manners, Greebo, Hogfather
 depends    :
 conflicts  :
 similar    :
-tags       : group
+tags       : groups, acl, users
-downloadurl: http://github.com/cosmocode/virtualgroup/zipball/master
+downloadurl: https://github.com/cosmocode/virtualgroup/zipball/master
-bugtracker : http://github.com/cosmocode/virtualgroup/issues
+bugtracker : https://github.com/cosmocode/virtualgroup/issues
-sourcerepo : http://github.com/cosmocode/virtualgroup/
+sourcerepo : https://github.com/cosmocode/virtualgroup/
 donationurl:
 ----
@@ Line 23: / Line 21: @@
 ===== Download and Installation =====
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. Refer to [[:Plugins]] on how to install plugins manually.
+[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
-  * http://github.com/cosmocode/virtualgroup/zipball/master
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Usage =====
-You simple can browse to the admin menu, click on the ''virtual groups'' button and can edit memberships of groups.
+You can simply browse to the admin menu, click on the ''virtual groups'' button and can edit memberships of groups.
+What is this plugin for? Imagine the following:
+  * Your authentication backend doesn't allow group changes for your wiki or it just doesn't have group support.
+    * Adding every single user isn't really very nice.
+  * Use this plugin and set groups to the users. The groups are only stored in the wiki.
+    * You can then use the new groups from this plugin in the ACL manager to set permissions.
+Group Names defined in the plugin should not start with "@" (e.g. ''myusergroup'') but must be prefixed with "@" when referenced in the ACL manager (''@myusergroup'').
+===== Limitations =====
+As [[https://github.com/cosmocode/virtualgroup/issues/17#issuecomment-163987101|noted in a comment on a GitHub issue]], this plugin does not affect ACL checks in general. Therefore, **you cannot use virtual groups for XMLRPC API authentication**.
+Virtual groups also only work for certain config settings:
+  * [[config:remoteuser]] does **NOT** allow virtual groups
+  * [[config:superuser]] allows virtual groups
+  * [[config:manager]] allows virtual groups
-You may ask "for what is this plugin?" imagine the following:
-  * You have a authentication backend that don't allow group changes for your wiki or just haven't a group support
-    * so you add every single user -> that isn't really nice
-  * so you use this plugin and set groups to the users. The groups are stored only in the wiki.
-    * you can use the new groups from this plugin for the ACL manager to set permissions.