Adding a category

When you add a category, you will see the following form. The only required form is Description – all the others are optional.

Description

(catdescription)

This is the category name and it is a required field.

Image

(catimage)

If you want to display an image for this category, you can enter a filename or URL here (for example books.gif or http://www.vpcart.com/vpasp/images/ books.gif).

You can also upload an image from your local computer, which will be uploaded to your server and automatically entered into this box.

Higher Category
(highercategoryid)

If this category will become a subcategory, you need to select its parent category from this dropdown menu.

Subcategories

(hassubcategory)

If this category has subcategories, select Yes.

Hide

(cathide)

If you do not want this category to display, select Yes.

You can use this field together with the config “xcathideproduct”.

xcathideproduct

If you would like to hide all products under a category when the category is set to Hide, then please set xcathideproductto Yes.
Please note, this will affect all categories in your site.

If you just want to have a category hidden but still be able to view products, set xcathideproduct to No.

For example :

If category A cathide set to Yes

andxcathideproduct set to No…

Then Category A will be hidden from shopdisplaycategories.asp listings and homepage sideboxes category listings.

But when you directly access the link shopdisplayproducts.asp?catid=xx,

this link will return product results.

If category A cathide set to Yes

andxcathideproduct set to Yes…

Then shopdisplaycategories.asp will not display category A and shopdisplayproducts?catid=xx will display no products from category A.

If category A cathide set to No

andxcathideproduct set to Yes…

Then there will be no changes to the product/category listings as xcathideproduct only works when cathide = Yes.

Match Product

(matchproduct)

If you are using product matching – this needs to be the same as the xproductmatch value in the shop$config.asp file (see page 429 for more information).

Catmemo

You can enter a detailed description of your category here using HTML or plain text.

Catextra

If xdisplaycategoryfiles=Yes in your shop configuration, you can enter the name of an HTML or text file that includes a detailed category description that is to be included at the top of product and subcategory pages.

Catextra2

Enter the name of an HTML or text file here that includes a detailed category description that is to be included at the top of product and subcategory pages.

Catextra3

Enter the name of an HTML or text file here that includes a detailed category description that is to be included at the top of product and subcategory pages.

Language

This field is included for compatibility with older versions of VPCART. You can add translations of the category after you have added the initial record by clicking the "Add Translation" button.

Template file

If you want this category to display using a specific template, you can do this by adding the name of the template file here.

Categories ID to Cross-Sell

Enter list of categories ID, separated by commas, to be displayed in cross selling products (e.g. 3,5,11)

Note : If you have a lot of categories in your site, and when you are at the edit categories page, the list of dropdown menus in the “Higher Category” field will be hard to select.

To handle this issue, we have a new config called “xAjaxSearchCategory”.

xAjaxSearchCategory

Set this to Yes to enable Ajax Search Categories mode at Edit Category page and Edit Product page.

When you are typing in the “Search Higher Category” textbox, the list of categories will be displayed based on the keywords. Simply click one of the lists and the category id will automatically be populated in the “Higher Category” field.