LearnDash

#Overview

Using WP Fusion and LearnDash, you can automatically add students to your CRM of choice when they register on your site.

You also can restrict access to course content using tags in your CRM, apply tags based on progress, and use tags as automated triggers for course and group enrollments.

#Restricting access to content

You can restrict access to Courses, Lessons, and Topics based on a user’s CRM tags, and redirect them to another page (like a sales page) if they don’t have the required tags.

You can also apply tags to a user when they’ve begun a course, lesson, or topic, and likewise when it has been marked complete.

See the screenshot below for an example of the options WP Fusion offers you when configuring a LearnDash lesson or topic:

For more information on restricting access to content and the main WP Fusion meta box, see the documentation here.

#Lesson, topic, and quiz access rules

By default, if a course is protected by WP Fusion, then every lesson, quiz, and topic in that course will inherit the same access rules.

If needed you can override this by configuring the WP Fusion meta box on any lesson (or quiz or topic) individually. If access rules have been specified on any lesson, quiz, or topic, then those rules will take priority over the course settings.

#Course settings and auto-enrollment

WP Fusion also adds some options specific to LearnDash courses. You can find these on the WP Fusion settings panel when editing any course.

There are nine settings here:

• Apply tags – Marked Complete: These tags will be applied in your CRM when a user fully completes the course.
• Apply tags – Enrolled:  These tags will be applied to a user when they are enrolled in the course, either manually, via a free signup, or another plugin integration. They will not be removed if the student is removed from the course, and they do not affect automated enrollments. They will not be applied if the user is given access to the course as part of a group.
• Remove Tags: When this is checked, the tags applied at enrollment will be automatically removed if the user is unenrolled from the course.
• Link with tag: Using this setting you can “link” a tag in your CRM with a LearnDash course. When this tag is applied, the user will automatically be enrolled in the course. If the tag is removed, the user will be un-enrolled. Likewise if the user is enrolled in the course (either manually or via a purchase) the linked tag will be applied, and if a user is removed from the course the linked tag will be removed.
• Unenroll from Course when Linked Tag is Removed: By default, WP Fusion will unenroll a user from a course when their linked tag is removed. However, if you are using drip-released content, this could cause a payment failure to remove the user from the course, and when they re-enroll the content drip will start over from the beginning. Disabling this setting will leave the user enrolled in the course when the linked tag is removed. In this case, it’s recommended to also protect access to the course with a tag, so users can’t access the course until they’ve reactivated their subscription.
• Course Navigation: This setting controls how WP Fusion handles the display of restricted lessons and other content in the course navigation. The options are:
  • Default: The course navigation will show all content, regardless of the user’s CRM tags.
  • Lock lessons: Lessons the user cannot access will show as disabled. You can optionally specify a message to be displayed as a badge on any locked lessons. See below for more info.
  • Filter Course Steps: Lessons the user cannot access will be completely removed from the course navigation and progression. This can be used to create personalized courses based on a user’s tags in your CRM (aka “Adaptive Learning”). See below for more info.
• Field – Course Progress: You can optionally select a custom field in your CRM to be used for course progress tracking. When a user’s course progress is updated, their course completion percentage will be synced to the selected custom field.
• Field – Course Enrollment Date: The selected field in your CRM will be updated with the student’s course enrollment date.
• Field – Course Enrollment Expiration Date: If your courses are set to exipre, this field will be updated with the student’s course access expiration date (at the time they enroll in the course).

#Lock lessons

If you’ve protected lessons and topics using CRM tags, you can optionally enable the Lock Lessons setting on the course (see Course Settings, below) to display those lessons as locked in the course navigation.

The default locked lesson text is “Not Available”. You can override this globally at Settings » WP Fusion » Integrations » LearnDash, or on individual courses by editing the Locked Lesson Text option.

The Locked Lessons feature also works with the BuddyBoss app. In that case, the lesson will be displayed as disabled.

If someone tries to open it, the Locked Lesson Text will be displayed in a popup.

#Filter Course Steps

This feature (available in LearnDash v3.4.0+) applies WP Fusion’s access rules to each step in the course, (such as lessons, topics, or quizzes). This is the same as enabling Filter Queries, but it can be enabled for individual courses.

When a user doesn’t have access to the step, based on their CRM tags, the step will be hidden from the course navigation, and won’t be required for course completion.

You can use this to create personalized course experiences and objectives for different users based on their CRM tags. For more info see this blog post.

#Strategies for managing course access

There are two common ways to manage LearnDash course access with WP Fusion:

1. (Recommended) Use LearnDash to manage access to the course content, and WP Fusion to trigger enrollments into the course based on tags in your CRM.

This is our recommended setup since it has the best compatibility with LearnDash. With this setup you would:

• Leave Users must be logged in to view this course un-checked in the WP Fusion meta box
• Set the course access type to Closed
• Set an auto-enrollment tag on the course

With this method, LearnDash handles the display of the course overview page based on whether or not a user is enrolled in the course.

This also works properly with Sample Lessons in LearnDash, and drip-feeding course content.

By applying a tag in your CRM, a user can automatically be enrolled in the course (see Auto-enrollment above), and the course overview page will update accordingly.

When a user is enrolled in the course it will also properly update the LearnDash Course Grid, the BuddyBoss enrolled courses list, and any other plugins that work with LearnDash.

For handling course bundles or “all access passes”, you can also use auto-enrollment tags with LearnDash groups. This lets you create different collections of courses that are managed by a single auto-enrollment tag.

2. (Not recommended) Use WP Fusion to manage access to the course content, bypassing LearnDash’s access rules.

WP Fusion adds a meta box to every post and page on your site that allows you to protect your content using tags in your CRM, and redirect the user to another page if they don’t have the required tags.

Using this meta box you can also protect your LearnDash courses and course content based on CRM tags. With this setup you would:

• Select Users must be logged in to view this course in the WP Fusion meta box, and choose some required tags to view the course
• Either select a redirect in the meta box, or leave the redirect blank to display the restricted content message
• Set the course access type to Open
• Do not set an auto-enrollment tag on the course

With this method, every user on the site is automatically enrolled in the course, but they can only view the course content if they have the right tags.

The problem with protecting the visibility of the course with a tag is that you lose all of the LearnDash options for customizing the page appearance when people aren’t enrolled. As well, the user will see themselves as enrolled in all courses, even if they don’t have access— which could be confusing for your students.

For that reason it’s recommended to let LearnDash handle protecting your course content by setting the course access type to Closed, and then using an auto-enrollment tag so that WP Fusion can update student enrollments.

#Quizzes

WP Fusion includes a few settings specific to LearnDash quizzes. These will appear in the WP Fusion tab when editing any quiz in the admin.

In addition to the standard access control options, the available quiz options are:

• Apply these tags when essay submitted: These tags will be applied in your CRM when a student has submitted an essay. They can be used to trigger an email to the student, or (for example) to create a task for the instructor to grade the essay.
• Apply these tags when quiz passed: These tags will be applied in your CRM when a quiz is submitted and the user has a passing score.
• Apply these tags when quiz failed: These tags will be applied in your CRM when a quiz is submitted and the user has a failing score.
• Field – Final Score: This option allows you to sync a student’s final quiz score (as a percentage) to a custom field in your CRM. It will be updated each time the quiz is submitted.
• Field – Final Points: This is the same as the Sync final score setting except instead of the quiz score, the total points earned by the user will be synced to the selected custom field.
• Field – Category Scores: If your quiz has question categories, you can sync the score for each question category to a separate custom field in your CRM.

#Quiz questions

Using WP Fusion you can sync the answers to individual quiz questions to custom fields in your CRM. This can be configured within the WP Fusion meta box when editing any single quiz question.

#Groups

WP Fusion’s settings for LearnDash groups can be found under Settings » Group Access Settings when editing any group.

Similar to Courses, the are four settings here:

• Apply tags – Enrolled:  These tags will be applied to a user when they are enrolled in the group, either manually, via a free signup, or another plugin integration. They will not be removed if the student is removed from the group, and they do not affect automated enrollments.
• Remove Tags: When this is checked, the tags applied at enrollment will be automatically removed if the user is unenrolled from the group.
• Link with Tag: Using this setting you can “link” a tag in your CRM with a LearnDash group. When this tag is applied, the user will automatically be enrolled in the group. If the tag is removed, the user will be un-enrolled. Likewise if the user is enrolled in the group (either manually or via a purchase) the linked tag will be applied, and if a user is removed from the group the linked tag will be removed.
• Link with Tag – Group Leader: This setting works similarly to Link with Tag, except for group leaders instead of group members. When this tag is applied, the user will automatically be set as the leader of the group. If the tag is removed, the user will be un-enrolled from the group leader position.

#Assignments

WP Fusion allows you to automatically tag students in your CRM when they upload an assignment to a LearnDash lesson.

This setting appears when editing any lesson where assignment uploads are enabled.

#Syncing course progress

In addition to syncing course progress on individual courses, WP Fusion adds several “pseudo” fields that enable syncing a student’s overall LearnDash progress to custom fields in your CRM. This can be configured under Settings » WP Fusion » Contact Fields.

The fields are:

• Last Course Enrolled: When a student is enrolled in a course, the name of the course will be synced.
• Last Lesson Completed: When a lesson is marked complete, the name of the lesson will be synced.
• Last Lesson Completed Date: When a lesson is marked complete, the date and time will be synced.
• Last Topic Completed:When a topic is marked complete, the name of the topic will be synced.
• Last Course Progressed: Whenever a student completes any content in a course (lesson, topic, quiz, etc.) the name of the course will be synced.
• Last Course Completed: When a course is marked complete, the name of the course will be synced.
• Last Course Completed Date: When a course is marked complete, the date and time will be synced.

You can use these fields to track progress in your CRM and potentially reduce the number of tags that need to be applied to a contact.

#ThriveCart

Using the LearnDash + ThriveCart extension you can automatically enroll new students into LearnDash courses after a successful ThriveCart purchase.

With LearnDash 3.4.0 and higher, WP Fusion can automatically detect new users imported from ThriveCart, and sync their randomly generated password back to your CRM for sending in a welcome email. To enable this, simply turn on the Return Password setting from the Webhooks section in the WP Fusion settings.

#Event Tracking

Using the Event Tracking addon, you can track LearnDash course progress as events in supported CRMs.

Events can be configured in two places. On an individual course, in the Settings panel, on the WP Fusion metabox:

Or in the Event Tracking global settings:

If your CRM supports multi-key events, you will see additional options for syncing event data.

The available triggers and merge fields for event tracking with LearnDash are:

• Course Started: Triggered when a user enrolls in a course.
  • {id}: The course ID.
  • {title}: The course title.
  • {last_completed_step}: The title of the last lesson, topic, or quiz completed in the course.
  • {course_progress}: The student’s percentage progress in the course.
• Course Progress: Triggered whenever a lesson, topic, or quiz is completed within the course, as well as when the course itself is completed.
  • {id}: The course ID.
  • {title}: The course title.
  • {last_completed_step}: The title of the last lesson, topic, or quiz completed in the course.
  • {course_progress}: The student’s percentage progress in the course.
• Quiz Completed: Triggered whenever a quiz in this course is marked complete.
  • {id}: The quiz ID.
  • {title}: The quiz title.
  • {percentage}: The student’s quiz score as a percent.
  • {points}: The student’s total quiz points.

#Batch operations

WP Fusion includes two batch processing tools to retroactively apply tags in your CRM based on each user’s current course and/or group enrollments in LearnDash.

These are found at Settings » WP Fusion » Advanced » Batch Tools.

#Course enrollment statuses

When you run the LearnDash course enrollment statuses operation, WP Fusion will check the current course enrollments for each user on your site, and apply any tags configured for that course.

This will not apply any tags if the user is enrolled in a course as part of a LearnDash Group.

This will not update any course or group enrollments (via linked tags), it only applies tags in your CRM.

#Course progress

The LearnDash course progress batch operation will check the course progress for each user on your site, and retroactively apply any tags configured in the Apply tags when marked complete setting for every course, lesson, topic, and quiz the user has already completed.

#Enrollment Date & Expiration

When you have enabled Course access expiration to a course, WP Fusion will sync the data a user has enrolled in the course with your CRM when they are added to a course, as well as the date that that user’s enrollment expires.

#Group enrollment statuses

When you run the LearnDash group enrollment statuses operation, WP Fusion will check the current group enrollments for each user on your site, and apply any tags configured for that group (the Apply Tags – Enrolled and Link With Tag settings).

This will not update any course or group enrollments (via linked tags), it only applies tags in your CRM.

#Progress meta

The LearnDash progress meta batch operation syncs any enabled progress meta fields (Last course enrolled, last course completed, last course completed date, course completion percentages, etc.) to the selected custom fields in your CRM. It does not apply any tags or affect enrollments.