View source for Forum Actions

Also available in ((/Doc/Deutsch/Aktionen/Forum Deutsch)), ((/Doc/Français/Fonctions/Forum Français)) and ((/Doc/Русский/Действия/Форум Русский))

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

{{toc numerate=1}}

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

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