View source for Action 论坛

其他语言 ((/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## – 创建多级论坛时,此可选参数传递一个逗号分隔的页面标签名称列表,这些页面必须被视为子论坛,因此这些集群子页面下的主题将不会显示。 标签必须是绝对标签。

===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

====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