README

WSSpaces is a comprehensive space management system developed for MediaWiki. It enables users to dynamically define namespaces. This document describes the extensions capabilities, options and usage.

Configuration

WSSpaces has two configuration variable.

• $wgWSSpacesEnableSpaceArchiving (boolean, default: true) Whether to allow archiving of spaces
• $wgWSSpacesAutoAddAdminsToUserGroups (boolean, default: false) Whether to automatically add space admins to a user group. Eg. An admin for a space with id 50000 will get added to a group called '50000Admin'. Will additionally add admins to a general 'SpaceAdmin' group that can be used to assign rights to all space admins.

To enable Semantic MediaWiki for the created namespace, place the following code in between the initialization of Semantic MediaWiki and WSSpaces in LocalSettings.php:

// NOTE: This is not very nice, and another solution is needed, but it suffices for now
for ($i = 50000; $i < 55000; $i++) {
	$smwgNamespacesWithSemanticLinks[$i] = true;
}

Parser functions

Retrieving defined spaces

You can use the {{#spaces:}} parser function to get a comma-separated list of spaces defined by WSSpaces.

Retrieving data for a space

You can use the {{#spaceadmins:{{NAMESPACENUMBER}}}} and {{#spacedescription:{{NAMESPACENUMBER}}}} and {{#spacename:{{NAMESPACENUMBER}}}} parser functions to get the list of admin names, description of the space, and long name of the space with Wikitext.

Hooks

WSSpaces defines several hooks to alter or extend its behaviour.

WSSpacesAfterCreateSpace

public static function onWSSpacesAfterCreateSpace( \WSS\Space $space ) {}

Gets called once directly after a space has been created. NOTE: The space has not been initialized with the Wiki at this point. Therefore, you cannot create a page in this namespace (use a job instead). Similarly, this space is at this point unaware of the admins that it has as they are only set after this hook is called.

WSSpacesCustomApiExceptionHandler

public static function onWSSpacesCustomApiExceptionHandler( \ApiUsageException $exception ) {}

Gets called whenever an ApiUsageException occurs when using the WSSpaces API. Allows for custom handling of the exception.

Rights

WSSpaces defines several rights.

Please note that administrators of a space are always able to edit the details of that space, regardless of whether or not they have been assigned any of the rights below. However, admins do not get the wss-edit-protected right by default, so they cannot edit "pages" in protected spaces.

wss-edit-all-spaces

Whether the user can edit all spaces or not, regardless of whether or not they are a space administrator of those spaces.

wss-add-space

Whether the user can add new spaces to the wiki or not.

wss-archive-space

Whether the user can archive existing spaces or not. This right does not affect the behaviour or $wgWSSpacesEnableSpaceArchiving.

wss-view-space-admins

Whether the user is able to view the admins for a space or not.

wss-view-spaces-overview

Whether the user is able to view the overview of spaces or not.

wss-edit-protected

Whether the user is able to edit pages in "protected" spaces.

API modules

WSSpaces defines several API modules. The documentation of these API modules can be found through the API sandbox or by going to /api.php on the wiki. For your reference, the following API modules are available:

• addspace
• archivespace
• unarchivespace
• editspace

Furthermore, the following API list (?action=query) modules are available:

• spaces
• spaceadmins
• singlespace