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.

  1. Remco
    Reply

    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?

  2. james
    Reply

    How can I make a subscribe to email page, like the job search page?

    is there a shortcode?

  3. David McDonald
    Reply

    These docs are almost 4 years old – are they still valid?

    • Greg
      Reply

      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.

  4. Do you have any video of that? I’d care to find out more details.

    • Greg
      Reply

      I am afraid we do not have video tutorials right now, what are you having problems with?

  5. Silvio
    Reply

    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?

    • Greg
      Reply

      As far as i am concerned you should first create file single-job.php and the single-job.php would load content-job.php.

      • Silvio
        Reply

        Your hint was useful, everything works fine now. Thank you.

Leave a Reply

Your email address will not be published.