Skip to content

Edit and review reported content page #213

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 26 additions & 26 deletions docs/en/modules/admin/pages/moderations/reported_content.adoc
Original file line number Diff line number Diff line change
@@ -1,43 +1,43 @@
= Reported content

When writing the Terms and Conditions of your platform, or your participation chart, you want to make sure that the
participants respect the participation rules in the contents they're writing.
All participants are able to report comments, proposals, debates, etc.
When writing the xref:pages/pages.html#_the_terms_and_conditions_page[Terms and Conditions] of your platform, or your participation chart, it is suggested that you ensure that the

Check warning on line 3 in docs/en/modules/admin/pages/moderations/reported_content.adoc

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Contractions] Use 'it's' instead of 'it is'. Raw Output: {"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "docs/en/modules/admin/pages/moderations/reported_content.adoc", "range": {"start": {"line": 3, "column": 140}}}, "severity": "INFO"}

Check warning on line 3 in docs/en/modules/admin/pages/moderations/reported_content.adoc

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Passive] In general, use active voice instead of passive voice ('is suggested'). Raw Output: {"message": "[Google.Passive] In general, use active voice instead of passive voice ('is suggested').", "location": {"path": "docs/en/modules/admin/pages/moderations/reported_content.adoc", "range": {"start": {"line": 3, "column": 143}}}, "severity": "INFO"}
participants respect the participation rules in the content they're writing.
All participants are able to report comments, proposals, debates, etc.

== Report a content
== Report content

Any logged in participant can report content, clicking on the "Report" button available next to the resource.
Any logged in participant can report content, by 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.
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 appears in two sections of the administration panel:
After a participant has reported content, it appears 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:
There, you'll find all the unprocessed reports if there's any, with:

* *Id*: unique identifier 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 the content is reported. If the participant that made the report has given extra
* *ID*: Unique identifier 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 the content is reported. If the participant that made the report has given extra

Check warning on line 34 in docs/en/modules/admin/pages/moderations/reported_content.adoc

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Passive] In general, use active voice instead of passive voice ('is reported'). Raw Output: {"message": "[Google.Passive] In general, use active voice instead of passive voice ('is reported').", "location": {"path": "docs/en/modules/admin/pages/moderations/reported_content.adoc", "range": {"start": {"line": 34, "column": 29}}}, "severity": "INFO"}
information it's possible to see it by hovering it.
* *Reported at*: when it was originally reported.
* *Count*: number of reports by different users.
* *Actions*: you can *Expand*, *Unreport* or *Hide*.
* *Reported at*: When it was originally reported.
* *Count*: Number of reports by different users.
* *Actions*: You can *Expand*, *Unreport* or *Hide*.

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

=== Actions

Expand All @@ -48,12 +48,12 @@

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

|image:icons/action_unreport.png[Unreport icon]
|Unreport
|Allows an administrator or moderator to keep showing this content and cancel the report.
|Allows an administrator or moderator to keep displaying this content and cancel the report.
|Available when the content isn't yet hidden.

|image:icons/action_hide.png[Hide icon]
Expand All @@ -63,21 +63,21 @@

|image:icons/action_hide.png[Unhide icon]
|Unhide
|Allows an administrator or moderator to Unhide this content (showing it publicly again).
|Allows an administrator or moderator to unhide this content (showing it publicly again).

Check warning on line 66 in docs/en/modules/admin/pages/moderations/reported_content.adoc

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Parens] Use parentheses judiciously. Raw Output: {"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "docs/en/modules/admin/pages/moderations/reported_content.adoc", "range": {"start": {"line": 66, "column": 62}}}, "severity": "INFO"}
|Available when the content is hidden.
|===

If a content has been mistakenly "Unreported" then you'll need to find it again in the public platform
If content has been mistakenly "unreported", you'll need to find it again in the public platform

Check failure on line 70 in docs/en/modules/admin/pages/moderations/reported_content.adoc

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Google.Quotes] Commas and periods go inside quotation marks. Raw Output: {"message": "[Google.Quotes] Commas and periods go inside quotation marks.", "location": {"path": "docs/en/modules/admin/pages/moderations/reported_content.adoc", "range": {"start": {"line": 70, "column": 32}}}, "severity": "ERROR"}
and report it again so you can moderate it.

=== Expand

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

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 review the different reports made by other participants, and expand them as well.
This view allows you to quickly assess and review the reported content.
At the bottom of the report, you can also review the different reports made by other participants, and expand them as well.

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