US English (US)
FR French
DE German
SA Arabic
BS Bosnian

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Book a Demo
  • Product Updates
  • Contact Us
English (US)
US English (US)
FR French
DE German
SA Arabic
BS Bosnian
  • Home
  • Customization Guides
  • Liquid Templating Basics

Helpjuice's Template Engine

Helpjuice's Template Engine is based on Liquid and nine default files

Written by Guilherme de Andrade Arantes

Updated at October 15th, 2021

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Getting Started
    Users Accessibility New to Helpjuice? Start Here Content Management Multiple Languages/Translations & Localization Multilingual Knowledge Bases Analytics Video Tutorials
  • Customization
    Customization Guides
  • API V2
  • API V3
  • Article Editor
  • Swifty (In-App Widget)
  • Billing / Subscription
  • Authentication
+ More

A Template Engine replaces variables in the template files with actual values, and transforms the template into the final file. Helpjuice's Template Engine is based on Liquid and nine default files.

These files contains all the code needed to display the support site completely such as HTML code for different page types, javascript and css files.

The knowledge base is rendered using the following template files:

  • Main CSS: Is the CSS stylesheet, this basically defines the looks on the page, by default it is already normalized, and ready to use on your knowledge base, you can create new CSS rules to customize it as well as erase old ones;
  • Main JS: Some of the KB already have a Main JS with some instructions although the newer users might find it empty. This document can be used to change the interactions with the Helpjuice KB, new functionalities and custom redirections;
  • Robots.txt: This is the text archive used by Search Engines such as Google, Bing and Yahoo. You can choose which folders will be crawled by them, and which won't;
  • Main Layout: This documents defines most of the looks on the KB, this archive is loaded for every single page, the liquid tags that define which layout parts will be loaded according to where the user is;
  • Index Page: The landing page, the first visited page, all the content defined on this document shows up when you access the Helpjuice KB;
  • Question Page: This page is loaded specifically when a user access a question, over the index, category, search or any other way, if is a question it uses this layout;
  • Category Page: Can be accessed over the Index Page, or by breadcrumbs slugs. This layout refers to all the category pages, subcategories included;
  • Contact Page: This can only be accessed over a direct link or a button to “contact support” or “contact us”, this form sends the info to the email address registered on the settings, although it is not the same form that appears when no search results were found;
  • Thanks Page: The page that comes up after sending the contact form.


How the Engine works

When any page of the Knowledge Base is accessed, the Template Engine will load the Main Layout file and render its values.

Notice the highlighted section on the above image. This area represents the concept of a Layout Content. Each page type has a different concept on the site:

  • Index Page Concept;
  • Category Page Concept;
  • Question Page Concept;
  • Contact Us Page Concept;
  • Thanks Page Concept.

In the end, the complete page is a result of the Main Layout + Layout Content for that specific page.


Contextual Sections

If you want to display Contextual Sections outside of the Layout Content scope, check the Contextual Sections Guide.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • How can I export my questions, categories and other data?
  • Loops Examples
  • Shopify/Liquid Complete Objects Reference

Copyright © 2023 - Helpjuice

Helpjuice, Inc. is a registered US Corporation, EIN # 45-2275731

Download W9
  • Help
  • Features
  • Pricing
  • About
  • Careers
  • Customers
  • Blog
  • Case Studies
  • Resources
  • Knowledge Base Examples
  • Privacy Policy
  • Terms of Service

Why is the knowledge base important?

With a knowledge base, you can allow your customers to self-help themselves, thus reducing your customer support by up to 60%. Furthermore, you can also have your team get instant answers to the questions they need without having to email themselves all using knowledge base software.

What is the purpose of a knowledge base?

The purpose of knowledge base software is to allow you to host your knowledge base/corporate wiki in one centralized 'hub'. Both your customers, and employees can now access information within seconds!

Made with from Miami, Bosnia, Morocco & Brasil

+1 (833) 387 3877 success@helpjuice.com
Expand