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
- Installation
- License Settings
- General Options
- 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
- Allow selected user roles to mark attendance
- Enable Activity Logs
- Enable debug Logs
- Attendance Logs
- Time Logs
- Mark Attendance
- Help
- Disallow Attendance
- Restrict Attendance Timeframe
- FAQ
- 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 Options
To locate the general settings for this add-on: Navigate to 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.
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
Enabling this feature will result in the deletion of all course and user attendance data when the add-on is uninstalled.
Enable Automatic Attendance on Login
Enabling this option will automate the attendance marking for all courses a user is enrolled in upon their login.
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.
Allow selected user roles to mark attendance
Here you can allow different user roles to mark student(s) attendance.
Enable Activity Logs
If this option is enabled, Admin will be able to generate activity logs of automatically marked attendances.
Enable debug Logs
If this option is enabled, the debug logs will be generated for easy troubleshooting by WooNinjas support teams.
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.
1. Display a List/ Table
Shortcode: [ld_attendance]
This shortcode is used to display a list/table of users with the best attendance records on any page or post. 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).
2. Display on a Calendar
Shortcode: [ld_attendance_calendar]
You can use this shortcode to showcase attendance on the calendar. Insert it into any page or post for logged-in users, offering them access to their own attendance records.
Disallow Attendance
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.
Disallow Attendance Tracking For Any Single Lesson
- Select any lesson’s edit page from LearnDash > Lesson.
- 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 Lesson.
Disallow Attendance Tracking For Any Single Topic
- Select any topic’s edit page from LearnDash > Topic.
- 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 Topic.
Restrict Attendance Timeframe
- To restrict attendance for a specific course, select any course’s edit page from LearnDash > Courses.
- Go to the settings tab and enable the option “Allow Attendance at Specific Time”.
- Define the start and end times for the duration when students can mark their attendance.
- The admin can specify a message to appear on the front end when students are unable to mark their attendance during restricted hours.
- Publish/Update the Course.
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.
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.6
New Features:
- Allow attendance only within the specific time range
- Disable attendance on each lesson and topic
- Capability to work with shared course steps
- Front-end attendance calendar shortcode
- Activity and debug logs
- UI upgrade
1.7.5
Bug Fixes:
- Fixed the license request time issue that can affect website speed
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
