Creative Commons Licence
Creative Commons Licence

onCourse documentation copyright ish group. Licensed under CC BY 4.0. You are free to, share and adapt this documentation for any purpose, as long as you give appropriate credit.

I: Web page editor (CMS)

1. onCourse CMS - Editor

1.1. Introduction

The onCourse Editor is your platform to create, manage and distribute information to your website. Editor is a Content Management System (CMS) that provides simple but powerful tools to manage the structure and content of your website in a collaborative environment.

Access to the Editor

Before you start editing content within the Editor you need to set up a user name and password to log in.

onCourse enables any user to also have the ability to log into and edit content within the Editor using the same log in credentials that you use to access onCourse . To do this go to the Security window in onCourse, click on the user in the left-hand column, then ensure they have 'Can access #editor' switched on in their user record.

editorCanEditOC
Figure 1. Enabling Editor Access within onCourse User Profile

Logging In

Access the editor by visiting your website and adding #editor at the end of the url. For example, if your website url is http://www.acme.com.au the editor can be accessed at http://www.acme.com.au#editor.

Log in using your email address.

editor login

The Editor View

Once logged in, a toolbar is visible to the left hand side of the window. You can continue to browse through your site as normal while logged into the Editor.

On the toolbar, you can see icons that allows you to quickly access the primary areas of the Editor. At the bottom of the toolbar, there is an option to publish any changes you’ve made. This will push all your changes to the production servers, so they are visible to everyone.

While you are logged into the editor you are looking at a draft version of the site which cannot be seen by anyone not also logged into the editor. Changes you make with webDAV (static files, images, javascript, css, etc) are also only visible while logged in to the editor, until you publish the site.

editor SideBar
Figure 2. Finding your way around the Editor view

Navigate through the Editor by using the icons on the toolbar. These icons allow you to access different areas of the Editor quickly.

Site

image::images/editorIconSite.png[]
Returns you to viewing your website. All changes made in the Editor (and not published) will be visible until you log out.

Content

image::images/editorIconContent.png[]
Allows you to edit the Blocks, Pages and Menus that appear on your site

Settings

image::images/editorIconSettings.png[]
Allows you to manage how your website and portal display information.

Design

image::images/editorIconDesign.png[]
Allows for the themes of the website to be edited

1.2. Editing Content

Click the Content icon to see the editor for Blocks, Pages and Themes. These three components make up the structure of the website.

editor content

Blocks

Blocks are re-usable snippets of text, pictures, rich text markup, etc. If you wanted to add a banner on every page of your website, or an area on different pages dedicated to a contact form, blocks are ideal. Even if you only use them once, they are a convenient way to break apart complicated pages into easy to edit pieces.

editor blocks
Figure 3. The Blocks page allows you to easily add,search and edit blocks.
Editing a block

Selecting a block takes you to the Editor page for that specific block. Here, you can change the name of the block and edit the contents. On the right hand side of the screen you see a preview of what the block will look like on your website.

Click on the block contents to open the block in a text editor view. Enter your rich text or html to be added to the block and click save. This closes the text editor and renders your changes for you to review.

editor BlocksHTML

You can navigate back to the Blocks page by clicking the title of the block in the top right hand corner.

editorBlocksBack
Creating a new block

You can create a new Block from the Block view by clicking on 'ADD NEW'. You will have to give your new block a name in the 'Title' field, as well as some rich text or HTML in the content field do the right. Remember that renaming a block might break places you have embedded that block using rich text.

Once you are happy with your new block, save it by hitting the blue 'SAVE' button. If you wish to discard the new block, hit the red 'REMOVE' button.

editorNewBlock

Pages

Many pages on your website are automatically generated from onCourse. These pages include:

  • /courses

  • /courses/arts/photography

  • /course/ABC

  • /sites

  • /tutor/123

  • /site/234

  • /checkout

Pages not automatically generated from onCourse can be created in the Editor. The Pages view shows a list of all the static pages in your website and gives you quick access to search for, edit and delete pages. Similar to the Block view, clicking on a Page will open text editor.

Editing existing pages

From the Content menu, select Pages to get a list of all static pages on your site.

editor pages

When a specific page is selected the editor allows you to change the theme that is applied to this page, the page name, as well as editing the content. You can also select whether any given page is 'visible'. The page title will be visible in the window title of the user’s browser. Every page will be given an automatic URL like /page/5 however you may wish to give it an easier to use URLs like /terms or /about/contact-us. You can even give a page multiple URLs which will all work to display the same page to the user. Only one of the pages will be 'canonical', and the others will redirect to it.

You can also select to have a page omitted from the site map. Hiding a page from the sitemap will make it invisible to web crawlers and search engines.

editor pagesEdit
Create new pages

Click the 'ADD NEW' button to create a new blank page. Here you can edit the pages Title, the pages URL as well as the theme that is applied to this page. You can also toggle if the new page is visible. Clicking the 'Sample content' will open the page in the text editor to be edited.

Once you have finished creating your new page, you will have to save it by hitting the blue 'SAVE' button or discard your changes by the red 'REMOVE' button.

editor newPage

Menus

From the Content view, the primary header navigation can be edited from 'Menus'.

Most websites have a primary navigation menu which users will use to find their way around. In Menu’s you can add new menu items, and link them to particular pages or external URLs.

Edit an existing menu item

Click on a menu name to edit it. The menu name is as shown on your website.

Click, hold and drag the menu items into a different order or nest them within other menu items.

Click to edit the URL, that is, the page to which the menu links. Ensure this matches the page name exactly. If it doens’t, it won’t work as you expect.

Menus exist in a hierarchy. Clicking, holding and drag a menu item to reorder the menu. Clicking and dragging a menu item on top of, and to the right of another will nest the menu item and make it a submenu item.

editor menus
Add a new menu item

Clicking 'ADD NEW ITEM' will create a new menu item with no URL. This menu item will appear as the top menu level and will not link to any page.

A menu item can be deleted by clicking the red 'REMOVE' button to the right of each menu item.

Once you are happy with your changes, you can save them by clicking the blue 'SAVE' button.

1.3. Settings

The editor allows you to manage a number of different aspects of how the website and portal display information. This includes determining what information can be viewed through the SkillsonCourse portal, general website settings, any checkout settings or preferences and the site’s 301 redirects.

editor settings

SkillsOnCourse

The SkillsonCourse Settings page allows you to manage the amount of information that is able to Tutors in the SkillsonCourse portal.

editor settingsSkillsOnCourse

Hide student contact details from tutor: When a tutor is viewing the class roll via the SkillsonCourse, you can determine whether you want them to be able to view the email address, phone numbers of each student listed on the class roll. Please note that it is not possible to not display the contact details for one class, but display it for another, as this setting is universally applied.

The below SkillsonCourse portal view shows the student contact details displayed within the class roll. By specifying that you do not want the contact details to be displayed, this class list would simply show as a list of student names.

cms set portal info display

Website Settings

The website settings page gives a few different options on how things are displayed on the website.

editor settingsWebsite

Add This is a powerful social media linking tool that enables you to insert social media links into your web pages, as well as giving you access to analytical tools to gain insight into your audience.

Add This accounts are free and the first step is to create a new account. Do this by clicking the 'Click here' link. Set up your account including specifying which social media links you wish to display on your website, the size and format of those links, as well as the free analytics tools that are part of your account set up.

Once complete, insert the Add This id into the field provided. You can choose what pages the Add This! buttons appear on by ticking the 'Course' or 'Web Page' boxes below the Add This! field.

Add This also gives you a snippet of HTML to put into your site. You can put this HTML snippet into a page or block manually.

<!-- AddThis Button BEGIN -->
<div class="addthis_toolbox addthis_default_style ">
    <a class="addthis_button_preferred_1"></a>
    <a class="addthis_button_preferred_2"></a>
    <a class="addthis_button_preferred_3"></a>
    <a class="addthis_button_preferred_4"></a>
    <a class="addthis_button_compact"></a>
    <a class="addthis_counter addthis_bubble_style"></a>
</div>
<script type="text/javascript" src="http://s7.addthis.com/js/250/addthis_widget.js#pubid=ra-4f0fc25723d304e0"></script><
!-- AddThis Button END-->

If you insert the social media links to your course information, it displays as follows.

adding social media links
Figure 4. Example of how you can add social media links to any courses on your website

Hide Classes on Website/Stop web enrolments Here you can set classes to hide or stop taking enrolments automatically after some threshold is passed. For examples, after a class starts, before a class starts after a class ends or beforea class ends.

Show Suburbs from The 'Show suburbs from' dropdown allows you to filter out suburbs being returned in the site search. For example, when entering the search query 'Newtown', with 'Show suburbs from' set to 'All states' the advanced search will return classes from:

  • NEWTOWN, 2042

  • NEWTOWN, 3220

  • NEWTOWN, 3351

  • NEWTOWN, 4305

  • NEWTOWN, 4350

Setting 'Show suburbs from' to NSW will just return:

  • NEWTOWN, 2042

Once you have finished changing your website settings, hit 'SAVE' to apply them.

Redirects

The redirect settings allow you to create 301 redirects to your website by entering the path in the field on the left (starting with '/') and the destination in the field on the right (either starting with '/' for another local page or starting with http/https for redirecting to another website)

editor settingsRedirect

Editing an existing redirect

You can edit an existing redirect by changing the From and To parameters.

Adding a new redirect

Clicking 'ADD NEW' creates a new redirect at the bottom of the redirects, with blank From and To parameters.

Once you have finished editing the list of redirects, click 'SAVE' to add the redirects to your site.

1.4. Design

The Design menu lets you edit the Themes applied to your onCourse website.

editor design

Themes

Themes are a way to describe a page structure made up by a number of blocks and is a design layout created for you by your designer. There will always be a layout called "default". If you want different parts of your site to have very different looks, ask your designer to create alternative layouts for you to use.

Each theme can have a number of blocks arranged in any way you choose. There are five regions available:

  • header

  • left

  • content

  • right

  • footer

Each region can contain one or more blocks which you click and drag from the right hand side 'Blocks' area. To remove a block, click and drag it back into the list of unused blocks on the right. Order the blocks on the page by clicking and dragging them into position.

editor designEditThemes

1.5. History

The History menu displays the most recent reversions of your site, the date this reversion of the site was publish and who published each reversion.

You can also see the current version of your site and have the option to publish recent changes from this page.

editor History

Reverting Changes

For each published revision of the site, there is an option to revert to that version. Click 'Revert' to roll your site back to how it was on the given date. Note that this cannot be undone.

editor revertHistory

1.6. Publishing your changes

Any changes you’ve made are only visible when logged into the Editor. Your site must be published before any changes appear on the live site.

To publish your changes to your live site, click 'Publish' from the bottom of the toolbar. This prompts you to confirm that you want the changes published. Click 'Confirm' to commit any changes you have made and make these changes visible on the live site.

editor publish

2. Your College Online

2.1. Introduction

One of the key features of onCourse is the integrated website. This allows you to promote your courses via your website with seamless online enrolments, waiting lists, mailing lists, discounts, credit card payments, student and tutor portals and much more.

2.2. Updating your site

Because onCourse has been written as one comprehensive system, updating your website is automated and painless. Every time you make a change to any relevant information those changes are automatically uploaded to your website without you having to do anything specific. For example, this means that as courses are filled the website automatically updates to show prospective students that places are limited.

updating1
Figure 5. Connectivity between your website and the onCourse client software

onCourse makes the uploading and downloading of information (the replication) foolproof so that you don’t have to worry about it. Replication was designed by ish to work perfectly even after your internet connection has been offline for a while (say, because your ISP had an outage). onCourse is designed to not require high performance internet links, so you can use very low cost ADSL and because you aren’t hosting the website in your office, you don’t need to invest in expensive, high performance, high reliability internet connections (such as SHDSL which are typically $400 / month and up). You also don’t need servers which provide 24×7 web access for students or have backup power and generators to ensure high reliability website service with a 24-hour climate controlled server room in a secure facility which complies with the Mastercard/Visa PCI security regulations .ish already does all that for you.

All you need are the computers you own today and a plain, simple low-cost internet link to run onCourse. We provide the rest.

  • Automatic uploads to the website every time you make a change

  • Resilient to outages in your internet connection

  • Does not require a high speed connection

  • Automatic replication of new enrolments and students from website

  • Since you aren’t serving the website from your office, you don’t need to supply, support or service data-centre quality links and equipment

  • Our data centre is constantly monitored and supported by experienced Unix system administrators. It has 24-hour airlock security, temperature control, diesel power backup, halon gas fire control and its own electricity sub-station

  • Separate monitoring systems check the availability of every website every 15 minutes. Our technical team is notified of any outage via SMS.

2.3. Enabling courses for online display

Each course needs to be marked as 'Enabled and visible online' from within the General tab when looking at the course to display on the website. To do this:

  1. Go to "Course"

  2. Double click on a course record

  3. In the general tab, make sure the "Enabled and visible online" option is on under "status"

  4. Click save

visibleOnline
Figure 6. Selecting this option will display the course online

You must also tag your courses with Subject tags for them to display on your web site. You may choose to allow subject tags to be set more than once, or limit to one. If a course is tagged with more than one subject, it will appear in the menu for each tag you have assigned.

WelcomePageSubjectTag
Figure 7. Example of a welcome page and Subject tags at the bottom

Course description

The field ‘web description' is where you should enter all the information about the course, what students should bring, pre-requisites, outcomes and anything else you can think of. As this is the course, this information needs to pertain to all the classes of this course. If you have class specific information you should put this in the class web description. The web description can be found in the 'Marketing' tab on courses inside onCourse.

The description fields are rich text fields, so you can use bullets, headings and numbered lists. See our documentation for more on our richtext markdown.. You can also include images and attachments in your pages using richtext or HTML.

2.4. Enabling Classes for online display

Similar to courses, each class needs to be marked as "Enrolment allowed and visible online" from within the General tab. To do this:

  1. Go to "Class"

  2. Double click on a class record

  3. In the general tab, make sure the "'Enrolment allowed and visible online'" option is on under "Restrictions".

  4. Click save

Class descriptions

A classes web drescription can be editted from the 'Web' tab inside a Class record.

The information that you put in this field should be specific for just this instance of the class. Keep your general course information in the course itself.

Summary

  • Courses have “Enabled and visible online” selected on the General tab

  • Courses are tagged with at least one tag under Subjects in the tag group (if it has multiple tags, this course will appear under each tag)

  • Ensure "Enrolment allowed and visible online” is selected on the "General" tab of every class you want to appear on your website.

2.5. Special Pages

Some URLs on your site are reserved for special pages. These pages are delivered by the onCourse software itself. To customise them, consult the templates chapter for details of how these pages are created. These pages include:

/courses

A list of all courses which are marked as web visible.

/course/arts

A list of all courses tagged with the tag "arts" from the "subject" tag group.

/courses/people/get-better-job

A list of all courses tagged with the tag "get-better-job" from the "people" tag group.

/course/ABC

The detail of the course with code ABC.

/class/ABC-123

The detail of the class with code ABC-123

/sites

A list of all sites marked as web visible.

/site/12

The detail of site with internal id 12.

/tutor/23

The detail of the tutor with internal id 23.

/checkout

All pages under this path are reserved for the enrolment/checkout processing pages.

2.6. Advanced Search Options

onCourse includes a Solr search engine indexed to your website. This allows users to use the built in simple or advanced search tools on your webpages to find the courses they are looking for, or for you to craft URLs which include certain search results.

You can also choose to include only courses tagged with a set tag group in your search engine index, this is commonly done when providers have multiple websites for different training departments. i.e. the workplace learning site only ever searches on and shows results tagged with professional development, while the community site indexes all courses.

The sort order for course results in a list view page prioritises courses with classes starting next. When a search parameter is added into a page, the sort order is shifted to bring results with a greater relevancy to the top of the page, and then to sort by classes starting next.

To see the scoring priority for each course in a search result, add the string ?debugQuery=true to the end of your URL.

When adding a 'near=' search, it will automatically hide results outside of 100km radius the search suburbs' GPO. This can be useful if you deliver in seperated locations. For example, a website visitor who searches for courses in Sydney is unlikely to be interested in results in Melbourne, but may be interested in results in Chatswood. In this case the Melbourne classes would be suppressed from the list but shown to the user if they click the button 'Show other classes'

Classes that are full or cancelled are suppressed from the course results.

If you wanted to craft some specific searches to put behind image banners, promotional ads or other links, you can build your search within a tag group URL to make the results more specific. For example, if you want a promo for day time cooking classes your search might be www.myurl.com/courses/cooking?time=day which will find all the courses tagged with the subject tag group named cooking that have classes running during the day time.

The onCourse search options available are:

Keyword search

Example - /courses?s=cook
This is standard keyword search, which includes stemming so the term cook will find cook, cooks, cooking, cookery ect. The search results prioritise courses where the search term appears in the course name, over courses where it appears in the course description.

Search by proximity to location

Example - /courses?near=Chatswood/2067/1
Search on both the Suburb/postcode/search radius in km. While the search may work without the postcode, adding the postcode is essential to determine location if the suburb exists in multiple states. You do not require the search radius for this to function.

Search by price

Example - /courses?price=200
This searches for classes with an enrolment fee less than the specified dollar value.

Search by specific tutor

Example - /courses?tutorId=1234
This searches for all classes that the tutor with ID number 1234 is currently teaching. To find what a tutors ID is you will need to find a class that is online and one the tutor currently teaches. Then right click on their name, in the class block, and open the link in a new window/tab. The tutors ID will be the last few digits of the URL. So if the URL is www.yoursite.com.au/tutor/3, then the tutor ID is 3.

Search by time of day

Example - /courses?time=day
Searching for a day class means the first session commences before 5pm.
Example - /courses?time=evening
Searching evening means the session starts after 5pm.

Search for classes starting on a specific day

Example - /courses?day=mon
This searches for a class where the first session is on Monday.
Parameters:

  • mon

  • tues

  • wed

  • thurs

  • fri

  • sat

  • sun

  • weekday - searches for classes where the first session is held Monday to Friday

  • weekend - searches for classes where the first session is held on a Saturday or Sunday

Date Specific Search

Example - /courses?after=20141201
This will show class that start after the date 1/12/2014. The date in the search is in format yyyymmdd.
Example - /courses?before=20141201
This will show classes that start before 1/1/2015. The date in the search is in format yyyymmdd. This can be used in combination with the after search option to create a date range.

Relative Time Search

Example - /courses?before=30
This will show all classes starting within the next 30 days.
Example - /courses?after=365
This will show all classes that are starting 365 days or more after the current day.

Tag Specific Search

Example - /courses/cooking?tag=delivery/School+holidays
This search allows you search for courses that are tagged with multiple tags. You must use the full secondary tag path. This means the course is tagged with both the landing page tag (usually the tag group from within the subjects tag) and the search term tag.

Multiple search teams can be concatenated to created complex search strings such as www.myurl.com/courses/cooking?s=thai&near=Chatswood+2057&price=500&time=day&tag=level/beginner which is searching inside the subject tag group cooking for courses also tagged with the level tag group beginner that contain the keyword Thai, held near Chatswood NSW in the day time and costing under $500.

A note on the space character inside a URL: If you have a tag name that contains a space, and you are manually crafting a URL that includes that tag, you need to replace the space character with "+" e.g. tag name "cooking for kids" in a URL becomes "cooking+for+kids". This is done automatically for pages generated by onCourse, it is only in hand crafted URLs you need to remember to add the space delimiter. "%20" works also, but makes the URL harder for a human to read.

Filtering class results using advanced search

Advanced search parametres can also be added to specific course pages, to filter the list of results returned. This can be a useful function when you offer the same course in multiple locations, but users only want to see the classes from a specific location.

These search options are appended to a standard course page, with the URL containing the course code. In these examples, course code ABC123 is used.

Example - /course/ABC123/?near=Chatswood+2057

Search on both the Suburb+postcode. While the search may work without the postcode, adding the postcode is essential to determine location if the suburb exists in multiple states.

Example - /course/ABC123/?time=day

Searching for day classes of a course means the first session commences before 5pm.

Example - /course/ABC123/?time=evening

Searching evening classes of a course means the first session starts after 5pm.

2.7. Faceted Search

Faceted search uses a hierarchy structure to enable users to browse information by choosing from a pre-determined set of categories. This allows a user to type in their simple query, then refine their search options by navigating. In reality, it’s an advanced search going on in the background, but instead of the user having to think of the additional search categories, it’s been made easier for them by the visible folder structure. Examples of other websites that use it are Amazon and eBay.

You can select more than one option in the faceted search which will allow you to view more than categories results.

In the example below ther has been one option selected in the Locations tag and two options in the Courses tag. The courses that are displayed will be ones that are being taught in Sydney that have either been tagged to Barista & Coffee Art or RSA Course. The URL that is generated after the domain name from this search is /courses/barista+%26+coffee+art+courses?tag=/rsa+courses&near=sydney/2000/5

faceted search
Figure 8. Example of how the faceted search is used

If you only selected the Sydney option above then the URL you would get is /courses?near=sydney/2000/5;if you only selected RSA Courses then the URL you would get is /courses/rsa+courses; and if you selected both Sydney and RSA Courses then the URL you would get is /courses/rsa+courses?near=sydney/2000/5.

2.8. Search Engine Optimisation

There are a number of tools available to you to help maximise the search engine optimisation for your onCourse website.

Google tools

Google offer a range of really useful free tools to help drive search results to your site and analyse who is visiting your site, why they are visiting your site and how much they are spending.

Analytics

ish will automatically sign you up to this service when we set up your account. onCourse has special hooks into Google Analytics to pass through the ecommerce details of people who visit your site, so not only can you see who is coming to your site and from where, but you can see which sources of traffic result in actual money being spent. It is all very well to get thousands of page views from Facebook, but unless that traffic is generating enrolments you aren’t getting the results you really need.

Tag Manager

Google Tag Manager is a powerful tool which allows you to inject javascript, images or other content into your web pages. Every onCourse site automatically comes with a tag manager account for your use. Although you can get by with never logging into Tag Manager, this is a really useful way to dynamically add scripts to your site. There are so many tools available for you, many of them free.

  • user tracking

  • remarketing tools (following users around the internet with ads for your site)

  • Facebook

  • user experience measurement (eg. using hotjar to watch a user’s mouse clicks to see which parts of your site are hard to use)

  • A-B testing (show different content to different users and measure the results)

Webmaster Tools

This free tool is something you can set up yourself. Just go to www.google.com/webmasters/tools and click "add a site". You’ll be given several choices for how to verify your site; choose "HTML file upload" option. Take the file and upload it to your onCourse site in the top of the /s folder using webDAV. Don’t forget to then publish your site changes into production.

You may decide to engage the services of an SEO company, and they may want to add your site to their own Webmaster tools. There is no problem with uploading several different Google html verification files to your site.

Once you have performed the verification, a huge number of options are available to you. Most importantly you’ll want to review your organic search results, look at who is linking to you, make sure Google knows which country you are in.

Site Map

onCourse automatically generates a sitemap for all your content, so you don’t need to maintain this by hand. This ensures that Google is able to locate every page in your site and index it. Whether you get page hits from Google search will of course depend on what you have on that page and how popular it is, but at least you know that Google will find every single page of your site.

For more information on Search Engine Optimization, refer to the SEO and analysis chapter of our Web Desgin manual.

3. Rich Text markup

3.1. Formatting text

Many places in onCourse where can enter large amounts of text to display on the website will allow you to enter "rich text". This includes web pages, course descriptions, tutor profiles, site descriptions and much more. Rich text is used for simple styling of your text, without you needing to know any HTML. The headings, fonts and bullet point styles used on your website are determined by your template and design. Anywhere you can enter rich text, you can also enter HTML, if you have these skills.

You can also enter rich text in any web page or block within the CMS.

Simple guide to rich text

Table 1. Common formatting options
You type Output Notes
The sun was *shining on the sea*

The sun was shining on the sea

All text between the * will be bold. Don’t put a space between the * and the text.

Shining with _all its might_

Shining with all its might

All text between the _ will be italics. Don’t put a space between the _ and the text.

* Now this was very odd
                                        * because it was
                                        * the middle of the night
  • Now this was very odd

  • because it was

  • the middle of the night

Make sure you put a space after the * on each line.

# Now this was very odd
                                        # because it was
                                        # the middle of the night
  1. Now this was very odd

  2. because it was

  3. the middle of the night

Make sure you put a space after the # on each line.

h1. The Moon

The Moon

Use the h1. for a large heading (you can also use h2. h3. h4. and h5. for smaller headings). Ensure you use a lower case h and full stop and space after the number. Leave a blank line of text between your heading text and the following paragraph, or all the text to follow will be rendered as a heading also.

"Alice":http://hole.example.com

Alice

The text wrapped in the quotes becomes the hyperlink text and the url which follows is the link the user will be redirected to upon clicking.

"Rabbit":/course/stew

Rabbit

An internal hyperlink is similar, however you do not have to provide the full path name. You only need to provide the text that appears after your domain name.

"Queen":mailto:red@hole.example.com

Queen

To create a mailto link, the text inside the quotes becomes the hyperlink which will open your users default mail client, followed by the email address.

For further information about rich text, please look at the Textile documentation. We use textile with some special extra additions for dynamic course content.

3.2. Inserting dynamic content

Using rich text markup onCourse is able to draw from many parts of your data. Maybe you wish to display a banner, linked to a random course from a subset of high priority courses; or display a collapsible menu of subject. Maybe you’d like to add the complete contents from one group of specially tagged blocks of content.

By using the dynamic content rich text markup your web pages will always be up to date. If you change a course description, then everywhere that course is referenced will automatically update.

There are many types of content you can insert into a page and you can use the following markup anywhere rich text is supported. That is, you can insert images, course lists, video and much more inside other web pages, course descriptions, tutor resumes and any other place you see the rich text symbol.

Table 2. Dynamic rich text
What you want Rich text to use

Position an image within some text

{image}

Link to an attachment

{attachment}

Insert a re-usable CMS block within some text

{block}

Display a course description within another page

{course}

Show a list of courses

{courses}

Display a list of subjects

{tags}

Embed a page inside another page

{page}

Display a video within a page

{video}

Display a form within a page

{form}

Add text field into a given form

{text}

3.3. {block}

Start by creating a new Block in the CMS editor and giving it the title of "bannerAd1". Put some text in there an image with a link to some special offer. Once this Block is saved it can be displayed in either your content or another block, throughout your website by the simple inclusion of the rich text markup

Usage

{block name:"bannerAd1"}
name

The name of the Web Block. Blocks cannot share the same name, so make sure each in unique.

3.4. {course}

The second rich text markup we consider is {course} This tag functions to embed specific onCourse Course data into a page or web block. It can display data/content either at random, or specified from a particular grouping - ie evening classes. If a course is chosen at random - courses can be restricted by specific tagging and basic class information can also be displayed.

You might like to highlight particular courses on your front page ("Course of the Week" for example), or display a random course in a 'block' in the sidebar across all pages of your website - the possibilities are endless.

Usage

{course tag:"/Subjects/Leisure/Arts" showclasses:"false"}
[tag]

Optional. Defines the path to a tag. The full path to the tag must be specified. e.g. "/Subjects/Leisure/Arts and Craft". This option is ignored if the "code" parameter is passed. A random course will be displayed from the tag specified. If no tag is defined, "/Subjects" is assumed.

[code]

Optional. Specifies a particular course code to display. If this option is not defined, a random course will be shown.

[showclasses]

[true, false] Optional. A unordered list of all the classes available for this course will also be displayed. Default is false.

3.5. {courses}

The third rich text markup we should look at is {courses} This variation of the "course" code will display a List of courses within your content or "block"; and can be sorted dynamically by number of filters including; by start date; alphabetical listing, and others.

For example the Courses markup could be used if you wished to create a home page…​ or landing page that contained the most popular courses, alternatively Courses that were about to start through the coming week. To do so, what you would need to do is open the relevant page - home page or other, and place the following rich text markup: (replace 'yourTopicsHere' with an appropriate list)

Usage

{courses tag:"/Subjects/Leisure/Arts" limit:"3" sort:"alphabetical" order:"asc" style:"titles"}
[tag]

Defines the path to a tag. The full path to the tag must be specified. e.g. "/Subjects/Leisure/Arts". All courses with this tag will be displayed. If no tag is given then "/Subjects" is assumed by default.

[showTag]

If the parameter is true then it shows all tags.
If tag parameter is not defined then it uses "Subject" first layers tags.
default: false

[limit]

The maximum amount of courses that will be shown. If no limit is defined, the default setting is that all valid entries are displayed.

[sort]

[alphabetical, date, availability] Optional. What fields you can use to sort the courses;
alphabetical: course.name.
date: course.startDate
availability: course.availableEnrolmentPlaces
default: alphabetical

[order]

[asc, desc] Optional. ascending or descending order. Default is ascending.

[style]

[titles, details] Optional. Which predefined template will be used to show every course:
titles: shows only name of course
details: shows full information about this course
default: details

3.6. {tags}

Tags are the most common way of creating navigation to your courses and classes. You might organise your courses into subject categories, e.g.:

  • Arts

  • Leisure

    • Cooking

    • Crafts

  • Business

  • Languages

  • Sports

Using onCourse’s powerful tagging system, you might also organise your courses according to skill level:

  • Beginners

  • Intermediate

  • Advanced

  • Masterclass

Or, perhaps by target audience:

  • Kids

    • 1 - 4 years old

    • 5 - 8 years old

    • 9 - 12 years old

  • Teens

  • Adults

You may then want to display that tag structure on your website to allow users to navigation through it. Clicking on any tag will take the user to a URL like /courses/leisure/crafts and all the relevant courses will be displayed on that page. To place a tree of tag options on a page, simply use the rich text "{tags}". Further options allow you to customise the output.

Usage

{tags name:"/Subjects/Leisure/Craft" maxLevels:"3" showDetail:"true" hideTopLevel:"false" template:"TagItem.tml"}
[name]

Optional. Defines the path to a tag. The full path to the tag must be specified. e.g. "/Subjects/Leisure/Craft" and will display all child tags including the specified tag. If no name is provided then it will default to "/Subjects".

[maxLevels]

Optional. Defining this option will limit how many levels of the tag tree will be displayed. For example, "1" will only show the top level tag and nothing else. If nothing is provided here then all levels of the tag tree are shown.

[showDetail]

[true, false] Optional. If true, a tag’s description (as defined in the onCourse client) will also be displayed. The default option is false.

[hideTopLevel]

[true, false] Optional. If true, the top level tag is not displayed. The default option is false.

[template]

Optional. The name of the template to use for rendering each item in the tag list. Defaults to TagItem.tml. If you set this to something else, make sure you create the appropriate file in your website resources.

Sample HTML output

                <div class="taggroup-2405">
  <ul>
    <li class="hasChildren childSelected">
      <a href="/courses">Personal Development</a>
      <ul>
        <li><a href="/courses/personal+development/work">Work</a></li>
        <li class="selected"><a href="/courses/personal+development/life">Life</a></li>
        <li><a href="/courses/personal+development/love">Love</a></li>
      </ul>
    </li>
  </ul>
</div>

The output of {tags} with a little css styling applied.

3.7. {page}

You may want to display content from one page within another page. Use this rich text element to embed content.

Usage

{page code:"123"}
code

The page number you wish to embed. This is the same as the number at the end of the default URL for the target page ("/page/123").

3.8. {form}

You are able to use this markup to display a form on the page which anyone can fill in. This can be very useful as a 'contact us' form for example. When the user enters the required data, an email is sent to the address you nominate with the information entered. This is the only rich text markup which requires a closing bit of markup to designate where the form ends. Don’t forget to insert {form} at the end!

Usage

{form name:"email us" email:"sales@acmecollege.com.au" url:"/thankyou"}
                {text label:"Email address" required:true}
                {text label:"First Name" required:true}
                {text label:"Last name" required:true}
                {text label:"Phone number" required:false}
                {text label:"Reason for complaint" required:true lines:8}
                {form}
name

The name of the form. It is not visible to the user on the webpage.

email

This is where the email will be sent. It is not visible to the user on the webpage.

[url]

After the user submits the form, they will be redirected to this URL. If not supplied, they will be returned to the current page.

required fields

If you wish to set a given field as a required field, you can reflect this within the form as either 'true' or 'yes' if it is required.

3.9. {text}

This markup is only useful inside {form} markup (see the previous section). You use this to add a text field into the form.

Usage

{text label:"Reason for complaint" required:true lines:8}
label

The visible label shown next to the field.

[required]

If you set this to "true" then the user cannot submit the form without entering some value here. Setting this to any other value or leaving it out means that the field is optional.

[lines]

Setting this to "true" displays a text area 10 lines high. You can also explicitly set this to any other integer number of lines. If this value is not set, a single line text field will be shown.

[maxlength]

This can be set to any integer value greater than 1 and limits the input in this field to this number of characters. Note that spaces count toward this maximum.

3.10. {radiolist}

This markup is only useful inside {form} markup. You use this to add a set of radio buttons into the form, of which only one can be selected.

Usage

{radiolist label:"Age range" default:"20-25" options:"20-25,26-30,31-35,36-40,41-45,46-50,50+"}
label

The visible label shown next to the field.

[default]

This is the radio button which is selected by default. If nothing is supplied here, then there is no default selected.

[required]

If you set this to "true" then the user cannot submit the form without entering some value here. Setting this to any other value or leaving it out means that the field is optional.

[options]

This comma separated list of options will be displayed as the list of radio button options. You must have at least two options.

3.11. {popuplist}

This markup is only useful inside {form} markup. You use this to add a popup list into the form, of which only one can be selected.

Usage

{popuplist label:"Age range" default:"20-25" options:"20-25,26-30,31-35,36-40,41-45,46-50,50+"}
label

The visible label shown next to the field.

[default]

This is the item which is selected by default. If nothing is supplied here, then there is no default selected.

[required]

If you set this to "true" then the user cannot submit the form without entering some value here. Setting this to any other value or leaving it out means that the field is optional.

[options]

This comma separated list of options will be displayed as the list of options. You must have at least two options.

3.12. {image}

Please see {image}.

3.13. {video}

Please see {video}.

3.14. {attachment}

Please see {attachment}.

4. Attaching images and documents

4.1. Adding files

onCourse provides an effortless way to display images and documents (for example JPG, PNG, GIF and PDF files) with your website. Within onCourse you can add documents directly to the Documents section by navigating to the window and clicking the + button.

Alternatively, you can upload or link attachments directly from the edit view inside Course, Class, Tutor, Student, Site or many other places within onCourse. This links the attachment directly to that resource.

Once an attachment is uploaded via the Resources menu of onCourse, you can preview an image file by double clicking on any attachment entry in the list view. PDF documents are not able to be previewed via this method.

Duplicate files

onCourse is clever enough to de-duplicate files when you upload them. So if you add a 1Mb PDF to the system and then sometime later upload the same file again to onCourse, only one copy will be stored and linked to both places. This reduces the size of your database. In order for this to work, the two files must be absolutely identical. The slightest difference and the two files will be both stored.

4.2. Displaying media online

If you wish to display attachments and images on your website, firstly make sure that you have the Security level set as Public in the document record inside onCourse. Then you have several ways of showing content online, depending on where you want to display it.

Linked to specific pages

If you attach a document to a course and mark it as 'public' that attachment will be shown on the course description page. This makes it very simple to add pictures or perhaps a PDF with further course information. Remember that Google and other search engines will not do a good job with indexing content in Word, PDF or other formats. So if you want the best exposure online and the best search engine results, put your course descriptions as text directly into the course description.

Attaching a PDF to the course can be useful for specific files such as a pre-enrolment questionnaire, additional information about course requirements, software exercise files, and so on. Including these files is achieved exactly the same way as including an image on your page…​ open the Course, click the Web tab and then the Plus sign to browse the files. We recommend documents are uploaded as PDF as they can be universally accessed no matter what computer the student is running.

  1. Open the Course to which you wish to add the document to and scroll to the Documents section.

  2. Now simply click on the + button next to the Documents heading and type the name of the existing image or upload a new one by clicking the Browse button.

  3. Once the data updates online, the course detail page ( /course/ABC ) will now have your new document at the bottom.

upload image to course
Figure 9. Upload a document to your course via the web page of the given course
  1. In onCourse open the Tutor record you wish to attach the image of.

  2. In the tutor record, click the blank head image in the top left of the window and select the image from your computer. Click Save. The image will now appear where the blank head image used to be.

  3. Provided there is text in the Resume field on their tutor record, the image will display on their tutor profile.

4.3. Adding thumbnail images

You have the ability to add thumbnail images to all your courses. These will appear on your website on any courses list view page, so that’s any URL that contains /courses after your domain name e.g. www.acme.com.au/courses or www.acme.com.au/courses/business/computing.

thumbnail image
Figure 10. Adding thumbnail images to courses

To enable this feature you will have to add the following code to the CourseItem.tml file:

<div t:type="ui/image" name="${courseItemModel.course.code}_1" width="pixel width" height="pixel height"></div>

substituting the words 'pixel width' and 'pixel height' for the correct dimensions. So assuming the image you are adding is 200px x 200px then the code will be:

<div t:type="ui/image" name="${courseItemModel.course.code}_1" width="200" height="200"></div>

The CourseItem.tml file can be found in WebDAV by going to templates → default → CourseItem.tml.

You would then store the attached image you want to the course and making sure the pixel width and height is the same as the code in the CourseItem.tml and name them 'coursecode_1' e.g. ActingBeg_1.

4.4. Editing Course Hero Images in onCourse

You can use images you have uploaded into onCourse as hero images for a specific course. To do so, you first need to add a snippet of code to your site’s CourseItem.tml file.

The CourseItem.tml file can be found in WebDAV by going to templates → default → CourseItem.tml.

This snippet is pasted below:

 <div class="hero-image-banner">
            <div t:type="ui/image" name="${courseItemModel.course.code}_hero" class="course-img" width="275" height="183"></div>
          </div>

Open the CourseItem.tml in a text editing tool, like NotePad++ or Sublime, then copy and paste this code into the file somewhere out of the way. Ensure that you set the name of the uploaded hero image in onCourse to x_hero, where 'x' is the course code of the course the image is intended for - e.g. for a Pottery course with the course code POT001, in onCourse you’d want to name the image POT001_hero.

You can edit the height and width values, but be aware that this may result in inconsistent results if the images you upload are all different szes to begin with.

4.5. Tagging images

You have the ability to display a different hero image on each course detail page. These will appear on your website on any course detail pages e.g www.acme.com.au/course/accounting.

tagged image course details
Figure 11. Tagged image displayed at the top of the Accounting course detail page

You would then create a new tag group called 'image' and a tag inside that group. Call that tag 'hero'.

taggingheroimage
Figure 12. Creating a new tag group called

Once you have created this tag group and tag the next step would be to upload the images you want to tag to the document management system.

Once you have done this you will have to tag each of these images with the 'hero' tag.

To enable this feature you will have to add the following code to the CourseItem.tml file :

<t:loop source="getAttachments(courseItemModel.course)" value="attachment">
  <t:if test="hasTag(attachment, 'image/hero')">
    <div t:type="ui/image" name="attachment.name" class="course-img" width="200" height="200"></div>
  </t:if>
</t:loop>

Lastly you would go into each course you want these images to be displayed and add the document to the course record. You do this by clicking the + button next to Documents heading and typing in the name of the image you’ve already added. If the image isn’t uploaded to onCourse yet, click Browse and search your local computer for it. Remember to make sure the pixel width and height is the same as the code in the CourseItem.tml then tag them to the tag 'hero' in the tag group 'image'.

tagged image course
Figure 13. Added the image

4.6. Rich text

Sometimes you want to position images and attachments not just at the end of the course description, but on other pages within your site. You may want to display an image on a regular CMS page or link to a course handbook pdf download within a block in the side margin on your site. Any rich text enabled text field within onCourse can display this content, such as:pages, blocks, course description, tutor resume, class description, site description.

{image}

You may want to attach images and other files to courses, classes, sites, rooms and tutors and have them appear on the website. Just attach the file you want in onCourse via the Training > Documents menu item, click the '+' button and upload the file or image, mark it as 'Public' via the Access dropdown box and that file will be automatically transferred and attached to your site. These files will appear by default at the bottom of the relevant page. So for instance, just attach a PDF to a course to have that document appear as a link at the bottom of the course description. Likewise, pictures will appear at the bottom of the page. If however you would like to position the image somewhere else (say, next to the relevant paragraph of text) you can do so with a special rich text entry called {image}.

Usage
{image name:"duck" align:"right" caption:"This is a duck"}
[name]

Optional. The name of the image. If this is not given and the id is also not given, then a random image is displayed from those linked to the relevant database object. For example, if the rich text is a course description, then the random image will be one of the images linked to that course; if the rich text is a tutor profile, then the random image will be chosen from those attached to the tutor.

[id]

Optional. If you know the internal reference of the binary image object, you can use that here instead of the name. If both id and name are passed, then the name will be ignored.

[align]

[left, right, center, centre] Optional. By default, images are left aligned.

[alt]

Optional. If supplied, the image will be given this 'alt' tag which is mainly useful for accessibility purposes. That is, people with vision difficulties may have a screen reader which can read out the names of images. If this value is not supplied, the alt tag is set to the image name.

[caption]

Optional. A caption to display under the image.

[width]

Optional. Specify the width of the image in pixels as it will display on the webpage. If not supplied, the image will display at its full size.

[height]

Optional. Specify the height of the image in pixels as it will display on the webpage. If not supplied, the image will display at its full size.

[class]

Optional. A CSS class will be added to this image for styling purposes.

[link]

Optional. If supplied, this image will be made an href link to the destination you specify.

{attachment}

Link to an attachment. When your user clicks on the link, the file will be downloaded. You will want to use well accepted file formats such as PDF.

Usage
{attachment name:"course_guide"}
name

The name of the attachment as you specified it in the onCourse attachment entry screen.

{video}

Embed a video on your page. You will not upload the video directly to onCourse, but instead use a third party service like YouTube - their servers are optimised for video delivery and the performance and tools more helpful.

You can also use this within the Marketing tab of any Course, Class or anywhere else that uses this rich text format. Just copy and paste the below portion of code, and replace the youtube_id with the id from the YouTube video you wish to embed. You can find this after the = sign in the Video URL.

Usage
p<{height:315px}. {video type:"youtube" id:"youtube_id" height:"315" width:"560"}
type

Currently only "youtube" is supported.

id

This is the remote id of the video. For example, a youtube video which has a URL of http://www.youtube.com/watch?v=YGwtEzZPb7M would have an id of 'YGwtEzZPb7M'

[height]

The height in pixels you want to force the video to. If you leave this option out, it will default to the standard player size. You need to enter this twice, as referenced in the example above. Both height parameters should match.

[width]

The width in pixels you want to force the video to. If you leave this option out, it will default to the standard player size.

II: SkillsonCourse

5. General

5.1. Introduction

skillsOnCourse is a website for tutors and students which allows them to interact with your college and with each other. Every student and tutor is automatically given a login when their record is created in onCourse or when they enrol online.

skillsOnCourse gives tutors the information they need without having to contact you regularly. "Is my class full?", "Will my class go ahead?", "Can I get a class roll". These are all things that your teaching staff will ask you every day; now you have a 24-hour assistance to help tutors get the answers they need.

Students will also enjoy the skillsOnCourse portal. They can quickly and easily get the information they need about their classes and timetable.

5.2. Creating accounts and logging in

All students when they are created in onCourse, will automatically have a skillsOnCourse account set up for them. The first time a student enrols in your college, they will be sent an email which allows them to log into skillsOnCourse and set their password. Tutors are also given an account when their record is created in onCourse.

The skillsOnCourse login screen will prompt the student or tutor to enter their details. Like the onCourse enrolment process, a student is identified by name and email address to avoid forcing students and tutors to remember another user id.

Tutor Portal Log In Screen
Figure 14. skillsOnCourse web login page

It is also possible to log into skills onCourse as a Company rather than an individual. To do so simply click the 'as person' switch and it will change to 'as company', then enter the email address and password for your company.

Tutor Portal Log In Screen Company

Auto-detect first time users

skillsOnCourse has the ability to auto detect first time visitors to the site, when following a login link from onCourse. The direct link that they would visit is email@gmail.com" class="bare">https://www.skillsoncourse.com.au/portal/login?e=email@gmail.com replacing 'email@gmail.com' with the email address of the user. The system will auto populate their name and email address and prompt them to create an account on their first visit as shown below.

First time users login screen
Figure 15. Auto-detect first time users login screen

Once you click on 'CREATE ACCOUNT' button you will be taken to page, as shown below, notifying you that a link has been sent to your email address where you can create a password.

reset password message
Figure 16. Create new password message

Recovering and Resetting Passwords

The main login screen for the skillsOnCourse portal includes a 'forgot password' link. The user will need to provide a name and valid email address in order to initiate the process. If the student or tutor does not have an email address in onCourse then they must contact the college so that you can manually update their record. It is important that you implement an appropriate set of policies around how to authenticate users over the phone when they request that their email address be changed or added, since that email address will give them access to the full profile and history of the user.

If the user clicks on the forgot password link and enters the other details, an email will be sent to them with a link to enable them create a new password. This link will be valid for 24 hours only, after that time the link within the email will not work. Once the student has reset their password, they can continue using skillsOnCourse.

Dear {name},

To reset your SkillsOnCourse password, simply click the link below. That will take you to a web page
where you can create a new password. Please note that the link will expire 24 hours after
this email was sent.

  {recoveryLink}

If you weren't trying to reset your password, don't worry - your account is still secure and no
one has been given access to it. Most likely, someone just mistyped their email address
while trying to reset their own password.

Dashboard

Once a user has logged into their skillsonCourse portal they will see a number of blocks that will allow the user to see areas that can be reviewed or need actioned.

portal dashboard
Figure 17. Example dashboard
portal dashboard mobile
Figure 18. Example mobile view dashboard

Updating Your Details

Once logged in, users are able to update their contact details via the Profile details menu. This screen also enables them to update their password and their responses to the RTO AVETMISS, USI and VET FEE Help student questions, under the various tabs available in their profile. Any custom fields that have been added and made to be shown in the cms preferences will appear in the 'Profile details' menu option. As you can see below the custom field 'Drivers Licence Number' has been added to the questions a student can answer or updated themselves.

Tutor Portal My Profile View
Figure 19. My profile page of skillsOnCourse
Tutor Portal My Profile Update Password
Figure 20. Reset your skillsonCourse Password

Updating AVETMISS Details

If a student is undertaking a VET course, they can provide or update the required AVETMISS information via the profile page, on the Census Questions tab. The student USI can also be supplied and will be verified in real time here, and citizenship information can be provided for funding and VET Fee-Help eligibility.

portal census questions
Figure 21. Student USI and AVETMISS Information

5.3. Navigating skillsOnCourse

Students and Tutors are able to navigate their way around skillsOnCourse via the top of page menu options. By clicking on the 'skillsOnCourse' logo in the top left hand corner of the page, they can return to the home page of the site. Because the site is built using modern html techniques, the user can safely use the back button on their browser or bookmark any page they like. When they return to a bookmarked page they will be asked to log in and will then be redirected to the page they bookmarked.

If a student or tutor is updating their profile, they must save their changes before navigating away from that page. If they leave the page without saving the changes, those changes are lost.

6. Dashboard

6.1. Next Class

If a tutor is scheduled to teach an upcoming session, or a student is scheduled to attend a class, then when they log into their skillsonCourse portal they will see the next class icon on their dashboard as shown below. The 'View Map' button is clickable and redirect them to the class location tab where a google map will display where the session is taking place.

portal dashboard next session
Figure 22. Next Class dashboard icon

6.2. Attendance

If a student has attended classes that have attendance marking then an icon will appear on their dashboard with their attendance percentage. The Attenance percentage is calculated by adding up all the sessions that the student has attended or are absent with a reason divided by the total number of session over the last 12 month period.

portal dashboard attendance
Figure 23. Attendance dashboard icon

The attendance percentage icon that appears depends on a students average attendance over the last 12 months.

  • A green icon will appear if they have attended over 85%

  • A orange icon will appear if they have attended between 75% and 85%

  • A red icon will appear if they have attended under 75%

portal dashboard attendance difference
Figure 24. Variance of attendance icons

6.3. Payment Due

If a payment is due, as in the due date of the payment has passed (not if the student owes money but is not due yet), there will be an icon on the dashboard notifying the student of this, as seen below. The 'PAY ONLINE NOW' button is clickable and redirect them to where they can make the payment.

portal dashboard payment due
Figure 25. Payment Due dashboard icon

6.4. USI Required

Students who haven’t already provided and verified their USI will see an icon on the dashboard notifying them that it’s still required. They can then click on 'Review Now' which will direct them to the Census Questions tab of the students profile where they can either enter and verify or create a USI.

portal dashboard usi
Figure 26. USI Required dashboard icon

6.5. Resources

If a user has one or more documents or images linked to their account then they will see a resources icon listing the three most recent upload. All the listed resources are clickable and will open in a new tab. They can also click on the 'View All' button in the top right to be redirected to the Resources page to see the full list of all the attachments.

portal dashboard resources
Figure 27. Resources dashboard icon

6.6. Class Feedback

After a student has completed a class they will have the ability to provide feedback about it and rate out of 5 stars. If there are multiple classes that haven’t been rated then it will show the oldest non-rated class first. If clicked on it will take the student to the class page. Once feedback has been provided the block will show the next oldest non-rated class; if there are no others then this icon will not be displayed at all.

portal dashboard class feedback
Figure 28. Class Feedback dashboard icon

6.7. Application to Study

If a student has applied to study in a class and has yet to be enrolled or withdrawn then they will see a 'Application to Study' icon similar to the one below. It will include the name of the class along with the current status.

portal dashboard application
Figure 29. Application to Study dashboard icon

If the application has been accepted then a 'PROCEED' button will appear, which if clicked, will redirect them to the Applications tab of the History page, as shown below. They can then either click on the 'Enrol Now' button to take them to a special URL on your website where they can enrol, or they can click on the 'Reject' button that will withdraw their application.

portal applications history
Figure 30. Applications tab of the History page

6.8. Class Approval (tutors only)

If a tutor has been assigned to teach a class and they haven’t confirmed whether they can teach it, the class approval icon will appear on their skillsonCourse dashboard. If a tutor has multiple classes that haven’t been approved then the block will show their next non approved class. If they don’t have any classes to approve then this icon will not appear.

portal dashboard class approval
Figure 31. Class Approval dashboard icon

You can check whether a tutor has confirmed if they can teach a class by going to the tutor section of a class and checking if there’s a confirmed date below their name. You can manually set a date by clicking to expand the tutor, clicking the field and adding a date.

tutor class confirm on missing
Figure 32. Checking to see if a tutor has confirmed to teach a class in onCourse

6.9. Mark Roll (tutors only)

Tutors will see the 'Mark Roll' dashboard icon in their portal if they are teaching a session less than an hour from now. If there is no such class then this block will show the tutor’s last session taught that hasn’t been marked. The icon will show the name of the course along with the start date and time of the session. The 'Mark Roll' button is clickable and will open the sessions roll marking page in the tutor’s portal.

portal dashboard mark roll
Figure 33. Mark Roll dashboard icon

6.10. Mark Outcomes (tutors only)

This block will appear if a tutor has outcomes for a class they have taught that haven’t been marked. If a tutor has multiple classes with have outcomes that haven’t been marked then this block will display the class that ended most recently.

portal dashboard mark outcomes
Figure 34. Mark Outcomes dashboard icon

If they click on the 'Mark Outcomes' button then it takes them to where they can either mark the students outcomes in the class by Outcome or by Student.

portal mark outcomes by student
Figure 35. Marking Outcomes by Student

7. Useful Information

7.1. Timetable Information

The user timetable can be viewed as either a schedule list of sessions or as a month or monthly calendar view. The timetable will display all classes on a given day, by clicking on a given day the session information will display at the top of the page, including course name, room, venue and tutor information. Timetables are applicable either to classes a student is enrolled in, or to sessions being taught by a tutor.

The timetable will open to the current date, or next scheduled session by default. You can navigate between months by using the calendar month tool on the left panel.

By expanding a timetable session, additional options like 'view course' and for tutors, 'mark roll' are available.

Tutor Portal Timetable View
Figure 36. skillsOnCourse timetable view

Team Timetables

If a portal user has permission to access the portal on behalf of other portal useres e.g. employers who can view their employee information, the timetable view will default to a team timetable view.

This view shows a combined timetable view for all the linked portal users, so an employer can see at a glance all the sessions their staff are scheduled to attend, or a parent can see a combined timetable for all their children’s sessions.

The team view can be switched back to an individual view by using the link on the top of the page.

Timetable Subscriptions

Skills onCourse allows both Students and Tutors to subscribe to a timetable for their classes. To add this Calendar feed to your own Calendar, simply click on the Sync to Devicelink within the portal timetable view then add this feed to your own Calendaring software.

Once the subscription has been set, any amendments made to the timetable for the classes you are either teaching or enrolled in will automatically flow through to your Calendar. This subscription only needs to be done once, per user. Any new classes a user enrols in, or are scheduled to teach, will be included in this subscription.

PortalCalendarSubscription
Figure 37. URL link generated by the Portal which can be added to your own Calendar

7.2. Resources

The resources tab is a quick way to navigate to any global resources that have been added to the portal, for example, documents like Student or Tutor handbooks, as well as resources for any classes currently in progress, grouped by their course name.

Resources grouped by class may have been attached at either the course, class or student enrolment record, and may include documents such as learning and assessment resources, of completion Certificates.

The display of resources in the portal is based on the permissions set for the document inside the onCourse application. Documents with the permission 'Student and tutor' show in the portal for both students and tutors. Documents with the permission 'Tutor only' show only to tutors, and are a suitable permission for resources like assessment marking guides.

The skillsOnCourse dashboard also contains links to the newest resources added to the portal for the student or tutor.

Resources for classes which are completed can be accessed from the class record directly. Completed classes are listed in History tab of the portal.

portal resources
Figure 38. Tutors can access detailed class information via the skillsOnCourse portal

7.3. Results

The results tab of the portal show students the outcome results for their enrolments. Results may be for VET and non-VET courses.

Some VET courses will show the link to the parent qualification, where the course has been created with this link in onCourse. Other VET courses, that are module only enrolments will list the outcomes only with no reference to a qualification.

Results where no value has been set in onCourse will show as 'not marked' in the portal.

Results where the outcome was successful will show in green font 'Pass' with the AVETMISS value set in onCourse displayed below.

Results where the outcome was not successful will show in red font 'Not yet competent' and the AVETMISS value set in onCourse.

portal results tab
Figure 39. List of all class results on the results tab

A student can also view their results for an individual class by clicking on the 'Results' tab on the class detail view.

Tutor Portal Classes Menu Result Tab
Figure 40. Students results within a single class record

7.4. Class information

Classes can be accessed from the link within the timetable, through the sidebar classes menu or via the History tab.

Students can access up to date class information such as the date of the next session, venue and room information, as well as a link through to the class description which outlines the content to be covered within the class.

The class tab also contains links to the class resources, such as learning and assessment materials, which have been uploaded to skillsOnCourse and any outcome results. Students can see their overall attendance calculation for the class, and the attendance value set for each class session.

Tutors are also able to access class information, which includes information about the students enrolled, total number of enrolments, and can mark the class rolls.

Tutor Portal Classes Menu Details Tab
Figure 41. Tutors can access detailed class information via the skillsOnCourse portal

Despite Tutors and Students both accessing the skills onCourse via the same log in page, the information displayed to these two groups is different.

Class feedback

Students have the ability to rate classes they enrolled in and provide feedback comments. They can provide a Net Promoter Score response out of 10 (How likely are you to recommend us to a friend) and rate out of 5 stars how they found the Venue, Course and Tutor with a notes field below for them to add comments. The tutors that are teaching these class will then be able to see their overall class rating in their portal, without any information identifying the student/s who provided the rating.

class rating student
Figure 42. Students have the ability to rate classes they enrolled in

Getting Directions to a Classroom

The skillsOnCourse class detail view provides a link to Google maps, providing detailed directions for getting to the venue. Simply click on the View on Maplink within the Class details view.

Tutor Portal Classes Menu Location Tab
Figure 43. Students can access Google Map directions via the skillsonCourse portal

7.5. Subscriptions

A student can view what waiting lists they are on by clicking on Subsciptions and then clicking Waiting List. This page with allow you to find out more information about the waiting lists you are subscribed to along with the option of deleting your name off that list.

Tutor Portal Subscriptions Menu Waiting Lists
Figure 44. Manage your Wait List entries

A student can view what mailing lists they are subscribed to by clicking on Subscriptions and then clicking Mailing Lists. You have the option of choosing what method you would like to received the information by (E-mail, SMS, Post) and which of the designated mailing lists you wish to subscribe to.

Tutor Portal Subscription Menu Mailing Lists
Figure 45. Add or remove yourself from Mailing Lists

Students have the ability to manage their unsubscriptions without a login by adding the follow syntax $\{contact.getPortalLink("subscriptions")} in email templates. We recommend you include this link in email templates sent from wait lists.

7.6. History

Students can access a list of their previously enrolled classes, their financial history and any applications they have submitted in the History menu.

Applications

If a student has submitted a applications that has been approved, they will have the option to enrol in the class or reject the offer.

Tutor Portal History Applications
Figure 46. List view of applications submitted by the student

If you want to withdraw the application simply click on the 'Reject' option. You will then be taken to the page as shown below, confirming the application has been withdrawn. If you want to enrol in the class you have applied for, simply click on the 'Enrol now' option which will take the student to that course page on your website.

Tutor Portal History Application withdrawn
Figure 47. Application has been withdrawn

Classes

Tutor Portal History Enrolments
Figure 48. List view of previously enrolled classes

Finance

Tutor Portal History Finance
Figure 49. List view of your Financial history

To find out more information about a certain transaction you can click on one of the records. That will iopen up payment information or a Tax invoice for the chosen payment, as seen below.

Tutor Portal History Finance Invoice
Figure 50. Tax invoice
Making a credit card payment in the portal

A student has the ability to make credit card payments in the skillsOnCourse portal, so debtors are allowed to make payments against their outstanding invoices or payment plans. This can be found in the Finance tab of the History menu. The payment option UI will only appear if the student has an overdue payment, if not, then this tab will just show a list of their financial history. A student has an option to reduce the amount they want to pay if they can’t afford to pay the full amount at the present time, with a minimum limit of $20 unless the total overdue amount is less than this. Once the user has defined the amount they want to pay the student just needs to enter the credit card details of person making the payment. The user will then get a message notifying them if the payment was successful or if it failed. If the payment fails, then a few seconds after getting a notification of this they will get directed back to the payment page allowing them to try again.

Tutor Portal Making a payment
Figure 51. Making a $550 overdue payment in the skillsOnCourse portal

If a payment is due there will be a block on the dashboard notifying the student of this, as seen below. If they click on the 'PAY ONLINE NOW' button in the block it will take them to where they can make the payment, as shown above.

portal payment due dashboard
Figure 52. Payment Due dashboard block

If a student has mulitple invoices that are overdue the amount shown that needs to be paid will be the combined overdue total. If they don’t want to pay the full amount yet, then the payment will be taken off the oldest invoice first, even if they are on a payment plan.

There is also a script in the Automation window called 'send payment plan reminder' that automatically sends a message 7 days before the payment due date, on the day the payment is due and every 7 days after that.

send payment plan reminder
Figure 53. Send payment plan reminder script

Below is an example of the email that gets sent to a student who is overdue. There is also a link in the email that allows them to go straight to the portal, without having to log in, and pay the overdue balance.

Payment Reminder Script
Figure 54. Payment reminder email

7.7. Certificates in skillsonCourse

Once you have attached the students Certificate to their enrolment record you will want to be able to direct the student to where they can find it in their skillsonCourse portal.

They can find this by:

  1. clicking on 'History' tab in the top menu, then on 'Classes' to see the full list of past classes.

  2. Under this section the student will see a list of past classes and to find the certificate for class 'Certificate III in Children’s Services (CHC2-4)' they would need to click on this class in the list.

  3. Finally click on the 'Resources' option; this option will only appear if they have something attached to their enrolment record.

  4. When they have done this the student will be able to download and print their Certificate themselves.

finding certificate portal
Figure 55. Where a student can find their Certificate in skillonCourse

8. Tutor Specific Features

8.1. Tutor Specific Features

Some features are only visible to tutors, including real time marking of the attendance roll for their classes.

Viewing and Marking a Class Roll

Tutors can access the attendance roll for the class they are teaching and mark the attendance records in real time, back to your onCourse database. Only class rolls for sessions in progress, or in the past, can be marked. Attendance can not be marked before the session has commenced.

If you have uploaded student profile images in onCourse, their image will appear along side their name assisting the tutors in verifying their identify. onCourse is also integrated with Gravatar, so if students have a loaded a profile image against a Gravatar profile using the same email address as they use in onCourse, this image will be used.

If a student is under 18, their age will show in brackets next to their name.

Students can be marked as attended, partially attended, absent or absent with reason. For both partially attended and absent with a reason a note can be recorded against the attendance record to provide more information.

Marked attendance data is then used to calculate the student’s attendance percentage. This percentage may be important for reasons like CRICOS student visa compliance, or the college’s own minimum attendance requirements in order to be eligible for a certificate of attendance.

The attendance roll can also list contact details such as mobile and email addresses for students, allowing the tutor to easily contact students as needed. If this is enabled for students who are under 18, it will display the name of their Parent/Guardian and their contact details.

Tutor Portal Classes Menu Marking Roll
Figure 56. Live attendance tracking via the skillsonCourse portal
marked roll mobile portal
Figure 57. Marking the class roll on a mobile device
child roll
Figure 58. How an under-18 student

A College can set whether or they wish the Tutor to see the contact details of the students via the Website CMS under the Site Settings menu. Whether you want this information displayed is dependent upon the policies of your business and the management of student records. This setting is for all tutors of the college.

Approving Class Information

Tutors can confirm their availability for a given Class using the Portal. To access any classes that a Tutor has not yet confirmed their availability for, simply click on the To Confirm menu within the Portal. There is also a dialog box available to the tutor so they can send in comments and or suggested amendments to the course copy. College staff then approve and update the changes via the onCourse Client. Tutors cannot edit the course schedule or description themselves, since it needs to be properly approved by College administrative staff.

Skills onCourse Tutor Class Approval
Figure 59. Tutors can confirm availability for a given Class via the Portal

Viewing Student Results

Tutors have the ability to view a list of results for each unit of competency for their students. They will be marked either 'Pass', 'Not Yet Competent' or 'No Result'. The AVETMISS specific value of the outcome is displayed below this summary label

Tutor Portal Classes Menu Results Tab
Figure 60. Student Assessment Sorted by Unit of Competency

Marking in the tutor portal

You can give your tutors access to mark their student’s outcomes in the tutor portal. This will save time for the tutor and the college, and will give you fast, accurate results in your onCourse database. The system is simple and easy to use for tutors, and has the advantage of updating the onCourse database automatically, so no further staff time is needed to have up to date results for AVETMISS reporting or certificate issuing purposes.

If your existing assessment strategy is for tutors to determine competency and notify the college, this system will be easy for you to enable, as it simply moves the notification to an online, integrated platform.

Tutors will be able to mark the students competent, not yet competent, no result and withdrawn in the portal. onCourse will automatically assign the correct reporting codes based on the student’s enrolment. The tutor is also be able select the date the outcome is marked as the end date of the outcome. This will override the existing outcome end date (or planned outcome end date) in the database.

All other VET Outcomes, such as 51- Recognition of Prior Learning (RPL) and 60- Credit transfer (CT) are only available to college staff. This is to ensure the internal processes are meet before they are entered into your database.

We recommend you have a policy for the tutors that outlines what settings you expect tutors to use. Please feel free to send them Marking non-VET Outcomes or edit them to include your own process with the specific steps and setting for your college.

Table 3. Outcome Values in the portal and their values in onCourse
Portal VET outcomes non-VET outcomes

Competent

20 - Competent

81 -Non-assessed enrolment - Satisfactorily completed

Not Yet Competent

30 - Competency not yet achieved / failed (NYC)

82 - Non-assessed enrolment - Withdrawn or not satisfactorily completed

Withdrawn

40 - Withdrawn

82 - Non-assessed enrolment - Withdrawn or not satisfactorily completed

No Result

Not set

Not Set

This feature is best for colleges that have a periodic, sample based assessment validation and moderation processes. If your college does ongoing moderation and validation on each assessment, it may be worthwhile considering a shift to a periodic system. Ongoing moderation and validation is a time intensive process that limits access to solutions that improve your overall efficiency and effectiveness.

Attendance and outcome marking in the portal enables your college to collect the most update to date and accurate training information from your tutors, and allows for you to access further benefits when combined with default scripts.

Enabling outcome marking via the tutor portal

You can enable marking in your CMS Site settings. Note that this is a single setting for the whole business. If this feature is enabled all tutors will have access to outcome marking. This setting is disabled by default.

  1. Login to the CMS

  2. Go to 'Site Settings'

  3. Click on 'skillsOnCourse'

  4. Tick the check box 'Enable outcome marking in tutor portal'

  5. Click Save at the bottom of the screen

CMS Site Settings to enable tutors marking in the portal

8.2. Class Resources and Files

Tutor also have access to a list of resources and files for each individual class they teach. These resources could be teacher training and assessment resources, marking guides or additional course materials. These documents are uploaded via the class or course in the onCourse database with a 'Tutors only' permission.

Tutors can also see documents uploaded with 'Tutors and enrolled students' permission, that may include documents like learning guides for students.

Tutor Portal Classes Menu Resources Tab
Figure 61. Available teaching resources and documents for a Class

9. User Switching

This feature allows you to set up different relationships between e.g. An employer and their staff members and allow them to have access to their skillsonCourse portal login.

9.1. onCourse Settings

To enable this feature between certain relationship you need to tick the checkbox in the Contact Relation types window in Preferences. Type 'Preferences' into the dashboard search and open the window, then select 'Contact Relation types' in the left hand column.

contact relationship list
Figure 62. Contact Relation Types view in Preferences

Once you have the marked the checkbox, as shown below, the employer will be able to access their staffs skillsonCourse portal.

contact relationship edit
Figure 63. The

After a relationship has been created and marked as giving access to information with the skillsonCourse portal then you can start creating relationships between contacts. To do this you have to open up the contact you want to create relationship to, Scroll till you see 'Relation' then click the + button. From here a sheet will appear that will allow you to choose who you want to create a relationship to along with what type of relationship. In the example below I am trying to make 'Natalie Morton' the employer of 'James Matthews'.

adding a relationship to contacts record
Figure 64. Adding a relationship to a contacts record

Once you have added the relationship it will remain there on the contact record once the record is saved

9.2. What will you see in skillsonCourse

Once you have marked the checkbox in the Contact Relation Types view in Preferences there should now be an option to switch users within skillsonCourse. This can be found at the top right hand side of the window. In the example below you can see user Natalie Morton has been given access to James Matthews' skillsonCourse details.

skillsonCourse user switching
Figure 65. Where to switch users within skillsonCourse

Once your in a different users account the second name below your name in the top right side of the page will change to the name of what ever users account you are in, as seen below.

skillsonCourse user switching2
Figure 66. View of what you will see in the top right side of the window when Natalie has switched to James

10. Information for Tutors

10.1. Getting Started

The skillsOnCourse portal is a web site that gives you the information you need about your classes and students without having to contact the college regularly. "What am I scheduled to teach?", "How many students are enrolled in my class?", "What resources should I use to teach the class?". These are all things that the portal can help answer.

You can access your skills onCourse portal on your desktop computer, tablet, or mobile phone. The screenviews may alter from those shown in this document based on the screen size of your device, but all the functionality is the same.

Tutor Portal Log In Screen
Figure 67. skillsOnCourse web login page

10.2. Creating, Recovering and Resetting Passwords

The first time you visit skillsOnCourse, you will not have a password to login. If the college has your name and email address details recorded in their onCourse database, a password link can be automatically sent to you. If you are not sure what details they have on record, please contact the college so that they can check or update your record with your preferred name and email address.

The main login screen for the skillsOnCourse portal includes a 'forgot password' option. Enter your first name, last name and email address and then click on the 'forgot password' link.

When you click on 'forgot password', an email will be sent to you with a link to allow you to create a new password. This link will be valid for 24 hours only, after that time the link will not work. Once you have reset your password, you will be logged in and can continue using skillsOnCourse.

The next time you visit skillsOnCourse, you can use this new password to login directly.

Dear {name},

To reset your SkillsOnCourse password, simply click the link below. That will take you to a web page
where you can create a new password. Please note that the link will expire 24 hours after
this email was sent.

  {recoveryLink}

If you weren't trying to reset your password, don't worry - your account is still secure and no
one has been given access to it. Most likely, someone just mistyped their email address
while trying to reset their own password.

10.3. Your timetable

The first page you see when you arrive in skillsOnCourse is your personalised timetable. This shows you the sessions you are scheduled to teach in a month by month format. The timetable summary of sessions on the top of page shows your upcoming sessions.

Clicking on a session will expand the session view to show any session notes, and also provide you with a quick link through to mark the class roll for that session.

Tutor Portal Timetable View
Figure 68. skillsOnCourse timetable view,showing the first session expanded

Using the 'Sync to Device' link in the top of the timetable, you can subscribe to your timetable so the sessions show in another electronic calendar, such as your phone. You only need to do this once - if the college adds new classes for you to deliver, or if the details of one of your class sessions changes i.e. a room change, then your subscribed calender updates also.

10.4. Class information

As a tutor, the primary function of skillsOnCourse is to show your class information, including total number of enrolments, venue and room information. You can navigate to classes through the timetable page or from the history page.

Alternatively you can click on the class name under the 'Classes' column on the right side of the window. The classes column is available in every page of the portal except the timetable view.

Tutor Portal Classes Menu Details Tab
Figure 69. You can access detailed class information via the skillsOnCourse portal

10.5. Viewing and Marking a Class Roll

You can access the class roll by clicking on the name of the class, and locating the session you wish to mark. The attendance records are then sent to the college in real time. Each session of your class has its own attendance record, and you can scroll through each session. By default, the next session (based on the current date) will show first.

If your college collects student identification photos as part of their enrolment process, you will also see those images in the class roll.

To mark a class roll, you can select the simple options of tick for attended, or cross for absent. If a student arrived late, left early or was absent from the whole session for a valid reason, you can click on the icon next to the roll marking option to add a note and record the student’s arrival and departure times.

Tutor Portal Classes Menu Marking Roll
Figure 70. Live attendance tracking via the skillsonCourse portal
partial attendance
Figure 71. Marking partial attendance for a student

10.6. Confirming your classes

When you are offered a class teaching opportunity, the college requires you to confirm that you are available to deliver the content as described and according to the schedule of delivery dates.

To access any classes that you have not yet confirmed your availability for, simply click on the APPROVALS button at the top right hand side of the Portal. If you are not available, or can not otherwise agree to teach the class as described there is a message box to email the college your feedback.

Skills onCourse Tutor Class Approval
Figure 72. You can confirm availability for a given Class via the Portal

10.7. Marking non-VET Outcomes

If your college has enabled outcomes marking in the tutor portal, you will be able to mark the students competent, not yet competent, no result or withdrawn in the 'outcomes' section in the class.

  1. Log in to the portal

  2. It will open your dashboard. You will see a widget 'mark outcomes' with the most recent class.

    tutor marking dashboard
    Figure 73. Tutor dashboard with the mark outcomes widget in orange
  3. Click on the 'mark outcomes' widget. This will open the class page to the 'outcomes' tab. Alternatively, if you are already on the class you can select 'outcomes' tab from the menu on the top of the class page.

  4. Click/ tap the name of the student to open their marking screen.

    tutor marking nonVET class
    Figure 74. Outcomes tab for a non-VET class
  5. In the marking screen, click/ tap on the word competent, not yet competent, withdrawn or no results to select the mark.

  6. Click/ tap the check box to select 'Set outcomes end date to today'. NOTE: You will need to check with your college to see if they wish you to use this feature.

  7. Then click/ tap save to complete.

    tutor marking non VET mark
    Figure 75. Marking Screen for Non-VET Students

10.8. Marking VET outcomes

If your college has enabled outcomes marking in the tutor portal, you will be able to mark the students competent, not yet competent, no result or withdrawn in the 'outcomes' section in the class.

The marks you enter will update directly to the college database and may be included reports, automations or the next lodgement for funding, so you should only enter outcomes if they are final.

  1. Log in to the portal

  2. It will open your dashboard. You will see a widget 'mark outcomes' with the most recent class.

    tutor marking dashboard
    Figure 76. Tutor Dashboard with Mark Outcomes Widget
  3. Click on the 'mark outcomes' widget. This will open the class page to the 'outcomes' tab. If you are already on the class you can select 'outcomes' tab from the menu on the top of the class page.

  4. You can choose to mark by student or by outcome. Click/ tap on the 'mark by outcome' button to show the list of outcomes attached to the class or 'mark by student' button to show the list of students in the class.

    tutor marking VET select outcomes
    Figure 77. Selecting marking by outcome
  5. Click/ tap on the outcome name or student name in the list to open the marking screen.

  6. Click/ tap on the word competent, not yet competent, withdrawn or no results to select the mark. NOTE: You have the option to mark on the student in the outcome, or all outcomes for that student, if you click/ tap 'mark all' at the top right-hand side.

  7. Click/ tap the check box to select 'Set outcomes end date to today'. NOTE: You will need to check with your college to see if they use this feature.

  8. Then click/ tap save to complete.

    tutor marking VET outcome
    Figure 78. Outcomes Page for VET Class

Jane Citizen is a tutor for Cert III Aged Care. Jane’s student Michael has completed all his assessments for the course and was competent for all outcomes on the same day.

  • Jane logs into the Tutor Portal using the browser on her mobile

  • Jane will then tap the Mark Outcomes' widget on the dashboard to go to the outcome tab on the class

  • As it is a VET course, Jane selects 'Mark by Student' to mark one student

  • Jane taps Michael’s name on the student list to open his record for marking

  • Jane selects 'Mark All' to mark all the outcomes

  • Jane taps Competent and 'Set outcomes end date to today', and then taps 'save' to complete.

10.9. Class Resources and Files

You have access to a list of resources and files for each individual class you teach. These can be found by clicking on the 'Resources' option in the top menu. Some of the resources listed will also be available to your students in their portal, while other resources are only available to tutors of the class.

Tutor resources that are generic to the college, rather than specifically related to one of your classes will appear at the top of the list.

Tutor Portal Classes Menu Resources Tab
Figure 79. Available teaching resources and documents for a Class

10.10. Class survey results

Students attending your class may be asked to complete a survey rating their experience at the conclusion of their training. You will be able to see a summary of their feedback in the class window.

survery rating
Figure 80. Feedback from a student about a class you taught

10.11. Updating Your Details

Once logged in, you are able to update your contact details via the My Profile menu.

Tutor Portal My Profile View
Figure 81. My profile page of skillsOnCourse

This screen also enables you to change your password at any time.

Tutor Portal My Profile Update Password
Figure 82. Reset your skillsonCourse Password

III: E-commerce

11. Online Enrolments

onCourse has a password free purchasing process meaning that students don’t have to remember obscure student identification details from their last enrolment, like a student number or a password they may have created some time ago. onCourse does everything possible to move the student quickly and simply through the enrolment process to secure their payment and commitment to the enrolment. Forcing a student to remember a old password will result in some loss of sales as students give up in frustration.

For this reason, onCourse errs on the side of sometimes creating duplicate student records rather than risking losing a sale. If you were running a banking website, then accurate identification might be critical. But here, we want to do everything to make it easy.

Where a student has enrolled previously they are identified by their contact details and can move immediately to the payment process. No information they have previously provided is exposed during this process.

11.1. Matching the student

After a student has added classes, products or applications to their shopping basket and proceeded to checkout, they will see the page below. All the student needs to enter here is their first name, last name and email address. Based on an exact match of these three fields, this determines if they are a new student or a returning student.

Sometimes students will use a different name (through marriage or abbreviation). Sometimes they will change their email address. In these cases, onCourse will create a new student record which you might want to merge later.

your details page
Figure 83. Student details landing page

Previously Enrolled Students

If the student is already in onCourse then they will be matched and further questions might be skipped.

your details page with info
Figure 84. Enrolling a previously enrolled student

If, since their last contact with your you have made some additional fields mandatory for online enrolment, and they didn’t previously supply this data, a page will be shown requesting these additional details be provided.

At no time are previously supplied details shown to the student.

returning student additional info
Figure 85. What the student will see if additional details need to be obtained since the their last enrolment

New Students

If this is the first time the person is interacting with your college, after they have entered their first name, last name and email address it will take them to the next details page where more information can be added. All the fields on this page can be shown or hidden, or made mandatory using the Data Collection functionality of onCourse. In the example below the only question which is mandatory is their postcode which is marked with a '*' symbol.

If you have set a minimum age for enrolment, the date of birth will be mandatory. The Data Collection rules allow you to set up specific data to be collected for different courses, so if a student is enrolling in two courses, these requirements will be combined. In the Data Collection configuration you can specify field labels and help text.

If in onCourse, you allow concession details to be added online, there will also be a dropdown for the student to select from the list whether they have any concessions you accept, and if you require concession card details or an expiry date, these fields will also be required.

new student
Figure 86. New student questions page

You can also include custom fields you’ve added to onCourse contact records into the online enrolment process.

custom field questions
Figure 87. Custom field and Special needs questions

Enrolling an additional student

Once a student has entered all their details they will be directed to a summary page. In this page they have the option of adding another contact/student to this order. The button can be found below the class/es that are being enrolled in and above the field where they can add a promotional code.

If they click on it then it will take them back to the 'YOUR DETAILS' page allowing them to enter the additional students' details.

To add another person, they need to know their first name, last name and email address, plus complete the responses for any fields you have deemed mandatory.

adding another student
Figure 88. Add another student button

By default, second and subsequent students added to the online enrolment process will also have the enrolment option selected for the same classes as the first student. These can be unchecked.

multiple students enrolling
Figure 89. Multiple student enrolling in multiple classes

11.2. Summary

Once a student has entered all their details they will be directed to a summary page.

This page includes the following information:

  • Full name and Email Address of the student/s enrolling or paying

  • Classes they are enrolling in and products they are purchasing

  • Price before and after discount of each class along with a total at the bottom right of the page

  • A option to add another student (please see the section above called 'Enrolling an additional student' for more information)

  • If the student is purchasing a product, a field to choose the quantity of the product they’re purchasing

The student can adjust the details and then proceed to the payment page by clicking on the 'Proceed to Payment' button at the bottom of the page.

summary page
Figure 90. Summary page

11.3. Adding a Parent or Guardian

Within the Editor settings you can specify an age under which all enrolments will require parent or guardian contact details e.g. for students under 18. We recommend that you also make the date of birth field mandatory for your system. In the example below, student Manual Child is trying to enrol in a course named 'Internal', however since they are under 18 years of age they will have to enter their Parent/Guardian details first by clicking the 'Add Guardian' button.

parent guardian1
Figure 91. The Summary page displaying the

If the student has enrolled before and already has a parent/guardian contact related to them in onCourse, then this information will not be requested, and the 'Proceed to Payment' button will show.

Until a Parent or Guardian’s details are supplied, there is no option to proceed to the payment screen. Clicking the 'Add Guardian' button directs to the Add a Parent or Guardian page, along with the following callout message; "Because a student is under 18 we require the details of a parent or guardian for our records. Please enter that person." As per adding all other contacts, if their details are already in onCourse, then only a first name, last name and email address are needed to identify them.

add parent guardian
Figure 92. The Add a Parent or Guardian page is where you add your parent/guardian

Once the guardian or parent’s details have been captured the user will be returned to the Summary page, which will show both the child’s name and the parent’s, along with a short description next to the child’s name of their relationship with the defined guardian.

Next to the relationship description there is also a Change button which, when clicked, takes the user back to the Add a Parent or Guardian page where the user can add a different Parent/Guardian.

parent proceed payment
Figure 93. Summary page after the student has added their parent or guardian

11.4. Payment

At the point of payment, the payer (person who will receive the invoice) can be selected. In the example of an enrolment with multiple students, the first contact added will be set as the payer by default. In the drop down list, you can select another payer.

If the student is under 18, their parent/guardian will be set as the payer by default. This can be changed back to the student if required.

For an enrolment to be successful, the payment section must be successfully completed. Credit card details are validated in real time and if the student abandons the transaction because they can not supply these details, you will see their enrolment in onCourse as 'failed', which you may choose to follow up.

Once the student is on the 'PAYMENT' page there are two main ways to pay for their classes, these are:

  1. Pay using a credit or debit card (default)

  2. Click on the 'CorporatePass' option. They can enter their CorporatePass code in the field to complete the transaction without the need for a payment at this time. This process works via pre-approval and it can’t just be chosen by any visitor to the website.

If the payer is listed below then all they have to do is make the radio button next to their name is marked before filling in their credit/debit card details. If the payer is not already listed then they can click on the 'Choose a different payer' button, select whether the payer is a person or business and then add them as a contact. If the payer is a business when trying to add them as a contact instead of the 'Your details' page asking for the first and last name of the contact, it will instead ask for the business name.

payment credit card
Figure 94. Payment page

If the total value of the enrolment and/or application sale is $0 then the final payment page will not show the 'secure credit card payment tab' nor the final page that shows 'payment successful'.

paying a fee for $0
Figure 95. Process a payment that is $0

11.5. Confirmation

After the student has clicked on the 'Confirm purchase' button at the bottom of the PAYMENT page, then they will be directed to a confirmation page with a message informing them that their online enrolment was either successful or rejected.

If the student is paying by credit card, this is the point where their card details are verified with the bank as being correct and having sufficient funds available.

At this point, onCourse also verifies there is still a place available in the class. If between the student commencing and completing the online enrolment process, the last place has been booked by another student, the enrolment process will fail at this point. Their credit card will not be billed. You will see the enrolment attempt and failure in onCourse, so you can follow them up if they don’t successfully complete the enrolment.

class full during online enrolment
Figure 96. What the student will see if the class has suddenly becoming full while enrolling

If the enrolment and payment were successful, at the bottom of the page there will be a continue button. If you’ve created a post enrolment page in the configuration, they will be redirected there, if not they will be re-directed to the courses list page.

If the students enrolment goes through successfully and their credit card is accepted they will see a page similar to the screen shot shown below.

credit card successful
Figure 97. What the student sees if their credit card has been accepted

If the credit card is not accepted the student will see a page similar to the screen shot shown below explaining what they may need to check or correct. At this point the student can try again or abandon their enrolment.

Abandoned enrolments are shown as 'failed' enrolments in onCourse.

credit card failed
Figure 98. What the student sees if their credit card has been rejected

After a successful online enrolment process, the payer of the invoice will be emailed a tax invoice, and each of the successfully enrolled students will be emailed an enrolment confirmation. If the student is enrolling and paying for themselves, then they will receive both emails.

These automatic emails are sent based on your customisable invoice and enrolment confirmation email templates in onCourse.

12. Payment Options

onCourse allows for a range of payment options for enrolling students. Students can pay for multiple classes and multiple students in a single credit card transaction, or choose to send the invoice to an approved third party, like their employer.

onCourse eCommerce doesn’t handle only enrolments in classes; it also includes product, memberships and gift voucher sales allowing you to diversify your business and the way people can buy and share your products.

12.1. Credit card

Real-time credit card processing ensures that successful enrolments are only made when the money is in your bank account. Once the student has entered their credit card details they will need to select the checkbox at the bottom of the page that says 'I understand the enrolment and refund policy', then click on the 'Confirm purchase' button to complete the order.

The credit card is captured by onCourse over an SSL encrypted connection. The full card number and CVV are never stored in the database, only passed directly to the banking system, so in the unlikely event of a security breach there are no stored card details for anyone to steal. The user should expect a response in about 5-10 seconds, and during this time the enrolment is put on hold, preventing someone else taking the last place available in a class.

Should the payment fail due to insufficient funds or some other problem, onCourse will retain the transaction history as an invoice, a failed payment, and a credit note reversing out the invoice. We encourage you to regularly review failed payments in your system and follow up with the user to offer them alternative payment means.

payment credit card
Figure 99. Using a credit card when paying for an online enrolment

12.2. Corporate Pass

CorporatePass gives approved users the ability to invoice their employer, or another approved third party, on enrolment. This allows you to create an ongoing training approval process with your corporate customers, but still allow their staff to select the training timetables, or classes, to suit themselves.

You can view, edit, create or disable a Corporate Pass within onCourse by clicking on the CorporatePass button that can be found in the marketing tab. Once you have clicked on the CorporatePass button a window will pop up with a list of current and expired (if you check the filter in the left column) Corporate Passes created.

You can view an existing CorporatePass by double clicking on a record, or alternatively create one by click on the '+' symbol in the top right hand of the window.

To pay using a CorporatePass during the online enrolment process the student has to click on the CorporatePass tab on the left side of the 'PAYMENT' page. The student then enters the CorporatePass code that has been supplied by their employer (this code can also be found in onCourse).

corporate pass
Figure 100. Using a CorporatePass code to complete an online enrolment without the need of a payment at that time

Once the student has submitted a valid CorporatePass code they will see a message confirming that the code they have used is valid. They will also be given an option to add a reference like a purchase order ID for this transaction that will be included on the invoice sent to their employer.

corporatepass validation
Figure 101. CorporatePass reference

Once the student has chosen or not to enter a reference; marked the 'Conditions' checked; and clicked on the button 'Confirm enrolment' they will be directed to a page informing them the enrolment and payment via CorporatePass was successful as shown below.

corporatepass confirmation
Figure 102. CorporatePass confirmation page

12.3. Pay Later

If you are using Payment Plans to offer a deferred payment for a course to newly enrolled students, when someone goes to enrol into one of these courses online, the online checkout will offer a 'Pay Later' option. It will appear as a tab on the payment page, just like 'Credit Card' and 'Corporate Pass'. If the user selects this tab, the Pay Now field will show $0. If they select either the Credit Card or Corporate Pass tab, the full price of the course will display. The user can also change the 'Pay Now' field to $0 and the 'Pay Later' tab will be automatically selected.

When using 'Pay Later' the user will be able to select to 'choose a different payer' by selecting the 'choose a different payer' button.

12.4. Vouchers and Gift Certificates

Vouchers are much more than a simple gift voucher. They can be used to sell training in flexible groups whether it be a sampler of arts courses or OH&S training for 20 co-workers.

add code
Figure 103. Adding a Voucher or Gift Certificate to pay for an online enrolment/s

If a student provides a valid voucher code during the enrolment process, then this will reduce the fee payable, possibly to zero on the final payment tab. Voucher codes can be added on either the summary or payment tab.

12.5. Discounts and Promotional Codes

A range of flexible discounting and promotional code tools allow for students to access your special enrolment rates right up until the point of payment. More information on discounts and promotional codes can be found in the Discount section of the main manual.

discounted class
Figure 104. Cost before and after discount for individual classes

The total cost breakdown will include how much the class/es have been discounted by. In the case below the class has been discounted by $51.01.

discounted amount
Figure 105. Total cost and discount for all classes you are trying to enrol in at this time

12.6. Concessions

Some colleges have created concession types that users can self select as part of the online enrolment process. Usually, selecting a concession type during the online enrolment process will then discount the enrolment fee payable.

Some types of concessions that provide discounts may only be available via a pre-approval process at the college e.g. the college has to add the concession to the student record, it can’t be added online by the student. In these cases, the applicable concession fee for enrolment will apply automatically during the online enrolment process without the user having to select anything.

If self identified concessions can be added during an online enrolment, then you will see a '+' symbol with text 'Add Concession' below the students name and email address.

add concession
Figure 106. Where to find the

Once you have clicked on the 'Add Concession' button you will be directed to the following page, as shown below.

Concessions
Figure 107. Adding a Concession/Membership to an enrolment

12.7. Credit

If a student has credit available on their onCourse contact record from a credit note, the next time they make a purchase online, be it for an enrolment, products or anything else available on your site, the credit on their account will be automatically applied to their sale total at checkout.

The credit amount cannot be altered; the transaction will always use the full amount of credit available. Any remaining credit left over will still be available for the customer to use on future transactions.

credit online
Figure 108. The