WPJobBoard

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:

1. 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)
2. company-home.php – displays the main page of [wpjb_company_panel] shortcode, the Employer Dashboard
3. company-panel.php – display list of employer jobs in Employer Dashboard
4. company-payment-history.php – display list of all employer payments in Employer Dashboard
5. company-product-details.php – displays details of single membership in Employer Dashboard
6. company-products-remove-confirmation.php – confirmation page, when an employer wants to cancel membership subscription in Employer Dashboard
7. company-products.php – display a list of all memberships that employers had or have in Employer Dashboard
8. company-verify.php – displayed when Employer requests verification
9. employers-item.php – displays single item from the default companies list table (this file is used by employers.php)
10. employers.php – displays a list of companies in [wpjb_employers_list] shortcode
11. index-item.php – displays single item from the default jobs list table (this file is used by index.php)
12. index.php – responsible for displaying a list of jobs on: main page, browse by type, browse by category and search results
13. job-applications.php – list of job applications visible in an Employer panel
14. job-application.php – single application view in an Employer panel
15. job-edit.php – job edit form in an Employer panel
16. job.php – displays full job offer, it is used in preview.php and single.php
17. memberships.php – displays page with all possible memberships pricing for the employer
18. payment-history-item.php – displays single item from the default list of payments (this file is used by company-payment-history.php)
19. payment.php – displays payment form (when purchasing a job ad or resume)
20. preview.php – job posting step #2. uses step.php and job.php
21. save.php – job posting step #3, uses step.php
22. search.php – contains an advanced search form
23. single.php – displays full job offer on a single page, uses job.php
24. step.php – box with information about posting “step”, used in add.php, preview.php, save.php
25. subscribe.php – contains “subscribe to anything” modal box template

Old, deprecated templates, that may appear in older versions of WPJobBoard:

1. apply.php – contains a form that is used by the applicant to send his resume (deprecated)
2. company-edit.php – Employer edit form
3. company-login.php – Employer login form
4. company-new.php – Employer registration form
5. company.php – company profile page

Templates / Resumes

WPJobBoard Resumes templates. The files are in wpjobboard/templates/resumes:

1. alert-details.php – displays single item from the default list of alerts in Candidate Dashboard (this file is used by my-alerts.php)
2. candidate-memberships.php – display a list of all memberships that the candidate had or have in Candidate Dashboard
3. candidate-payment-history.php – display list of all candidate payments in Candidate Dashboard
4. candidate-products-remove-confirm.php – confirmation page, when a candidate wants to cancel membership subscription in Candidate Dashboard
5. index-item.php – displays single item from the default resumes list table (this file is used by index.php)
6. index.php – displays a list of resumes and resumes search results
7. memberships.php – displays page with all possible memberships pricing for the candidate
8. my-alerts.php – displays a list of all alerts in Candidate Dashboard
9. my-applications.php – display a list of all applications in Candidate Dashboard
10. my-bookmarks.php – display list of all bookmarks in Candidate Dashboard
11. my-home.php – displays the main page of [wpjb_candidate_panel] shortcode, the Candidate Dashboard
12. my-resume.php – displays candidate profile edit page.
13. payment-history-item.php – displays single item from the default list of payments (this file is used by candidate-payment-history.php)
14. register.php – Candidate registration form
15. resume.php – resume details page
16. search.php – advanced resumes search form

Old, deprecated templates, that may appear in older versions of WPJobBoard:

1. login.php – Candidate login form
2. my-resume-detail.php – resume detail (education or experience) add/edit form
3. my-resume-edit.php – resume edit form visible by Candidate only
4. my-resume.php – resume overview visible by Candidate after logging in.
5. resume-purchase.php – resume purchase form visible by Employer when purchasing resume

Templates / Default

WPJobBoard Resumes templates. The files are in wpjobboard/templates/default:

1. 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
2. payamnet.php – displays payment page where user can choose a payment gateway and perform payment for any WPJobBoard object
3. print_multiple.php – template for print option in wp-admin, when you print more than one application (contains own CSS)
4. 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:

1. Add CSS into the child theme .css file
2. 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.