Your Jobs Pages

If you’ve followed our Getting Started guide step-by-step, good news, you’re on the final step! We are now going to see how to display your jobs on your site. This document will cover:

• Viewing the Single Job page
• Creating a Jobs page using the [matador_portal] shortcode.
• Settings that affect the display on the front-end

Let’s start with… a job.

The Single Job

To view a single job, provided your sync has successfully imported some jobs already, go to your WordPress admin area, then click or tap Matador Jobs in the menu. You will go to your list of jobs.

By tapping or hovering your mouse over the table row containing a job, a submenu will appear. Click or tap on “view” to go to the job.

Every WordPress theme will make the job page look different.

Matador Jobs posts inherit as much styling, or look and feel, from the theme as possible. Since many WordPress themes are custom built to fit the branding of the business or entity the website represents, this means your job page should have similar fonts, colors, and layout to the rest of your site.

Depending on your settings, your application form may appear after your job description or an Apply Now button will guide users to the application.

Every WordPress theme is built differently, and sometimes the developer of a theme might not have prepared it for having posts like Job Listings on the site. If you see stuff that doesn’t belong, like “author” or “date”, this is a sign your post.php template–the default single post look/feel–was made too specifically. You will want to engage a local WordPress developer to either modify the default template or create a single-matador-job-listings.php template to customize this.

The Jobs Listing Page

The easiest way to create your jobs listing page is to make a new WordPress page and use the [matador_portal] shortcode. Here is how you do that:

• Log into the WordPress Admin area
• Mouse hover, focus, or tap on Pages. Then click or tap on Add New in the submenu.
• Name the new page. “Search Jobs” works great!
• Add the shortcode using the method right for your WordPress install.
  • If using the WordPress Block Editor, create a new shortcode block by clicking on the + and typing shortcode. Enter [matador_portal] into the box.
  • If using the WordPress Classic Editor, simply type [matador_portal] into the box.
• Click or tap Publish.

You page might look something like this (in the WordPress Block Editor):

One more to-do: now, we’ve created the page, but we need to teach Matador that this is the jobs page:

• Log into the WordPress Admin area
• Mouse hover, focus, or tap on Matador Jobs and then click or tap Settings. Navigate to the Job Listings tab.
• Scroll down to the URL Settings section.
• Change the Job Board Location setting to the name of the page you just created.

Great! Now, we can go visit that page on your site! The list of jobs will appear with the title, an excerpt of the job description, a job information header containing location, the job type, and the Bullhorn Job ID, and finally jobs navigation button(s), generated based on your settings.

The jobs navigation button(s) will reflect your application settings, showing either “More Info” and “Apply Now” buttons if the application is on a separate page, or just an “Apply Now” button if the application is appended to the job page.

The Job Information header can be enabled or disabled in settings. Older versions of Matador did not have this feature, and so it is toggle-able to provide backward-compatibility.

Don’t forget to add links to this page from your main menu so visitors can begin finding your jobs!

Settings that Impact Job Display

Now that we have a page that is showing jobs, we can mess around with some settings and change the experience. Go to WordPress Admin > Matador Jobs > Settings and let’s play with some of these settings:

This is not a comprehensive review of Matador settings, and many will be skipped. The goal is to show you several settings that may affect how your first jobs display. You can learn more about all settings in the Basic Configuration > Settings help documentation category.

Under the “General” Tab

“Use Matador Styles” determines whether Matador will load its stylesheets that help with basic layout and styling. Turn off to write your own CSS for displaying jobs and application forms.

Under the “Job Listings” Tab

Job Date Field: Choose the field which will represent the job date. Since jobs are displayed reverse chronologically by default, newer jobs will be at the top. “Date Added” is when the job record is created in Bullhorn, “Date Last Published” is the date the job was last explicitly published or republished in Bullhorn, “Date Last Update” is the date the job record was last updated, which may include even minor changes. We recommend “Date Last Published.”

Description Field: Choose the field in Bullhorn where you will source your job description. As a best practice, choose “Published Description,” which is set during Publishing, over the Description field.

Category Field: Choose the field in Bullhorn where you will source your category. As a best practice, choose “Published Category,” which is set during Publishing. That said, “Job Categories” can have multiple values while the Published Category cannot, so if you’d like to show your job in secondary categories, choose “Job Categories” instead of “Published Category”.

Location Taxonomy Term: The Matador “locations” taxonomy can be populated by one of several options. Since most job filtering occurs against the taxonomies, selecting the right type of term for a location is important. Regionally-focused firms might use city/locality while international firms use country.

“Remote” Taxonomy Term: Toggle this setting to “on” to add a “Remote” value to the “locations” taxonomy when certain triggers are met. This is in addition to the location term added by the prior setting.

Show Job Info Header: Whether to show the job info header, a box containing information about the job. Best practice is to leave this on unless a web developer builds a custom layout for your jobs.

Display Job Salary/Pay Rate: Toggle whether to display job salary information (and expose it to external aggregators and Google for Jobs). If “Show Job Info Header” is off, this will not show automatically on your site but needs to be on to be exposed to external services. You may be obligated under local laws or regulations to display this.

Sort Jobs By: Select how you’d like your jobs sorted.

Order Jobs By: Select whether you’d like your jobs ordered ascending (ie: oldest first, to newest) or descending (ie: newest first, to oldest).

Under the “Applications” Tab

The following settings will be available only to users of Matador Jobs Pro, as Application Processing is a core feature.

Application Method and Confirmation Method: these settings determine how your applications and application confirmations are displayed. “Add” them to your job page to include the Application form and Confirmation (if needed) above or below your job page. “Generating” them to create a “page” for the application and confirmations. Or “Link” to a custom WordPress page, which will add a setting for you to select the page. Your selections will influence how Matador routes user traffic around your jobs pages and impact what kinds of buttons are added to your jobs pages.

“Resume” or CV: This setting changes occurrences of the word resume to “CV” or “Curriculum Vitae” and uses the correct terminology for your locale.

Default Application Fields: This setting lets you select the fields that show on the default application. This setting is often overridden by code customizations or the Advanced Applications extension.

Require Applicant to Agree to Privacy/Terms of Service: Toggling either of these settings to “on” will add a checkbox at the bottom of every application that must be checked in order for an application to be accepted. The fields state the user has read and agreed to the Privacy Policy and/or Terms of Service.

Terms of Service Page: If this setting is activated, a link to the selected page will be added to the Terms of Service field.

The global WordPress > Settings > Privacy setting Privacy Policy Page setting functions exactly as the Terms of Service Page Matador Setting. If you want a similar link to your Privacy Policy near the checkbox, set the global Privacy Policy Page setting.

Whats Next?

Well congratulations! You’ve purchased Matador, installed Matador, connected to Bullhorn, imported your published jobs, and now are showing them on the site. You’re done right?

Well, technically, you can be, but we know you have more you want to do, so from this point we invite you to explore two resources at your own pace. First, we’ve made a complete checklist for everything we think you should do when setting up Matador. Some of the steps you’ve already completed. Checkout our Setting Up Matador Checklist for more. Second, you can explore more in-depth help docs on various topics about getting the most out of Matador in our Using Matador docs category.

Regardless of how you move forward from here, welcome to the party!