This custom hook allows you to award or deduct points from your users for watching YouTube Videos. The Video Add-on (premium) replaces this hook and adds support for Vimeo as well as YouTube.
This hook supports three different ways you can reward your users for watching a video:
Play
Points are triggered as soon as the user starts watching the video. Points will trigger even if the user selects to pause the video immediately after it has finished loading.
Full
Points are triggered once a user has finished watching the entire video. Since a lot of things can go wrong while watching a full video, a leniency percentage must be set. This leniency value is the maximum percentage a users view of a movie can differ from the actual length they watch.
Interval
Awards or deducts points for every x number of seconds watched of the video.
Available since version 1.2
Known Issues
Only videos that are embedded using the mycred_video shortcode will reward points! Furthermore, if you reward users using the Interval method, no badges or ranks will trigger!
In it’s current form, neither the free or the premium version of this hook supports awarding multiple point types at the same time for watching a video!
Setup
The amount value, logic and log entry template in this hooks settings are your default settings. You can override these values when you use the mycred_video shortcode. A default value must be set to enable the hook. The hook will not work if you set the default amount to zero.
| Instance Reference | Description |
|---|---|
watching_video |
Give or take points from users for watching videos. |
A pro version of this hook is available in the myCRED store that adds support for Vimeo video embeds, and the option to show the users how much points they have earned when watching a video.
