Saurabh

francescolaffi

<h4>LATEST VERSION REQUIRE PHP 5.3+</h4>
<p>Site admins can already edit or delete every content in a BP community, but<br />
analyzing every content posted could be a crazy/impossible work in big communities.<br />
This plugin use crowdsourcing to help site admins finding contents to moderate.</p>
<p>It adds links/buttons to flag inappropriate user generated content in the site,<br />
so members can easily flag contents as inappropriate. Admins can then see all the<br />
reported contents in an organized table in the wp backend, order/filter them and<br />
take actions (ignore, delete, mark/unmark the content author as spammer, …).</p>
<p>Another table show members, how many posts from them have been reported/moderated,<br />
how many posts have they reported and moderated from admin. Here find bad/good<br />
members and take action on them.</p>
<p>Note on private messages:<br />
* private message sender: reporting this will flag the sender, not the thread, but the admin is not able to see the messages, effective against bulk spammer<br />
* private message: in this case a sender is reported in a specific thread, the admin can see the messages, more useful for moderation (eg k-12 communities)<br />
the latter is a bit hackish and could be less solid on future bp upgrades, the first one is based on apis that should be more stable</p>
<p>Use <a href="https://wordpress.org/support/plugin/bp-moderation" rel="ugc">support forum on wordpress.org</a><br />
for support and discussion.</p>
<p>The default style uses one icon from http://www.famfamfam.com/lab/icons/silk/<br />
(cc-by-2.5) and one from http://damieng.com/creative/icons/silk-companion-1-icons<br />
(cc-by-3.0), so if you use default style give credit to them somewhere in your site.</p>
<h3>Moderator panel</h3>
<p>You can access the backend panel from the “BP Moderation” link in your<br />
Wordpress admin menu.</p>
<p>There are three tabs on the top: “contents”, “users”, “settings”.</p>
<h4>Contents view</h4>
<p>In this view you can see the reported contents.</p>
<p>Use the custom query filter/order contents.</p>
<p>The contents table has three columns:</p>
<ol>
<li>info on the content author</li>
<li>info on the content itself ( and link to take actions on it on mouseover )</li>
<li>info on the flags on this content</li>
</ol>
<h4>Users view</h4>
<p>In this view you can see users that reported a content or users whom contents<br />
have been reported.</p>
<p>Use the custom query filter/order contents.</p>
<p>The contents table has three columns:</p>
<ol>
<li>info on the user itself</li>
<li>info on the contents generated by the user and flagged by others</li>
<li>info on the contents generated by others and flagged by the user</li>
</ol>
<h4>Hotkeys</h4>
<p>You can enable and disable hotkeys with the link displayed under contents and users tables.</p>
<p>I tried to make hotkeys similar wordpress comments table hotkeys, if you never<br />
used them, give a look to <a href="https://codex.wordpress.org/Keyboard_Shortcuts" rel="nofollow ugc">this codex page</a>.</p>
<p>When a row is selected with hotkeys the possible keys will be shown next to the actions links.</p>
<p>Hotkeys in both tables:</p>
<ul>
<li>j/k: moves down/up</li>
<li>x: check current row for bulk actions</li>
<li>shift+x: invert row selection</li>
<li>c: direct contact selected user (or selected content author)</li>
<li>s/u: mark as spammer selected user (or selected content author) / unmark him</li>
</ul>
<p>Only in contents table:</p>
<ul>
<li>v: view content</li>
<li>a: approve (ignore)</li>
<li>e: edit</li>
<li>m: mark as moderated</li>
<li>d: delete</li>
</ul>
<p>Only in user table:</p>
<ul>
<li>b: see the contents generated by the selected user and flagged by others in the content view</li>
<li>g: see the contents generated by others and flagged by the selected user in the content view</li>
</ul>
<p>Bulk hotkeys:</p>
<p>Some keys can be triggered on all selected rows if pressed with shift.<br />
Those keys are s,u,a,m,d.</p>
<h3>Integration guide</h3>
<p>= Introduction =<br />
This guide aims to explain how integrate bp-moderation with custom content types,<br />
wp/bp core content types are already covered by the plugin, but you can write your<br />
own custom content type definitions also for them.</p>
<p>It’s important to understand how bp-moderation differentiate/recognize contents:<br />
each content have to be identified by an internal content type slug (you choose<br />
it in your custom content type definition) and one or two bigint ids.</p>
<p>Decide a convention with 2 ids for your content type, is not something you can change<br />
later. You have to call bp-moderation methods using always the same convention and<br />
bp-moderation will use the same one when referring to your contents.<br />
If your contents are tied with the activity stream you already have chosen a convention<br />
for primary and secondary ids, using the same convention you use with activities<br />
will make things easier. If you only have one id use 0 for the secondary id.</p>
<h4>Register a content type</h4>
<p>The main entry point in bp-moderation is bpModeration::register_content_type(), it<br />
allows you to register a content type and has to be called at every page load.</p>
<p>You’ll need to provide:</p>
<ul>
<li>a slug: used to differentiate between content types  (alfanumeric and underscore only)</li>
<li>a label: human readable name of the content type (used in backend)</li>
<li>some callbacks: called by bp-moderation to request information/operations on your contents</li>
<li>activity types: the activity types that your content are posted on the activity stream with (if any)</li>
</ul>
<h4>Code sample</h4>
<pre><code>examples/bpMod_ContentType_BlogPostExample.php is a code sample that shows
</code></pre>
<p>how to integrate content types with bp-moderation taking blog posts as an example,<br />
you can also modify and adapt it to your content type.</p>
<p>Other informations are in the doc of <code>bpModeration::register_content_type()</code> and<br />
    bpModFrontend::get_link(), those are most likely the only two bp-moderation<br />
methods you need to use.</p>
<p>All core content types are in bpModDefaultContentTypes.php, but they are hardcoded<br />
for speed reasons, so don’t use them as an example.</p>
<h4>Advanced integration with activities</h4>
<p>If you use the same primary and secondary id convention for activities and bp-moderation<br />
you only have to tell the activity types of your content when registering,<br />
bp-moderation is already hooked in the activity loop and will print the links<br />
for your contents too.</p>
<p>Instead if some reason you cat use the same convention or you want to customize<br />
the activity loop flag button, you can use the filter</p>
<pre><code>    bp_moderation_activity_loop_link_args_{the activity type}
</code></pre>
<p>where <code>{the activity type}</code> is the activity type you’d like to filter.<br />
Look in <code>bpModFrontend::activity_loop_link()</code> to see what to filter.</p>
<h4>Contents generated by non members</h4>
<p>It’s possible to have contents generated by not members (e.g. blog comments).<br />
If you have to provide a user id to bp-moderation give 0 for it, but you’ll also<br />
need to filter author information for displaying them in backend table. Use the filter</p>
<pre><code>    bp_moderation_author_details_for_{slug used in content type registration}
</code></pre>
<p>to add missing info, look in <code>bpModBackend::author_details()</code> to see info needed.</p>
<h4>OK I coded my custom content type, and now?</h4>
<p>If you have coded a custom content type and you think that could be widely useful,<br />
contact me and it could easily get included in the bp-moderation plugin.</p>
<p>If you integrated your plugin and you prefer to keep the custom content type in<br />
your plugin it’s fine, I guess is more convenient and you can update it together<br />
with your plugin.<br />
Remember to check if bp-moderation is active before including unnecessary code<br />
or calling non-existing functions: safest way is to use the action <code>bp_moderation_init</code><br />
for including/registering it.</p>
<p>If none of the above this is the easier way to get a custom content type loaded:</p>
<ul>
<li>place your custom content type php file in <code>wp-content/plugins/bp-moderation-content-types/</code></li>
<li>copy this line in wp-config.php <code>define('BPMOD_LOAD_CUSTOM_CONTENT_TYPES', true);</code></li>
</ul>
<h4>Possible future content type system features</h4>
<ul>
<li>differentiate between trash, untrash and delete, or maybe custom actions on content</li>
<li>methods to be called when a content is edited/trashed/untrashed/deleted so bp-moderation<br />
can display also what happen outside of it</li>
</ul>


BuddyPress Moderation

Adds links/buttons to flag inappropriate content and gives a convenient way to moderators to view reports and take actions.

Automattic

Daniel Bachhuber

Thorsten Ott

<p>This plugin gives your visitors the possibility to report a comment as inappropriate. After a set threshold is reached the comment is put into moderation where the moderator can decide whether or not he want to approve the comment or not. If a comment is approved by a moderator it will not be auto-moderated again while still counting the amount of reports.</p>
<h3>Customizations</h3>
<p>By default this script should hook in just fine in most existing themes as it attaches itsself after the comment-reply link via the comment_reply_link filter.<br />
In case this does not work out you can place the flagging link manually by defining no_autostart_safe_report_comments in your themes’ functions.php file and initializing the class via <code>$safe_report_comments = new Safe_Report_Comments(false);</code>.</p>
<p>Here is an example of a custom setup via functions.php and placing the link comments callback function.</p>
<p>In functions.php:</p>
<pre><code>//flag comments plugin included in themes' functions.php - disable plugin.
define( 'no_autostart_safe_report_comments', true );
include_once( 'replace-with-path-to/safe-report-comments/safe-report-comments.php');
// make sure not to auto-attach to comment reply link
$safe_report_comments = new Safe_Report_Comments(false);

// change link layout to have a pipe prepended
add_filter( 'safe_report_comments_flagging_link', 'adjust_flagging_link' );
function adjust_flagging_link( $link ) {
    return ' | ' . $link;
}

// adjust the text to "Report abuse" rather than "Report comment"
add_filter( 'safe_report_comments_flagging_link_text', 'adjust_flagging_text' );
function adjust_flagging_text( $text ) {
    return 'Report abuse';
}
</code></pre>
<p>In your custom comment callback function used by wp_list_comments: https://codex.wordpress.org/Template_Tags/wp_list_comments place the following action which will print the link.</p>
<pre><code><?php do_action( 'comment_report_abuse_link' ); ?> 
</code></pre>
<p>A possible callback function could look like this:</p>
<pre><code>function mytheme_comment($comment, $args, $depth) {
    $GLOBALS['comment'] = $comment; ?>
    <li <?php comment_class(); ?> id="li-comment-<?php comment_ID() ?>">
        <div id="comment-<?php comment_ID(); ?>">
            <div class="comment-author vcard">
                <?php echo get_avatar($comment,$size='48',$default='<path_to_url>' ); ?>
                <?php printf(__('<cite class="fn">%s</cite> <span class="says">says:</span>'), get_comment_author_link()) ?>
            </div>
            <?php if ($comment->comment_approved == '0') : ?>
            <em><?php _e('Your comment is awaiting moderation.') ?></em>
            <br />
        <?php endif; ?>
        <div class="comment-meta commentmetadata"><a href="<?php echo htmlspecialchars( get_comment_link( $comment->comment_ID ) ) ?>"><?php printf(__('%1$s at %2$s'), get_comment_date(),  get_comment_time()) ?></a><?php edit_comment_link(__('(Edit)'),'    ','') ?></div>

        <?php comment_text() ?>

        <div class="reply">
            <?php comment_reply_link(array_merge( $args, array('depth' => $depth, 'max_depth' => $args['max_depth']))) ?>
        </div>
        <div class="report-abuse">
            <?php do_action( 'comment_report_abuse_link' ); ?>
        </div>
    </div>
    <?php
}
</code></pre>
<p>Furthermore there are various actions and filters within the script to allow easy alteration of implemented behavior. Please see inline documentation.</p>
<h3>Known issues</h3>
<p>Automatic mode implementation currently does not work with threaded comments in the last level of threading. As the script attaches itself to the comment_reply which is not displayed once the maximum threading level is reached the abuse link is missing at this point. As a workaround set the threading level higher than the likely amount of threading depth.</p>


Safe Report Comments

This plugin gives your visitors the possibility to report a comment as inappropriate. After a set threshold is reached the comment is put into moderat …

BuddyPress Moderation vs Safe Report Comments