This article concerns versions 2.0.0 (and later) of the Recruiter Profiles Add On
The Matador Jobs Pro – Recruiter Profiles Add On provides two shortcodes:
- [matador_linked_recruiters] – for displaying recruiters linked to a job (e.g. displaying a recruiter profile alongside a job’s details)
- [matador_all_recruiters] – for displaying all the recruiters on your site (e.g. displaying all the recruiters on an ‘Our Team’ style page)
- [matador_recruiter_linked_jobs] – for displaying all jobs a recruiter is linked to<
Displaying Recruiters Linked to a Job
You can display all the recruiters linked to a job using the [matador_linked_recruiters] shortcode.
By default, the recruiter profile displayed by this shortcode will contain all the fields which are set to ‘on’ in the ‘Recruiter Profiles’ tab of Matador Job’s settings.
You should use this shortcode in a context where it can pick up on a job and display the recruiter(s) associated with that job (e.g. on a job’s single page).
Displaying Jobs linked to a Recruiter
You can display all the jobs linked to a recruiter using the [matador_recruiter_linked_jobs] shortcode
You should use this shortcode in a context where it can pick up on a job and display the recruiter(s) associated with that job (e.g. on a job’s single page or on the profile page).
Displaying All Recruiters
You can display all the recruiters on your site using the [matador_all_recruiters] shortcode. This shortcode will display a recruiter profile for all the recruiters on your site.
By default these recruiter profiles will contain all the fields which are set to ‘on’ in the ‘Recruiter Profiles’ tab of Matador Job’s settings.
This shortcode can be used in any context where you want to display all the recruiters on your site.
Setting which fields are displayed
You may wish to have finer grained control over which recruiter fields are displayed than simply setting them to on/off in the settings. This can be achieved using the fields attribute of the shortcodes. Simply specify the fields you want to display, in the order you want them to appear. Fields must be activated in the settings to be able to appear in the front end.
Here’s an example of using the fields attribute to display only the title and name of the linked recruiter (in that order).
If a field is disactivated (se to ‘off’) in the settings, it will not be shown on the front end, even if it is passed to the shortcode using the ‘fields’ attribute.
Similarly, if there is no value set for a field, it will not display (as there’s nothing to show)