Also available in ((/Doc/Deutsch/Aktionen/Forum Deutsch)), ((/Doc/Español/Acciones/Foro Español)), ((/Doc/Français/Fonctions/Forum Français)), ((/Doc/Русский/Действия/Форум Русский)), ((/Doc/简体中文/Actions组件/论坛 简体中文))
With the forum actions you can create a forum within a defined cluster of your wiki.
{{toc numerate=1}}
%%(info type="note")
Non-mandatory options and parameters are enclosed in ##[square brackets]##.
**!!(green)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"##.
%%
===Global settings===
file:/ap_forum_cluster_en.png
The config value ##forum_cluster## defines the namespace where the forum is located. This is necessary to provide a unique path.
===Actions===
These actions work only within the defined forum cluster.
====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.
====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.
===Permissions===
====Meta pages====
%%(info type="important" title="Important")
The **permissions for comments** on all forum **meta pages**, those having the action ##""{{forums}}""## or ##""{{topics}}""##, **must be empty**.
%%
e.g.
file:/forum_permissions_en.png
file:/page_properties_forum_en.png
====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 .
===Handler===
You must be a member of the Moderator group to use the moderation tools.
====Moderate forum====
file:/moderate_forum_en.png
====Moderate topic====
file:/moderate_topic_en.png
===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
file:/forrum_action_en.png
Forum/Discussion
file:/topics_action_en.png