Job Board Component: Difference between revisions

Jump to navigation Jump to search
1,191 bytes added ,  12:21, 2 October 2023
no edit summary
No edit summary
No edit summary
Line 1: Line 1:
== Intro ==
== Intro ==
This component renders ATS jobs posted to a provided job board.  
The <code>JobBoard</code> is a versatile web component designed for job listings. This component can fetch and display job posts from a given endpoint and also allows for search functionality based on a variety of criteria.  


== 3B Portals Compatibility ==
== 3B Portals Compatibility ==
This component is fully compatible with 3B Portals
This component is fully compatible with 3B Portals. Simply drag and drop it in a portal page.


== Set Up ==
== Set Up ==
Line 10: Line 10:
When creating a Job Board record in the system, please set the following fields:
When creating a Job Board record in the system, please set the following fields:


* Name - this is the name of the job board and must match one of the options defined on the Job Boards multi-select field on the job object
* Job Post Link (b3o__Job_Post_Link__c) - this is a template link telling the Job Board component where to re-direct the user when they click on a Job Post. A valid value is https://.../JobPost?id={0}. The {0} param will be merged with either the Job Id or the Job Reference
* Job Post Link (b3o__Job_Post_Link__c) - this is a template link telling the Job Board component where to re-direct the user when they click on a Job Post. A valid value is https://.../JobPost?id={0}. The {0} param will be merged with either the Job Id or the Job Reference


Line 67: Line 68:
</syntaxhighlight>
</syntaxhighlight>


== Options and ATS Config ==
== Attributes ==


=== Attributes ===
=== User and Job Board Settings ===


* user-id - this is the contact id. Required
* <code>user-id</code>: User's unique ID.
* job-board-name - we will match the value provided in this attribute against the defined Job Boards field value on the Job object
* <code>job-board-name</code>: The name of the job board.
* <code>portal-post-link</code>: The link when embedded in 3B Portals which defines the Job Post page.
 
=== Customization and Overrides ===
 
* <code>default-search-radius</code>: Sets the default search radius (default is <code>10</code>).
* <code>places-api-key</code>: Key for Google Places API, if using.
* <code>job-object-name</code>: The API name of the job object (default is <code>b3o__Job__c</code>).
 
=== Search Parameters ===
 
* <code>search-radius-opts</code>: Options for the search radius dropdown.
 
=== Field Paths for ATS Integration ===
These attributes define the field paths for specific pieces of data within your ATS (Applicant Tracking System). Defaults are provided, but can be overridden for customization:
* default-search-radius - defaults to 10
* default-search-radius - defaults to 10
* places-api-key - not set by default
* places-api-key - not set by default
Line 79: Line 94:
* site-coordinates-path = 'b3o__Site__r.b3o__Coordinates__c' - for radius search, this is the coordinates of the job
* site-coordinates-path = 'b3o__Site__r.b3o__Coordinates__c' - for radius search, this is the coordinates of the job
* job-board-path = 'b3o__Job_Boards__c' - the job boards multi-select field
* job-board-path = 'b3o__Job_Boards__c' - the job boards multi-select field
* job-title-path = 'b3o__Job_Advert_Title__c'  
* job-title-path = 'b3o__Job_Advert_Title__c'
* job-short-path = 'b3o__Job_Post_Short_Description__c'
* job-short-path = 'b3o__Job_Post_Short_Description__c'
* job-body-path = 'b3o__Job_Post_Body__c'
* job-body-path = 'b3o__Job_Post_Body__c'
Line 85: Line 100:
* job-featured-path = 'b3o__Featured_Job__c'
* job-featured-path = 'b3o__Featured_Job__c'
* job-posted-path = 'b3o__Date_Posted__c'
* job-posted-path = 'b3o__Date_Posted__c'
* siteFieldPath = 'b3o__Site__c'  
* siteFieldPath = 'b3o__Site__c'
* site-name-path = 'b3o__Site__r.b3o__Public_Name__c'
* site-name-path = 'b3o__Site__r.b3o__Public_Name__c'
* job-type-path = 'b3o__Job_Type__r.Name'
* job-type-path = 'b3o__Job_Type__r.Name'
Line 100: Line 115:
Note: for attributes that are not documented, please see the 3B Job object's fields.
Note: for attributes that are not documented, please see the 3B Job object's fields.


=== URL Params ===
== URL Parameters ==
userId or just id - the contact id (optional)
The <code>JobBoard</code> component can pre-populate filters using URL parameters. For example, to filter by employment type, location, job type, and keyword, the URL might look like:<syntaxhighlight lang="text">
.../JobBoard?employmentType=Contract&location=London&jobType=Vaccinator&keyword=blah


''Note that attributes will always override URL params and you can mix and match''
</syntaxhighlight>
[[Category:3B Onboarding]]
[[Category:3B Onboarding]]
[[Category:3B Portals]]
[[Category:3B Portals]]

Navigation menu