How to install and use the rtMedia myCRED Add-on

myCRED is a point management system for WordPress sites. Through the rtMedia myCRED addon, you it is possible to assign points for various media-related activities that rtMedia provides.

Points

Points can currently be assigned for the following activities:
(Some activities require additional addons; these are noted where applicable)

---

Upload	Image
	Audio
	Video
	Document	rtMedia Docs and Other Files
View	Image
	Audio
	Video
	Document	rtMedia Docs and Other Files
Media	Like
	Edit
	Delete
	Comment
	Set Featured
	Rate	rtMedia 5 Star Rating
	Report	rtMedia Moderation
	Download	rtMedia Direct Download Link
Album	Create
	Edit
	Set Cover	rtMedia Set Custom Thumbnail for Audio/Video
Misc.	Create Playlist	rtMedia Playlists

Setup

myCRED plugin

The rtMedia myCRED integrates myCRED points with media-related activities. Thus, the basic (free) version of the myCRED plugin needs to be installed and activated on your website.

Setting up myCRED Hooks

Once myCRED and rtMedia myCRED have both been installed and activated, a new myCRED Points tab will appear under rtMedia Settings.

Click on this tab, and the follow “Setup myCRED here” link.

Step 1: From the “Active Hooks” section, delete the default “rtMedia Galleries” integration and add the “Points for rtMedia” block instead:

Step 2: Assign points for activities as suitable, and set limits. The “Log template” field can be used to set text strings that will appear in the Points Log when points are awarded to a user.

Remember to save after making any changes! The “Save” button is right at the bottom of the “Points for rtMedia” section.

Limits

It is possible to limit the maximum number of points that can be awarded to a user over a period of time. Points can be limited independently for each rtMedia activity.

Limits can be configured to apply over a period of a day, week, month or in total (irrespective of time).

In the above screenshot, every user will be awarded 2 points for every comment, for his/her first 10 comments of the day. This will set a maximum of 20 (2 x 10) points per day. Subsequent comments will not result in points being credited to the user till the day ends.

Points Log

The Points log under Points > Log in the WordPress Dashboard displays a detailed list of all points activity. Log entries can be filtered & edited if required.

To edit an entry, hover over it and click on the Edit option. A popup will display more details along with the option to permanently update the entry:

Filters

• rtmedia_mycred_point

rtmedia_mycred_point

Use this filter to limit the number of points for media author.
For example, the snippet below will limit the number of points added to a user when s/he comments on his/her own media.

function rtmedia_mycred_point_for_comment_callback( $cred_details, $name, $rtmedia_points_media_id, $media, $arguments ) {

    if ( isset( $rtmedia_points_media_id ) ) {
        $model = new RTMediaModel();
        $media = $model->get_media( array(
            'id' => $rtmedia_points_media_id,
        ), 0, 1 );

        if ( 'after_comment' == $name ) {
            $media_author = $media[0]->media_author;

            if ( $media_author == $cred_details['user'] ) {
                $cred_details['media_point'] = 1;
            }
        }
    }

    return $cred_details;
}
add_filter( 'rtmedia_mycred_point', 'rtmedia_mycred_point_for_comment_callback', 10, 5 );