1) How to integrate it in a website and existing .php file?

If you downloaded the script .zip file and extracted the files in a sub folder, for example /test , it's enough to add such line of php code:


in order to show the jobs by category or the following line:


in order to show the latest jobs. You can also add them both on a single page and change their positions in order to have for example the jobs by category show up at the top and latest jobs below or the jobs by category to show in the middle, while the latest jobs in a right panel etc.

2) Changing the different settings like SimplyHired Publisher ID, preferred country, number of results per page and others

To change these values, you need to edit the configuration file - config.xml located in the /simplyhired-job-lister folder.

You may check the content of the sample config.xml file below -

<my_config> <configuration> <publisher_id>1555820896294234</publisher_id> <api_domain></api_domain> <date_format>m/d/Y</date_format> <timezone>Europe/London</timezone> <results_per_page>20</results_per_page> <latest_jobs_number>5</latest_jobs_number> <latest_jobs_default_category>Computers</latest_jobs_default_category> </configuration>

The values you could modify in the configuration file are

publisher_id -your SimplyHired publisher id, you could get one by signing up as publisher on the website
api_domain - the api domain, as provided by the simplyhired api when registering as publisher
date_format - the format of the date, in the way you prefer the date should be displayed on the website (accepts any valid php date format string)
timezone - the time zone of the website (acepts any valid php time zone)
latest_jobs_number - the number of jobs showing up in the latest jobs section
latest_jobs_default_category - the default category for the latest jobs section, you can enter any word - the search will be performed by it or leave empty

3) How to define your own job categories?

You could do that by editing the categories.xml file located in the /simplyhired-job-lister folder.

You may find below the content of the sample products.xml file we are using in our demos:

<job_categories> <category>Accounting</category> <category>Computers</category> <category>Banking</category> <category>Freelance</category> <category>Customer Service</category> <category>Healthcare</category> <category>Human Resources</category> <category>Manufacturing</category> <category>Marketing</category> <category>Science</category> <category>Hotels</category> <category>Restaurants</category> <category>Fashion</category> <category>Textile</category> <category>Retailing</category> <category>Logistics</category>

To add more categories, you need to add more lines in the categories.xml by keeping the same file format.