Extension:Prefix Security/ReadMe.txt

==========================================
       PREFIX SECURITY EXNTENSIONS
==========================================

        Version 1.2.0
        Author Borut Tomažin (debijan@gmail.com)
        Url http://www.mediawiki.org/wiki/Extension:Prefix_Security
        Copyright Copyright © 2008, Borut Tomažin
        License http://www.gnu.org/copyleft/gpl.html GNU General Public Licence 2.0 or later


== Overview ==

        1. Introduction
        2. Installation requirements
        3. Installing the extension
        4. Change log


== 1. Introduction ==

GroupsAdministration extension is a generic extension for managing user groups. Any user
can be added or removed from specified group.

PrefixAdministration extension is advanced extension where page prefixes can be
defined. 

        Example: pagename=Main_page, pageprefix=Main

When page prefix is defined nothing is really done with security because there
is no user or group defined for this prefix. After user or group is added to
specified page prefix then read & edit permission can be set. 
If user is not allowed to edit then edit page will be unavailable.
If user is not allowed to read then will be promted for login or the page could not be seen.


== 2. Installation requirements ==

This extension requires hooks present in MediaWiki 1.6.5 and later.


== 3. Installing the extension ==

To install the GroupsAdministration & PrefixAdministration prefixes extensions, 
first copy/upload following files into your MediaWiki extensions directory:
        
        Installation.php
        GroupsAdministration.php
        PrefixAdministration.php
        PageRestrictionHooks.php
        
Then edit your LocalSettings.php file and add the following lines:

        require_once( 'extensions/GroupsAdministration.php' );
        require_once( 'extensions/PrefixAdministration.php' );
        $wgWhitelistRead = array ( "username1", "username2" );

Where "username1" and "username2" are real usernames to whom access to extension(s) is allowed. 

        
Save the file and upload it.

The first step is done. Now go to your MediaWiki SpecialPages tabs logged in as Sysop.
Click on GroupsAdministration extension where you will be followed by instructions until end
of installation.


== 4. Change Log ==

Version 1.0.0
21/08/2006
  Initial release
Version 1.1.0
19/02/2007
  Update
Version 1.2.0
16/09/2008
  Update