8 - Setting Up Custom Fields

Once you have setup your core listing pages, you might feel the need take it a step further and customize custom fields which includes not only adding new fields but also editing or removing existing fields.

Adding or modifying fields in job/resume submission form is just one aspect, since you most probably would aslo want to display those fields in your single listing pages.

In this section, I'll discuss both of these aspects.

Adding New Fields

There are basically two ways in which you can add new fields to your job or resume submission forms, this includes adding the field in both front and back end forms.

  1. Using Custom Code

  2. Using Plugin Interface

For the first method there is a very good tutorial available on "WP Job Manager" website which explain how you can add new field to job submission form and how to display that field in single job listing page. The tutorial can be found here: https://wpjobmanager.com/document/tutorial-adding-a-salary-field-for-jobs/‚Äč

For the second method, the theme comes with an optimized support for a third-party plugin named "WP Job Manager - Field Editor" (by myles). This plugin provides an easy admin interface via which you can define new custom fields or modify existing ones.

Once the plugin is activated you can access it's interface by going to "Job Listing -> Job Fields" (for job related fields), "Job Listing -> Company Fields" (for company related fields) and "Resumes -> Resume Fields" (for resume related fields).

Once you are on the relevant admin page click on "Add Job/Company/Resume Field" button located just beside page title.

It'll open a popup where you can define details for your new field. The custom field can take many forms whether it is simple text field, check box, radio button, drop-down field, range slider, phone field and many others.

Custom Field Definition Dialogue Box

Once you have defined field details, click on "Add New Field" button and the field would start appearing in relevant submission form.

Modifying Existing Fields

In addition to creating new field you can also modify (edit, disable) existing fields as per your requirement. The process is quite simple, for example to disable any field hover over to the field's row and click on the "Disable" link to make it disappear.

You can alternatively also edit any field by clicking the "Edit" link and modifying it's configuration or options (provided its a multi-option field) .

Displaying Custom Fields

Now that you have defined your custom fields, it's time to display them on master or detail listing page for relevant listings. If you are using "WP Job Manager - Field Editor" plugin you'll not need to use custom code to display the custom fields since the theme comes with a number of "auto-output locations" specifically optimized for the theme.

If you want to display any field in one of these locations you can assign that field to the location. To assign a field to the location, open field configuration window by clicking the "Edit" link just below field name. Once the field configuration window has opened, click on the "Output" tab and choose any auto-output location from "Output" dropdown.

You can assign a single field to multiple location by selecting additional locations under "Additional Output" field.

It must be noted here that not all fields are suitable for all output locations. The different output locations with their description are given below.

a) Quick Meta Fields - Location

This location is situated just below single listing title. It is suitable to display "label-only" meta fields.

This location is available for detail job, resume and company pages.

Quick Meta Fields Location

b) Regular Meta Fields - Location

This locations is situated just below single listing header. This is the primary area where most of your custom fields should appear. This location is suitable for regular "label:value" pairs.

This location is available for detail job, resume and company pages.

Regular Meta Fields Locations

For some of these locations you might also want to add a small icon beside meta field (as shown in the images above), to add this icon configure your custom field as following, where you'll replace URL with actual icon URL. Following the approach described above you can display custom fields on detail job/resume/company listing page.

c) Company/Candidate Social Icons - Location

This location is situated in the sidebar module. It is only suitable to display social icons, using font-awesome classes. For example, if you want to add instagram social profile field, just create a new field, select following output location in "output" tab:

After that in same screen, define font-awesome class for relevant social icon.

After that click "Save Field" button. Now the icon will appear in "Candidate's Profile" module in the sidebar, provided listing has a defined instagram field value.

d) Preview Meta Fields - Location

In addition to displaying custom fields in detail listing pages, the theme also supports an output location in master listing page. You can assign custom fields to "Preview Meta Fields" location to display them for each listing item in master view.

This location is available for both job and resume listings.