Menu Close Menu
Menu
  • 0
    • Number of items in cart: 0

      • Your cart is empty.
      • Total: $0.00
      • Checkout
  • Pricing
    • Purchase Options
    • Individual Extensions
  • Support
    • Documentation
    • Log a Support Ticket
  • Your Account
    • Register
  • Blog

Customising Template Files

Customising Template Files

An easy way to customise the look and feel of KB Support pages

KB Support utilises template files to display content on the front end of your website. These files can be customised as described below.

The template files included within the KB Support plugin are all located within the /plugins/kb-support/templates folder. If you were to update these files, they would be overwritten during the next plugin update and your changes would be lost. To avoid this, you can copy the files to an alternative location and KB Support will utilise them instead of its default files. You can then customise these files and they will not be overwritten during plugin updates.

Template Files

The template files included within KB Support are;

shortcode-form.php Outputs the submission form for a customer to submit a ticket
Shortcode: [kbs_submit]
shortcode-login.php Outputs a login form
Shortcode: [kbs_login]
shortcode_profile_editor.php Outputs a page where the user can update their profile and their preferences
Shortcode: [kbs_profile_editor]
shortcode_register.php Outputs a form enabling customers to register a WordPress user account
Shortcode: [kbs_register]
shortcode_search.php Outputs a search form for searching through published KB Articles
Shortcode: [kbs_search]
ticket-history.php Outputs a page where customers can see a list of tickets they have submitted
Shortcode: [kbs_tickets]
view-ticket.php Outputs a page where a customer can view the details for a specific ticket
kbs.css Contains the CSS styles utilised by KB Support on the front end
kbs.min.css A minified version of the CSS styles utilised by KB Support on the front end. This is the stylesheet that is used by default

Note: our premium extensions may have additional template files included. Those files can be customised in the same way as described in this article.

KB Support will search in the following locations for its template files, in the order specified. Once a file is found, it uses that file and the search stops:

  1. /wp-content/themes/<your-child-theme>/kbs_templates/
  2. /wp-content/themes/<your-theme>/kbs_templates/
  3. /wp-content/plugins/kb-support/templates/

Copying Template Files

Before you make any changes to the template files, you should copy them to a location that will not be impacted by plugin and theme updates. This can be a child theme (recommended) or your parent theme.

Using a Child Theme

If you do not already have a child theme in place, you can view the instructions for how to create one on WordPress.org.

Once your child theme is active, create the kbs_templates folder and copy the template files you wish to update into this folder.

You can now make any changes you would like to make and save the file. KB Support will now use these files instead of those default templates included within the plugin.


Was this article helpful?

We're working hard to ensure we provide you with useful and relevant documentation to help you get the most out of KB Support.

Please take a moment to let us know if you found this article helpful.

Customising Template Files

KB Support utilises template files to display content on the front end of your website. These files can be customised as described below. The template files included within the KB Support plugin are all located within the /plugins/kb-support/templates folder. If you were to update these files, they would be overwritten during the next plugin update…
KB Article rating: 1.0 based on 1 ratings
Advanced Developer Docs Customisation Templates Last updated: 22/01/2021

Published by Cristian Raiber

Posts by Cristian Raiber

Post navigation

Previous

Forms REST API Route

Next

Adding Google reCAPTCHA Fields

Contact Details

  • Follow us on Twitter
  • Like us on Facebook
  • Fork us on GitHub

Developer Resources

Plugin Boilerplate

Trello Board

GitHub Repository

Ratings & Satisfaction Docs

  • Configuring Ratings and Satisfaction
  • Advanced Settings

Email Support Docs

  • Plugin Requirements
  • Configuring Email Support
  • Creating New Tickets
  • Replying to Closed Tickets
  • Anonymous Replies in Email Support
  • HTML Emails Tags
  • Email Commands
  • Defining IMAP Flags

KBS REST API Docs

  • Using the REST API
  • Tickets REST API Route
  • Replies REST API Route
  • Articles REST API Route
  • Agents REST API Route
  • Customers REST API Route
  • Companies REST API Route
  • Forms REST API Route
  • Form Fields REST API Route
  • Ticket Categories REST API Route
  • Ticket Departments REST API Route
  • Ticket Source REST API Route

Article Categories

  • Configuration
    • Advanced
    • Getting Started
  • Developer Docs
    • Constants
    • Hooks
  • Extensions
  • FAQs
© 2023 KB Support. All rights reserved.
  • Blog
  • Shop
  • Support
  • Privacy Policy
  • Discount Code