Forum Actions

Also available in Deutsch, Français and Русский


With the forum actions you can create a forum within a defined cluster of your wiki.



1. Global settings

define the forum cluster
The config value forum_cluster defines the namespace where the forum is located. This is necessary to provide a unique path.

2. Actions

These actions work only within the defined forum cluster.

2.1. forums

  • shows sub-forums list
  • {{forums [pages="subtag1, subtag2, ..."]}}
  • pages – to create multilevel forums this optional parameter passes a comma-delimeted list of tag names of pages that must be considered sub-forums, and not topics.
  • Tags must be absolute (not relative). If you define pages, it must be done for all sub-forums and topic pages.

2.2. topics

  • shows forum topics list
  • {{topics [pages="subtag1, subtag2, ..."]}}
  • pages – when creating multilevel forums this optional parameter passes a comma-delimeted list of tag names of pages that must be considered sub-forums, so topics under these cluster sub-pages will not be displayed. Tags must be absolute.

3. Permissions

3.1. Meta pages

Important

The permissions for comments on all forum meta pages, those having the action {{forums}} or {{topics}}, must be empty.

e.g.
Settings for Forums meta page permissions

3.2. Topic pages

The engine sets special permissions for the topic pages, you usually create them with the topics action, it recognizes them over the name space.

$read_acl	= '*';
$write_acl	= $user_name;
$comment_acl	= '$';
$create_acl	= '';
$upload_acl	= '';

Notice the empty create_acl. The topic action shows only pages with empty create_acl as topics .

4. Handler

You must be a member of the Moderator group to use the moderation tools.

4.1. Moderate forum

moderate forum

4.2. Moderate topic

moderate topic

5. Example


To have multiple forums you can create sub-forums within the forum cluster:


Page Action
Forum {{forums pages="Forum/Discussion,Forum/National"}}
Forum/Discussion {{topics}}
Forum/Discussion/Topic1
Forum/Discussion/Topic2
Forum/National {{forums pages="Forum/National/Deutsch"}}
Forum/National/Deutsch {{topics}}
Forum/National/Deutsch/Topic1
Forum/National/Deutsch/Topic2

Forum
forums action
Forum/Discussion
forum topics action