Jobs on your website

Introduction

There are two ways to display the jobs you create in JobAdder on your website - our Javascript widget and JobAdder’s XML job feed.

The Javascript widget is the simplest and quickest way to display a list of jobs, job search form, job details pages and application form on your website. All you need to do is add a couple of lines of code and (optional) styles to your page.

Some development work will be required to integrate JobAdder’s XML job feed with your website, however this option gives you ultimate flexibility - you can display jobs in a way that suits you, build a custom search form or create job alerts for your subscribers.

JavaScript Widget

JobAdder’s customizable Javascript widget allows you to easily display the following on your website:

  • A list of your current jobs
  • A job search form
  • Job detail pages
  • An application form that candidates can use to apply.

To get up and running -

  1. Generate your embed code using our widget builder
  2. Add the embed code to your website
    This is usually done by copying and pasting the code into your page using your CMS or HTML editor.
  3. Style the widget so it matches the look and feel of your website
    The widget automatically uses the styles (fonts, colours, etc) you’re already using on the page. If you know CSS then it’s easy to customize the look and feel of the widget.
    No idea what CSS is? No problem - your designer or developer will be able to easily make these changes for you using our default styles.

Example

Here’s an example of the embed code you would add to your page -

<div id="ja-jobs-widget"></div> <script> var _jaJobsSettings = { key: "bbhc36kiqfoudkoc4yd7qaihf4" }; </script> <script src="//apps.jobadder.com/widgets/v1/jobs.min.js"></script>

Modifying the default behaviour

The widget is quite flexible, allowing you to modify things like the number of jobs displayed per page, link and button text, displaying a search form and even displaying "hot"" jobs only.

Use our widget builder to modify these settings and generate your customized embed code.

Please speak to our Support Team if you would like to display a customized application form that can include custom fields and screening questions.

FAQ

Q. How often are jobs updated?
A. Jobs are updated once per hour (if there have been new jobs added, jobs expired or edited).

Q. Can I add the jobs widget to more than one page?
A. Yes, the widget can be added to as many pages as you like, but it can only be included once per page.

Q. If I update the settings on apps.jobadder.com/widgets will it update my website?
A. No, each time you make a change to the widget you will need to copy the new embed code and add it to your website.

Q. Can I change the job categories and locations via the apps.jobadder.com/widgets?
A. No, this will need to be changed via JobAdder. Your JobAdder Administrator can make these changes in the Admin console, or contact the JobAdder Support Team for assistance.

XML Job Feed

If you would like more control over how jobs are searched and displayed on your website JobAdder can send you an XML file containing your job data.

Your developers will take the data from the XML file and use it to build a custom job search form, job list, job detail pages, or whatever else you need.

We can send you the XML in several ways -

  1. We upload the file to your FTP server.
    You provide us with the host name and login details of your server.
  2. We HTTP POST the XML data to your website.
    Your developer creates a page or URL where we can post the data.
  3. We can send you the file by email (not recommended)
    Email is not a reliable solution and should only be considered as a final resort if you are unable to use either of the above methods.

Sample XML

<?xml version="1.0" encoding="utf-8"?> <Jobs advertiser="Your Company" jid="10000" source="xco62rdcabeezp6as7vnn5yfcm"> <Job jid="100000" reference="sample001" datePosted="2014-01-01" dateUpdated="2014-01-02T02:28:29Z"> <Title>Sample Job</Title> <Summary>This is the job summary</Summary> <Description><![CDATA[This is the job description and can contain <strong>HTML</strong>]]></Description> <BulletPoints> <BulletPoint>Thrilling Partnership</BulletPoint> <BulletPoint>Convenient Sydney CBD location</BulletPoint> <BulletPoint>Remarkable Career Opportunity</BulletPoint> </BulletPoints> <Salary period="PerAnnum"> <MinValue>65000</MinValue> <MaxValue>80000</MaxValue> <Text>Including company car and phone</Text> </Salary> <Classifications> <Classification jid="10000" name="Category">IT</Classification> <Classification jid="10001" name="Sub Category">Architect</Classification> <Classification jid="10002" name="Location">Sydney</Classification> <Classification jid="10003" name="Work Type">Full Time</Classification> </Classifications> <Apply> <EmailTo>applications@yourcompany.com</EmailTo> <Url>http://apply.jobadder.com/999/10000/xco62rdcabeezp6as7vnn5yfcm</Url> </Apply> </Job> </Jobs>

XML Schema

<?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="Jobs"> <xs:complexType> <xs:sequence> <xs:element name="Job" minOccurs="0" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="Title" type="xs:string" /> <xs:element name="Summary" type="xs:string" /> <xs:element name="Description" type="xs:string" /> <xs:element name="BulletPoints" minOccurs="0" maxOccurs="3"> <xs:complexType> <xs:sequence> <xs:element name="BulletPoint"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Salary"> <xs:complexType> <xs:sequence> <xs:element name="MinValue" type="xs:int" /> <xs:element name="MaxValue" type="xs:int" /> <xs:element name="Text" type="xs:string" /> </xs:sequence> <xs:attribute name="period" type="xs:string" /> </xs:complexType> </xs:element> <xs:element name="Classifications" minOccurs="0" maxOccurs="unbounded"> <xs:complexType> <xs:sequence> <xs:element name="Classification"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="jid" type="xs:int" /> <xs:attribute name="name" type="xs:string" /> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Apply"> <xs:complexType> <xs:sequence> <xs:element name="EmailTo" type="xs:string" /> <xs:element name="Url" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> <xs:attribute name="jid" type="xs:int" /> <xs:attribute name="reference" type="xs:string" /> <xs:attribute name="datePosted" type="xs:date" /> <xs:attribute name="dateUpdated" type="xs:date" /> <xs:attribute name="hot" type="xs:boolean" /> </xs:complexType> </xs:element> </xs:sequence> <xs:attribute name="advertiser" type="xs:string" /> <xs:attribute name="account" type="xs:int" /> <xs:attribute name="jid" type="xs:int" /> <xs:attribute name="source" type="xs:string" /> </xs:complexType> </xs:element> </xs:schema>

Element and Attribute Descriptions

Element Attribute Data type Description
Jobs Root element
advertiser String Your company name
jid Integer Internal JobAdder ID
source String Internal JobAdder job board reference
Job
jid Integer Internal JobAdder ID
reference String Job reference as entered into JobAdder
datePosted Date Date the job was posted
dateUpdated Date Date the job was last updated
Title String
80 characters max
Job title
Summary String
150 characters max
Job summary / short description
Description String
No maximum length
Job description. May contain HTML
BulletPoints Maximum of 3 bullet points per job ad
BulletPoints BulletPoint String
80 characters max
Bullet point text
Salary Salary information
period String Possible values:
PerAnnum
PerMonth
PerDay
PerHour
Salary MinValue Integer Minimum salary value
Salary MaxValue Integer Maximum salary value
Salary Text String
50 characters max
Additional salary text
Eg. “Plus Super”
Classifications List of classifications this job has been given
Classifications Classification String Classification value
jid Integer Internal JobAdder ID
name String Classification name
Apply Application information
Apply EmailTo String Email address applications should be sent to
Apply Url String Unique application form URL for this job

FAQ

Q. How often is the XML job feed updated?
A. The XML feed is updated once per hour (if there have been new jobs added, or jobs expired or edited).

Q. Does the XML contain all current jobs or just those that have changed?
A. The XML contains all current active jobs as they exist in JobAdder. It is up to you to determine any jobs that have been added, updated or deleted.

Q. Can the XML be customized?
A. No. It contains all available job information. You simply take the bits you need.

Q. Can I change the job classifications (e.g. the categories, location and work types)?
A. Yes, this will need to be changed via JobAdder. Your JobAdder Administrator can make these changes in the Admin console, or contact the JobAdder Support Team for assistance.