Creating a Theme | Advanced Customization | WS.WebTV Documentation | WebTV Solutions

Print

A Theme consists of Templates (HTML), CSS, graphic files and Javascript files. A Theme is what defines the WebTV appearance.

We will explain how to create a Theme with an example...
For the example we will create a new Theme based on the "Default" Theme which we will call "My Theme".

1. Duplicate the "Default" theme folder and rename it
The "Default" theme folder is public/frontend/default, rename the copy to public/frontend/my_theme

2. Open/Edit the _theme.ini file
The theme file is located in public/frontend/my_theme/_theme.ini
Please note that it is a JSON, plain text, UTF-8, file. You can use any plain text editor like Notepad, Notepad2, Notepad++, Dreamweaver, etc. to edit it.

...now enter the basic Theme info:
{
"theme": {
   "id" : "my_theme",
   "title" : "My Theme",
   "description" : "A variation of the Default theme",
   "author" : "Me...",
   "author_web" : "http:///www.my_web_domain.com",
   "version" : "1.0",
   "mobile_support" : 1,
(...) "id" : The Theme ID which must match the folder name of the Theme. The ID must not contain any special character or spaces.
"title": The Theme title.
"description": The Theme description.
"author": Your name.
"author_web": Your Website.
"version": The Theme version.
"mobile_support": Options 0/1. Whether your Theme supports the Mobile interface or not (this requires you to supply two versions of each template: one for the "Desktop" and another for the "Mobile" interface).

3. Publish the new Theme to the server
The New Theme will appear in the Configuration > Appearance section of your WebTV.


4. Start editing the new Theme's files!
Cache: Disable page caching while editing templates. In order to disable caching go to Configuration > Settings > Caching, and set the "Page cache life" value to 0 (and Save...).

Advice: Always keep track of any modification you make to the WebTV so you can re-apply it after updates or reinstallations.