14 KiB
Forum
Odoo Forum is a question-and-answer forum designed with providing customer support in mind. Adding a forum to a website enables you to build a community, encourage engagement, and share knowledge.
(forum-create)=
Create a forum
To create or edit a forum, go to {menuselection}Website --> Configuration --> Forum: Forums
. Click
{guilabel}New
or select an existing forum and configure the following elements.
{guilabel}Forum Name
: add the name of the forum.
{guilabel}Mode
: select {guilabel}Questions
to enable marking an answer as best, meaning
questions then appear as solved, or {guilabel}Discussions
if the feature is not needed.
:::{note} Regardless of the selected mode, only one answer per user is allowed on a single post. Commenting multiple times is allowed, however. :::
{guilabel}Default Sort
: choose how questions are sorted by default.
- {guilabel}
Newest
: by latest question posting date- {guilabel}
Last Updated
: by latest posting activity date (answers and comments included)- {guilabel}
Most Voted
: by highest vote tally- {guilabel}
Relevance
: by post relevancy (determined by a formula)- {guilabel}
Answered
: by likelihood to be answered (determined by a formula)
:::{note} Users have several sorting options (total replies, total views, last activity) on the forum front end. :::
{guilabel}Privacy
: select {guilabel}Public
to let anyone view the forum, {guilabel}Signed In
to make it visible only for signed-in users, or {guilabel}Some users
to make it visible only for a
specific user access group by selecting one {guilabel}Authorized Group
.
Next, configure the {ref}karma gains <forum/karma-gains>
and the {ref}karma-related rights <forum/karma-related-rights>
.
(forum-karma)=
Karma points
Karma points can be given to users based on different forum interactions. They can be used to
determine which forum functionalities users can access, from being able to vote on posts to
having moderator rights. They are also used to set user {ref}ranks <forum/ranks>
.
:::{important}
- A user's karma points are shared across all forums, courses, etc., of a single Odoo website.
- eLearning users can earn karma points through different {ref}
course interactions <elearning/karma>
and by {ref}completing quizzes <elearning/quiz>
. :::
(forum-karma-gains)=
Karma gains
Several forum interactions can give or remove karma points.
.. list-table::
:header-rows: 1
:stub-columns: 1
* - Interaction
- Description
- Default karma gain
* - :guilabel:`Asking a question`
- You post a question.
- 2
* - :guilabel:`Question upvoted`
- Another user votes for a question you posted.
- 5
* - :guilabel:`Question downvoted`
- Another user votes against a question you posted.
- -2
* - :guilabel:`Answer upvoted`
- Another user votes for an answer you posted.
- 10
* - :guilabel:`Answer downvoted`
- Another user votes against an answer you posted.
- -2
* - :guilabel:`Accepting an answer`
- You mark an answer posted by another user as best.
- 2
* - :guilabel:`Answer accepted`
- Another user marks an answer you posted as best.
- 15
* - :guilabel:`Answer flagged`
- A question or an answer you posted is :ref:`marked as offensive <forum/moderation>`.
- -100
:::{note} New users receive three points upon validating their email address. :::
To modify the default values, go to {menuselection}Website --> Configuration --> Forum: Forums
,
select the forum, and go to the {guilabel}Karma Gains
tab. Select a value to edit it.
If the value is positive (e.g., 5
), the number of points will be added to the user's tally each
time the interaction happens on the selected forum. Conversely, if the value is negative (e.g.,
-5
), the number of points will be deducted. Use 0
if an interaction should not impact a user's
tally.
(forum-karma-related-rights)=
Karma-related rights
To configure how many karma points are required to access the different forum functionalities, go
to {menuselection}Website --> Configuration --> Forum: Forums
, select the forum, and go to the
{guilabel}Karma Related Rights
tab. Select a value to edit it.
:::{warning}
Some functionalities, such as {guilabel}Edit all posts
, {guilabel}Close all posts
,
{guilabel}Delete all posts
, {guilabel}Moderate posts
, and {guilabel}Unlink all comments
,
are rather sensitive. Make sure to understand the consequences of giving any user reaching the
set karma requirements access to such functionalities.
:::
.. list-table::
:header-rows: 1
:stub-columns: 1
* - Functionality
- Description
- Default karma requirement
* - :guilabel:`Ask questions`
- Post questions.
- 3
* - :guilabel:`Answer questions`
- Post answers to questions.
- 3
* - :guilabel:`Upvote`
- Vote for questions or answers.
- 5
* - :guilabel:`Downvote`
- Vote against questions or answers.
- 50
* - :guilabel:`Edit own posts`
- Edit questions or answers you posted.
- 1
* - :guilabel:`Edit all posts`
- Edit any question or answer.
- 300
* - :guilabel:`Close own posts`
- Close questions or answers you posted.
- 100
* - :guilabel:`Close all posts`
- Close any question or answer.
- 500
* - :guilabel:`Delete own posts`
- Delete questions or answers you posted.
- 500
* - :guilabel:`Delete all posts`
- Delete any question or answer.
- 1,000
* - :guilabel:`Nofollow links`
- If you are under the karma threshold, a *nofollow* attribute tells search engines to ignore
links you post.
- 500
* - :guilabel:`Accept an answer on own questions`
- Mark an answer as best on questions you posted.
- 20
* - :guilabel:`Accept an answer to all questions`
- Mark an answer as best on any question.
- 500
* - :guilabel:`Editor Features: image and links`
- Add links and images to your posts.
- 30
* - :guilabel:`Comment own posts`
- Post comments under questions or answers you created.
- 1
* - :guilabel:`Comment all posts`
- Post comments under any question or answer.
- 1
* - :guilabel:`Convert own answers to comments and vice versa`
- Convert comments you posted as answers.
- 50
* - :guilabel:`Convert all answers to comments and vice versa`
- Convert any comment as answer.
- 500
* - :guilabel:`Unlink own comments`
- Delete comments you posted.
- 50
* - :guilabel:`Unlink all comments`
- Delete any comment.
- 500
* - :guilabel:`Ask questions without validation`
- Questions you post do not require to be :ref:`validated <forum/moderation>` first.
- 100
* - :guilabel:`Flag a post as offensive`
- Flag a question or answer as offensive.
- 500
* - :guilabel:`Moderate posts`
- Access all :ref:`moderation tools <forum/moderation>`.
- 1,000
* - :guilabel:`Change question tags`
- Change posted questions' :ref:`tags <forum/tags>` (if you have the right to edit them).
- 75
* - :guilabel:`Create new tags`
- Create new :ref:`tags <forum/tags>` when posting questions.
- 30
* - :guilabel:`Display detailed user biography`
- When a user hovers their mouse on your avatar or username, a popover box showcases your
karma points, biography, and number of :ref:`badges <forum/badges>` per level.
- 750
:::{tip}
Track all karma-related activity and add or remove karma manually by {ref}enabling developer mode <developer-mode>
and going to {menuselection}Settings --> Gamification Tools --> Karma Tracking
.
:::
(forum-gamification)=
Gamification
Ranks and badges can be used to encourage participation. Ranks are based on the total {ref}karma points <forum/karma>
, while badges can be granted manually or automatically by completing
challenges.
(forum-ranks)=
Ranks
To create new ranks or modify the default ones, go to {menuselection}Website --> Configuration --> Forum: Ranks
and click {guilabel}New
or select an existing rank.
Add the {guilabel}Rank Name
, the {guilabel}Required Karma
points to reach it, its
{guilabel}Description
, a {guilabel}Motivational
message to encourage users to reach it, and an
image.
:alt: Default forum ranks
(forum-badges)=
Badges
To create new badges or modify the default ones, go to {menuselection}Website --> Configuration --> Forum: Badges
and click {guilabel}New
or select an existing badge.
Enter the badge name and description, add an image, and configure it.
Assign manually
If the badge should be granted manually, select which users can grant them by selecting one of the
following {guilabel}Allowance to Grant
options:
- {guilabel}
Everyone
: all non-portal users (since badges are granted from the backend). - {guilabel}
A selected list of users
: users selected under {guilabel}Authorized Users
. - {guilabel}
People having some badges
: users who have been granted the badges selected under {guilabel}Required Badges
.
It is possible to restrict how many times per month each user can grant the badge by enabling
{guilabel}Monthly Limited Sending
and entering a {guilabel}Limitation Number
.
Assign automatically
If the badge should be granted automatically when certain conditions are met, select
{guilabel}No one, assigned through challenges
under {guilabel}Allowance to Grant
.
Next, determine how the badge should be granted by clicking {guilabel}Add
under the
{guilabel}Rewards for challenges
section. Select a challenge to add it or create one by clicking
{guilabel}New
.
:::{tip}
It is possible to give the badge a {guilabel}Forum Badge Level
({guilabel}Bronze
,
{guilabel}Silver
, {guilabel}Gold
) to give it more or less importance.
:::
:alt: Default forum badges
(forum-tags)=
Tags
Users can use tags to filter forum posts.
To manage tags, go to {menuselection}Website --> Configuration --> Forum: Tags
. Click
{guilabel}New
to create a tag and select the related {guilabel}Forum
.
:::{tip}
- Use the {guilabel}
Tags
section on the forum's sidebar to filter all questions assigned to the selected tag. Click {guilabel}View all
to display all tags. - New tags can be created when posting a new message, provided the user has enough {ref}
karma points <forum/karma-related-rights>
. :::
(forum-use)=
Use a forum
:::{note}
Access to many functionalities depends on a user's {ref}karma points <forum/karma-related-rights>
.
:::
(forum-post)=
Post questions
To create a new post, access the forum's front end, click {guilabel}New Post
, and fill in the
following:
- {guilabel}
Title
: add the question or the topic of the post. - {guilabel}
Description
: add a description for the question. - {guilabel}
Tags
: add up to five {ref}tags <forum/tags>
.
Click {guilabel}Post Your Question
.
(forum-interact)=
Interact with posts
Different actions are possible on a post.
- Mark a question as favorite by clicking the star button ({guilabel}
☆
). - Follow a post and get notifications (by email or within Odoo) when it is answered by clicking
the bell button ({guilabel}
🔔
). - Vote for (up arrow {guilabel}
▲
) or against (down arrow {guilabel}▼
) a question or answer. - Mark an answer as best by clicking the check mark button ({guilabel}
✔
). This option is only available if the {guilabel}Forum Mode
is set to {guilabel}Questions
. - {guilabel}
Answer
a question. - Comment on a question or answer by clicking the speech bubble button ({guilabel}
💬
). - Share a question on Facebook, Twitter, or LinkedIn by clicking the share nodes button.
Click the ellipsis button ({guilabel}...
) to:
- {guilabel}
Edit
a question or answer.- {guilabel}
Close
a question.- {guilabel}
Delete
a question, answer, or comment. It is possible to {guilabel}Undelete
questions afterward.- {guilabel}
Flag
a question or answer as offensive.- {guilabel}
Convert
a comment into an answer.- {guilabel}
View
the related {ref}Helpdesk ticket <helpdesk/forum>
, if any.
:alt: Posts actions
:::{note} By default, 150 karma points are required to view another user's profile. This value can be configured when creating a new website. :::
(forum-moderation)=
Moderate a forum
On the forum's front end, the sidebar's {guilabel}Moderation tools
section gathers the essential
moderator functionalities.
:alt: Forum sidebar moderation tools
{guilabel}To Validate
: access all questions and answers waiting for validation before being
displayed to non-moderator users.
:alt: Question to validate
:::{note} A question is pending if a user does not have the required karma. The user is not able to post questions or answers while awaiting validation. Only one pending question per user is allowed per forum. :::
{guilabel}Flagged
: access all questions and answers that have been flagged as offensive. Click
{guilabel}Accept
to remove the offensive flag or {guilabel}Offensive
to confirm it, then select
a reason and click {guilabel}Mark as offensive
. The post is then hidden from users without
moderation rights, and 100 karma points are deducted from the offending user's tally.
:alt: Offensive reason selection
{guilabel}Closed
: access all questions that have been closed. It is possible to {guilabel}Delete
or {guilabel}Reopen
them. To close a question, open it, click the ellipsis button
({guilabel}...
), then {guilabel}Close
, select a {guilabel}Close Reason
, and click
{guilabel}Close post
. The post is then hidden from users without moderation rights.
:::{note}
When selecting {guilabel}Spam or advertising
or {guilabel}Contains offensive or malicious remarks
as the reason, 100 karma points are deducted from the poster's tally.
:::
:::{tip}
- Create and edit close reasons by going to {menuselection}
Website --> Configuration --> Forum: Close Reasons
. Select {guilabel}Basic
as {guilabel}Reason Type
if the reason should be used when closing a question, and {guilabel}Offensive
if it should be used for flagged posts. - Manage all posts by going to {menuselection}
Website --> Configuration --> Forum: Forums
, selecting the forum, and clicking the {guilabel}Posts
smart button. By clicking the {guilabel}Actions
button, it is possible to {guilabel}Export
, {guilabel}Archive
, {guilabel}Unarchive
, or {guilabel}Delete
one or multiple posts. :::