Publish Jobs via your Website

You can publish jobs directly to your website from TrackerRMS using our free publishing feature which is embedded in your website using a single line of HTML.

This feature allows you to control the following aspects of published jobs:

  • The fields that are displayed (for example a summary list may display less information than the full details of the Job)
  • The order in which the fields are displayed
  • The look and feel of the published information in keeping with your own website (Cascading Style Sheets)
  • Filter only certain jobs based on work type, location etc

Please note: In order to appear in the publish jobs page, you must first set the “Publish on your TrackerRMS Portal” setting to “Yes”.  This can be found on the Publish tab within the main Job record within TrackerRMS.  Please also note that the publish feature only selects “Open” Jobs and so Jobs will be removed from the publish jobs list automatically once filled, placed or otherwise closed.

How it works

The publish jobs information is embedded using an <iframe/> which essentially places a website powered by TrackerRMS into an existing web page on your website.  Your web developer will pass a series of instructions to this <iframe/> to cover each of the points bulleted in the section above to control how the page will be displayed. TrackerRMS will then render the HTML based on this information within the <iframe/> for visitor to view and action accordingly.

The 3 sets of instructions to pass are summarised in the table below and will form the URL link to be used in the <iframe/> src=”” call:

stylesheetThis is the fully qualified web address to the custom CSS stylesheet file you want to apply to the published content
parametersThis is a comma separated list of fields that will be displayed for each published job and in the order they appear in this list.

For example: parameters=joblink,title,location will display the Job Reference, the Job Title and the Location of the Job:

JOB-1234
Part Time Secretary
London
[filters]Each filter can be included to narrow the published job details to a particular set of records.

For example: worktype=Permanent will display only those Jobs with a Job Type = Permanent

So an example of the format for the URL will be:

publish.asp?stylesheet=http://domain/filename.css&parameters=x,y,z&filter1=a&filter2=b
The HTML and Stylesheet

The styling can be based on the examples below and are completely customisable so will need to be authored by your website designer in order to reflect the look and feel of your website when displaying the published job information.  The published job HTML is rendered using a simple unordered list format as in the following example:

<div id="trackerpublishlist">
    <ul>
        <li>
            <ul>
                <li class="publish_reference">JOB-1168</li>
                <li class="publish_title">Administrator</li>
                <li class="publish_location">London</li>
            </ul>
        </li>
    </ul>
</div>

First, you will probably want to set up the base style for the iframe body and the unordered list that is rendered as follows:

#trackerpublishlist
{
 list-style: none;
 padding: 10px;
 margin: 0px;
 background-color: #fff;
 overflow: auto;
 vertical-align: text-top;
}
#trackerpublishlist ul
{
 list-style: none;
 padding: 0px;
 margin: 0px;
 position: relative;
}
#trackerpublishlist ul li
{
 list-style: none;
 position: relative;
 padding: 0px;
 margin: 0px;
}
#trackerpublishlist ul li ul
{
 list-style: none;
 padding: 0px;
 margin: 0px;
 position: relative;
}
#trackerpublishlist ul li ul li
{
 list-style: none;
 position: relative;
 padding: 0px;
 margin: 0px;
}

As you can see from the example HTML above, each field in the parameter list has its own class reference in the HTML rendered so that it can be style independently to any other field. For example, the “title” parameter can has a corresponding class=”publish_title” CSS class so can be re-styled as in the example below.  Each of the fields therefore can have its own class defined in the CSS file.

#trackerpublishlist ul li ul li.publish_title
{
     font-size: 15px;
     color: #666;
     list-style: none;
     left: 0px;
}

Once all the classes have been defined for the current page, this CSS file should be saved onto your main web server alongside your website in order that it can be referenced in the <iframe/> code.

Getting creative with the CSS

CSS is very flexible in its ability to control the look, feel and content of the information displayed on screen and here are some additional tricks you can use to help you better display published job information to your visitors.

Example 1: This CSS snippet will add the text “Location: ” before the location information is displayed:

#trackerpublishlist ul li ul li.publish_location
{
     font-size: 13px;
     font-weight: bold;
     color: #333;
     list-style: none;
     left: 0px;
     margin-top: 20px;
}
.publish_location:before
{
     content: "Location: ";
     font-weight: normal;
}

Example 2: This CSS snippet will truncate the description to 1 line and add “…” to the end if it runs off the page.  Idea for Vacancy lists:

.publish_description
{
    font-size: 13px;
    	font-weight: normal;
    	color: #333;
    	list-style: normal;
    	left: 0px;
    	background-color: #ffffff;
    	margin-bottom: 10px;
    width: 700px;
    height: 20px;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}
The Parameters

You may decide to have more than one list of Jobs on your website and the parameters you pass will be different for each one.  For example you may have a “Latest Jobs” section which will only display the Job Title and a link to the Job in a designated area of the website which may have code as follows :

N.B. In each of the following examples, if you are a US user, “portal.tracker-rms.com” should be replaced by “usportal.tracker-rms.com”

<iframe frameborder="0" scrolling="no" width="100%" height="300" src="http://portal.tracker-rms.com/[your_url]/publish.asp?stylesheet=http://www.yourdomain.co.uk/LatestVacancies.css&parameters=title,joblink&joblink=http://www.yourdomain.com/jobdetails.xyz&joblinktarget=_parent"></iframe>

For the main Job Vacancies list you may wish to include further information about each Job as follows:

<iframe frameborder="0" scrolling="no" width="100%" height="300" src="http://portal.tracker-rms.com/[your_url]/publish.asp?stylesheet=http://www.yourdomain.co.uk/ListVacancies.css&parameters=title,worktype,location,salaryfrom,joblink&joblinkuri=http://www.yourdomain.com/jobdetails.xyz&joblinktarget=_parent"></iframe>

For the single Job Details page you will want the entire Job Details displayed as follows:

<iframe frameborder="0" scrolling="no" width="100%" height="300" src="http://portal.tracker-rms.com/[your_url]/publish.asp?stylesheet=http://www.yourdomain.co.uk/Vacancy.css&parameters=title,worktype,location,salaryfrom,description,linkregister&reference=1168"></iframe>

Here are a list of all the parameters available to you for this feature:

ParameterDescription
categoryThe Publish Category
descriptionThe Publish Description
durationThe Publish Duration
emailThe Publish Email Address for the Consultant owning the Job in TrackerRMS (including mailto link)
joblinkAn active link to the job that redirects to a new page or javascript function (see job link details below)
linkregisterAn automatic link to your online registration portal passing the Job Id for potential short listing
locationThe Publish Location
referenceThe TrackerRMS Job Reference
salaryfromThe Publish Salary From
salaryperThe Publish Salary Period (e.g. per day, per hour etc)
salarytoThe Publish Salary To
sectorThe Publish Sector
startdateThe Publish Start Date
titleThe Publish Job Title
worktypeThe Publish Work Type
postcodeThe Postcode Location from the main Job Record

For the Job Link information there are a number of advanced settings that can be used to better navigate around your website and these are as follows:

Job Link OptionDescription (Usage)
joblinkuri=A fully qualified URI to a web page that will be linked to when using the joblink parameter

(e.g. http://mysite/myjobpage.php)

Note: This can be a new webpage for displaying a single job and the URI will be appended with &jobcode=123 (where 123 is the unique job id) to facilitate this (e.g. http://mysite/myjobpage.php?jobcode=123). This jobcode can be passed back to this publish function using the &reference= parameter to retrieve the specific job as required.

Examples:

PHP - &reference=< ? php echo $_GET["jobcode"]; ? >
ASP - &reference=<%=Request.QueryString("jobcode")%>
joblinktarget=Can be used to specify where the redirected page is displayed for example "_blank" opens a new window and "_self" or "_parent" etc will open in the same frame/window.
joblinkonclick=If you would prefer that the joblink parameter calls a javascript function (e.g. openMyJob) rather than redirect to a new window in order to modify the window setting etc beforehand then the joblinkonclick can be used to pass the name of the javascript function (joblinkuri and joblinktarget must be blank).

Note: This can be a javascript function for displaying a single job and the function call will be appended with the jobcode as a parameter to the function to facilitate this (e.g. openMyJob(123); ). This jobcode can be passed back to this publish function using the &reference= parameter to retrieve the specific job as required.
Using Javascript and pure HTML pages

If you are unable to use dynamic pages such as .ASP, .ASPX or .PHP to retrieve the &jobcode from the web address then we have compiled the following Javascript code that can be used in any .HTML page to retrieve the jobcode from the address and pass this to the <iframe/> for you.

Paste the following Javascript code at the bottom of your “Job Details” page:

<script type="text/javascript">

    var getQueryString = function (field, url) {
        var href = url ? url : window.location.href;
        var reg = new RegExp('[?&]' + field + '=([^&#]*)', 'i');
        var string = reg.exec(href);
        return string ? string[1] : null;
    };

    function loadSite() {
        var site = "http://usportal.tracker-rms.com/xyz/publish.asp?stylesheet=http://www.tracker-rms.com/publish.css&parameters=title,location,description&reference=" + getQueryString("jobcode");
        document.getElementById('trackerrms-iframe').src = site;
    }

</script>

Then within the body of the page, ensure the following code is included:

<body onload="loadSite();">
    <iframe src="" frameborder="0" scrolling="yes" width="700" height="700" id="trackerrms-iframe"></iframe>
</body>
The Filters

There are a number of filters that have been included for when you want to reduce or differentiate the Jobs being displayed, for example you may want to have a search box on your website to allow visitors to fine certain job titles, or have a drop down filter to select between permanent and temporary Job Vacancies only.  This is where filters come in and you can add any combination of these to your publish call.  The list of filters available are as follows:

Query String ParameterDescription
worktype=The Work Type for the main Job record in text format
department=The Department for the owner of the main Job record in text format
reference=The Job Id of the main Job record (returns a single record so great for the Job details page)
keywords=Keywords for searching title and description
sector=Sector as defined in the Publish section
location=Location as defined in the Publish section

 

Output Formats

You can now publish your jobs from Tracker to your own website or to external job boards (where it is supported) in the following formats using the &output= parameter in your call to the publish.asp page.

FormatDescriptionOutput Parameter
HTMLStandard Hypertext Markup Language for use on your normal web pages and can be passed styling information as beforeNot required
XMLThe same information as the above publish function only in pure XML format which is useful for importing publish jobs information into another system such as a website CMS or jobs database managed locally&output=xml
RSSStandard RSS news feed based publishing of the jobs information which can be subscribed to of viewed in a standard browser or RSS reader&output=rss

What to do next

Here is a summary of the steps to following to embed Published Jobs on your website:

  1. Create a new blank web page on your website which can include all the logos, colours and navigation of the other pages on the website as the published jobs information will be included in the main body only.
  2. Obtain your unique publish jobs portal link from our support team or your account manager, for example http://usportal.tracker-rms.com/Tracker_DEMO_REC_US2/publish.asp which you will need for the main <iframe/> code.
  3. In the main body of the new webpage, include the <iframe/> HTML, replacing the address with the one constructed using the instructions above.
Safari Known Issues

Safari browsers may have an issue when using iframes as this browser does not allow iframe’d pages to use cookies unless the end user has first visited the same page in the main browser window.  This can cause the registration pages to error on Safari and iPhone etc as it uses cookies to store certain information about the session.

The work-around for this is to use the urlRedirect parameter which allows you to call our registration page as the main page in the browser and then instantly redirect to your branded web page.  This allows the browser the ability to store the cookies which are then used within the iframe.

To do this:

  1. If not already in place, ensure that you have a branded web page on your website for housing our TrackerRMS registration page (e.g. www.yourwebsite.com/register/ ) and that the jobcode in the query string we pass you is transferred to the src of the iframe.  See instruction above regarding this.
  2. Update your TrackerRMS settings to make the registration button point to the redirected page in Tools > Job Settings > Job Boards > Registration Override URI
    e.g. http://[us]portal.tracker-rms.com/[yoursite]/register.asp?urlRedirect=http://www.yourwebsite.com/register/

This will ensure a seamless link to the registration page that will work in any browser, but address the issues surrounding iframes in Safari