Skip to content

PRO - requires MediaShield Pro. For Learnomy, see the note under “Supported course plugins”.

Link a MediaShield video to a lesson in your course plugin. When a student finishes the video, the lesson is marked complete. You can also limit a video to students enrolled in the course.

Students’ progress in your course plugin updates by itself when they finish the video, so nobody has to tick lessons by hand. You can also keep a video for enrolled students only.

  • Your course plugin is active: LearnDash, Tutor LMS or LifterLMS.
  • The lesson exists, and the video is in your MediaShield library.
  • Students are logged in. Guests never trigger completion.
Course plugin What you can link Detected by
LearnDash Lessons and topics LearnDash is active
Tutor LMS Lessons Tutor LMS is active
LifterLMS Lessons LifterLMS is active

Detection is automatic. If none of these is active, the LMS Integration box does not appear on the video screen and the LMS card does not appear under Settings.

Learnomy works differently. Learnomy is not one of the three adapters above. The free MediaShield plugin supplies Learnomy with a signed embed link for a video when the lesson’s content type is MediaShield. Lesson completion in Learnomy is handled by Learnomy, not by this Pro feature. Other course plugins can be added by a developer. See Hooks and Filters.

  1. Go to Videos and open the video.
  2. In the side column, find LMS Integration.
  3. Under the lesson list, choose the lesson. Lessons are grouped by course. LearnDash topics are marked “(Topic)”.
  4. Set Complete at % (below).
  5. Optionally tick Require enrollment to watch.
  6. Click Update.

Each list shows up to 200 lessons (and up to 200 topics in LearnDash). On a larger catalogue some lessons will not be offered.

Once a video is linked, MediaShield adds the player to the end of that lesson’s content for you. Nothing else is needed.

  • If the lesson already contains a [mediashield ...] shortcode, MediaShield leaves it alone so the video does not show twice.
  • Access rules still apply. If the visitor fails the login, role or enrollment check, no player is added.
  • To place it yourself, paste [mediashield id=N] where you want it. Use the number shown in the video’s Embed This Video box.

A developer can turn automatic placement off with a filter.

MediaShield records milestones at 25, 50, 75 and 100 percent. A lesson completes at the first milestone that is at or above your Complete at % value, so a setting of 90 completes the lesson at the 100 percent milestone, because there is no 90 percent milestone.

Choice Lesson completes at
Use global default The site-wide value (default 100)
100% (Must watch entire video) The 100 percent milestone
90% The 100 percent milestone
75% The 75 percent milestone
50% The 50 percent milestone

Milestones fire once per student per video, for good. Rewatching does not fire them again.

Tick Require enrollment to watch on a video. Students who are not enrolled in the course that contains the linked lesson are blocked, with the message “You must be enrolled in this course to watch this video.” Administrators always pass. Guests are blocked.

The check applies only when the video has a linked lesson and the box is ticked. If the course plugin is not available (for example it was deactivated), playback is allowed rather than locking everyone out.

Open MediaShield > Settings and find the LMS Integration card. It shows only while a supported course plugin is active.

Setting Default What it does
Auto-complete lessons On Marks the linked lesson complete when the viewer reaches the completion point. Off stops completion everywhere
Require enrollment On The master switch for enrollment checks. On means each video’s own checkbox decides. Off disables enrollment checks on every video, even ones with the box ticked
Global completion % 100 The value used by videos set to “Use global default”. Choices are 25, 50, 75, 90 and 100. Values below 10 are raised to 10

Per-video values (stored on the video):

Per-video setting Default What it does
Linked lesson none The lesson this video completes and gates
Complete at % Use global default Overrides the global value
Require enrollment to watch Off Gates this video by enrollment

Lesson completion and Milestone Actions respond to the same milestone. They are independent. Both can fire, and turning one off does not affect the other.

On the lesson page the viewer sees the protected player at the end of the lesson content. If they are not enrolled and the video requires it, they see “You must be enrolled in this course to watch this video.” instead of the player. When they reach the completion point, the lesson shows as complete in the course plugin.

If a lesson does not complete, see Troubleshooting.