Jobs on your website

Introduction

There are three ways to display the jobs you create in JobAdder on your website – our Javascript widget, JobAdder’s XML job feed and our new careers page builder.

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.

The careers page builder is a more hands free approach, we do the work styling it and you add a HMTL link on your website – it’s that simple. We  are actively developing the CPB solution with other features and functionality.

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:

 

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 Schema

 

Element and Attribute Descriptions

Please view this on desktop device to view the table.

ElementAttributeData typeDescription
JobsRoot element
advertiserStringYour company name
jidIntegerInternal JobAdder ID
sourceStringInternal JobAdder job board reference
Job
jidIntegerInternal JobAdder ID
referenceStringJob reference as entered into JobAdder
datePostedDateDate the job was posted
dateUpdatedDateDate the job was last updated
TitleString
80 characters max
Job title
SummaryString
150 characters max
Job summary / short description
DescriptionString
No maximum length
Job description. May contain HTML
BulletPointsMaximum of 3 bullet points per job ad
BulletPoints BulletPointString
80 characters max
Bullet point text
SalarySalary information
periodStringPossible values:
PerAnnum
PerMonth
PerDay
PerHour
Salary MinValueIntegerMinimum salary value
Salary MaxValueIntegerMaximum salary value
Salary TextString
50 characters max
Additional salary text
Eg. “Plus Super”
ClassificationsList of classifications this job has been given
Classifications ClassificationStringClassification value
jidIntegerInternal JobAdder ID
nameStringClassification name
ApplyApplication information
Apply EmailToStringEmail address applications should be sent to
Apply UrlStringUnique 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.

Careers Page Builder

Please ask sales or support for more information on this option - it is brand new.