SectionPermissionPlugin

Deny or allow view of sections for specific wiki groups

Description

The plugin allows you to cut out a specific text section for a specific wiki group. By passing a name or name list of wiki groups to the plugin you can define those view rights for this section.

Usage

To define view rights for a section simple surround a section of any size with the following start and stop tag:

%STARTPERMISSION{...}%
  ...any section...
        ...of any size...
%STOPPERMISSION%

Supported parameters:

Parameter:	Value:	Description:
allow	Group name or list of group names (comma separated)	Only (!) that group or grouplist can view the section
deny	Group name or list of group names (comma separated)	That group or group list cannot view the section

You need to define either deny or allow! Both do not work together and will cause no operation.

Note: The admin group will never be affected.

Examples

Only the admin group can see the following section (if the plugin is installed):

%STARTPERMISSION{allow="AdminGroup"}% Foswiki makes my day. %STOPPERMISSION%

Guess it!

Installation Instructions

Visit the Plugin Home for a manually installation:

• Download the ZIP file from the Plugin Home
• Unzip SectionPermissionPlugin.zip in your Foswiki installation directory. Content:

  File:	Description:
  data/System/SectionPermissionPlugin.txt	Plugin topic
  lib/Foswiki/Plugins/SectionPermissionPlugin.pm	Plugin Perl module
  lib/Foswiki/Plugins/SectionPermissionPlugin/Core.pm	Plugin core Perl module

• Run the configure script, and enable the plugin in the {Plugins} section.
• Surround a topic section with %STARTPERMISSION{allow="AdminGroup"}% and %STOPPERMISSION% to test if the installation was successful.

Info

Many thanks to the following sponsors for supporting this work:

FormMed HealthCare AG

Author(s):	Foswiki:Main.SvenHess
Copyright:	© 2009, Foswiki:Main.SvenHess
License:	GPL (Gnu General Public License)
Version:	1.0
Change History:
07 August 2009:	Initial version
Dependencies:	none
Home page:	http://foswiki.org/bin/view/Extensions/SectionPermissionPlugin
Support:	http://foswiki.org/bin/view/Support/SectionPermissionPlugin