其他语言 ((/Doc/Deutsch/Aktionen/Forum Deutsch)), ((/Doc/English/Actions/Forum English)), ((/Doc/Español/Acciones/Foro Español)), ((/Doc/Français/Fonctions/Forum Français)), ((/Doc/Русский/Действия/Форум Русский))
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_zh.png
The config value ##forum_cluster## defines the namespace where the forum is located. This is necessary to provide a unique path.
===Actions组件===
这些操作仅在定义的论坛集群内有效。
====论坛forums====
* 显示子论坛列表
* ##""{{forums [pages="subtag1, subtag2, ..."]}}""##
* ##pages## – 要创建多级论坛，此可选参数传递一个逗号分隔的页面标签名称列表，这些页面必须被视为子论坛，而不是主题。
* 标签必须是绝对的（不是相对的）。 如果您定义页面，则所有子论坛和主题页面必须这么做。
====主题topics====
* 显示论坛主题列表
* ##""{{topics [pages="subtag1, subtag2, ..."]}}""##
* ##pages## – 创建多级论坛时，此可选参数传递一个逗号分隔的页面标签名称列表，这些页面必须被视为子论坛，因此这些集群子页面下的主题将不会显示。 标签必须是绝对标签。
===权限管理===
====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_zh.png
file:/page_properties_forum_zh.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