Awesome Support Documentation

Templating

If you want to change the ticket details page template, please follow this guide: Ticket Details Page Template

The plugin comes with a theme for the front-end part that should be compatible with most themes. However, if you want / need to customize it so that it fits your theme better, there is a way to achieve it.

First of all, the theme is located in awesome-support/themes/default. A theme for Awesome Support contains a minimum of four files:

  • details.php : The ticket details view. This is where users can read the ticket and reply to it
  • list.php : The list of all tickets created. This is where the user can find the complete list of tickets he opened
  • registration.php : The registration form
  • submission.php : The ticket submission form

All those templates can be customized, but you don’t need to customize them all in your custom themes.

Be careful when editing the template files. You will see a number of hooks throughout the code. Do not remove those as it will break some of the plugin’s features.

Customizing a Theme

The first thing you need to do is create the theme directory. It must be located inside your active WordPress theme’s directory and named awesome-support.

Then, you have to copy the template file(s) that you want to customize in this new directory.

Once this is done, you can customize the template code as much as you want to achieve the result you like, but keep in mind that it is important to keep all the hooks in the templates (the do_action() and apply_filters() functions).

Stylesheet

For versions of Awesome Support before 5.8.0 and the introduction of “overlays”, If you need to add custom style to your theme you can add a new stylesheet. It will be loaded automatically if you place it inside your theme’s  awesome-support/css directory and name it style.css.

For Awesome Support version 5.8.0  you should add your custom styles to your theme’s custom CSS area, the WordPress customizer custom CSS area or via load your stylesheet via a custom plugin.

We will restore the ability to have override style.css in your theme folder in version 5.9.0 – schedule for release in early 2019.

Example

Let’s imagine I’m using the WordPress theme TwentyFifteen and I want to customize the Awesome Support theme. I will save all the customized files in

wp-content/themes/twentyfifteen/awesome-support

The architecture of this directory will look like this (if I want to customize everything):

/
- details.php
- list.php
- registration.php
- submission.php
/css
- style.css