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: Website

1. Creating new websites

Within onCourse itself we give you the ability to create new websites that link to your onCourse system. You can have as many websites as you like.

In onCourse, search for Website Setup. It will open a new window where you will see all of your current websites. Click the + button to add a new one.

You’ll need to select a website template from the list shown. When you click the drop-down box, a section will open showing you each of the basic templates. Select one.

The website page title prefix the title that appears in the browser when someone goes to your website, so make sure it looks nice and makes sense.

The site location is the base URL your website will be given. If you don’t have a plan that offers the use of a custom domain, this will also be the address for your new website. If you do have a plan that allows for a custom domain, you can set that as the main URL that customers use to access it, but the base URL will never change.

Click Save to deploy your new website.

2. Attaching images and documents

2.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 documents directly from the edit view inside Course, Class, Tutor, Student, Site or many other places within onCourse. This links the document directly to that resource.

Once a document is uploaded into onCourse, you can preview it by going to the Documents list view, finding the record and clicking 'View' or, when it’s attached to another record, by clicking the image icon on the document card.

Duplicate files

onCourse is clever enough to de-duplicate files when you upload them. 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, saving you space in your allocated storage.

This only works for two identical files. The slightest difference and the two files will be both stored.

2.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 1. 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.

2.3. Adding thumbnail images to courses

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. or

thumbnail image
Figure 2. 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 200 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.

2.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>

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.

2.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

tagged image course details
Figure 3. 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'.

Figure 4. 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="" class="course-img" width="200" height="200"></div>

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 5. Added the image

2.6. Adding images to pages in the Editor

There are two methods of adding an image to a page you’ve created in the editor.

via WebDAV

The first involves uploading the images to your website webdav via a program like Cyberduck. Click the link to learn how to set that up if you haven’t already. Once you have access to you webdav files, upload your images into the /s/img folder. You can realistically use any folder you like, but for consistency we suggest using this one.

Once your images are uploaded into the desired folder, you can reference them on any page or content block using the following syntax:

<img src="images/placeholder.png" class="lazy" data-src="/s/img/imagename.jpg" alt="">

This calls the images directly from your website files and can be a more efficient method than referencing from within onCourse. You can also add image attributes like 'alt', 'height', 'width' etc.

via onCourse

The second method involves uploading the images directly into onCourse, setting the permissions for the images with 'shareable link' turned on, which enables the image to appear on the website. Then, you can reference the image in an imf tag directly using the shareable link generated, like below:

<img src="images/placeholder.png" class="lazy" data-src="" alt="">

This then calls the image from the URL. You can also add image attributes like 'alt', 'height', 'width' etc.

3. Your College Online

3.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.

3.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.

Figure 6. 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 and email notification.

3.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 course record, make sure the "Enabled and visible online" option is selected under "status"

  4. Click save

Figure 7. Selecting this option will display the course online

You must also tag your courses with Subject tags for them to display on your website. 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.

Figure 8. 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 markup. You can also include images and attachments in your pages using richtext or HTML.

3.4. Enabling Classes for online display

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

  1. Go to "Class"

  2. Double click on a class record

  3. Make sure the "'Enrolment allowed and visible online'" option is on under "Restrictions".

  4. Click save

Class descriptions

A class’s web description can be editted from 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.


  • Courses have “Enabled and visible online” selected in the record

  • 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 in every class you want to appear on your website.

3.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:


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


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


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


The detail of the course with code ABC.


The detail of the class with code ABC-123


A list of all sites marked as web visible.


The detail of site with internal id 12.


The detail of the tutor with internal id 23.


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

3.6. Search

onCourse includes a powerful search engine across your website. Because it understands the structure of your content, it can be used to deliver very precise results.

Search engines like Google will create a pathway for students to get to your site which is why we implement opengraph (Facebook) and (Google, etc) to inject structured data into those search engines as well.

When a student arrives on your onCourse site, use some of the tools below to craft a user journey from the front page to the course they are looking for.


This is standard keyword search, which includes stemming so the term cooking will find cook, cooks, cooking, cookery, etc. Synonyms are also matched. Phrases are search both as separate words and as a phrase.

Ordering of the results is highly sophisticated, taking into account higher priority for terms appearing in headings, tutor names or words in the description as a complete phrase or just words close together. Course with classes starting sooner are also sorted higher. Classes which are cancelled or full are sorted lower. And since classes are always grouped by course, these rankings are aggregated to produce the final sort order.

Distance to suburb


Search for classes held near the Suburb and postcode. While the search may work without the postcode, adding the postcode is essential for some suburbs which are not unique in your country. All results within 100km will be returned with the closest sorted to the top.


Add a parameter for the search radius if you want something other than the default 100km. If you include the radius then results further away will be completely excluded from the results.


Add one more parameter at the end for a label to display to users. So instead of the suburb name, we’ll display "North Sydney" to users of the site.



This searches for classes with an enrolment fee less than the specified dollar value.



Find classes that last this many days, including the start and end days. So a duration of 1 is a single day class.


Find classes with 3 or more days, or 3 or fewer days. Note that the symbols are not in the order you might expect. You need to use => rather than >=


This finds selfpaced classes.



This searches for all classes that the tutor with ID 1234 is currently teaching. Note that a normal keyword search will find tutors by name, but may also pick up those words in other places like course description.

Time of day


Searching for a day class means the first session commences before 5pm.


Searching evening means the session starts after 5pm.

Specific day


This searches for a class where the first session is on Monday. Choices you can use here:

  • mon

  • tues

  • wed

  • thurs

  • fri

  • sat

  • sun

  • weekday

  • weekend



This will show classes that start after the date 1/12/2014. The date in the search is in format yyyymmdd.


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 dates


This will show all classes starting within the next 30 days.


This will show all classes that are starting a year or more into the future.


This search allows you to search for courses that are tagged with multiple tags. In this case the primary tag searched on is "cooking" from the "Subject" tag group. The tag description for cooking will appear at the top of that page.

The results will be filtered for the secondary tag "school holidays" from the tag group "delivery".

Combination searches

Multiple search teams can be concatenated to created complex search strings such as


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 daytime and costing under $500.


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

Filtering classes

Advanced search parameters 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.


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.


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


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

3.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 9. 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.

3.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.


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 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.

4. Markup

The #editor will let you use one of three different styles of markup, which you must define using the dropdown box in the top right of the content window; legacy, html and markdown.

editor syntax dropdown
Figure 10. The content edit view with 'Markdown' selected in the top-right
editor dropdown selections
Figure 11. The three choices of editing syntax: markdown, html and legacy (rich text)

4.1. HTML

If you select HTML you can use standard HTML tags to build the content on your page. This is only recommended for advanced users with a prior working knowledge of HTML, otherwise we recommend using markdown mode.

4.2. Rich Text

Markdown is a simplified markup language designed to be easy to use for people who don’t code. To add content using markdown, select 'markdown' from the drop-down box in the top-right of the content page you’re editing. HTML cannot be used in Markdown mode.

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.

1. Now this was very odd
2. because it was
3. the middle of the night
   1. it was dark
   2. no one was home
  1. Now this was very odd

  2. because it was

  3. the middle of the night

    1. it was dark

    2. no one was home

Make sure you put a space after the . on each line. If you want an ordered sub-list, at any point put three spaces before the number.

# The Moon

The Moon

Header are created using the hashtag symbol, a space and then the heading. You can use up to four hastags in a row for different level headings. See below under Headers for more information.[Alice]


The url is the link the user will be redirected to upon clicking, while the text wrapped in the brackets becomes the hyperlink text.


To type out a header, add a # symbol at the beginning of the line. The number of # you use, up to 4 total, sets the type of heading that’s used.

# = H1
## = H2
### = H3
#### = H4


You can bold or italicize text by wrapping the text in asterisks and/or underscores.

You can **bold text** using twin asterisk's (**) on either side of the text you want to emphasize.
You can use _italics_ by using an underline (_) on either side of the text you want to emphasize.
You can also combine the two to create text that's **both bold and _italicized_**.

Line Breaks

Line breaks can be added by starting a new paragraph with a line gap in between the first paragraph and the second.


You can create both ordered and unordered lists, and combinations of the two as well. Some examples include:

* This is
* an unordered
* list

1. This is the first entry in an ordered list
2. second entry
   1. ordered sub-list 1
   2. ordered sub-list 2
3. third entry
4. fourth entry
    * the fourth entry has an unordered sub-list
    * second entry in the unordered sub-list
5. fifth entry

You can create in-links using the following syntax:

[The text you want inside the link](

It’ll come out something like this:

Click this [link to search]( for your favourite courses


You can reference images stored in your onCourse documents by using its reference URL like so:

![alt text]( "Title Text")

Whatever you put in 'Title Text' will appear when hovering the mouse over the image and is useful as a caption.

Code blocks

You can highlight portions of text to preserve things like code formatting by flanking the text using the ` symbol. You can also create code blocks this way, see the example below:

You can highlight `certain words` or a `call to action` like this.

<!DOCTYPE html>

<p>This is how you can present code using markdown.</p>
<p>This example uses html, but it can be anything you like.</p>



You can insert videos using pure Markdown, however it’s far simpler (and better for users as well) if you simply embed the html code into the page. Video services like YouTube have an easy 'Embed' button that gives you the code you need to copy and paste into the content field of the page you’re editing.

Block Quotes

You can add Block Quotes to your text by using a > symbol at the beginning of the line, like so:

> This is a block quote.
> This is a part of the same block quote.

4.3. Legacy

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 when 'legacy' is selected.

Simple guide to legacy

Table 2. 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.



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.



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.



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 9[Textile documentation]. We use textile with some special extra additions for dynamic course content.

4.4. 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 3. Dynamic rich text
What you want Rich text to use

Position an image within some text


Link to an attachment


Insert a re-usable CMS block within some text


Display a course description within another page


Show a list of courses


Display a list of subjects


Embed a page inside another page


Display a video within a page


Display a form within a page


Add text field into a given form


4.5. {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


{block name:"bannerAd1"}

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

4.6. {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.


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

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.


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


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

4.7. {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)


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

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.


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


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


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


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


[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

4.8. {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.


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

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".


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.


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


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


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">
    <li class="hasChildren childSelected">
      <a href="/courses">Personal Development</a>
        <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>

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

4.9. {page}

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


{page code:"123"}

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").

4.10. {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!


{form name:"email us" email:"" 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}

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


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


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.

4.11. {text}

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


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

The visible label shown next to the field.


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.


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.


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.

4.12. {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.


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

The visible label shown next to the field.


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


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.


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

4.13. {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.


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

The visible label shown next to the field.


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


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.


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

4.14. {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}.


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

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.


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.


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


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.


Optional. A caption to display under the image.


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.


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.


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


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

4.15. {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.


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

Currently only "youtube" is supported.


This is the remote id of the video. For example, a youtube video which has a URL of would have an id of 'YGwtEzZPb7M'


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.


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.

4.16. {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.


{attachment name:"course_guide"}

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

4.17. {duration}

A block to display search options for duration.


{duration display:"One-day courses" duration:"1"}
{duration display:"Longer courses" duration:">5"}
{duration display:"Self-paced" duration:"selfpaced"}

A label to display in the user interface.


The number of days the class runs for. "1" is a single day class. "selfpaced" for classes with no timetable. Use ">3" or "<3" for greater than or less than searches.

4.18. {tutors}

You are able to use this markup to display tutors on your home, courses, course detail, internal page or any other page. Use this rich text element to embed tutors.


{tutors tagName:"featured"}
{tutors id:"10"}

Optional. Shows 3 random tutors tagged with 'featured' tag if [count] is not specified. Please note that 'featured' should not be a tag group but a child tag.


Optional. Defining this option will limit number of tutors that will be displayed. Default value is 3.


Optional. Defines the specific tutor you wish to display. id parameter refers to the same id which we use in the tutor page URL. ("/tutor/123")

5. Website setup

By going to the Website Setup section in onCourse, you can manage and control much of the setup behind your website, including the adding of custom domains, set up of google tag manager and analytics, and even create brand new websites from scratch.

5.1. Billing

The billing section will show you your current level of onCourse plan, and the number of concurrent users your licence allows for.

If you wish to make a change, click the Change button, then enter the number of concurrent users you require and select a new plan from the drop-down list. Hit cancel if you’ve made a mistake and don’t wish to change anything.

You can also set the email address and name of the person who should be receiving invoices for your onCourse account. You can also add an invoice reference, should you require one.

Once you’re happy with your changes, hit Save.

IMPORTANT - If you drop to a lower tier plan, it will take effect at the start of the next month. If you raise up to a higher tier plan, the change will be immediate.

5.2. Websites

Here you will see a list of all of your onCourse websites, each with four different sub-sections beneath them; analytics, URLs, tag manager and google search.

You can also create a new website. by clicking the + button next to the Websites header.

Creating a new website

Create a new website linked to your onCourse system by clicking the + button next to the Websites header.

When setting up a new website, you’ll be asked for a website page title prefix (a page title that appears at the top of the browser), a key for the site location URL, any custom site domains you might be adding (for licence holders who are allowed custom domains) and the base template, selected from our list of site templates.

Set the page title and site location, then add your custom site domains and then select a primary hostname.

Finally, select your base template from our list.

When you’re done, click Save and your new website will start to build. Websites without custom domains will appear almost instantly while those with custom domains will take a little longer.

5.3. Log in to Google services

The first thing you’ll do here is log in and connect with Google services. This will allow you to access things like analytics directly from within onCourse. Click the 'Log in' button and accept the permissions to set up your services.

not logged in ga
Figure 12. The view when not logged in to Google services

The first step is to set up your Analytics, and then your Google Tag Manager, and then add your Google Maps API key. If you have not created an account for either Analytics or Tag Manager, you will need to do so before you can complete these steps.

Once you have selected your analytics account from the list, you can select the Analytics web property. This is the specific code used to track events and users on your site. If you leave this empty, onCourse will attempt to create one for you at the point you hit 'Save'.

Simiarly with the Google Tag Manager account, select this from the drop-down list, and then select the appropriate container from the drop-down box.

If you don’t have the right permissions to use or view a tag manager container or analytics web property, you won’t be able to see them in the lists. In these cases just leave these fields empty and onCourse will create them for you automatically when you Save.

Google Maps API

You also apply your Google Maps API key on the Google Services set up screen. It’s a bit of a process to get set up for Google Maps, so follow the instructions below:

  1. Go to

  2. Create a new project by clicking 'Create Project'

  3. Choose 'Maps Javascript API', and then select 'Enable'

    enable maps api
    Figure 13. click Enable to turn on the API
  4. Click 'Credentials', then '+ Create Credentials' in the top bar, then click 'API Key', then click 'Restrict API key'

  5. In the next window, rename your API key to something relevant

  6. Under 'Application restrictions', select 'HTTP referrers (websites)'

  7. IMPORTANT - DO NOT SKIP THIS STEP - Under Website restrictions, click 'Add an item'. You’ll want to add at least two items - the first will be your onCourse website URL eg* with a * on the end. The second will be your custom domain URL, again with a star on the end after the slash eg*. THIS IS VERY IMPORTANT FOR SECURITY

  8. Lastly, go into billing section of the Google Cloud Platform and attach your credit card details, otherwise your api call quota will be very small. You’re given $100 worth of credit every month, but without adding your credit card there’s a very good chance this will stop working until you next top it up. The map functionality will simply not work if you choose not to do this.

google application restrictions
Figure 14. Where to retrieve your Google Maps API key


ga logged in
Figure 15. Adding your Google Analytics details in onCourse

To plug your Google Analytics account into your website and view simple analytics from this section in onCourse, click the Analytics section under the website you wish to set up or view, then simply log in to Google Services and select your Analytics account from the drop-down box. You’ll need to have this set up in Google Analytics before it will show in onCourse. If you have yet to set your Google Analytics, you can get started by clicking 'Open Analytics' while logged in to Google Services.

Once this is set up and analytics are flowing into your system, you’ll be able to view the number of website sessions from the past 4 weeks from here. In Google Analytics, 'Sessions' refers to the number of individual sessions initiated by all the users of your website.


ga urls
Figure 16. 'The website URLs page is where you can set your custom domains

Here you can see the domain names in use for this website, if you have a custom one, as well as the default onCourse domain for your site.

You can change the page title by editing the current entry in the Website page title prefix field, then hitting Save. Your site location is the default URL, and is fixed and cannot be edited.

If your onCourse plan allows for them, you can also add any custom site domains to your website here. After you’ve entered the domain name URL make sure you also set the primary hostname from the drop-down box that appears, then hit Save.

Tag manager

ga gtm
Figure 17. Check your Tag Manager settings

This screen will show you which container from your Tag Manager setup you’ve applied to the site. If you want to change this, click 'Configure' to be taken to the Analytics section where this is set. Alternatively, clicking 'Open Tag Manager' will take you to the Google Tag Manager dashboard, external to onCourse.

Your Tag Manager needs to be set up separately from onCourse in order for this to be available to use, so ensure it is ready to go before attempting to link Google Services to your onCourse website.

II: Checkout

6. Checkout

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.

6.1. Adding a 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 18. 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.

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 19. 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, make sure the date of birth field in data collection is set to mandatory, or else they won’t work. 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 20. New student questions page

You can also include custom fields you’ve added to onCourse contact records into the online enrolment process. For example in the screenshot above the International Phone Field is a custom field being used in the data collection rules. You can learn more about data collection rules in onCourse in our data collection chapter, and custom fields in our Preferences chapter.

Adding another 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' first name, last name and email address. They will also need to complete the responses for any fields you have deemed mandatory.

adding another student
Figure 21. 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 22. Multiple student enrolling in multiple classes

6.2. 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 23. 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 24. 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 25. Summary page after the student has added their parent or guardian

6.3. 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, including changing the class they are enrolling in (if there’s more than one to pick from) and then proceed to the payment page by clicking on the 'Proceed to Payment' button at the bottom of the page.

summary page
Figure 26. This student is enrolling in an online based, self-paced class. They can change this by clicking on that drop-down menu, provided there is another class to choose from.

6.4. Terms and conditions

Anyone completing a transaction via the checkout, regardless of whether payment is being made or not, MUST tick the terms and conditions checkbox at the top of the Payment page before continuing. The payment section will not open or display, and the user will not be able to continue until this checkbox is ticked.

checkout agree
Figure 27. The student must tick the terms and conditions checkbox in order to continue

6.5. Payment and confirmation

After the student has clicked on the 'Finalise checkout' 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 28. 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 student’s enrolment goes through successfully and their credit card is accepted they will see a page similar to the screenshot shown below.

credit card successful
Figure 29. 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 screenshot 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 30. 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.

6.6. Checkout queries

You can use queries on the end of any Checkout URL to automatically add items to a student’s web cart. Items that can be automatically added are any course, class or product.



Multiple codes can be added by separating them with a comma ','


Different entities can be combined using an ampersand '&'


This opens up lots of avenues for automation to guide students through certain course paths, or bundling particular items together. You could also create an automation that sends a new checkout link to a student to enrol in the next level course upon completion of their last enrolment.

Remember that items will need to be set as visible online in onCourse to appear in web checkout.

6.7. Suggestions box

If you want to make use of the [courseRelations] to show suggested items next to your website checkout, you can add the following html code to the available next to the checkout block on the /checkout page. It’s important to remember to set the block type to 'HTML'.

<section class="ish__suggestions">
 <h3 id="suggestions">Suggestions</h3>
 <div data-cid="checkout-suggestions" class="oncourse-checkout oncourse-checkout-suggestions"></div>

7. 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.

7.1. Credit card

Real-time credit card processing ensures that successful enrolments are only made when the money is in your bank account. On the Payment page the student will need to select the terms and conditions checkbox, then they can enter their credit card details and 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 for online payments, only passed directly to the banking system, so in the unlikely event of a security breach there are technically 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 31. Using a credit card when paying for an online enrolment

7.2. Corporate Pass

Corporate Pass 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 the Corporate Pass window. Once you have clicked on the Corporate Pass 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 Corporate Pass by double clicking on a record, or alternatively create one by click on the '+' symbol.

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 32. 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 Corporate Pass 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 33. 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 Corporate Pass was successful as shown below.

corporatepass confirmation
Figure 34. CorporatePass confirmation page

7.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.

7.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 35. 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.

7.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 36. 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 37. Total cost and discount for all classes you are trying to enrol in at this time

7.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 38. Where to find the

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

Figure 39. Adding a Concession/Membership to an enrolment

7.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 40. The

III: Editor

8. onCourse CMS - Editor

8.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 in onCourse 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.

Figure 41. 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 the editor can be accessed at

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 42. 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.


Returns you to viewing your website. All changes made in the Editor (and not published) will be visible until you log out.


Allows you to edit the Blocks, Pages and Menus that appear on your site


Allows you to manage how your website and portal display information.


Allows for the themes of the website to be edited


Allows reverting to older drafts in the case of an issue

8.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

You can add content to Blocks and Pages using one of three different markup styles that you can set per block/page; Rich (markdown), html or 'legacy', which is our older-style of textile markup. We recommend using the Rich mode for ease of use, and for the fact that it alows the use of markdown and most html. With a suitably skilled web designer you could take your website a long way.


Blocks are re-usable snippets of text, pictures, 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 43. 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. Here you can set the style of markup to use using the drop-down box in the top right. Enter your markup and content 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 burger menu icon in the top-left corner of the window, and by clicking Blocks again. You can also navigate directly to a block by hovering your mouse over the Blocks sectiona nd selecting a bock from the list that appears.

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 content/markup. Remember that if you’re editing an existing block, renaming it might break it in places you have embedded that block elsewhere.

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.



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

The text fields are versatile in that they will let you select one of three markup varieties to work with; rich text (based on Markdown), legacy (textile-based rich text markup used by onCourse in the past) and advanced (html), for when you just want onCourse to get out of your way and let you type things out in HTML.

The Rich Text mode has a built-in visual editor that makes it very easy for all users to enter content. You can use the Write view to enter pure markup, or use Preview to see the correct formatting while you type.

You can learn more about the different types of markup modes, particularly rich text and legacy modes, in our Markup chapter.

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. You can select the markup style to be used on the page in the drop-down box in te top-right.

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


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.

8.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


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>
<script type="text/javascript" src=""></script><
!-- AddThis Button END-->

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

adding social media links
Figure 44. 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.


The checkout page gives you some simple options to set around when users access the /checkout part of your website.

Allow create new student - allows new student records to be created by users on the website. Disable this if you only want to allow students you or your staff have added to onCourse manually to use the checkout.

Allow student to update current details in a Checkout - allows any previously answered data collection questions by this student be asked again. This allows returning students the opportunity to update their previous information at the time of enrolment.

Collect parent or guardian details for students under <x> - turn on if you wish to collect parent/guardian details for students under the set age.

Terms and conditions checkbox label - The text that displays alongside your terms and conditions checkbox in the website checkout. The default text is 'I understand the enrolment, sale and refund policy.'

Terms and conditions url - The relative path of the terms and conditions page. Should always start with a /. Default is /terms.

editor checkout


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.

8.4. Design

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

editor design


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.

Themes are applied by URL path. This will allow you to set up cetain themes for different sections of your site based on the URL e.g. if you have a tag URL for all your business courses that uses the /course/business URL path on your website, you can have a special theme for all pages that appear under this path.

To apply the theme to a URL path, just add the URL path to the 'New Page URL' field and click the green + button to confirm. After confirming, a drop-down box appears where you set whether this will apply to all pages starting with this URL, or only pages with this exact URL. Be sure to Save after setting your changes and publishing.

You can apply the same theme to multiple paths by simply adding the additional paths using the same process as above.

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

When editing or creating themes for pages, make sure you don’t overwrite any default theme. You must always ensure there is a default theme set up for standard pages. This must always be set with the URL as "/" with a type of 'Starts with'.

8.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

8.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. Leave a short description of your changes in the Description field, and then click 'Confirm' to commit any changes you have made. These changes will then be made visible on the live site after a short wait of a few minutes.

editor publish

IV: Portal

9. General

9.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 can quickly and easily get the information they need about their classes and timetable.

9.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 45. 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" class="bare"> replacing '' 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 46. 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 47. 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.


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.


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 48. Example dashboard
portal dashboard mobile
Figure 49. 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 50. My profile page of skillsOnCourse
Tutor Portal My Profile Update Password
Figure 51. 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 52. Student USI and AVETMISS Information

9.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.

10. Dashboard

10.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 53. Next Class dashboard icon

10.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 54. 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 55. Variance of attendance icons

10.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 56. Payment Due dashboard icon

10.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 57. USI Required dashboard icon

10.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 58. Resources dashboard icon

10.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 59. Class Feedback dashboard icon

10.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 60. 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 61. Applications tab of the History page

10.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 62. 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 63. Checking to see if a tutor has confirmed to teach a class in onCourse

10.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 64. Mark Roll dashboard icon

10.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 65. 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 66. Marking Outcomes by Student

11. Useful Information

11.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 67. 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.

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

11.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 69. Tutors can access detailed class information via the skillsOnCourse portal

11.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 70. 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 71. Students results within a single class record

11.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 72. 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 73. 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 74. Students can access Google Map directions via the skillsonCourse portal

11.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 75. Manage your Waiting 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 76. 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 message templates sent from wait lists.

11.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.


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 77. 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 78. Application has been withdrawn


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


Tutor Portal History Finance
Figure 80. 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 81. 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 82. 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 83. 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 84. 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 85. Payment reminder email

11.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 86. Where a student can find their Certificate in skillonCourse

12. Tutor Specific Features

12.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 87. Live attendance tracking via the skillsonCourse portal
marked roll mobile portal
Figure 88. Marking the class roll on a mobile device
child roll
Figure 89. 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. If a tutor sends in comments these are emailed to the system admin email set in Preferences.

College staff then approve and update the changes via onCourse.

Tutors cannot edit the course schedule or description themselves, since it needs to be properly approved by College administrative staff.

The date of approval is shown as a date of confirmation in the Tutor section of the class.

Skills onCourse Tutor Class Approval
Figure 90. 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 91. 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 4. Outcome Values in the portal and their values in onCourse
Portal VET outcomes non-VET outcomes


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


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

12.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 92. Available teaching resources and documents for a Class

13. 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.

13.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 93. 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 94. 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 95. 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

13.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 96. 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 97. View of what you will see in the top right side of the window when Natalie has switched to James

14. Information for Tutors

14.1. Getting Started

The skillsOnCourse portal is a website 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 skillsonCourse 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 98. skillsOnCourse web login page

14.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.


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.

14.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 99. 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.

14.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 100. You can access detailed class information via the skillsOnCourse portal

14.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 101. Live attendance tracking via the skillsonCourse portal
partial attendance
Figure 102. Marking partial attendance for a student

14.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 cannot 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 103. You can confirm availability for a given Class via the Portal

14.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 104. 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 105. 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 106. Marking Screen for Non-VET Students

14.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 107. 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 108. 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 109. 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.

14.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 110. Available teaching resources and documents for a Class

14.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 111. Feedback from a student about a class you taught

14.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 112. My profile page of skillsOnCourse

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

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