The job-widget integrates seemingly into your website and automatically displays all published jobs, as well as a filter and search bar. You find all the needed information in our article to configurate your own widget.
Table of contents
To install the widget, the widget code needs to be copy-pasted into the website at a chosen position. You can find the widget code in the settings of your recruiter account under "Settings" (1) > "Integrations" (2) > "Website Widget" (3) > "Website Widget Code" (4).
In order to copy the right widget code be sure that you´ve selected the right config of your code in the drop-down menu "Current default configuration". If no configuration is selected, the one which is set as default will be used.
Multiple widget configurations can be created in the settings of your recruiter account under "Settings" (1) > "Integrations" (2) > "Widget Configurations" (3). The "Widget Config 1" (4) is your automatically generated default configuration. To edit your default configuration click on "Edit" (5) and configure the parameters according to your website. To add another widget configuration click on "Add widget configuration" (6). You can also set the new configuration as default by clicking the link "Set as default" (7).Attention! All saved changes are immediately applied to your integrated widget on your website.
|lang||browser, de, en, hu, fr||browser||Defines the language of the widget interface. If set to "browser", it uses the default language of the browser.|
|primary_background||Background color of main page + search input field + filter holder input fields|
|secondary_background||Background color of filter-bar + job title hover + buttons|
|standard_text||Default job title + link color|
|primary_text||Colored headings and inline links in forms|
|secondary_text||Table header/footer font color (usually darker gray)|
|selection_text||Color, when selecting an element or a piece of text.|
|border_radius||Border-radius for buttons: 3px = rounded, 0px = not rounded|
|helper_color_1||Button-hover background color|
|helper_color_2||Table header/footer row background|
|font_family||Helvetica, Arial, Sans-Serif||Overall font-family (usually Helvetica, Arial, Sans-Serif)|
Example widget-code with client-sided-configuration:
<div id="psJobWidget"></div> <script src="https://mycompany.jobbase.io/widget/iframe.js?lang=de&font_family=monospace"></script>
3. URL-parameters / Speculative applications
In order to handle speculative (self-initiative) applications you have to create a separate link (e.g. above or below the widget), which includes special URL parameters.
Let’s say you have integrated the widget under this URL:
The link for initiating a speculative application would then be:
- "jh": The "jh"-parameter tells the widget, which job it should load (jh = job-handle, 0 = no job, speculative application).
- "sa": The second parameter “sa=1” tells the widget, that it should skip the job-ad and instead start the application process.
This way you could also load jobs / start the application process for jobs within the widget (without using the job list of the widget), e.g. if you render the job list by yourself with the help of our JSON/XML job-feed.
4. Additional adaptions
It is possible to use job related custom data fields as a widget column. To define them navigate to "Settings" (1) > "Jobs" (2) > "Custom Data Fields" (3) and edit the fields that should be displayed as a column. For this click on "Edit" (4) > Gear icon (5) and activate the button "Display as column" (6).
Note: If you activate custom fields as columns on your widget, it removes the columns "City" and "Position Type".
In addition to the custom-columns above, it is also possible to remove the "Added" date column. Please contact our support, if you want this column to be removed.
There are additional filters which can only be configured by us. If you consider some of these filters or want them removed, please contact our support team.
|Team-Filter||If that filter is enabled, then it is possible to filter for a team|
|Instance-Filter||If that filter is enabled, then it is possible to filter for a instance|
|Country-Filter||If that filter is enabled, then it is possible to filter for a country|
|Job-Title-Filter||If the same job-title is published more than once, then it´s possible to filter for the job-title.|
Our widget needs third-party cookies (for your mycompany.jobbase.io domain) in order to work properly. As modern browsers are restricting the possibility for third-party providers to place cookies into browsers, enabling the multi step application process within the customer website is not possible in all cases (recent versions of Safari are very restrictive to prevent tracking users). In this case we, as the owner of the "jobbase.io" domain, are not allowed to save a cookie in the browser of a user that is currently visiting the customer domain (e.g. mycompany.com/jobs). The same situation occurs when a user has restricted the browser to accept cookies from third-party domains. In that case — in order to keep the widget working as good as possible — we set a cookie "ps_widget_token" in the name of your homepage (http://mycompany.com) and manage the session with GET parameters in the iFrame-URL.