Welcome to Agilix Dawn!

Getting Started in Dawn: Root Admin Guide

  • Updated:
    info_outline
    Created:

As the Root Admin, you have access to and control over every aspect of your Dawn site.

This guide will help you learn about Dawn as you:

  1. Brand your site
  2. Add publishers
  3. Add payment information for publishers
  4. Invite individual learners to join
  5. Set up Organizations

1. Brand your site

First, you'll want to make sure your site looks professional. Dawn enables you to easily build a branded experience for your learners (only Root admins have access to this tab).

To brand your site, make sure you're in the Administrator view.

Select the Branding tab and provide the requested information on each of the cards. The pencil icon indicates editable fields.

Most of the fields are straightforward, asking for basic information, including:

  • Title
  • URL Address (You must own the domain and DNS routing for the hostname you submit, here. After you submit the request, you will need to add custom DNS entries to finish switching to the new hostname.)
  • Application languages (The languages your website is available in.)
  • Default language
  • Company name
  • Company description
  • Privacy policy
  • Contact information (found under the Branding card)

The Branding components are used to manage the look and feel of your site:

  1. Theme allows you to choose a two-color color scheme that is applied throughout your site.
  2. Favicon allows you to upload graphic files to be used in internet browser tabs. Directions and resources to help you generate your files are included in the dialog.
  3. Icon allows you to upload your desired icon (300 x 300), which is automatically inserted into your site.
  4. Logo lets you upload your logo (640 x 200), which is automatically in your main header an other places in your site.
  5. Banner lets you upload an image (800 x 200) that appears on your About page.
  6. Landing page allows you to download all the components your landing page in a zip file.
  7. Once you've populated the fields with the appropriate information, click Publish now to make your changes live.

Set up automated Email templates

Dawn includes a variety of templated messages that are automatically sent to end users when certain actions or events take place to help administer the site.

On the Email templates card, these messages can be customized and localized into the language of your choice.

For example:

When a potential learner is invited to create an account on your site, they receive an invite. By default, this message reads as follows (assuming your app is called "LoremLearning"):

You've been invited to LoremLearning!

The HTML that automates this message looks like this:

You've been invited to {{appName}}!  

There are two parts of this example message that we discuss in this document:

  • Message templates: You can edit any of the text in the Message template, so you could change it to read: We cordially invite you to join LoremLearing!, or simply Join us at LoremLearning!
  • Template variables: The text reading {{appName}} represents a Template variable. Dawn includes a variety of variables that you can insert into messages, and they will be replaced with information specific to your site; as seen above, variables are always enclosed in double curly braces.  

Use Message templates

Dawn's Message templates are specified as valid HTML with information text and Template variables. The following table outlines the default Message templates included in Dawn.

Name
Purpose
inviteUserTitle
This is the title text used when inviting a person to create an account in your system.

Default template: 
You've Been Invited to {{appName}}!
inviteUserMessage
This is the message text used when inviting a person to create an account.

This message should incorporate:
  •  The inviter variables described in the table below to personalize the message. 
  • The inviteURL variable, so the learner can use it to join.
Default template: 
{{inviteeGivenName}} {{inviteeFamilyName}},

I created an account for you on {{appName}}. Click the link below to set your password and get started.

<a href='{{inviteURL}}'>Get Started</a>

If you have any questions about this invitation respond to me at {{inviterEmail}}.

Enjoy,
{{inviterGivenName}} {{inviterFamilyName}}
createAccountTitle
This is the create account email confirmation message.

Default template: 
Create account
createAccountMessage
This is the title text for the create account email confirmation message.

The message must include the resetToken for the email confirmation message to be usable.

Default template: 
Create account

This message is in response to a request to create an account. If you did not make that request, then simply ignore this message. Otherwise, use the following token in the create account prompt.

{{resetToken}}

resetPasswordTitle
This is the title text for the reset password email confirmation message.

Default template: 
Reset password
resetPasswordMessage
This is the title text for the create account email confirmation message.

The message must include the resetToken for the reset password message to be usable.

Default template: 
Reset password

This message is in response to a request to reset your password. If you did not make that request then simply ignore this message. Otherwise use the following token in the password reset prompt.

{{resetToken}}

Example HTML file

In a scenario where Maria Chan were to invite a student named Jay Campbell to join a course in LoremLearning, the inviteUserMessage shown above would look like this:

Jay Campbell,

I created an account for you on LoremLearning. Click the link below to set your password and get started.

Get Started

If you have any questions about this invitation respond to me at Maria.Chan@email.email.

Enjoy,

Maria Chan

Use Template variables

As discussed above, Template variables can be used in Message templates to customize and personalize the delivered messages based on context and the users involved.

The following table outlines the variables you can use.

Variable Purpose
appName
This variable inserts the application name you’ve chosen.
inviteeGivenName
This variable inserts the given name of the person receiving the message.
inviteeFamilyName
This variable inserts the family name of the person receiving the message.
inviteURL
This variable inserts the URL that allows the invitee to accept the invitation.
inviterEmail
This variable inserts the email of the inviter.
inviterGivenName
This variable inserts the given name of the person generating the message.
inviterFamilyName
This variable inserts the family name of the person generating the message.
resetToken
This variable inserts the token used to complete the account interaction.

2. Add publishers

Publishers are any entity that wants to create content under one name.

They can create course content, manage who can author or coach their courses, and have their own branded publisher page in the course catalog. Publisher Administrators manage the Stripe payment mechanism for their courses.

The Publishers screen lists the Avatar, Company name, and Email of each publisher with authoring permissions on your site. By adding additional publishers to your website, you can offer a broader selection of courses.

On this screen, you can:

  1. Add publishers.
  2. Edit publisher information and brand.
  3. Add/edit payment information.
  4. Delete publisher.

Select a publisher to:

  1. Make existing users Administrators, Authors, or Coaches for that publisher. Simply click the Add [plus sign] icon and search for the user you want to give the role to.
  2. Remove Administrators, Authors, and Coaches from the publisher.
  3. Review user feeds for Administrators, Authors, and Coaches.

Add publisher

To create a new publisher, provide the publisher's:

  • Name
  • Email
  • Avatar (use dimensions 300x300)
  • Logo (use dimensions 640x200)
  • Banner (use dimensions 848x300)
  • Description (click the help button for formatting instructions, and enable Preview with the toggle).
  • Catalog page short link (add a single word to the provided URL to create a custom URL for this Publisher catalog).

Click Add publisher.

Edit publisher

The Edit screen allows you to make changes to the elements added when you created the publisher.

Additional articles

Once you get a publisher set up, and create Authors and Coaches for that publisher, you can assign them to courses:

3. Add payment information for publishers

Use the Edit payment information screen to Connect with Stripe payment or make changes that sync.

Individual payer

By default, Dawn is designed to allow learners to purchase courses from publishers by connecting with a Stripe, We Chat Pay, or Alipay account.

If you set up an Organization, you can enroll students in bulk and pay for enrollments with a purchase order (this is covered in Set up Organizations, below).

Set up a Stripe account

Dawn Academy is set up to easily arrange payment from your customers using Stripe.

  1. Open your User Menu and select Administrator view.
  1. Select the Publishers tab.
  2. Open the Actions menu next to the desired company and select Edit payment information.
  1. Click Connect with Stripe.
  1. If you already have a Stripe account, click Sign in. If you don't, complete the form and click Authorize access to this account.

Connect your Stripe account with WeChat Pay and Alipay

To use WeChat Pay and Alipay, set up your Stripe account, then activate them in your Stripe console:

  1. Select Settings.
  2. Choose Payment methods.
  1. Click Activate next to the desired services.

4. Invite individual learners to join

Admins can invite people to join their site with the Users screen:

  1. Click the Invite user button.
  1. Enter the indvidual's email address, first, and last name. They will receive an email with the invitation text and link.

You can see which learners have accepted the invitation on the Users screen.

  • A user invited by email is marked as active as soon as they log in for the first time.
  • A user who joins without an invitation, is marked as active once they complete the email verification. If they don't verify they remain invited.

A user is added to the Learners screen as soon as they have make any progress in any course.

5. Set up Organizations

Organizations are entities, like school districts or businesses, that want to purchase course enrollments in bulk for their members.

Organization Administrators can use purchase orders to create enrollments for their members and track the progress of those enrollments. Site administrators create the purchase orders for organization use when contracts are signed outside of the Dawn system.

On this screen, you can:

  1. Add organizations, providing:
    • Name
    • Email
    • Avatar (300x300)
    • Description
  2. Edit organization information.
  3. Delete organizations.
  4. Click an organization to review and edit Administrators, Enrollments, and Purchase orders.

Administrators screen

On the Administrators screen, you can:

  1. Add Organization Administrators (these must be existing Dawn users).
  2. Review user feeds.
  3. Remove Administrators from the Organization.

Enrollments screen

On the Enrollments screen, you can:

  1. Filter the enrollments by Group.
  2. Review enrollment data.
  3. Review enrollment feeds.
  4. Enroll users in the courses and pay for them with the organization's purchase order. If a user is invited through the bulk enrollment process they are invited are immediately added to the Admin > Learners screen.

Purchase orders screen

On the Purchase orders screen, you can set up and manage purchase order amounts. Only root administrators, or site administrators, can add/edit purchase orders. District/organization administrators can view purchase orders to see what funds are available and authorize enrollment purchases.

Organizational purchase orders

Purchase orders contracts are prepared outside of the system, and then Site administrators create them.

Organization Administrators can use purchase orders to create enrollments for their organization's members and track the progress of those enrollments. On the Organization > Purchase orders screen, District/organization administrators can view purchase orders to see what funds are available and authorize enrollment purchases.

Use purchase orders to enroll multiple users as part of an organization

Organization admins can enroll multiple users in courses at once as part of their organization:

  1. Select the Organizations screen and open the organization you want.
  2. Click the Enrollments tab.
  3. Click the Enroll users button.
  1. Choose a course.
  2. Enter learner email addresses or mobile phone numbers. Each entry should be on its own line. Enter phone numbers as just numbers (without spaces, parentheses, or dashes).
  3. Wait for Dawn Academy to Verify the information. You get one of three responses for each learner:
    • Invite and enroll means that the user is not in the system associated with that email or phone number, so Dawn Academy will send them an invite.
    • Enroll means that the user is already in the system, but not enrolled in the selected class, so they are enrolled.
    • No action (already enrolled) means the user is already in the system and enrolled in the selected class.
  4. If you want the learners to be part of a group, check the Create a group box and provide a Group name and Group description. If you don't want a group, uncheck the box.
    • Including learners in groups allows them to message their group members and filter their conversations by group.
  1. Choose payment method, select the Purchase order to debit (if applicable), and click Pay now.
forum

Have a question or feedback? Let us know over in Discussions!