Forum Actions
Also available in Deutsch, Español, Français, Русский, 简体中文
With the forum actions you can create a forum within a defined cluster of your wiki.
Non-mandatory options and parameters are enclosed in
When using the actions please remove the square
Numerical values are given without and strings with quotation marks,
[square brackets]
.When using the actions please remove the square
[ ]
brackets from the parameters to make it work.Numerical values are given without and strings with quotation marks,
max=10
and page="PageName"
.
1. Global settings
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-delimited 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-delimited 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.
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
4.2. 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 | |