Template files
Before you start reading this tutorial, please make sure you read the introduction to templates article. It contains some basic yet important information about how the WPJobBoard template engine works.
Templates / Job-board
Below is an alphabetic list of all files that make a WPJobBoard Theme, the files are in wpjobboard/templates/job-board directory:
- add.php – this file contains a template that displays job posting form (i.e. step #1). Into this file, step.php is included (which will be described further)
- company-home.php – displays the main page of [wpjb_company_panel] shortcode, the Employer Dashboard
- company-panel.php – display list of employer jobs in Employer Dashboard
- company-payment-history.php – display list of all employer payments in Employer Dashboard
- company-product-details.php – displays details of single membership in Employer Dashboard
- company-products-remove-confirmation.php – confirmation page, when an employer wants to cancel membership subscription in Employer Dashboard
- company-products.php – display a list of all memberships that employers had or have in Employer Dashboard
- company-verify.php – displayed when Employer requests verification
- employers-item.php – displays single item from the default companies list table (this file is used by employers.php)
- employers.php – displays a list of companies in [wpjb_employers_list] shortcode
- index-item.php – displays single item from the default jobs list table (this file is used by index.php)
- index.php – responsible for displaying a list of jobs on: main page, browse by type, browse by category and search results
- job-applications.php – list of job applications visible in an Employer panel
- job-application.php – single application view in an Employer panel
- job-edit.php – job edit form in an Employer panel
- job.php – displays full job offer, it is used in preview.php and single.php
- memberships.php – displays page with all possible memberships pricing for the employer
- payment-history-item.php – displays single item from the default list of payments (this file is used by company-payment-history.php)
- payment.php – displays payment form (when purchasing a job ad or resume)
- preview.php – job posting step #2. uses step.php and job.php
- save.php – job posting step #3, uses step.php
- search.php – contains an advanced search form
- single.php – displays full job offer on a single page, uses job.php
- step.php – box with information about posting “step”, used in add.php, preview.php, save.php
- subscribe.php – contains “subscribe to anything” modal box template
Old, deprecated templates, that may appear in older versions of WPJobBoard:
- apply.php – contains a form that is used by the applicant to send his resume (deprecated)
- company-edit.php – Employer edit form
- company-login.php – Employer login form
- company-new.php – Employer registration form
- company.php – company profile page
Templates / Resumes
WPJobBoard Resumes templates. The files are in wpjobboard/templates/resumes:
- alert-details.php – displays single item from the default list of alerts in Candidate Dashboard (this file is used by my-alerts.php)
- candidate-memberships.php – display a list of all memberships that the candidate had or have in Candidate Dashboard
- candidate-payment-history.php – display list of all candidate payments in Candidate Dashboard
- candidate-products-remove-confirm.php – confirmation page, when a candidate wants to cancel membership subscription in Candidate Dashboard
- index-item.php – displays single item from the default resumes list table (this file is used by index.php)
- index.php – displays a list of resumes and resumes search results
- memberships.php – displays page with all possible memberships pricing for the candidate
- my-alerts.php – displays a list of all alerts in Candidate Dashboard
- my-applications.php – display a list of all applications in Candidate Dashboard
- my-bookmarks.php – display list of all bookmarks in Candidate Dashboard
- my-home.php – displays the main page of [wpjb_candidate_panel] shortcode, the Candidate Dashboard
- my-resume.php – displays candidate profile edit page.
- payment-history-item.php – displays single item from the default list of payments (this file is used by candidate-payment-history.php)
- register.php – Candidate registration form
- resume.php – resume details page
- search.php – advanced resumes search form
Old, deprecated templates, that may appear in older versions of WPJobBoard:
- login.php – Candidate login form
- my-resume-detail.php – resume detail (education or experience) add/edit form
- my-resume-edit.php – resume edit form visible by Candidate only
- my-resume.php – resume overview visible by Candidate after logging in.
- resume-purchase.php – resume purchase form visible by Employer when purchasing resume
Templates / Default
WPJobBoard Resumes templates. The files are in wpjobboard/templates/default:
- form.php – used to display all forms that do not need any specific format, like login form. We recommend to do not modify this one if it is not necessary, as it is used in multiple places
- payamnet.php – displays payment page where user can choose a payment gateway and perform payment for any WPJobBoard object
- print_multiple.php – template for print option in wp-admin, when you print more than one application (contains own CSS)
- print.php – template for print option in wp-admin when you print the single application (contains own CSS)
Modifying CSS
To modify CSS we recommend do use two possible ways:
- Add CSS into the child theme .css file
- Add CSS to wp-admin -> Appearance -> Customize -> Additional CSS.
if you will modify WPJobBoard CSS files directly, you will lose changes after the next WPJobBoard update. The above methods will keep your changes, as long as you use the theme where you provided changes.
Modifying Forms
To modify any form please use tools located in wp-admin -> Settings (WPJB) -> Custom Fields.
The related jobs are published with reference to with text “about 20 hours”
I would like to use the Dutch translation for this?
Is this possible?
How can I make a subscribe to email page, like the job search page?
is there a shortcode?
These docs are almost 4 years old – are they still valid?
Yes the document is still valid for the most part, it was created 4 years ago but last updated just few months ago if i remember correctly.
Do you have any video of that? I’d care to find out more details.
I am afraid we do not have video tutorials right now, what are you having problems with?
Can we copy the template in theme folder and make changes there ?
Yes, this is something we call child-templates, the article here https://wpjobboard.net/kb/introduction-to-templates/ explains how to do it.
If I use my WordPress theme, then wpjobboard use the content-single.php from my WordPress theme. I’ve copied the content-single.php to content-job.php because I want to make some changes there.
How can I explain WordPress to use content-job.php instead of content-single.php if it is showing a job item.
Maybe do you have an hint for me?
As far as i am concerned you should first create file single-job.php and the single-job.php would load content-job.php.
Your hint was useful, everything works fine now. Thank you.