How to add own templates

In this how-to you will learn how to add your own templates for categories and products.

Generally

The content of products and categories are rendered by templates. LFS ships with several default templates and you can add your own.

All registered templates for categories can be selected within the View tab of the Category Management Interface. All registered templates for products can be selected within the Data tab of the Product Management interface.

Please refer to the default templates in order to find out which information are provided within the templates. You can also add your customer template tags in order to provide more functionality.

Categories

In order to add a new template for categories go to lfs.catalog.settings and add tuple to CATEGORY_TEMPLATES.

Example 1

(0,{"file":"%s/%s" % (CAT_PRODUCT_PATH ,"default.html"),
    "image":IMAGES_PATH + " /product_default.png",
    "name" : _(u"Category with products"),
    }),

Which means:

0:
The unique id of the category template.
file:
The absolute path to the template. CAT_PRODUCT_PATH means this is a template which displays the products of a category.
image:
The absolute path to the preview image (not used anymore).
name:
The pretty name of the template, which is displayed within the template select box.

Example 2

(1,{"file": "%s/%s" % (CAT_CATEGORY_PATH ,"default.html"),
    "image": IMAGES_PATH + "/category_square.png",
    "name": _(u"Category with subcategories"),
    }),

Which means:

1:
Unique id of the category template.
file:
The absolute path to the template. CAT_PRODUCT_PATH means this is a template which displays the sub categories of a category.
image:
The absolute path to the preview image (Not used anymore).
name:
The pretty name of the template, which is displayed within the template select box.

Products

In order to add a new template for products go to lfs.catalog.settings and add tuple to PRODUCT_TEMPLATES.

Example

(0, {"file" : "%s/%s" % (PRODUCT_PATH, "product_inline.html"),
     "image" : IMAGES_PATH + "/product_default.png",
     "name" : _(u"Default template")
     },),

Which means:

0:
The unique id of the product template.
file:
The absolute path to the template.
image:
The absolute path to the preview image (Not used anymore).
name
The pretty name of the template, which is displayed within the template select box.