Overview: Customization
Each theme contains a list of front-end files, supporting HTML, CSS and JavaScript as well as Liquid markup.
Table of Contents
This article provides guidance on customizing your Helpjuice knowledge base, including the use of basic customization panels and Shopify/Liquid tags. Understanding the underlying technology, which includes HTML5, CSS3, JS, and Liquid, is essential for creating themes for your Helpjuice page.
In this article, you'll learn:
- Global files and their functions
- Language-specific files and their roles
- Details about the main layout and various page types
Global files
The following files are unique per account and are applied to all language sections:
Main CSS
This is the CSS stylesheet that defines the appearance of your page. It is normalized by default and ready for use in your knowledge base. You can create new CSS rules for customization or remove existing ones.
Main JS
Some knowledge bases may have a Main JS file with instructions, while newer users might find it empty. This document can be used to change interactions within your Helpjuice KB, add new functionalities, and set up custom redirections.
Robots.txt
This text file is utilized by search engines like Google, Bing, and Yahoo. You can specify which folders will be crawled and which will not.
Language Specific Files
The following files are language-specific, meaning each active language will have its own copy. You can switch the language using the dropdown:
Main Layout
This document defines most of the appearance of your knowledge base. It is loaded for every page, and the Liquid tags determine which layout parts will be displayed based on the user's location.
Index Page
This is the splash screen, the first page visitors see. All content defined in this document appears when accessing your Helpjuice KB.
Question Page
This page is specifically loaded when a user accesses a question, whether from the index, category, search, or other means. If it is a question, this layout is used.
Category Page
This can be accessed from the Index Page or through breadcrumb slugs. This layout pertains to all category pages, including subcategories.
Contact Page
This page can only be accessed via a direct link or a button labeled “contact support” or “contact us.” The form sends information to the email registered in the settings, but it is not the same form that appears when no search results are found.
Thanks Page
This page appears after submitting the contact form.
Author Page
Lists the articles written by a given author, accessed by clicking an author's name or byline.
Not Found Page
Loaded whenever a visited URL doesn't match any existing page, question, or category. This is a standalone document that does not include Main CSS, Main JS, or the layout, and does not inherit the injected variables.
Login Page
The sign-in form for a private or gated knowledge base. This is a standalone document that does not include Main CSS, Main JS, or the layout, and does not inherit the injected variables.
Forgot Password Page
The form a user submits to request a password reset. This is a standalone document that does not include Main CSS, Main JS, or the layout, and does not inherit the injected variables.
Change Password Page
The form a user lands on to set a new password after requesting a reset. This is a standalone document that does not include Main CSS, Main JS, or the layout, and does not inherit the injected variables.
More on HTML5: http://www.w3schools.com/html/html5_intro.asp
More on CSS3: http://www.w3schools.com/css/css_intro.asp
More on JS: http://www.w3schools.com/js/js_intro.asp
More on Liquid/Shopify: https://shopify.github.io/liquid/