Moderation Data for Analytics - HL Vanilla Community
<main> <article class="userContent"> <p><strong>📝 NOTE</strong>: It is assumed you know how to create custom Dashboards and Charts. If not, <a href="https://success.vanillaforums.com/kb/articles/433#building-custom-charts-dashboards" rel="nofollow noreferrer ugc">read this article</a> before proceeding.</p><p>When building your own Dashboard Charts, you can pull data from various <strong>data sources</strong> to view different types of analytics events. </p><ul><li>In this article, we're going to focus on the <strong>Moderation </strong>data source, which tracks all moderation activity across your <strong>Higher Logic Vanilla (Vanilla)</strong> community.</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/ODUH14GS5ZOU/moderation-data-source.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/ODUH14GS5ZOU/moderation-data-source.png" alt="moderation_data_source.png" height="586" width="1385" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="overview">Overview</h2><p>The Moderation data source tracks when:</p><ul><li>a user is banned</li><li>a user is unbanned</li><li>a post is flagged for moderation</li><li>a post is reviewed and approved from the Moderation or Spam Queue</li><li>a post is reviewed and deleted from the Moderation or Spam Queue</li><li>a user receives a warning</li><li>a warning is reversed</li><li>a user is jailed</li><li>a Moderator restores deleted or edited content from the change log</li><li>a Moderator permanently deletes records from the change log</li></ul><p>For each moderation event logged, you can see:</p><ul><li>the <strong>Type </strong>of moderation event that occurred</li><li>the <strong>Discipline Type </strong>(positive or negative)</li><li>information about the <strong>Disciplining User </strong></li><li>information about the <strong>Disciplined User</strong></li><li>the <strong>Source </strong>of the moderation action</li></ul><p>Some moderation events include additional information. For example, you can also view the following data for issued warnings:</p><ul><li>the <strong>Warning Name </strong>or <strong>ID</strong></li><li>the<strong> Rule Name </strong>or <strong>ID</strong> linked to the warning</li><li>information about the post that may be linked to the warning, including:<ul><li><strong>Discussions Name</strong> or <strong>ID</strong></li><li><strong>Category Name</strong> or <strong>ID</strong></li><li><strong>Subcommunity Name</strong> or <strong>ID</strong></li></ul></li></ul><h2 data-id="filter-chart-data">Filter Chart data</h2><p>Controlling what data is shown in a Chart is accomplished via the <strong>Group By</strong> and <strong>Filter </strong>options.</p><ul><li>The <strong>Group By</strong> 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.</li><li>You can add <strong>Filters </strong>to your query to <em>drill into</em> or <em>exclude</em> specific types of events (e.g., exclude guests from traffic data or focus your Chart on traffic seen in a specific category).</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/LIDJXJ9QEXX1/groupby-and-filters.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/LIDJXJ9QEXX1/groupby-and-filters.png" alt="GroupBy_and_Filters.png" height="800" width="1160" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Let's learn about each of the available Group By and Filter options.</p><h2 data-id="type">Type</h2><p>Each moderation event has a <strong>Type</strong>. The type parameters define what happened. </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/3FEMFB5SW4CH/group-by-type.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/3FEMFB5SW4CH/group-by-type.png" alt="group_by_type.png" height="858" width="1385" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h3 data-id="user-bans"><strong>User Bans</strong></h3><ul><li><strong>ban</strong>: a user was banned</li><li><strong>unban</strong>:<strong> </strong>a user was unbanned</li></ul><h3 data-id="warnings"><strong>Warnings</strong></h3><ul><li><strong>warnUser</strong>: a warning is issued</li><li><strong>jail</strong>:<strong> </strong>a user was jailed</li><li><strong>reverseWarning</strong>:<strong> </strong> a warning was reversed</li></ul><h3 data-id="spam-moderation-queue-activity"><strong>Spam & Moderation Queue Activity</strong></h3><ul><li><strong>logSpam</strong>:<strong> </strong>a post was flagged as Spam</li><li><strong>logSpam_approve</strong>:<strong> </strong>a post flagged as Spam was reviewed, and approved</li><li><strong>logSpam_delete</strong>: a post flagged as Spam was reviewed and deleted from the Spam Queue</li><li><strong>logModerate</strong>:<strong> </strong>a post was flagged as Abuse</li><li><strong>logModerate_delete</strong>:<strong> </strong>a post flagged as Abuse was reviewed and deleted</li><li><strong>logModerate_approve</strong>:<strong> </strong>a post flagged as Abused was reviewed and approved</li><li><strong>logPending: </strong>a post was flagged for moderation by Keyword Blocker, Requires Approval Permission, or Pre-moderated category settings</li><li><strong>logPending_delete</strong>:<strong> </strong>a flagged post was reviewed and deleted</li><li><strong>logPending_approve</strong>:<strong> </strong>a flagged post was reviewed and approved</li></ul><h3 data-id="change-log-activity"><strong>Change Log activity</strong></h3><ul><li><strong>logDelete_approve</strong>:<strong> </strong>a Change Log entry was reviewed and reversed</li><li><strong>logDelete_delete</strong>:<strong> </strong>a deletion logged in the Change Log was reviewed and permanently deleted</li><li><strong>logEdit_delete</strong>:<strong> </strong>an edit logged in the Change Log was reviewed and permanently deleted</li><li><strong>Ban.delete</strong>:<strong> </strong>a ban logged in the change log is deleted </li><li><strong>logBan_approve</strong>:<strong> </strong>a ban logged in the change log is restored </li></ul><h2 data-id="disciplining-user">Disciplining User</h2><p>The <strong>Disciplining User</strong> is the user who performed the moderation action.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/TR9LHJFMNORO/group-by-discuser.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/TR9LHJFMNORO/group-by-discuser.png" alt="group_by_DiscUser.png" height="856" width="1112" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h3 data-id="examples"><strong>Examples</strong></h3><ul><li>Jane bans Joe; Jane is the Disciplining User</li><li>Alex warns Anna; Alex is the Disciplining User</li><li>Bruce flags Bill's post as Spam; Bruce is the Disciplining User</li></ul><p><strong>Group </strong>moderation data by:</p><ul><li>Disciplining User Name, ID, or UUID to see who is handling moderation in your community</li><li>Disciplining User Rank Name or ID to see which Ranks are contributing to moderation efforts</li><li>Disciplining User Role Type, Role Name, or ID to see which Roles are contributing to moderation efforts</li></ul><p><strong>Filter </strong>moderation data by:</p><ul><li>Disciplining User Name, ID, or UUID to see moderation activities performed by a specific user</li><li>Disciplining User Role Type, Role Name, or ID to see moderation activities performed by users of a specific role</li><li>Disciplining User Rank Name or ID to see moderation activities performed by users of a specific rank</li></ul><h2 data-id="disciplined-user">Disciplined User</h2><p>The <strong>Disciplined User</strong> is the user who required moderation.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/AW5S5WUOFGM8/group-by-disciplineduser.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/AW5S5WUOFGM8/group-by-disciplineduser.png" alt="group_by_DisciplinedUser.png" height="856" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h3 data-id="examples-1"><strong>Examples</strong></h3><ul><li>Jane bans Joe; Joe is the Disciplined User</li><li>Alex warns Anna; Anna is the Disciplined User</li><li>Bruce flags Bill's post as Spam; Bill is the Disciplined User</li></ul><p><strong>Group </strong>moderation data by:</p><ul><li>Disciplined User Name, ID, or UUID to see which users have required moderation</li><li>Disciplined User Rank Name or ID to see which Ranks have required moderation</li><li>Disciplined User Role Type, Role Name, or ID to see which Roles have required moderation</li></ul><p><strong>Filter </strong>moderation data by:</p><ul><li>Disciplined User Name, ID, or UUID to see moderation events for a specific user</li><li>Disciplined User Role Type, Role Name, or ID to see moderation events for a specific Role</li><li>Disciplined User Rank Name or ID to see moderation events for a specific Rank</li></ul><h2 data-id="discipline-type">Discipline Type</h2><p>Moderation events can either be <strong>positive </strong>or <strong>negative </strong>(referred to as its <strong>Discipline Type</strong>).</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/Z43IXUI12IRF/group-by-disciplinetype.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/Z43IXUI12IRF/group-by-disciplinetype.png" alt="group_by_DisciplineType.png" height="850" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><strong>Negative </strong>moderation events include:</p><ul><li>a user is banned</li><li>a warning is issued</li><li>a user is jailed</li><li>a post is flagged as Spam or Abuse</li><li>a flagged post is deleted from the Moderation Queues</li></ul><p><strong>Positive </strong>moderation events include:</p><ul><li>a user is unbanned</li><li>a warning is reversed</li><li>a flagged post is approved from the Moderation Queues</li></ul><h2 data-id="source">Source</h2><p>Each moderation event has a <strong>Source</strong>, which is the <em>source</em> that triggered the moderation event. </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/NFHTARCVJB3J/group-by-source.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/NFHTARCVJB3J/group-by-source.png" alt="group_by_source.png" height="848" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>These may include:</p><ul><li><strong>User</strong>: when moderators ban a community member, or approve and delete flagged content.</li><li><strong>Keyword Blocker</strong>: when a post is flagged for moderation because a user posted content containing a blocked word.</li><li><strong>Warnings</strong>: when a warning is issued, a user is banned or jailed, or a warning is reversed.</li><li><strong>CleanSpeak</strong>: when user content is flagged for moderation by our CleanSpeak integration.</li><li><strong>Reactions</strong>:<strong> </strong>when a post is flagged for moderation due to users reacting with the Spam and Abuse reactions.</li><li><strong>Akismet</strong>:<strong> </strong>when our spam filtering detects and flags spam for moderation</li><li><strong>Ban Rules</strong>:<strong> </strong>when a user is banned by configured Ban Rules.</li></ul><p><strong>Group </strong>moderation events by Source to see breakdown of the tools that are powering your moderation workflows.</p><p><strong>Filter </strong>moderation events by Source to review moderation events for a specific tool.</p><h2 data-id="warning-rule">Warning & Rule</h2><p>For all warnUser and reverseWarning moderation events, you can also see:</p><ul><li>the warning type issued, by <strong>Warning Name </strong>or <strong>ID</strong></li><li>the rule linked to the warning, by <strong>Rule Name </strong>or <strong>ID</strong></li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/PRW74MDS5RMY/group-by-warning-rule.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/PRW74MDS5RMY/group-by-warning-rule.png" alt="group_by_warning_rule.png" height="857" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><strong>📝 NOTE</strong>: 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. </p><h2 data-id="subcommunity">Subcommunity</h2><p>If your Vanilla community is leveraging Subcommunities, you can:</p><ul><li><strong>Group </strong>moderation data by Subcommunity Name or ID to see a breakdown of moderation events per subcommunity. </li><li><strong>Filter </strong>moderation data by Subcommunity Name or ID to see moderation events for a specific Subcommunity.</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/D2SZORZ8YZZW/group-by-subcommunity.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/D2SZORZ8YZZW/group-by-subcommunity.png" alt="group_by_subcommunity.png" height="623" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Some moderation events may not be linked to a Subcommunity. This can happen when, for example:</p><ul><li>a user is banned from the User Management Dashboard</li><li>a warning is issued from a users profile</li></ul><p><strong>📝 NOTE</strong>: When no subcommunity is linked to an event, you will see null or "Other" for Subcommunity Name and ID. </p><h2 data-id="category">Category</h2><p>Some moderation events may be linked to a specific Category when:</p><ul><li>A post is flagged for moderation</li><li>A flagged post is reviewed and approved or deleted</li><li>A user is warned for content posted in a specific Category</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/PNUNNV9L7M9F/group-by-category.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/PNUNNV9L7M9F/group-by-category.png" alt="group_by_category.png" height="653" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>You can:</p><ul><li>Group moderation data by Category to see a breakdown of where content is being posted that requires moderation</li><li>Filter moderation data by Category to see moderation events for a specific category</li></ul><p><strong>📝 NOTE</strong>: When no Category is linked to the moderation event you will see "null" or "Other" for Category Name and ID</p><h2 data-id="discussion">Discussion</h2><p>Some moderation events may be linked to a specific discussion when:</p><ul><li>A post is flagged for moderation</li><li>A flagged post is reviewed and approved or deleted</li><li>A user is warned for content posted in a specific category</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/UV48OB49R4U5/group-by-discussion.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/UV48OB49R4U5/group-by-discussion.png" alt="group_by_discussion.png" height="857" width="1079" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><strong>📝 NOTE</strong>: When no discussion is linked to the moderation event, you will see "null" or "Other" for Category Name or ID.</p> </article> </main>