Skip to content

Commit

Permalink
Update Reported content article
Browse files Browse the repository at this point in the history
  • Loading branch information
paulinebessoles committed Nov 7, 2024
1 parent 5de2d23 commit 20697a7
Show file tree
Hide file tree
Showing 27 changed files with 123 additions and 19 deletions.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
15 changes: 6 additions & 9 deletions docs/en/modules/admin/pages/global_moderations.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

The *Global moderations* function allows you to moderate different kind of contents and
ensure that the dialog in your platform is democratic and constructive.
It also allows managing users who infringe the rules of the platform.
It also allows managing participants who infringe the rules of the platform.

NOTE: Looking for how to report users or content? See xref:moderations/reported_users.adoc[Reported users] and xref:moderations/reported_content.adoc[Reported content].
NOTE: Looking for how to report participants or content? See xref:moderations/reported_users.adoc[Reported participants] and xref:moderations/reported_content.adoc[Reported content].

For instance, in the case of https://www.decidim.barcelona/[Decidim Barcelona],
the https://www.decidim.barcelona/pages/terms-and-conditions[Terms of Service] says:
Expand Down Expand Up @@ -42,13 +42,10 @@ the admin navigation bar.

image:moderations/moderations_menu.png[Global moderations menu]

Any logged in participant can report a content or a user through the "Flag" icon.
After a participant has clicked in this action then they need to provide a
reason why they are making this report:
The Global moderations panel allows to manage reported contents as well as reported participants.
By default, you'll be redirected on the Reported content list.

* Contains clickbait, advertising, scams or script bots.
* Contains racism, sexism, slurs, personal attacks, death threats, suicide requests or any form of hate speech.
* Contains illegal activity, suicide threats, personal information, or something else you think doesn't belong on [This organization].
image:moderations/moderations_backend_list_content.png[Global moderations panel for content]

== Examples

Expand All @@ -58,4 +55,4 @@ You can report and hide a comment containing personnal information, or a link to

=== Report user

You can report and block users who are constantly infriging the participation chart, or spamming and trolling the platform.
You can report and block participants who are constantly infriging the participation chart, or spamming and trolling the platform.
81 changes: 81 additions & 0 deletions docs/en/modules/admin/pages/moderations/reported_content.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
= Reported content

When writing the Terms and Conditions of your platform, or your participation chart, you want to make sure that
the participation rules are respected by participants in the contents they are writing.
All participants are able to report comments, proposals, debates, etc.

== Report a content

Any logged in participant can report content, clicking on the "Report" button available next to the resource.

image:moderations/moderations_reported_content_flag.png[Report flag in content]

image:moderations/moderations_reported_comment_flag.png[Report flag in comment]

Participants have to select a reason for the report, and can add extra information if needed.

image:moderations/moderation_modal.png[Give reason for moderation modal]

== Manage reported content

After a participant has reported a content, it'll be shown in two sections of the
administration panel:

* Global moderations panel
* Participatory space moderation panel

image:moderations/moderations_backend_list_content.png[Global moderations panel for content]

There you'll find first all the unprocessed reports if there's any, with:
* *Id*: unique identificator of the reported content.
* *Type*: the kind of content reported (for instance comment, proposal, debate, etc.)
* *Participatory Space*: which space this content belongs to.
* *Reported content URL*: link for seeing the content reported and see the context of the complaint.
* *Reason*: why it has been reported. If the participant that made the report has given extra
information it's possible to see it by hovering it.
* *Reported at*: when it was originally reported.
* *Count*: Number of times it has been reported by different users.
* *Actions*: you can *Expand*, *Unreport* or *Hide*.

Once you moderate a content, it will be available in the "Hidden" contents list, accessible at the top right of the page.

=== Actions

|===
|Icon |Name |Definition |Condition

|image:icons/action_expand.png[Expand icon]
|Expand
|To see the full details of the reported content and reports.
|Always available.

|image:icons/action_unreport.png[Unreport icon]
|Unreport
|Allows an admin or moderator to keep showing this content (rejecting the report).
|Available when the content is not yet hidden.

|image:icons/action_hide.png[Hide icon]
|Hide
|Allows an admin or moderator to hide this content (accepting the report).
|Available when the content is not yet hidden.

|image:icons/action_hide.png[Unhide icon]
|Unhide
|Allows an admin or moderator to unhide this content (showing it publicly again).
|Available when the content has been hidden.
|===

If a content has been mistakenly "Unreported", then you'll need to find it again in the public platform
and report it again so you can moderate it.

=== Expand

To check the details of a content, and the different reports that were made by participants, you can click on the "Expand" button.
see all the metadata of a report, you can see it Expanded.

image:moderations/moderations_backend_report_content.png[Global moderations panel for content]

This view allow you to assess quickly if it's necessary to hide or not the content.
At the bottom of the report, you can also check the different reports that were made by other participants, and expand them as well.

image:moderations/moderations_backend_report_details.png[Global moderations panel for content]
46 changes: 36 additions & 10 deletions docs/en/modules/admin/pages/moderations/reported_users.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,19 +23,45 @@ image:moderations/reported_participant_modal_admin.png[Give reason for reporting

== Manage reported participants

All the reported participants are listed on the reported participant list in the administration panel, with:
* a link to the participant profile
* the name and nickname of the participant
* the reason why they were reported
* the justification of the report if there is one (by hovering over the reason)
* the date of the report
* the report count (shows if several participants reported the same person)
Reported participants will be visible on the "Reported participants" section of the Global moderations panel.

image:moderations/moderations_backend_list_users.png[Global moderations panel for users]

Administrators can choose to perform two different actions:
* Unreport the participant, if the report is not justified
* Block the participant, if the report is justified
All the reported participants are listed on the reported participant list in the administration panel, with:
* *Name*: name of the participant, with a link to their profile.
* *Nickname*: nickname of the participant, with a link to their profile.
* *Reason*: why they have been reported. If the participant that made the report has given extra.
information it's possible to see it by hovering it.
* *Reported at*: when they were originally reported.
* *Reports count*: Number of times it has been reported by different users.
* *Actions*: you can *Unreport* or *Block* the participant.

=== Actions

|===
|Icon |Name |Definition |Condition

|image:icons/action_unreport.png[Unreport icon]
|Unreport
|To unreport the participant and remove them from the list.
|Available when the participant is not yet blocked.

|image:icons/action_block.png[Block user]
|Block user
|To block the participant.
|Available when the participant is not yet blocked.

|image:icons/action_block.png[Unblock user]
|Unblock user
|To unblock the participant.
|Available when the participant is blocked.

|===

=== Block a participant

If a content has been mistakenly "Unreported", then you'll need to find it again in the public platform
and report it again so you can moderate it.

Administrators need to provide a justification if they want to block a participant.

Expand Down

0 comments on commit 20697a7

Please sign in to comment.