Branding

Branding

The Enterprise version of Veracity Learning lets you brand the user interface (UI) of your LRS. You can make simple color and logo changes quite easily, but you can also make more complex customizations too. 
Notes
Only the Enterprise version supports branding. 


Replacing Static Files

To brand the UI, replace the CSS and image files that the LRS serves to browsers from the /public/branding directory: 
  1. branding.css
  2. favicon.ico
  3. sitelogoDarkBackground.png
  4. sitelogoLightBackground.png
  5. banner-bg.jpg
You can download these files, change them as needed, and re-upload them. 


Replacing Server Templates

You can also control the server-rendered HTML templates that manage the LRS UI, by over-writing them with Handlebars templating language files.
Warning
Be Careful! Errors in Handlebars code could cause the server to become unreachable. 
Enterprise customers can replace the templates served by the LRS from the /views/templates/home directory. To overwrite a template, upload a corresponding Handlebars file: 
  1. home.hbs — The homepage for users who don’t log in. 
  2. head.hbs — The site-wide <head> element, with all style and script tags. 
  3. header.hbs — The site-wide top menu bar. 
  4. footer.hbs — The site-wide footer. 
The above list should be enough for most uses. However, you can change or replace all components of the UI. Contact Veracity support for further instructions. 
Notes
When you change a template file, you must restart the server to see the change take effect. 
If a template calls a plugin and you replace that template with your own Handlebars file, then that plugin might not work correctly.


Adding Plugins

You can add plugins that let you change the branding of the LRS UI: 
  1. Log in as the site administrator. 
  2. On the home page for the administrator, scroll down to Admin Tools. 
  3. Click Manage Plugins. 
  4. From the next page, choose Activate a Plugin. 
Here's a list of built-in plugins and what they do: 
  1. Login Notice — Shows a banner when users log in. 
  2. Site Branding — Lets you insert custom HTML into the header, footer, and title of pages.