Creating custom VETenrol links

Links to VETenrol can be implemented to take customers to the following entry points:

• The course selection page — This is the default entry point, where customers must first choose the course they are interested in.
• A specific course — This type of link provides access to all available occurrences for a specific course.
• An occurrence — This type of link takes the client directly to the first step of the enrolment process.
• The calendar — An alternative entry point to the course selection page.
• Category view — An alternative entry point to the course selection page.
• The schedule — An alternative entry point to the course selection page.
• Search  — An alternative entry point to the course selection page.

Use of the course and occurrence specific links introduces a higher risk of human error as those links require manual entry of identification numbers obtained from VETtrak and then may need to be carefully managed.

Short course/non-accredited training alternative
There is a separate article for Linking to Rapid Registrations

A combination of the above can be used throughout your organisation’s website if required. In addition, the above entry points can be used in an iFrame on your website:

• Linking via iFrame

If you (or your web designer) intends to link to VETenrol through an iFrame, please see the Standard Settings option Break out of iFrame to Register to determine if this setting should be enabled.

Linking to the Course Selection Page

This linking method is recommended as it requires little to no maintenance once the link has been included on your organisation’s website.

The link is simply the URL to the VETenrol server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings.

For example: http://enrol.vetenrol.com.au/?clientid=VT-DEMO

Linking to a Specific Course

A link to a specific course is most logically included on pages in your organisation’s website which provide details on a course offered. The enrolment link will then take clients to a list of dates and locations when the course is occurring.

The link used in this case is the URL with your client ID, as per the example in Linking to the Course Selection page then &progID= and the programme ID for the course appended to the address. Programme IDs can be obtained through the Client Administration as described in the topic: Summary Report on page 1.

For example:  http://enrol.vetenrol.com.au/?ClientID=VT-DEMO&progID=96

Sample of an organisation’s website utilising a specific course link.

A specific course link will continue to function for as long as there is at least one occurrence available for registration.

Linking to an Occurrence

Links to occurrences could be included on pages in your organisation’s website which provide details on the course offered and also list the dates and locations.

The link used is the URL with your client ID, as per the example for Linking to the Course Selection page, then &occuID= and the Occurrence ID for the course instance appended to the address. Occurrence IDs can be obtained from VETtrak or through the Client Administration as described in the topic: Summary Report on page 1.

For example: https://enrol.vetenrol.com.au/?ClientID=VT-DEMO&occuID=2618

Warning: An occurrence specific link works only while that particular occurrence is valid, thus the link will display an error if there are no more vacancies, or the enrolment close date has passed. The Client Administration setting, Enable Prior Enrol, can negate this if enabled.

Linking to the Calendar

There are two calendars available for linking. In both cases the linking method provides an alternative to the Course Selection page.

See also: The Calendar (Student Interface)

Basic Calendar

This calendar offers a monthly view and a category view. The Category View available with this calendar can also be directly linked and used without the calendar.

The link is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &page=calendar.aspx.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&page=calendar.aspx

To link to this calendar without the category view, include &altCSS=1 in the link.

For example: https://enrol.vetenrol.com.au/?clientID=VT-DEMO&page=calendar.aspx&altCSS=1

Advanced Calendar

This calendar provides a monthly, weekly and daily view plus access to the list of available courses. Colour coding is applied to courses based on the occurrence colour set in VETtrak.

The link is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &page=kalendar.aspx.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&page=kalendar.aspx

To link to this calendar without the course list, include &altCSS=1 in the link.

For example: https://enrol.vetenrol.com.au/?clientID=VT-DEMO&page=kalendar.aspx&altCSS=1

Linking to Category View

This linking method provides an alternative to the Course Selection page. Featured as part of the basic calendar, there is also a stand-alone version. The Category View is suitable for those wanting to show their course offering in groups. Courses are listed based on the programme type assigned in VETtrak.

The link is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &page=categoryview.aspx.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&page=categoryview.aspx

Linking to the Schedule

This linking method provides an alternative to the Course Selection page. Courses are displayed in a table and grouped by state. It is ideal for those offering multiple courses across different states.

The link is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &page=schedule.aspx.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&page=schedule.aspx

Linking to Search

This linking method provides an alternative to the Course Selection page. Users can search for a course using a keyword as well as browse the Available Courses as per default.

The link is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &page=search.aspx.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&page=search.aspx

Linking via iFrame

Most of the previous linking methods can be adapted to use as the source URL for an iFrame on your website, however the standard link to use in your iFrame is the URL to the server followed by ?clientID= and your ClientID exactly as displayed in your Client Administration Settings and then &altCSS=2, which points to your iFrame branding.

For example: https://enrol.vetenrol.com.au/?clientid=VT-DEMO&altCSS=2

An iFrame allows you to give customers the appearance of remaining on your website through-out the registration process (retaining access to your header, menus, etc) but has the drawback of a slower customer experience and, depending on how the iFrame is implemented on your website, it may also negatively impact tablet and mobile users.

If you did not initially expect to use an iFrame, branding for this feature may not have been created during your VETenrol activation. Please contact Support to request iFrame branding, or for other branding adjustments such as removing the course list.

Dynamic height for iFrame

There is a Javascript solution for the iFrame that will expand the height of the frame to fit the content. The Javascript goes between the <script> tags in the <head> of the page where you are displaying the iFrame.

window.addEventListener("message", receiveMessage, false); function receiveMessage(event) {
    document.getElementById("framed").height = parseInt(event.data) + 20;
}

NOTE: in the above the ID "framed" should be changed to match the Id for your own iframe. Additionally, the height is calculated to be actual content height + a little bit of padding for appearances, which is set to 20 but can be adjusted to give more or less padding if you prefer.