Changes for page Forum Application (Pro)

Last modified by Administrator on 2024/02/21 00:01
<
From version < 646.1 >
edited by Administrator
on 2020/09/03 00:00
To version < 648.1 >
edited by Silvia Macovei
on 2020/09/04 11:21
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Admin
1 +XWiki.SilviaMacovei
ExtensionCode.ExtensionClass[0]
Description
... ... @@ -1,7 +1,5 @@
1 -{{extensionToc/}}
1 +The Forum Pro application boasts the following features:
2 2  
3 -Forum application boasts the following features:
4 -
5 5  * Multiple Forums creation
6 6  * Topic creation
7 7  * Answering to topics
... ... @@ -8,11 +8,11 @@
8 8  * Commenting on topics
9 9  * Voting
10 10  * Ordering topics by number of comments or votes
11 -* Editing all fields (topics, answers, comments) in Wysiwyg including Images and Macros
9 +* Editing all fields (topics, answers, comments) in WYSIWYG, including Images and Macros
12 12  * Admin or Topic Manager forum/topic/answer/comment deleting
13 -* Flagging innappropriate content with Flag queue for moderators
11 +* Flagging inappropriate content with Flag queue for moderators
14 14  
15 -Here are some screenshots:
13 +\\
16 16  
17 17  {{gallery}}
18 18  image:ForumAppHome.png
... ... @@ -20,77 +20,7 @@
20 20  image:forumTopic.png
21 21  {{/gallery}}
22 22  
23 -== Forum Template ==
24 24  
25 -A Forum Template is displayed in the page creation wizard.
26 -
27 -{{image reference="forumTemplate.png"/}}
28 -
29 -This application lets you flag inappropriate content on an answer, comment or topic. Everytime you want to flag one of the previous items, you just have to press the flag icon {{image reference="flag.png" width="30px"/}} inside each element.
30 -
31 -Here are some screenshots:
32 -
33 -{{image reference="flagCreation.png" width="700"/}}
34 -
35 -//Flag creation//
36 -
37 -{{image reference="flagList.png" width="700"/}}
38 -
39 -//Flag list//
40 -
41 -The flag list provides you information about the:
42 -
43 -* **Reason** - a motive why an user thought that conversation should be flagged
44 -* **User** - current user that flagged the conversation
45 -* **Date** - date and hour at which the conversation was flagged
46 -* **Moderator** - user that created the conversation that is flagged
47 -* **Status** - flag status (open/ resolved/ in progress)
48 -
49 -To receive an email when you flag a topic/answer/comment you need to have the mail sending configured ([[http://extensions.xwiki.org/xwiki/bin/view/Extension/Mail%20Application]] ) and also, in XWIki Preferences, go to edit mode ( [[http://localhost:8080/xwiki/bin/edit/XWiki/XWikiPreferences]]), then Edit Objects, under Objects of type XWiki.XWikiPreferences open the Object and add an email address to Admin email.
50 -
51 -== Most active topics panel ==
52 -
53 -Among other functionalities, Forum application offers you a simple way to visualize the **Most active topics**. You can also order them ascending or descending, regarding creation date, number of votes or number of comments, with a simple click on the sorting arrows.
54 -
55 -{{image reference="panel.png"/}}
56 -
57 -== Recent Forum Discussions macro ==
58 -
59 -{{image reference="RecentForumDiscussions.png" width="700"/}}
60 -
61 -== Forum rights management ==
62 -
63 -There are few entities that we should focus on when we are talking about rights in the Forum application: **forum**, **topic**, **answer** and **comment**.
64 -By default, any regular user is allowed to perform the same actions on all the above mentioned entities, just as they are on any other wiki page: **create** a new one, **edit any**(even created by others), **delete** only those for which is the creator.
65 -In order to be able to properly configure a **rights schema** on Forum application, please read and understand the [[XWiki Access Rights Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/]].
66 -Since the default behavior often needs to be modified to meet the requirements, the following sections represent some general use cases and the solutions that address them:
67 -
68 -=== Allow only certain users to create a forum ===
69 -
70 -In order to allow only certain users to create a forum, two actions have to be done, by an user with **admin** rights (using, in each case, the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children):
71 -
72 -* from **Forums.WebHome** page -> explicitly allow **edit** rights only for the needed users or groups of users (this will prevent all the other users to create, edit, delete).
73 -* from each **Forum** page -> explicitly allow **edit** rights for XWikiAllGroup (this will resume the unwanted behavior from the previous action).
74 -
75 -This is a simple rights schema achievable when there are no other rights constraints on the Forum application. Things get complicated, otherwise.
76 -
77 -=== Close a forum, topic or answer ===
78 -
79 -An entity can be closed when is considered to be at end of live and the activity on it should stop. Nothing can be created, edited or deleted.
80 -A closed forum implies that all the topics and answers are closed.
81 -A closed topic implies that all the answers are closed.
82 -When an entity needs to be closed, an user with Admin rights can deny **edit** and **comment** rights for all the users by explicitly allowing the **edit** and **comment** rights to some Admin/Moderator users or groups (using, in each case, the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children).
83 -
84 -=== Delete a forum, topic or answer ===
85 -
86 -Deletion can be performed, by default, only by Admin users. It will also work when in the forum is only one participant (the creator).
87 -By default Forums, Topics and Answers can be deleted only by their creators and Admin users. However, an user can't delete a forum if is not allowed to delete all the topics children and their answers children.
88 -Deleting a forum means that all its topics and answers are being deleted.
89 -Deleting a topic means that all its answers are being deleted.
90 -A forum creator must be explicitly allowed to **delete** a forum, in order to be able to delete the topics and answers (using the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children). The same applies when a topic creator wants to delete a topic. An answer can be deleted by its creator without any constraint.
91 -
92 -For more advanced rights schemes, please [[contact us>>https://www.xwiki.com/en/company/contact-us]]
93 -
94 94  == External Resources ==
95 95  
96 96  {{html}}
... ... @@ -110,3 +110,4 @@
110 110   </div>
111 111  </div>
112 112  {{/html}}
41 +
Installed count
... ... @@ -1,1 +1,1 @@
1 -30
1 +35
Store.Code.PayingAppsClass[0]
Documentation
... ... @@ -1,1 +1,74 @@
1 -
1 += Topics =
2 +
3 +{{toc start="2"/}}
4 +
5 +== Forum Template ==
6 +
7 +A Forum Template is displayed in the page creation wizard.
8 +
9 +{{image reference="forumTemplate.png"/}}
10 +
11 +This application lets you flag inappropriate content on an answer, comment or topic. Everytime you want to flag one of the previous items, you just have to press the flag icon {{image reference="flag.png" width="30px"/}} inside each element.
12 +
13 +Here are some screenshots:
14 +
15 +{{image reference="flagCreation.png" width="700"/}}
16 +
17 +//Flag creation//
18 +
19 +{{image reference="flagList.png" width="700"/}}
20 +
21 +//Flag list//
22 +
23 +The flag list provides you information about the:
24 +
25 +* **Reason** - a motive why an user thought that conversation should be flagged
26 +* **User** - current user that flagged the conversation
27 +* **Date** - date and hour at which the conversation was flagged
28 +* **Moderator** - user that created the conversation that is flagged
29 +* **Status** - flag status (open/ resolved/ in progress)
30 +
31 +To receive an email when you flag a topic/answer/comment you need to have the mail sending configured ([[http://extensions.xwiki.org/xwiki/bin/view/Extension/Mail%20Application]] ) and also, in XWIki Preferences, go to edit mode ( [[http://localhost:8080/xwiki/bin/edit/XWiki/XWikiPreferences]]), then Edit Objects, under Objects of type XWiki.XWikiPreferences open the Object and add an email address to Admin email.
32 +
33 +== Most active topics panel ==
34 +
35 +Among other functionalities, Forum application offers you a simple way to visualize the **Most active topics**. You can also order them ascending or descending, regarding creation date, number of votes or number of comments, with a simple click on the sorting arrows.
36 +
37 +{{image reference="panel.png"/}}
38 +
39 +== Recent Forum Discussions macro ==
40 +
41 +{{image reference="RecentForumDiscussions.png" width="700"/}}
42 +
43 +== Forum rights management ==
44 +
45 +There are few entities that we should focus on when we are talking about rights in the Forum application: **forum**, **topic**, **answer** and **comment**.
46 +By default, any regular user is allowed to perform the same actions on all the above mentioned entities, just as they are on any other wiki page: **create** a new one, **edit any**(even created by others), **delete** only those for which is the creator.
47 +In order to be able to properly configure a **rights schema** on Forum application, please read and understand the [[XWiki Access Rights Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/]].
48 +Since the default behavior often needs to be modified to meet the requirements, the following sections represent some general use cases and the solutions that address them:
49 +
50 +=== Allow only certain users to create a forum ===
51 +
52 +In order to allow only certain users to create a forum, two actions have to be done, by an user with **admin** rights (using, in each case, the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children):
53 +
54 +* from **Forums.WebHome** page -> explicitly allow **edit** rights only for the needed users or groups of users (this will prevent all the other users to create, edit, delete).
55 +* from each **Forum** page -> explicitly allow **edit** rights for XWikiAllGroup (this will resume the unwanted behavior from the previous action).
56 +
57 +This is a simple rights schema achievable when there are no other rights constraints on the Forum application. Things get complicated, otherwise.
58 +
59 +=== Close a forum, topic or answer ===
60 +
61 +An entity can be closed when is considered to be at end of live and the activity on it should stop. Nothing can be created, edited or deleted.
62 +A closed forum implies that all the topics and answers are closed.
63 +A closed topic implies that all the answers are closed.
64 +When an entity needs to be closed, an user with Admin rights can deny **edit** and **comment** rights for all the users by explicitly allowing the **edit** and **comment** rights to some Admin/Moderator users or groups (using, in each case, the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children).
65 +
66 +=== Delete a forum, topic or answer ===
67 +
68 +Deletion can be performed, by default, only by Admin users. It will also work when in the forum is only one participant (the creator).
69 +By default Forums, Topics and Answers can be deleted only by their creators and Admin users. However, an user can't delete a forum if is not allowed to delete all the topics children and their answers children.
70 +Deleting a forum means that all its topics and answers are being deleted.
71 +Deleting a topic means that all its answers are being deleted.
72 +A forum creator must be explicitly allowed to **delete** a forum, in order to be able to delete the topics and answers (using the {{html clean="false"}}<span class="glyphicon glyphicon-cog"></span>{{/html}} menu > Administer page > Rights: Page & Children). The same applies when a topic creator wants to delete a topic. An answer can be deleted by its creator without any constraint.
73 +
74 +For more advanced rights schemes, please [[contact us>>https://www.xwiki.com/en/company/contact-us]]
XWiki SAS Copyright © 2024