New Course Notifications

When a course is made available for the very first time on the SGC Website an email will be sent out to all individuals who signed up to receive notifications for the specific language the course is released in.

Process

How a Course is Marked For Notification

If a course has been newly created with the Show on SGC Website Box Checked, it will be added to the list
Alternatively if course has been modified and in that modification

The checkbox has been changed
The change has been to check the box
The currently saved item does not have that field checked
It has not been checked previously (or at least since the log began keeping track)

This means you can, under these conditions, safely uncheck/recheck the box and it will not trigger an email.

Selecting Courses

If a course has an entry that says it was marked as enabled prior to 00:00 UTC on the current day and it has not been sent yet, then a notification will be sent. This time check occurs so that users do not receive notifications for courses that have not yet been synced to the SGC Site.

Selecting Recipients

All users who have selected a specific language to receive notifications AND have confirmed that language will receive an email digest with all languages that they have selected to receive. Note: it is possible for someone to have confirmed English and French but not Spanish so they will not receive notifications for new Spanish Courses.

Authenticating Email Sender

All Emails for this notification process are sent out via Microsoft Graph API. In order to send email in this manner, there has to be a office 365 user account that is authenticated. (Alternatively, we could utilize a service account but are not currently doing so.) In order to authenticate with the API someone will need to navigate to the settings page and click the Authenticate Office 365 button. This button is hid by default to prevent breaking the email flow. Therefore the user will also need to have the following permission added admin.auth-microsoft-graph

Sending the Email

All emails are sent automatically - if there are any to be sent - each day at 12:00 CST

Signing Up to Receive Emails

There are 2 URLS that are configured to be embedded as an iframe.
/public/email-signup/{optional language id}
/public/email-settings
However, to accomodate limiting the current user, the email-settings page should be passed 2 url parameters:
email and signature
This will verify that the url has not been tampered with and the user only has access to their own management. In order to make this work any url params passed to the host page should also be passed to the iframe.