📝 NOTE: It is assumed you know how to create custom Dashboards and Charts, and have an understanding of chart Types, Presets, and Metrics. If not, read this article before proceeding.
When building your own Dashboard Charts, you can pull data from various data sources to view different types of analytics events.
- In this article, we're going to focus on the Moderation data source, which tracks all moderation activity across your Higher Logic Vanilla (Vanilla) community.
Overview
The Moderation data source tracks when:
- a user is banned
- a user is unbanned
- a post is flagged for moderation
- a post is reviewed and approved from the Moderation or Spam Queue
- a post is reviewed and deleted from the Moderation or Spam Queue
- a user receives a warning
- a warning is reversed
- a user is jailed
- a Moderator restores deleted or edited content from the change log
- a Moderator permanently deletes records from the change log
For each moderation event logged, you can see:
- the Type of moderation event that occurred
- the Discipline Type (positive or negative)
- information about the Disciplining User
- information about the Disciplined User
- the Source of the moderation action
Some moderation events include additional information. For example, you can also view the following data for issued warnings:
Filter Chart data
Controlling what data is shown in a Chart is accomplished via the Group By and Filter options.
- The Group By options (available for pie graphs, line graphs, bar graphs, and tables) enable you to view data by moderation action (type), subcommunity, category, country, and more.
- You can add Filters to your query to drill into or exclude specific types of events (e.g., exclude guests from traffic data or focus your Chart on traffic seen in a specific category).
✔️ TIP: You can add one or multiple Group By and Filter options to dissect the data how you see fit. Generally speaking, you'll select Group By options to view a specific slice of data, and, if needed, use Filters to dig deeper.
Let's learn about each of the available Group By and Filter options.
Type
Each moderation event has a Type. The type parameters define what happened.
User Bans
- ban: a user was banned
- unban: a user was unbanned
Warnings
- warnUser: a warning is issued
- jail: a user was jailed
- reverseWarning: a warning was reversed
Spam & Moderation Queue Activity
- logSpam: a post was flagged as Spam
- logSpam_approve: a post flagged as Spam was reviewed, and approved
- logSpam_delete: a post flagged as Spam was reviewed and deleted from the Spam Queue
- logModerate: a post was flagged as Abuse
- logModerate_delete: a post flagged as Abuse was reviewed and deleted
- logModerate_approve: a post flagged as Abused was reviewed and approved
- logPending: a post was flagged for moderation by Keyword Blocker, Requires Approval Permission, or Pre-moderated category settings
- logPending_delete: a flagged post was reviewed and deleted
- logPending_approve: a flagged post was reviewed and approved
Change Log activity
- logDelete_approve: a Change Log entry was reviewed and reversed
- logDelete_delete: a deletion logged in the Change Log was reviewed and permanently deleted
- logEdit_delete: an edit logged in the Change Log was reviewed and permanently deleted
- Ban.delete: a ban logged in the change log is deleted
- logBan_approve: a ban logged in the change log is restored
Disciplining User
The Disciplining User is the user who performed the moderation action.
Examples
- Jane bans Joe; Jane is the Disciplining User
- Alex warns Anna; Alex is the Disciplining User
- Bruce flags Bill's post as Spam; Bruce is the Disciplining User
Group moderation data by:
- Disciplining User Name, ID, or UUID to see who is handling moderation in your community
- Disciplining User Rank Name or ID to see which Ranks are contributing to moderation efforts
- Disciplining User Role Type, Role Name, or ID to see which Roles are contributing to moderation efforts
Filter moderation data by:
- Disciplining User Name, ID, or UUID to see moderation activities performed by a specific user
- Disciplining User Role Type, Role Name, or ID to see moderation activities performed by users of a specific role
- Disciplining User Rank Name or ID to see moderation activities performed by users of a specific rank
Disciplined User
The Disciplined User is the user who required moderation.
Examples
- Jane bans Joe; Joe is the Disciplined User
- Alex warns Anna; Anna is the Disciplined User
- Bruce flags Bill's post as Spam; Bill is the Disciplined User
Group moderation data by:
- Disciplined User Name, ID, or UUID to see which users have required moderation
- Disciplined User Rank Name or ID to see which Ranks have required moderation
- Disciplined User Role Type, Role Name, or ID to see which Roles have required moderation
Filter moderation data by:
- Disciplined User Name, ID, or UUID to see moderation events for a specific user
- Disciplined User Role Type, Role Name, or ID to see moderation events for a specific Role
- Disciplined User Rank Name or ID to see moderation events for a specific Rank
Discipline Type
Moderation events can either be positive or negative (referred to as its Discipline Type).
Negative moderation events include:
- a user is banned
- a warning is issued
- a user is jailed
- a post is flagged as Spam or Abuse
- a flagged post is deleted from the Moderation Queues
Positive moderation events include:
- a user is unbanned
- a warning is reversed
- a flagged post is approved from the Moderation Queues
Source
Each moderation event has a Source, which is the source that triggered the moderation event.
These may include:
- User: when moderators ban a community member, or approve and delete flagged content.
- Keyword Blocker: when a post is flagged for moderation because a user posted content containing a blocked word.
- Warnings: when a warning is issued, a user is banned or jailed, or a warning is reversed.
- CleanSpeak: when user content is flagged for moderation by our CleanSpeak integration.
- Reactions: when a post is flagged for moderation due to users reacting with the Spam and Abuse reactions.
- Akismet: when our spam filtering detects and flags spam for moderation
- Ban Rules: when a user is banned by configured Ban Rules.
Group moderation events by Source to see breakdown of the tools that are powering your moderation workflows.
Filter moderation events by Source to review moderation events for a specific tool.
Warning & Rule
For all warnUser and reverseWarning moderation events, you can also see:
- the warning type issued, by Warning Name or ID
- the rule linked to the warning, by Rule Name or ID
📝 NOTE: Linking a rule to a warning is optional. If no rule is selected, Rule Name and ID will be listed as null or "Other" in your charts.
Subcommunity
If your Vanilla community is leveraging Subcommunities, you can:
- Group moderation data by Subcommunity Name or ID to see a breakdown of moderation events per subcommunity.
- Filter moderation data by Subcommunity Name or ID to see moderation events for a specific Subcommunity.
Some moderation events may not be linked to a Subcommunity. This can happen when, for example:
- a user is banned from the User Management Dashboard
- a warning is issued from a users profile
📝 NOTE: When no subcommunity is linked to an event, you will see null or "Other" for Subcommunity Name and ID.
Category
Some moderation events may be linked to a specific Category when:
- A post is flagged for moderation
- A flagged post is reviewed and approved or deleted
- A user is warned for content posted in a specific Category
You can:
- Group moderation data by Category to see a breakdown of where content is being posted that requires moderation
- Filter moderation data by Category to see moderation events for a specific category
📝 NOTE: When no Category is linked to the moderation event you will see "null" or "Other" for Category Name and ID
Discussion
Some moderation events may be linked to a specific discussion when:
- A post is flagged for moderation
- A flagged post is reviewed and approved or deleted
- A user is warned for content posted in a specific category
📝 NOTE: When no discussion is linked to the moderation event, you will see "null" or "Other" for Category Name or ID.
