r1 - 08 Sep 2007 - 09:30:24 - TWikiGuestYou are here: TWiki >  TWiki Web > WebPermissionsPlugin

Web Permissions Plugin

View and edit web permissions

This plugin provides a centralised interface to TWiki permissions.

Web permissions are presented as a matrix that has columns of webs and rows of users. For each web, you can control which users can view or change that web. All user webs, every registered user (except admin users), and every group (except admin groups) are shown in the matrix.

To interactivly edit topic permissions, it adds an "Edit topic ACLs" option to the "More Actions" page.

Web Permissions

Viewing Editing
VIEW = CHANGE =
AlbumsSinglesReviewsStatistics
AnnieLennox
BillyBragg
ColinTowns
DavidSoul
EaglesGroup
VIEW = CHANGE =
AlbumsSinglesReviewsStatistics
AnnieLennox?
BillyBragg?
ColinTowns?
DavidSoul?
EaglesGroup?


This control model is very useful in cases such as a web per project environment. In this case you will probably want to give team members change access to the specific projects they are working on. The plugin gives you a simple, one page interface, for handling these permissions.

The plugin tries very hard to keep the permissions specification you started with, though it does move them to METADATA.

Topic Permissions

All Users and Groups

Editors

Viewers

       

THIS PLUGIN REQUIRES TWiki-4.0.0 or later

Syntax Rules

The permissions matrix can be viewed (and edited) by entering %WEBPERMISSIONS% anywhere in a topic. You have to have admin rights (be a member of TWikiAdminGroup) to view/edit the matrix.

The WEBPERMISSIONS TWiki variable accepts the following parameters:

  • webs - a comma-separated list of webs to show. Default is to show all webs.
  • repeatheads - if set to a number, headings will be repeated every this number of rows. This is very useful when you have a lot of users and groups.

If you have a lot of webs, use the following form to select the subset of webs you want to display. If you have admin rights, and the plugin is installed, you will see the matrix below the form:

Select the webs you want to change permissions for from the list below. Ctrl+click and Shift+click work as normal.

VIEW CHANGE
TWiki
AlexUndrus?
AlexanderWilliamson?
AlexeiKlimentov?
AlexiaLeyval?
AndreiGaponenko?
AndrewZahn?
AnyesTaffard?
AtlasAdminGroup?
AtlasUserGroup?
AustinNapier?
TWiki
AyanaHolloway?
BenjemanMeekhof?
BobHealy?
CarlosGamboa?
CharlesWaldman?
ChuckBoeheim?
CraigBlocker?
DantongYu?
DavidMalon?
DavidMorrison?
TWiki
DavidStampf?
DieterBest?
DimitriosKatramatos?
EdwardMoyse?
EnriqueGarcia?
FrankLaue?
FrederickLuehring?
GabrieleCarcassi?
GeorgeRedlinger?
GregCross?
TWiki
HongMa?
HorstSeverini?
HowardGordon?
JackCranshaw?
JasonNielsen?
JasonSmith?
JayPackard?
JerryGieraltowski?
JimShank?
JoeIzen?
TWiki
JohnBrunelle?
JohnDeStefano?
JohnHover?
JosephUrbanski?
JustinRoss?
KamalBenslama?
KarthikArunachalam?
KaushikDe?
KevinBlack?
KristyKallback?
TWiki
KristyKallbackRose?
KrzysztofSliwa?
KyleCranmer?
MarcoMambelli?
MarkSosebee?
MartyDippel?
MaximPotekhin?
MichaelErnst?
NobodyGroup?
OliverBaker?
TWiki
OnCallAccess?
PatrickMcGuigan?
PatrickSkubic?
PavelNevski?
PenkaNovakova?
PeterLoch?
PohsiangChiu?
ProjectAdminGroup?
RandyMelen?
RazvanPopescu?
TWiki
RobertBall?
RobertGardner?
RobertHarrington?
RyanReece?
SarojKandasamy?
SaulYoussef?
SergeyPanitkin?
ShawnMckee?
ShuweiYe?
SiteAdminGroup?
TWiki
SriniRajagopalan?
StephaneWillocq?
StephanieMajewski?
StevenGoldfarb?
StewartCLoken?
SudhamshReddy?
TWiki::User=HASH(0x15ca97ec)
TWiki::User=HASH(0x15cb22b4)
TWiki::User=HASH(0x15cb3438)
TWiki::User=HASH(0x15cb34b0)
TWiki
TWiki::User=HASH(0x15cb87f8)
TWiki::User=HASH(0x15cbb18c)
TWikiAdminGroup?
TWikiGuest?
TadashiMaeno?
TestTwiki?
TomWlodek?
TorreWenaus?
VivekJain?
WeiYang?
TWiki
WenjingWu?
WenshengDeng?
XinZhao?
YeeTingLi?
YingziWu?
YuriSmirnov?
ZhenpingLiu?

Plugin Settings

By default, the plugin only supports VIEW and CHANGE permissions on webs. You can change the set of access modes handled by the plugin by defining a configuration variable (in LocalSite.cfg) to be a comma-separated list of access modes. For example,
$TWiki::cfg{Plugins}{WebPermissionsPlugin}{modes} = 'VIEW,CHANGE,RENAME';
See TWikiAccessControls for more information on what access modes can be used to control.

Plugin Installation Instructions

Note: These instructions are for the TWiki maintainer. No changes to your browser are required. This plugin makes extensive use of new features added to TWiki in the Feb 2006 release. Earlier versions lack all the features described here. Make sure you install using the zip appropriate to your TWiki installation. For best overall performance, please upgrade your TWiki to the latest released version.

  • Download the archive (zip or tgz) from the Plugin web (see below). Contents:
    File: Description:
    lib/TWiki/Plugins/WebPermissionsPlugin.pm  
    lib/TWiki/Plugins/WebPermissionsPlugin/Core.pm  
    data/TWiki/WebPermissionsPlugin.txt  
    pub/TWiki/WebPermissionsPlugin/CHANGE.gif  
    pub/TWiki/WebPermissionsPlugin/VIEW.gif  
    pub/TWiki/WebPermissionsPlugin/uparrow.png  
    pub/TWiki/WebPermissionsPlugin/downarrow.png  
    pub/TWiki/WebPermissionsPlugin/leftarrow.png  
    pub/TWiki/WebPermissionsPlugin/rightarrow.png  
    pub/TWiki/WebPermissionsPlugin/logo.gif  
    pub/TWiki/WebPermissionsPlugin/wikiringlogo20x20.png  
    pub/TWiki/WebPermissionsPlugin/WebPermissionsPlugin.js  
    templates/webpermissionsplugin.topichtml.tmpl  
    templates/webpermissionsplugin.topicjavascript.tmpl  
    templates/oopsmore.webpermissions.tmpl  
    templates/oopsmoretopicacls.tmpl  
    templates/topicacls.tmpl  

  • Unpack the archive in your twiki installation directory.
  • perl WebPermissionsPlugin_installer.pl to automatically check and install other TWiki modules that this module depends on. This script also includes an uninstaller should you ever wish to remove the plugin from your installation.
  • Alternatively, manually make sure the dependencies listed in the table below are resolved.
NameVersionDescription
TWiki::Plugins>=1.10TWiki-4
TWiki::Contrib::FuncUsersContrib>=0Optional, only used for TWiki-4.1.2 and earlier
  • Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.
  • to enable the TOPIC ACLs user interface, add webpermissions to the front of the SKIN setting (eg Set SKIN=webpermissions,pattern)

Plugin Info

Another great TWiki extension from the WikiRing - working together to improve your wiki experience!

Many thanks to the following sponsors for supporting this work:

Plugin Author: TWiki:Main.CrawfordCurrie & TWiki:Main.SvenDowideit, http://wikiring.com
Copyright: © 2006, Evolved Media Network, Spanlink Communications and WikiRing?
License: GPL (GNU General Public License)
Plugin Version: 14788 (08 Sep 2007)
Change History:  
8 Sep 2007 Updated for TWiki-4.2.0
July 2006 add Topic ACLs user interface via More topic actions - SvenDowideit@WikiRing.com
10216 Item2291 Added repeatheads and webs parameters
9048 Item1766 corrected problems with passing incorrect parameters to setACLs and not interpreting values from the form correctly.
8877 Item1701 first release
Dependencies:
NameVersionDescription
TWiki::Plugins>=1.10TWiki-4
TWiki::Contrib::FuncUsersContrib>=0Optional, only used for TWiki-4.1.2 and earlier
Demo Url: http://demo.wikiring.com/twiki/bin/view/Demo/TopicPermissionsDemo
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/WebPermissionsPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/WebPermissionsPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/WebPermissionsPluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

About This Site

Please note that this site is a content mirror of the BNL USATLAS TWiki. To edit the content of this page, click the Edit this page button at the top of the page and log in with your BNL USATLAS account.


Attachments


png wikiringlogo20x20.png (b) | , 31 Dec 1969 - 19:00 |
gif logo.gif (b) | , 31 Dec 1969 - 19:00 |
 
Powered by TWiki
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.WebPermissionsPlugin