With the installation or update of the plugin, a new page titled ‘Student Notifications’ (slug: ‘student-notifications’) will be created on your website.

This page allows both admins and group leaders to create, send, and manage student notifications directly from the frontend.

All filters and email notification options are conveniently available on this page, providing a streamlined and efficient way to handle student communications. By enabling frontend access, you eliminate the need for instructors and group leaders to access the WordPress dashboard, simplifying the notification process and enhancing workflow efficiency.

Here’s what you can configure and manage on this page:

1. Notification Title
   • Purpose: A short title/label for the notification.
   • This appears in the Notifications tab inside the learner’s course area.
   • Example: “🚀 Success! You’ve Finished Your Course! 🎓”.
2. Filter By
   • Options: Individual or Group.
   • Group: Apply filters to all learners belonging to a specific LearnDash group.
   • Individual: Select one or more learners manually from the student list.
   • Impact: Determines whether you see the Group dropdown (next field) or the Student List field.
3. Group
   • Active only if the Group is selected in Filter By.
   • A dropdown list of all LearnDash groups on the site.
   • Select one group, and the notification will apply to learners enrolled in that group.
4. Select Course
   • Dropdown list of courses.
   • Behavior changes depending on the filter:
   • Group filter: Only courses linked to the chosen group are shown.
   • Individual filter: All courses in LearnDash are available.
   • Multiple courses can be selected.
5. Select Action
   Defines the learner activity that triggers the notification. Options include:
   1. Course Action:
      • Filters based on course progress.
      • Completed, Not Started, In Progress, Expires In, Learners Enrolled In.
      • With multiple courses: additional logic (e.g., All Not Started, At Least One Not Started).
   2. Assignment Action:
      • Filters based on assignment submission.
      • Submitted, Not Submitted, Late Submitted.
      • With multiple assignments: All Not Submitted, At Least One Not Submitted.
   3. Quiz Action:
      • Filters based on quiz results.
      • Passed, Failed, Not Attempted, Custom Threshold.
      • With multiple quizzes: All Not Passed, At Least One Not Passed.
6. Select Assignment / Quiz (Conditional)
   • Appears only when Assignment Action or Quiz Action is selected.
   • Lets you choose the assignment(s) or quiz(zes) for filtering.
7. Submission / Result Status (Conditional)
   • When Assignment Action is selected: Submitted, Not Submitted, Late Submitted.
   • When Quiz Action is selected: Passed, Failed, Not Attempted, Below Threshold.
8. Exclusion Criteria
   • Two useful options to refine recipients:
   • Exclude Admins and Group Leaders: Ensures only learners get the notification.
   • Exclude Students Belonging to Group (active only if Individual is chosen): Removes group members, leaving only independent learners.
9. Student List
   • Active when Individual filter is chosen.
   • Dropdown where you can select one or multiple students manually.
   • Example: Jack Doe, Nancy Dsilva, Siya Davis.
10. Email Subject
    • This is the subject line for the email.
    • Students will see this in their email inbox if email delivery is enabled.
11. Email Body (WYSIWYG Editor)
    • A rich text editor where you draft the full message.
    • Supports formatting, links, and media.
    • Placeholders can be inserted to personalize messages:
      • {Student_Name} → The learner’s name.
      • {Group_Name} → The selected group name.
      • {Course_Name} → The selected course(s).
      • {Quiz_Name} → The selected quiz(zes).
      • {Assignment_Name} → The selected assignment(s).
12. Status Panel
    • Located on the right-hand side.
    • Displays the current status of the notification (Draft, Scheduled, Sent).
    • Shows the scheduled date/time if the message is planned for later.
13. Placeholders Panel
    • Quick reference and copy buttons for placeholders.
    • Ensures admins/group leaders can insert dynamic variables without memorizing code.
14. Action Buttons
    • Save Draft → Save without sending (useful for review).
    • Send Now → Immediately send to filtered recipients.
    • Schedule Notification → Choose a future date and time for delivery

Special Behavior:
Scheduled notifications can be rescheduled until 15 minutes before send time.
Within that 15-minute window, scheduling is locked, but notifications can still be canceled.