LearnDash Attendance Add-on - Overview

Installation:

  • Install the LearnDash plugin & activate it.
  • Install and activate the Learndash Attendance Add-on.
  • After activation, the “Attendance” sub-menu will be added under the LearnDash menu.


 A “Mark Attendance” button will be visible to enrolled students. By clicking the button,  students can mark their attendance in the course. 

License Key:

The license key is configured on the License Option tab of the LearnDash Attendance Settings. License keys are delivered by email after the purchase of the add-on.

Enter the license key in the corresponding field and click on Activate.




General Settings:

To locate the general settings for this add-on: select LearnDash LMS, click on the “Attendance” sub-menu and select the “General Option” tab.

  • Restrict IP:

When this option is enabled, students will only be permitted to mark attendance from a single static IP address.

A “Restricted IP” message will be displayed if students mark their attendance from a different IP address.

  • Enable Admin Mark Attendance:

If enabled, only users with Admin and Group Leader roles will be able to mark attendance for students. 

 A “Mark Attendance” tab will be added at the course, lesson, and topic pages, but will only be visible to Admin and Group Leaders.

Course Page:Lesson Page:Topic Page:To mark attendance for students as an Admin or Group Leader, follow these steps:

  • Click on the “Mark Attendance” tab and go to the “Mark attendance for selected enrolled students” field.
  • Select enrolled students.
  • Select the Present or Absent option.
  • Click the “Mark Attendance” button.

After clicking the “Mark Attendance” button, the message “Students attendance marked successfully” will be displayed. Admins and Group Leaders can mark attendance for multiple students at a time. Keep in mind that Group Leaders can only mark attendance for students that are members of their group.

  • Delete Attendance On Uninstall:

If enabled, all course and user attendance data will be deleted when the add-on is installed.

  • Enable Automatic Attendance on Login:

If enabled, attendance for all courses a user is enrolled in will be automatically marked when the user logs in. 

  • Disable mark attendance for users:

By enabling this option, the users won't be able to mark their attendance from courses lesson, and topic pages.  Only group leaders and admins will be able to mark the attendance for students.

  • Disable attendance report send to user's email:

If this option is enabled, users won’t receive emails with their attendance reports.

  • Send attendance report- Weekly/Monthly:

This option lets you select how often attendance reports will be sent to your students.

If the “Weekly” option is selected, email reports are sent every Friday. If the “Monthly” option is selected, then email reports will be sent on the last day of every month.

  • Display Attendance Count in Number/ Percentage:

Here you can select whether attendance data is displayed in Number or Percentage in the email reports.



  • Attendance Logs:

Admins can see the attendance count of all enrolled students on the Attendance Logs tab of the Attendance Settings page. Group Leaders can also view the attendance count for all their group members.

You can locate the Attendance Logs by navigating to LearnDash LMS from the dashboard, selecting Attendance, and clicking on the “Attendance Logs” tab.

Admin’s Dashboard:Group Leader’s Dashboard:

You can find the Attendance Logs by navigating to LearnDash LMS from the dashboard and logging into the Group Leader’s account, selecting Attendance, and selecting Attendance Logs.

Attendance reports can be grouped "By Course,” "By Lesson,” “By Topic,” “By User,” or “By All absent logs.” Then hover over a particular user or course and click “View Detail Logs.” There is a filter for the attendance table which lets you select whether you want to display present or absent attendance data.The attendance reports table has the following filters: Course, Lesson, Topic, and Date Range. Filters allow admins to narrow down their search quickly and export the filtered attendance logs in CSV file format.


  • Time Logs:

Admins and the group leaders can see the time users have spent on LearnDash course contents on the Time Logs tab. The admin or the group leader can filter the time logs according to the Courses, Lessons, Topics and Quizzes.



  • Mark Attendance:

Admins can manually mark attendance for a single user or for multiple users on the “Mark Attendance” tab.  Admins can then select the courses, lessons, and topics that attendance will be marked for. 


Finally, the admin can determine whether attendance will be marked as present or absent The admin can also select a date range for attendance markings and add a message that will be displayed when attendance is marked as present or absent.



  • Help:

You can view all the possible LearnDash Attendance shortcodes on the Help tab. Shortcodes are used to display a list/table of users with the best attendance records on any page or post.

The shortcode required to display the LearnDash Top Attendance list on a page or post is as follows:

<em><strong></strong></em><strong>[ld_attendance]</strong><em><strong></strong></em>

You can alter the list displayed by setting different short-code parameters as seen here:

<strong>[ld_attendance display="table" course_ids="xxx" user_ids="current" title="Week top attendance" time_frame="13-01-2020,17-01-2020" count="percentage" wrap_id="attendance_week_table_wrap" limit=xxx ]</strong>

Shortcode Parameters:

  • Title: Enter title to display.
  • Display: table/list.
  • Count: number/percentage.
  • Time_frame: week/month/comma-separated date range.
  • Limit: Enter the number of records to show.
  • User_ids: comma-separated user IDs / current (to use current logged in user ID).
  • Course_ids: comma-separated course IDs / current (to use current course ID).
  • Wrap_id: Assign an id to a wrapping div.
  • Group_leader_ids: comma-separated Group Leader’s IDs / current (to use current logged in Group Leader’s ID).

This is how the shortcode will be displayed on the front end:



  • Disallow Attendance Tracking For Any Single Course:

  • Select any course’s edit page from LearnDash > Courses.
  • Find the meta box titled “Disallow Attendance” on the right side of the edit page.
  • Check the box next to the “Disallow Attendance” option.
  • Publish/Update the course.


Award BadgeOS Achievements:

Install the BadgeOS plugin and activate it if you want to award badges and achievements on attendance activity, then it must be enabled.

  • Awarding an achievement for ‘Marking Attendance Greater than or Equal to Specific Percentage’:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired achievement type.
  • Click Add New.
  • Name the achievement.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Greater than or Equal to Specific Percentage trigger.
  • Select the Course and Percentage requirements.
  • Click on Save All Steps.
  • Select a featured image for that achievement from the Featured Image meta-box.
  • Publish/Update.

Note: You can also award points along with the achievement. To award points, you have to enter the number of points for the field Points Awarded under Achievement Data on the same edit page.

  • Awarding an achievement for ‘Marking Attendance Less than or Equal to Specific Percentage’:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired achievement type.
  • Click Add New.
  • Name the achievement.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Less than or Equal to Specific Percentage trigger.
  • Select Course and Percentage requirements for the achievement.
  • Click on Save All Steps.
  • Select a featured image for that achievement from the Featured Image meta-box.
  • Publish/Update.

Note: You can also award points along with the achievement. To award points, you have to enter the number of points for the field Points Awarded under Achievement Data on the same edit page.

  • Awarding an achievement for Marking Attendance Greater than or Equal to a Specific Count:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired achievement type.
  • Click Add New.
  • Name the achievement.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Greater than or Equal to Specific Count trigger.
  • Select the Course and Percentage/Count requirements for the achievement.
  • Click on Save All Steps.
  • Select a featured image for that achievement from the Featured Image meta-box.
  • Publish/Update.

Note: You can also award points along with the achievement. To award points, you have to enter the number of points for the field Points Awarded under Achievement Data on the same edit page.

  • Awarding an achievement for ‘Marking Attendance Less than or Equal to a Specific Count:

  • Navigate to BadgeOS from the WP dashboard.
  • Navigate to the desired achievement type.
  • Click Add New.
  • Name the achievement.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Less than or Equal to Specific Count trigger.
  • Select the Course and Percentage/Count requirements for the achievement.
  • Click on Save All Steps.
  • Select a featured image for that achievement from the Featured Image meta-box.
  • Publish/Update.

Note: You can also award points along with the achievement. To award points, you have to enter the number of points for the field Points Awarded under Achievement Data on the same edit page.



Award BadgeOS Ranks:

  • Award a Rank for ‘Marking Attendance Greater than or Equal to a Specific Percentage’:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired rank type.
  • Click Add New.
  • Name the rank.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Greater than or Equal to Specific Percentage trigger.
  • Select the Course and Percentage requirements for the rank.
  • Click on Save All Steps.
  • Select a featured image for that rank from the Featured Image meta-box.
  • Publish/Update.
  • Award a Rank for ‘Marking Attendance Less than or Equal to a Specific Percentage’:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired rank type.
  • Click Add New.
  • Name the rank.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Course and Percentage requirements for the rank.
  • Click on Save All Steps.
  • Select a featured image for that rank from the Featured Image meta-box.
  • Publish/Update.
  • Award a Rank for ‘Marking Attendance Greater than or Equal to a Specific Count:

  • Navigate to BadgeOS from the WordPress dashboard.
  • Navigate to the desired rank type.
  • Click Add New.
  • Name the rank.
  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Greater than or Equal to Specific Count trigger.
  • Select the Course and Percentage/Count requirements for the rank.
  • Click on Save All Steps.
  • Select a featured image for that rank from the Featured Image meta-box.
  • Publish/Update.
  • Award a Rank for ‘Marking Attendance Less than or Equal to a Specific Count:

  • Navigate to BadgeOS from the WP dashboard.
  • Navigate to the desired rank type

  • Scroll down to Required Steps.
  • Click Add New Step.
  • Select the LearnDash Attendance Activity for Required field.
  • Select the Attendance Percentage Activity trigger.
  • Select the Marking Attendance Less than or Equal to Specific Count trigger.
  • Select the Course and Percentage/Count requirements for the rank.
  • Click on Save All Steps.
  • Select a featured image for that rank from the Featured Image meta-box.
  • Publish/Update.