Adding custom templates available since version 4.0.0 / 3.7.23 On-Premises

Add custom template

To create custom templates in builder, take the following steps:

• access builder as admin by expanding your on-premises brand, going to section "Custom templates" and clicking Create custom templates button;
• choose a desired template and rebuild it at your wish;
• when you are done save new website hovering Publish button and clicking on Save as...;
• fill the form for a new template:
  • Left column:
    • enter your custom template name in the Name field;
    • choose the Screenshot (optional if you are saving currently existing template by overwriting it);
    • check Overwrite existing template option in order to overwrite the current template (you can overwrite only your custom templates, but not original templates);
    • check Make private only if you want to hide that template from customers, e.g. if this template is a draft or not finished yet;
    • check Do not translate only if you want the template not be translatable to the customer's selected language in the builder. If you keep this option unchecked, then all your custom phrases which do not have integrated translations in builder, will be converted to random texts when the customer chooses the template.
  • Right column:
    • choose options for each dropdown, which, in your opinion, are applicable to your template (this is for a better template searching; these options are not editable at the moment);
    • in the Category dropdown choose the category where you want your template to be located on templates choosing page;
• click Save Draft and you are done.

Remove custom template

To remove template, take the following steps:

• open admin builder;
• go to templates page by clicking button "Change template" (hovering "New/Reset" button in the builder toolbar);
• find the custom template you want to delete;
• hover it and:
  • [if you see red "Delete" button] click "Delete" button to delete the template;
  • [if you do not see red "Delete" button]:
    • select the template by clicking green "Select" button;
    • save the template by clicking "Save as..." (hovering "Publish" button in the builder toolbar);
    • in the appeared dialog make sure that options "Overwrite existing template" and "Make private" are checked;
    • click "Save draft" button;
    • click button "Change template" again;
    • find that template again if needed;
    • hover it and click the appeared "Delete" button to delete it.

Add new category

To create a new category, take the following steps:

• navigate to "[builder_path]/templates" directory in your builder installation;
• [if file "tags-ext.json" does not exist] create file "tags-ext.json";
• open the file in the text editor and add the following content:

  {
      "category": [
          {
              "id": "lzb16vqwpjo6b5jncems",
              "name": "My category 1"
          },
          {
              "id": "343asx4y4f9rgav3437f",
              "name": "My category 2"
          }
      ]
  }

  This code shows how to add 2 new categories: "My category 1" and "My category 2"
  It is important to give unique IDs and names for your categories.
  IDs should be just random strings consisting of any number of letters "a-z" and numbers "0-9".
• when saving the template in the builder, you will see your new categories which you can choose for your templates (refresh builder window in the browser with F5 if needed).

Hide native category

In order to hide some category, take the following steps:

• navigate to "[builder_path]/templates/[category you want to hide]" directory;
• create file "config.json" there with contents {"isPrivate":true} and save file;
• remove cache file "[builder_path]/templates/index.json".

After that your clients will not see this category on template chooser page.

Hide native template

In order to hide some template, take the following steps:

• open "[builder_path]/templates/[template category]" directory;
• create file "config.json" there with contents {"privateTemplates": ["Template One", "Template Two"]}. Replace "Template One/Two" with name of template(s) you want to hide in that category (names must be specified in English language).
  
  If file "config.json" already exists and has some content then you need to add "privateTemplates" parameter to that file.
• remove cache file "[builder_path]/templates/index.json".

After that your clients will not see templates you hide in this category.

Enable/disable templates by hosting plan available since version 4.0.0

There is a possibility in builder to have specific templates enabled (or disabled) depending on hosting plan the customer has. In order to activate this feature create file in your builder installation templates/plans.json with the following structure:

{
    "list": [
        {
            "hostingPlan": "plan1",
            "templates": [
                "ID of template 1",
                "ID of template 2",
                ...
            ]
        },
        {
            "hostingPlan": "plan2",
            "templates": [
                "ID of template 3",
                "ID of template 4",
                ...
            ]
        },
        ...
    ]
}

{
    "list": [
        {
            "hostingPlan": "plan1",
            "action": "exclude",
            "templates": [
                "ID of template 1",
                "ID of template 2"
            ]
        },
        ...
    ]
}

{
    "templateBundles": [
        {
            "id": "group1",
            "list": [
                "ID of template 1",
                "ID of template 2",
                ...
            ]
        },
        {
            "id": "group2",
            "list": [
                "ID of template 3",
                "ID of template 4",
                ...
            ]
        }
    ],
    "list": [
        {
            "hostingPlan": "plan1",
            "templates": [
                "bundle:group1",
                "ID of template 5",
                "ID of template 6",
            ]
        },
        {
            "hostingPlan": "plan2",
            "templates": [
                "bundle:group1",
                "bundle:group2"
            ]
        },
        ...
    ]
}

Using custom thumbnails for original templates available since version 4.2.45

Every template has its own directory, which is calculated by pattern "[builder]/templates/[Category Name]/[Template Name]/", and every template contains 3 thumbnail images in its directory with the following names:

• preview.jpg - 968 x 600 image file
• thumb.jpg - 484 x 330 image file
• thumb2x.jpg - 968 x 600 image file

To use custom images for template thumbnails, add your files with the following names in the same directory:

• preview.custom.jpg
• thumb.custom.jpg
• thumb2x.custom.jpg

It is preferable for custom images to have the same size as original images, or at least, to be of the same aspect ratio.