Attendance can be marked by students themselves or by administrators and group leaders only, based on your preference. All student attendance data can also be accessed through complete attendance reports, which can be filtered according to your needs.

Table of Content

1. Installation
2. License Settings
3. General Settings
   • Restrict IP
   • Enable Admin Mark Attendance
   • Delete Attendance On Uninstall
   • Enable Automatic Attendance on Login
   • Disable mark attendance for users
   • Show absent of unmarked days in reports
   • Disable attendance report send to user’s email
   • Send attendance report- Weekly/Monthly
   • Display Attendance Count in Number/ Percentage
4. Attendance Logs
5. Time Logs
6. Mark Attendance
7. Award BadgeOS Achievements:
8. Award BadgeOS Ranks
9. FAQ
10. Changelog

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.

License Settings:

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 whereas admins can mark attendance for all of the students.

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.

Show absent of unmarked days in reports:

When this option is enabled, unmarked attendances will be marked as “absent” in the attendance logs and reports. 

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 available LearnDash Attendance shortcodes on the Help tab. 

The ld_attendance shortcode is used to display a list/table of users with the best attendance records on any page or post.To display the LearnDash Top Attendance use the following shortcode:

[ld_attendance]

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

[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 ]

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.

FAQ’s:

The Mark Present button is not showing on the course page to the students.

Please make sure the “Disallow Attendance” option should not be checked on the desired course edit page if you want to allow the user/student to make his/her attendance.

BadgeOS plugin is mandatory for the LearnDash Attendance add-on?

BadgeOS plugin isn’t necessary, but if you want to award badges and achievements on attendance activity, then it must be activated.

Can a user undo his/her marked attendance? 

No, once a user/student marked his/her attendance, it will never be unmarked or undo.

Does the user/student have to mark his/her attendance every time he/she come to the specific course page? 

The user/student has to mark his/her attendance once a day.

Where can I check my students’ attendance? 

You can check your students’ attendance at the specific course edit page > Student Information. 

Which translation plugins are recommended to work with this add-on? 

Loco Translate and WPML plugins are recommended to translate the LearnDash Attendance add-on into other languages.

Changelog:

1.7.4

Bug Fixes:

• Warnings in attendance shortcode.

1.7.3

Bug Fixes:

• Restrict IP address issue has been fixed. 
• Automatic attendance on the login issue has been fixed. 
• The attendance logs issue with the date and user filters has been fixed. 
• Remarks popup content cropping in attendance logs issue has been fixed.

1.7.2

New Features:

• Option added to clear attendance and time logs.
• Option added to allow different user roles to mark students’ attendance.

1.7.1

Bug Fixes:

• String localization issues.

1.7.0

New Features:

• Added “ld_attendance_allowed_admin_roles” filter to bypass certain user roles as admin.
•  Added Filter to bypass group enrollment check on front-end mark attendance user search field.
•  Improve codebase.

Bug Fixes:

• Text localization
• Compatibility issues with LD 3.5 and WordPress 5.8
• Mark attendance for un-enrolled users
• Group leader mark attendance flow
• Search filter in attendance logs for Group Leader
• Warnings/Notices on CSV export

1.6.0

New Features:

• Added option to show missing attendance as absent in reports

Bug Fixes:

• Admin/Group leader marked attendance gets overridden if auto-login attendance is enabled.
• The group leader can see only their groups’ attendance logs.
• Exported CSV report displayed on the browser instead of downloading.
• Typos.

1.5.1

New Features:

• Functionality to show unmarked days as absent counts in reports and reports filter on date selection.

Bug Fixes:

• Admin/Group leader marked attendance gets overridden if auto-login attendance is enabled.
• Group leaders can see only their groups’ attendance logs.
• Exported CSV report displayed on the browser instead of downloading.
• Remove LearnDash Group dependency for the “Marking Attendance” button.

1.5.0

New Features:

• Time Tracking for each user

Bug Fixes:

• Mark Attendance button not showing for Group Leaders

1.4.0

New Features:

• The group leader can access attendance logs of their courses and users
• Admin and Group Leader can mark Lesson/Topic attendance
• Minimum user role to access logs
• Adds parameter group_leader_ids in the shortcode to list attendance for specific group leaders only

Bug Fixes:

• General UI fixes

1.3.0

New Features:

• Added option to disallow students to mark attendance

Bug Fixes:

• Fixed typo issues in the DB query

1.2.0

New Features:

• Added option to mark attendance for lessons
• Added option to mark attendance for topics
• Added option to mark attendance automatically on log in
• Allow admin/group leader to mark attendance for lessons/topics
• Added option to mark attendance in bulk
• Added option to mark absent with courses/lessons/topics
• Added option to add message with present/absent

1.1.0

New Features:

• Added new table to store student’s attendance
• Added new report section for the admin
• Added option to download the attendance report in CSV fromat
• Added new help tab with shortcode details
• Revamped shortcode to display attendance table on frontend
• Added option to restrict user to mark attendance using different IP Address
• Added option to save IP Address, device name, date, and time with the attendance
• Added option to allow group leaders and admin to mark attendance for students
• Made the add-on compatible with latest versions of LearnDash and WordPress
• Made the add-on compatible with LearnDash Labels
• Made the add-on compatible with WordPress time zone
• Added new action/filter hooks