LogicMelon JobRelay field reference guide
This page outlines all of the data that is received in WordPress from LogicMelon in the JobRelay feed.
Without any configuration, the job title is saved as the post title, the job description is saved as the post content and the job short description is saved as the post excerpt.
The job post date will be the date and time when the post was created, seconds or minutes from when it was published in LogicMelon.
The tables below outline the data that arrives in WordPress from the LogicMelon JobRelay feed. Data is saved by mapping it to WordPress meta or taxonomy terms.
Required fields
JSON node | Data type | Example value | Notes |
---|---|---|---|
subscription_id | integer | 1 | The client subscription ID with JobRelay. This can be found on their subscriptions page in “My Account”. |
license_key | string | dfdf343fsf | The license key assigned to the JobRelay user when they signed up. This should be included in their welcome email but can also be found on the purchase history page |
site_url | string/url | https://site.url/ | The URL of the site to which this users jobs should be ‘relayed’ too. Users should first add this site to their JobRelay My Account > Purchase history > View licenses > Manage sites area. |
password | string | aZkp3760rsAn | A password to authenticate the feed. Letters and numbers only. |
job_reference | string | REF-123 | A unique reference assigned to this job. |
job_title | string | WordPress Developer | The job title – no HTML allowed. |
job_description | string | | the main description of the job. It can contain the following HTML elements<img> <a> <strong> <em> <ul> <ol> <li> |
command | string | add | Wither add , update or delete . |
application_email | string | tracking123@site.url | This is the email address used to track applications to this job. |
application_url | string | https://site.url/apply?job=12334 | The URL of the application form for this job, if not using a tracking email address. |
job_source | string | Awesome Job Posting Service | A string representing the source of the job (where it was written). For example Broadbean, LogicMelon or Idibu |
LogicMelon fields
JSON node | Data type | Example value | Notes |
job_short_description | string | ||
contact_name | string | Jane Smith | The recruiters name. |
contact_email | string | jane.smith@mail.com | The recruiters email |
contact_telephone | string | 01234567890 | The recruiters telephone number. |
contact_url | string/url | https://site.url | The recruiters website URL. |
company_name | string | JobRelay | The company name where the position is. |
company_tagline | string | Relaying Jobs | The company tagline where the position is. |
company_website | string/url | https://jobrelay.io | The company website where the position is. |
company_twitter | string | @jobrelay | The company twitter handle where the position is including the @ symbol. |
company_logo | string/url | https://img.com/im.jpg | The company logo where the position is. This should be a hosted image URL. |
company_video | string/url | https://youtube.com/videoid | A link to a video on a video sharing site such as Youtube. |
expiry_date | date | 2020-12-01 | When the job expires or no longer takes applications. Should be in the format of YYY-MM-DD . |
start_date | string | 2021-01-10 or ASAP | When the job starts. Can be any string including in a date format. |
salary_currency | string | GBP | Currency code for the salary |
salary_from | float | 10000 | A number (float) for the lower salary. |
salary_to | float | 20000 | A number (float) for the highrer salary. |
salary_per | string | annum | For more information please see our Default Values. |
salary_benefits | string | Laptop & healthcare | Freetext, additional salary information. |
salary | string | £15000 + benefits | A string for the salary. |
featured | boolean | 1 | 1 to mark as featured or 0 (default) to not be featured. |
job_location | string | London, UK | The formatted location string. |
job_location_raw | string | Europe > England > London | The raw location string. |
custom_data | string | Some custom data | This is an open text field for any additional information. |
Multi-select fields
These are the fields that have multi-options from which to select from in LogicMelon.
JSON node | Data type | Example value | Notes |
job_type | string | Contract | A pipe (| ) separated list of job types. |
job_hours | string | Full Time | A pipe (| ) separated list of job hours. Used for full time and part time. |
job_industry | string | IT | A pipe (| ) separated list of job industries. |
working_arrangement | string | Remote | One of either “Remote”, “Hybrid” or “Office based”. If none selected and empty field is sent. |
Geo location fields
These fields are available for all providers. The providers don’t actually send this data. It is generated by JobRelay for each job and then sent onto your WordPress website.
JSON node | Data type | Example value | Notes |
geo_lat | float | 53.19339 | The latitude of the job location. |
geo_long | float | -2.89075 | The longitude of the job location. |
geo_formatted_address | string | Chester, UK | The formatted address of the location sent. |
geo_city | string | Chester | The name of the city for the geo located location |
geo_country_short | string | GB | The shortened country name for the geo located location |
geo_country_long | string | United Kingdom | The long country name for the geo located location |
geo_administrative_area_level_2_short | string | Cheshire West and Chester | The short version of the second level administrative area. |
geo_administrative_area_level_2_long | string | Cheshire West and Chester | The long version of the second level administrative area. |
geo_administrative_area_level_1_short | string | England | The short version of the first level administrative area. |
geo_administrative_area_level_1_long | string | England | The long version of the first level administrative area. |
It is worth noting that not all of this data is available for every job. JobRelay uses the Google Geo coding API to obtain Geo data for each job, using the job_location
field.
The location is run through the API and the resulting data sent on. Depending on the location string, not all this data may be available.
For example, if the location sent via JobRelay is Lancashire, UK
, a geo_city
value will not be present. This is because the location is not specific enough to return a city value.