Author 诗语

Lesson Display & Content Settings

The lesson content & display settings provide a way for you to use additional content on your lesson, as well as make it a little more interactive. You can include additional lesson materials, add some helpful logic to your video playback, allow users to upload assignments, and include a lesson timer.
Table of Contents [show]1 Locating Lesson Display & Content Settings2 Lesson Materials3 Video Progression4 Assignment Uploads4.1 File extensions4.2 File size limit4.3 Points4.4 Grading Type4.4.1 Limit number of uploaded assignments4.4.2 Allow file deletion5 Forced Lesson Timer5.1 Was this article helpful to you?
Locating Lesson Display & Content Settings

Navigate to LEARNDASH LMS > LESSONS
Click on the lesson you want to edit
Click on the Settings tab at the top of the page
Locate the section titled 「Display and Content Options」

Lesson Materials
Lesson materials are supplemental materials needed for the lesson. It is most common to include PDF files or other downloadable files in this area, but you can include anything you』d like (PDFs, images, downloadable audio files, links to other websites, etc.).

Next to Lesson Materials, turn the setting on
Add your materials in the box (HTML is supported)

Lesson materials are displayed to your users in a separate tab, alongside your main lesson content.

NOTE
Between video progression, assignment uploads & lesson timer, only one of the three can be enabled at a time. Enabling one of these options will make the other two inaccessible.
Video Progression
Video progression is a way to require users to watch the entirety of a video before they can complete the lesson. Please see our full guide on video progression.
Assignment Uploads
NOTE
Assignment uploads cannot be enabled if either video progression or lesson timer are enabled.

To allow users to upload assignments to the lesson, enable the Assignment Uploads option. You』ll be presented with a few additional options:
File extensions
You can specify exactly which file types may be uploaded.

Enter each allowed file type in the box (without the leading .)
Separate multiple file types with a comma
Leave blank to allow any file type to be uploaded

For example, enter the following to allow only Microsoft Word, Excel & PowerPoint files:

doc, docx, xls, xlsx, ppt, pptx

Here』s a list of common file extensions »
File size limit
You can specify the maximum file size allowed to be uploaded.

Enter a number, followed by M (for megabytes)

For example, to limit uploads to 5 megabytes, enter 5M.
NOTE
Your host also sets a maximum file size limit. The lower limit will always be used. If you』re having trouble receiving assignment uploads, you can contact your host and ask them to increase your maximum file upload size.
Points
If you』d like to award points to a user when they submit an assignment:

Next to Points, turn the setting on
Enter the number of points to be awarded for a submitted assignment

Grading Type
There are two options for how assignments are graded:

Auto-approve (default)
No grading or approval is needed. The assignment will be automatically approved & full points will be awarded.
Manually approve
An admin or group leader must approve the assignment. The lesson cannot be completed until the assignment is approved.

If you choose to manually approve an assignment, you have additional options:
Limit number of uploaded assignments
Enter a number in the box to specify the maximum number of files a user can upload for this assignment.

Leave blank for unlimited (default)

Allow file deletion
Enable this option to allow the user to delete their own uploaded files. This is only possible up until the assignment has been approved.
Forced Lesson Timer
Enabling a forced lesson timer will require the user to spend a certain amount of time on the lesson page before they can mark it complete. The lesson cannot be completed until the set time has elapsed.

Next to Forced Lesson Timer, turn the setting on
Enter the time in the following format:

HH : MM : SS (hours : minutes : seconds)

The countdown timer will appear below the 「Mark Complete」 button.

Was this article helpful to you?

Yes

No

Group Access Settings

The group access settings allow you to define a set of criteria for how a user gains and maintains access to your group and associated courses. This article will go through all the options, including payment settings, free access, prerequisites and more.
Table of Contents [show]1 Locating Group Access Settings2 Group Access Mode2.1 Free2.2 Buy Now2.3 Recurring2.4 Closed2.5 Was this article helpful to you?
Locating Group Access Settings

Navigate to LEARNDASH LMS > GROUPS
Click on the group you want to edit
Click on the Settings tab at the top of the page
Locate the section titled 「Group Access Settings」

Group Access Mode
Access mode is how you determine the way in which someone can gain access to a group (free with registration required, one-time payment, recurring subscription, admin-enrollment, etc.). LearnDash has four group access modes available.
Free
The following rules apply to Free groups:

Must be registered/logged in to access
No payment is required
「Enroll in Group」 button is shown to users not yet enrolled. They are sent through the registration process. See login & registration for more details.

The Free access mode is a good choice if you want users to self-enroll into the group.

Buy Now
The following rules apply to Buy Now (one-time payment) groups:

Must be registered/logged in to access
Requires a one-time fee to be paid (no free access)
Only works with the following payment methods: PayPal, Stripe & 2Checkout
Do not use if you』re selling group access via a shopping cart or membership plugin (see Closed below)

The Buy Now access mode does not allow you to use discounts/coupons. Consider using an ecommerce or membership integration, along with the Closed access mode.
When using the Buy Now mode, you need to enter a price in the Course Price field.

Select the Buy Now access mode
Enter your price in the Group Price field

NOTE
For both 「Buy Now」 and 「Recurring」 access modes, the user will be automatically enrolled into the group upon a completed payment.
Recurring
Recurring is very similar to Buy Now, except for recurring payments (as opposed to one-time payments).
The following rules apply to Recurring groups:

Must be registered/logged in to access
Requires a recurring fee (choose a billing cycle in X days, weeks, months or years)
Only works with the following payment methods: PayPal, Stripe & 2Checkout
Do not use if selling group access via a shopping cart or membership plugin (see Closed option below)

To set up the Recurring access mode:

Select the Recurring option
In the Group Price field, enter the amount you would like to charge
Enter the number of days/weeks/months/years at which frequency you would like the user to be billed
Choose either day(s), week(s), month(s) or year(s) from the dropdown

NOTE
Group access sold via PayPal will not be automatically revoked should the user stop the recurring payments. This will require the administrator to manually remove the user from the group.
Closed
The following rules apply to Closed groups:

Must be registered/logged in to access
Allows you to sell group access via an ecommerce or membership add-on*
Enables a custom Button URL field, which sends users to a custom sales or checkout page (a button is only shown if you enter a URL)
Option to manually enroll users into the group

When you choose Closed, you are essentially telling LearnDash to restrict access to your group. In order to enroll users into the group, one of the following (or both) can happen:

Let an ecommerce/membership add-on handle group access by associating the product or membership with the LearnDash group (see individual add-on instructions).
Manually add users  to the group (via the user』s WP Profile, or Group edit page). Must be an Administrator or Group Leader with proper capabilities enabled [insert URL].

NOTE
Existing groups created prior to LearnDash v3.2 will automatically be converted to the 「Closed」 access mode. You can edit these as needed.
 

Was this article helpful to you?

Yes

No

Developers

Code Reference (Hooks & Filters, Functions, and API)
Database Info
Transferring LearnDash Courses

Was this article helpful to you?

Yes

No

Lessons

Lessons are a place for you to start building out your actual course material. You can include text, images, video, audio, PDFs and virtually any other type of third-party or embeddable content. This section will explain everything you can do with LearnDash lessons—free sample lessons, timers, additional materials, assignments and more.

Global Lesson Settings
Settings applied to all lessons on your site
Configure Lesson Access
Sample lessons, drip content & schedule lesson availability
Display & Content Settings
Add materials, configure video settings, control assignment uploads & lesson timers
Create Lesson Content
Add text & images, insert videos, embed interactive content, etc.

If you』re looking to organize your course content even further, consider adding topics to your lesson, or grouping your lessons with course sections. You might also want to assign a quiz to a lesson.

Was this article helpful to you?

Yes

No

Database Info

Table of Contents [show]1 Custom Tables2 Other Tables Used by LearnDash3 Data of Deleted Users4 Additional Quiz Tables4.1 Was this article helpful to you?
Custom Tables
All LearnDash data is stored within the same database used to run WordPress. LearnDash does not store or connect to any external data sources to retrieve or store data about users, courses, quizzes, etc.
LearnDash has two database tables to contain the users Course and Quiz progress details.
The first table is wp_learndash_user_activity which works similar to the 『wp_posts』 table to record the activity type course, lesson, topic or quiz as well as the started and completed timestamps. This table is keyed by the 『user_id』 and』 post_id』.
The second table is wp_learndash_user_activity_meta which works like the 『wp_postmeta』. This table contains meta information related to the activity record in the main 『wp_learndash_user_activity』.
There is a referenced activity_id field to link the main activity row to the activity meta rows. This meta information is the same items stored into the user meta array elements and will be keys like 『steps_total』, 『score』, 『points』, etc. (basically key/value pairs of meta data needed to be stored as part of the activity record).
The process for populating these tables works in addition to the existing course and quiz progress. This means that when a user completes a lesson, the first part of the transaction will update the existing user meta array item. Afterwards, a secondary step will update the activity database tables. Please note that in future versions of LearnDash we will remove the dependence on the user meta array completely.
The database table details (schemas) are as follows:
CREATE TABLE `wp_learndash_user_activity` (
`activity_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
`user_id` bigint(20) unsigned NOT NULL DEFAULT '0',
`post_id` bigint(20) unsigned NOT NULL DEFAULT '0',
`activity_type` varchar(50) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
`activity_status` tinyint(1) unsigned DEFAULT '0',
`activity_started` int(11) unsigned DEFAULT NULL,
`activity_completed` int(11) unsigned DEFAULT NULL,
`activity_updated` int(11) unsigned DEFAULT NULL,
PRIMARY KEY (`activity_id`),
KEY `user_id` (`user_id`),
KEY `post_id` (`post_id`),
KEY `activity_status` (`activity_status`),
KEY `activity_type` (`activity_type`),
KEY `activity_started` (`activity_started`),
KEY `activity_completed` (`activity_completed`),
KEY `activity_updated` (`activity_updated`)
)
CREATE TABLE `wp_learndash_user_activity_meta` (
`activity_meta_id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
`activity_id` bigint(20) unsigned NOT NULL DEFAULT '0',
`activity_meta_key` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
`activity_meta_value` mediumtext COLLATE utf8mb4_unicode_ci,
PRIMARY KEY (`activity_meta_id`),
KEY `activity_id` (`activity_id`),
KEY `activity_meta_key` (`activity_meta_key`(191))
)
Other Tables Used by LearnDash

wp_postmeta
wp_posts
wp_usermeta
wp_users

Data of Deleted Users
When a user is deleted via WordPress it also deletes of the user』s meta data.
Deleting a user removes the Assignment and Essay custom post types created by that user.
Quiz related statistics stored into the table wp_wp_pro_quiz_statistic and wp_wp_pro_quiz_statistic_ref are also remove when the user is deleted.
Additional Quiz Tables

wp_wp_pro_quiz_category
wp_wp_pro_quiz_form
wp_wp_pro_quiz_lock
wp_wp_pro_quiz_master
wp_wp_pro_quiz_prerequisite
wp_wp_pro_quiz_question
wp_wp_pro_quiz_template
wp_wp_pro_quiz_toplist

Was this article helpful to you?

Yes

No

Lesson Page Content

The lesson page content is where you have full control over adding whatever content you』d like to your lesson. If you』ve added topics or quizzes to your lesson, LearnDash will automatically add a list of associated content to the bottom of the lesson page.
The lesson page content you add here is your own custom information that will be displayed above any associated topics or quizzes.
Table of Contents [show]1 Where to Add Lesson Page Content2 Lesson Title3 Lesson URL4 Lesson Content5 Featured Image5.1 Was this article helpful to you?
Where to Add Lesson Page Content

Navigate to LEARNDASH LMS > LESSONS
Click on the lesson you』d like to edit -or- click the Add New button
You will automatically land on the Lesson page tab
You can immediately start adding your content

GUTENBERG vs. CLASSIC EDITOR
This article assumes you are using WordPress 5.0 or greater, which includes the new WordPress editing experience (aka: Gutenberg). If you』re using the Classic Editor plugin, your experience will be different.
PAGE BUILDERS
If you』ve chosen to use a page builder plugin (Elementor, Beaver Builder, Divi, WPBakery, etc.) to edit your lesson content, you should refer to the page builder』s documentation on adding content.
Lesson Title
Your lesson title is the first thing you』ll see at the top of the editing screen. Look for a placeholder that says 「Add Lesson title.」
Most themes display the lesson title near the top of the page, below your header and/or global navigation.
Lesson URL
When you click inside of the 「Add Lesson title」 box, you』ll see an area appear above, labeled 「Permalink.」 This is your lesson URL.
The first two parts of the URL are not editable. They are determined by your site』s domain name and the lesson slug you have chosen (which will be /lessons/, unless you』ve customized your LearnDash permalinks).
You can edit the third part of the URL:
https://yoursite.com/lessons/your-lesson-permalink/
NOTE
If your URL looks different than above, it』s because you』ve enabled shared course steps. You can still edit the final part of the URL. Learn more about shared course steps »
In most cases, the permalink should be a reflection of your lesson title.

Click the 「Edit」 button next to the permalink
Type your new permalink
Hit Enter, or click the Save button

This shows a course URL but lesson URLs are edited the same way.
Lesson Content
Everything below the lesson title is a blank canvas for you to add your content. This is powered by the same WordPress editor used for pages, blog posts and other content types in WordPress.
Add text, insert images, embed videos or other multimedia content, link to PDFs or audio files… the possibilities are endless. You have full control over the type of learning experience you deliver to your users.
For more information on how to use the WordPress editor, please see the official WordPress Editor documentation.
Featured Image
The featured image is the main image associated with your lesson. Most WordPress themes will display this image near the top of your lesson page. It』s also the image we』ll display if you』re using the course grid add-on with the [ld_lesson_list] shortcode.

Look for the Featured Image panel in the sidebar
If it』s not already open, click on it to open it
Click Set featured image
Choose an image from your Media Library, or upload a new one
Click the Select button at the bottom

This shows a course image but lesson images work the same way.
NOTE
Where and how your lesson title, content & featured image are displayed is heavily dependent on your WordPress theme. If you』re experiencing layout issues with this content, please contact your theme developer.

Was this article helpful to you?

Yes

No

Group Users and Group Leaders

Groups are made up of two types of users. Enrollees (group users) who enroll into the group to take the related courses, and Group Leaders, who oversee and manage the group.

Table of Contents [show]1 Group Leader1.1 What is a Group Leader?1.2 Creating a Group Leader1.3 Assigning a Group Leader to a Group2 Group Users2.1 Was this article helpful to you?
Group Leader
What is a Group Leader?
Group Leader is a user role included in LearnDash. By default, it adds the ability to…

view reports on course progress for any user in the group
view reports on quiz performance for any user in the group
send email messages to the entire group

Group Leaders can also edit and create groups, as well as users. Read more about these Group Leader Settings here.
Creating a Group Leader
Before you can assign a Group Leader, you have to grant the Group Leader user role to the desired users (or create a new user as a Group Leader directly). After doing so, they will appear for selection when you create your group.

From your WordPress admin dashboard, navigate to USERS > ALL USERS
Select the checkbox next to the desired user(s)
From the Change role to… dropdown menu, select Group Leader
Click Change

Assigning a Group Leader to a Group
Once your Group Leader(s) have been created, you must assign them to the group. There are no limits on the number of Group Leaders that can be assigned to a group, but it must have at least one.
Assigning a Group Leader to a group is the same process as when you assigned courses.

Still on the Edit Group page…
Scroll down to Group Leaders
Choose on the user(s) you want to add as Group Leaders by clicking on their name. Hold CTRL (CMD on Mac) to select multiple courses at once.
Click the right arrow to move the user into the Assigned Group Leaders window

NOTE
A single Group Leader can oversee multiple groups.
Group Users
Any user role can be added as an enrollee of a group.
Adding users to your group is similar to how you added courses and Group Leaders.

Still on the Edit Group page…
Scroll down to Group Users
Choose the user(s) you want to add to the group by clicking on their name. Hold CTRL (CMD on Mac) to select multiple courses at once.
Click the right arrow to move the user into the Assigned Group Users window

Was this article helpful to you?

Yes

No

Shared Course Steps

Shared course steps allows you to reuse a lesson, topic and/or quiz across multiple courses. A few key reasons why you』d want to enable shared course steps include:
✅ Quickly create new courses with existing content from other courses
✅ Decrease bloat on your site caused by duplicate content
✅ Edit a step (lesson, topic or quiz) in a single place and that change will be reflected across all courses containing that step
WARNING
Once shared course steps is enabled, it should not be disabled without careful consideration. Any step (lesson, topic or quiz) associated to multiple courses will lose its association if the setting is disabled.
Table of Contents [show]1 Key Considerations1.1 Requires Course Builder1.2 Permalinks/URLs1.3 All Courses Listing Page2 Course Progression3 Enable Shared Course Steps4 Terminology4.1 Primary Association4.2 Secondary Association4.3 Bare URL5 Associated Content & Course Switcher5.1 Was this article helpful to you?
Key Considerations
Before you enable Shared Course Steps, please consider the following.
Requires Course Builder
Because your course step associations are no longer one-to-one, shared course steps requires you to use the LearnDash course builder.
Since steps can now be used across multiple courses, the course association dropdown—normally found within lesson, topic & quiz settings—is disabled.
Permalinks/URLs
Enabling Shared Course Steps will automatically change your permalinks structure to use nested URLs.
Here』s a topic URL without Shared Course Steps:
https://yoursite.com/topic/topic-name/
Here』s a topic URL with Shared Course Steps:
https://yoursite.com/courses/course-name/lessons/lesson-name/topic/topic-name/
All Courses Listing Page
In the WordPress admin area, the lesson, topic & quiz listing pages will no longer have an 「Assigned Course」 column.
However, you can use the course filter dropdown to view all steps assigned to a particular course.

Course Progression
Progression will always be tracked on a per-course basis. If a user completes a step in one course, it will not be marked complete in other courses where that step is also associated. This applies to lessons, topics and quizzes.
Enable Shared Course Steps

Navigate to LEARNDASH LMS > COURSES
Click on the Settings tab
Scroll down to the Global Course Management & Display Settings section
Make sure the 「Course Builder」 is turned on
Next to 「Shared Course Steps,」 flip the toggle switch on
Save your changes

Terminology
Primary Association
A primary association means that the step was associated to the course before the Shared Course Steps setting was enabled. More specifically, you will see some courses designated as the 「primary course」 for the related step, if the association took place before enabling shared course steps. You can have a maximum of one primary association for any given step.
Secondary Association
A secondary association means that the step was associated to the course after the shared course steps option was enabled. More specifically, you will see some courses designated as 「other course」 for the related step, if the association took place after enabling shared course steps. You can have more than one secondary association.
Bare URL
A bare URL refers to the standalone component』s URL. For example, we needed a way for admins to have the ability to view a lesson, topic or quiz even if it was not yet assigned to a course (i.e. cannot use nested URL that would normally include the course slug). Only administrators can access bare URLs.

Example Bare URL: https://yoursite.com/lessons/lesson-name/
Example Nested URL: https://yoursite.com/courses/course-name/lessons/lesson-name/

Associated Content & Course Switcher
Once Shared Course Steps is enabled, a new 「Associated Content」 box will appear when editing courses, lessons, topics & quizzes. It』s located at the bottom of the sidebar:

Note:
The Associated Content box is NOT for assigning or moving content between courses. It functions as a way to show you what content the item is currently associated with. Instead, if you want to add, change, or remove the step from a course, you will need to use the Course Builder
When editing a course, the Associated Content box will list all lessons, topics & quizzes that have been associated with that course. You can click on any course step to go directly to it』s edit screen.
When editing a lesson, topic or quiz, you』ll see the same thing. In addition, there is a Course Switcher dropdown. This allows you to view the lesson/topic/quiz』s associated content for a different course (if it』s associated with more than one course).

Was this article helpful to you?

Yes

No

404 Errors on LearnDash Pages

There are many reasons why you may be seeing a 404 error. One common reason is when a theme or plugin calls a flush rewrite rule. Here are a couple things you can try:
Table of Contents [show]1 Step 12 Step 22.1 Was this article helpful to you?
Step 1
Try re-saving your WordPress permalinks:

Navigate to SETTINGS > PERMALINKS
Scroll to the bottom and click Save Changes

This performs a hard flush of your rewrite rules and will update your .htaccess file. This is a plugin- & theme-agnostic solution that corrects 404 issues the majority of the time.
Step 2
If you』re still having issues, try to reverse any recent changes you made on your site. Did you update a theme or plugin? If so, try deactivating the new plugin or revert to a prior version of the theme. You should also test with a default WordPress theme, like Twenty Nineteen. After reversing your changes, repeat Step 1.
If you』re still having issues, please contact support.

Was this article helpful to you?

Yes

No

LearnDash Overview

LearnDash is a WordPress learning management system (LMS) trusted by companies, universities, training organizations, and entrepreneurs worldwide for creating (and selling) their online courses.
The structure and delivery of LearnDash courses is based on instructional design principles used in learning programs at Fortune 500 companies:

The top-level is Course.
Below that you have Lessons. Lessons are assigned to Courses. Lessons can optionally be grouped into Sections.
Below Lessons you have Topics. Topics are assigned to Lessons just like Lessons are assigned to Courses.
Finally, there are Quizzes. Quizzes can be assigned to a Course, Lesson or Topic.

NOTE
The terminology can be changed using custom labels, but the general structure remains the same. For example, 「Lessons」 can be renamed 「Modules,」 「Quizzes」 can be renamed to 「Tests,」 and so on.
The software itself has a variety of options, and you also have the ability to add functionality using free and paid add-ons. For optimal performance (and a decreased risk of compatibility issues) we recommend only installing the add-ons that you need.
How LearnDash Modifies WordPress
Upon activating LearnDash, several items are added to your site in order for it to function properly:

New menu items, custom post types and taxonomies for courses, lessons, topics, quizzes, questions, assignments and essays
New widgets & shortcodes
New database tables
Group Leader user role

Was this article helpful to you?

Yes

No