Category Tree¶

Category Tree is a hierarchical structure of categories to which you can assign your products. Categories are normally used to unite similar products. You can use them typically in connection with the Product Catalog Component, whose purpose is, among other things, to display all products from a selected category.

This application serves for managing the category tree (and all its categories) and for adding particular products to it. If you want to add or delete a product from a particular category in this application, you have to select it and click the Edit button. You can also manage the placement of products in categories in the settings of products, on the catalog categories tab. A category tree will be also displayed the Navigation Trees application in order to create an online store menu from the categories of products you sell. The created links refer to a particular category and display its content (products added to this category).

When you run this application, all currently existing categories are always displayed. You will be unable to use filtering in this application (displays only some categories according to search in particular columns), but you can restrict the display of some columns you find unnecessary (click the little arrow on a particular column name and edit the displayed ones). You can change the hierarchy of particular category using drag and drop.

Tip

Categories can be also used for product sorting in the Product Catalog Component settings (Items Sort).

Create Category¶

Assign Products¶

Particular products can be assigned to a category both in a product detail (on the Catalog Categories tab) and in a category detail on the Products tab.

Select a particular category in which you want to assign a product.
Click the Edit button in the toolbar. New tab with the category detail appears.
Go to the Products tab and click the Add button.
A new window appears. Select how will be the product (or products) to this category assigned:
- Single Product displays a separate product. This is used for normal products and master products. If you select this for a variant product, it will be displayed without any connection to other variants.
- Variant Product can be used only for variants. It is used to define the main variant from all other variant products. It will be displayed in the category as a representative product for all other variants.
Use the product selection to search for products you want to add.
You can also use the Bulk Add button which allows you to add multiple products at one. In the window that appears, you can add the product codes (or External IDs or EANs) that you want to add. Each code (External ID or EAN) must be on a new line.
Click the Add button and save the category record.
For products, you can set the relevance in a given category by clicking in the Relevance column. Ascending order begins with products without relevance, and the last is the product with the highest relevance value. Descending begins with the product with the highest relevance value and ends with products without the relevance set. If the product belongs to more than one category, the least submerged category is given priority.
To view and check your changes on the website, use the preview. To make them visible to website visitors, approve your project.

Edit Category¶

Settings will be displayed only during editing of the category, which is not part of the basic window, and which is shown during the creation of a new category, such as category descriptions, SEO setting or particular products selection.

Export and Import¶

You can export your category tree in order to make some changes and import it back. It can save your time, because you don’t need to edit, add or delete every category manually in this application.

Click the Export button located in the toolbar (the second Export next to the Import button).
Select all languages in which will be the data exported.
It takes some time to prepare the file. When it is done, you can save this file to your computer, open it and edit it according to your needs. See the table of column names below.
When you are done with editing, inserting or deleting, save the file and click on the Import button located next to the Export. Here you can set up how the categories will be imported:
- File Type defines the file format of the file you want to import (this will typically be Excel).
- Select Import Type setting is used to define how will be the categories imported. Insert inserts all newly added categories that exists in the imported file but not in your category tree. Update updates all categories that have been changed (there is a difference between the imported file and your category tree). Delete deletes all categories that are included in your category tree, but are missing in the imported file.
Select a particular file from your computer and click the Import button. The import may take a while. After it is done, don’t forget to approve your project!

List of Column Names¶

Column Name (Excel)	Filed Name (Application)	Short Description
sysid	Internal Name	The internal name of the category, required.
parent	Internal Name	The internal name of the parent category, required.
name:en	Name	The name of the category which can be displayed on the website.
info\|breadcrumbs	Info	Shows category names from the root (root is not displayed). It is an informational column that is ignored when importing.
nameUrl:en	Name in URL	The last part of the URL detail.
description:en	Name	The name of the category which can be displayed on the website.
web	Web	The category’s website.
logo	Logo	Define a path to an image that will be used as the logo for the category.
web	Web	The category’s website.
availability:en	Availability	Define the default category availability (text string).
active	Active	A boolean value which defines the current category activity.
includeInNavigation	Include in Navigation	A boolean value which defines if the category will be displayed in the navigation.
shortDesciprion:en	Short Description	The short description of the category.
seoTitle:en	SEO Title	The SEO title for this product.
seoDescription:en	SEO Description	The SEO description for this product.
seoKeywords:en	SEO Keywords	The SEO keywords of this category.
seoTitleSource	SEO Title Source	Define from where will be taken the SEO title source (default, specific, none).
seoDescriptionSource	SEO Description Source	Define from where will be taken the SEO description source (default, specific, none).
external\|googleExternalId	External Mapping - Google category ID	The ID of a Google category to which this product belongs.
external\|heurekaExternalId	External Mapping - Heureka category ID	The ID of a Heureka category to which this product belongs.
external\|heurekaSkExternalId	External Mapping - Heureka SK category ID	The ID of a Heureka SK category to which this product belongs.
external\|aukroExternalId	External Mapping - Aukro category ID	The ID of a Aukro category to which this product belongs.
external\|zboziExternalId	External Mapping - Zboží category ID	The ID of a Zboží category to which this product belongs.
external\|glamiExternalId	External Mapping - Glami category ID	The ID of a Glami category to which this product belongs.
customExternalMapping:externalId:internal-name	Custom External Mapping	The External ID of a custom mapping. Instead of the internal-name insert the internal name of the custom mapping.
customExternalMapping:externalName:internal-name	Custom External Mapping	The External Name of a custom mapping.Instead of the internal-name insert the internal name of the custom mapping.
custom:customPropertyInternalName	Custom property value	Insert the particular custom property value.

Settings for E-shop¶

This button is available in the Category application and in a particular category detail. It allows you to set up the sales behaviour of the category.

Click this button and a new window will appear. All E-shop Settings from your account are available here and you can change the category Availability for the e-shops. Click in the Available column to restrict the category availability only for the particular E-shop Settings. If a category is not available for that e-shop setting, it does not appear on the web at all and behaves identically to an inactive category.

Category Mapping¶

Sometimes you will need (for the purposes of products, product feeds or external sales channels) to define a particular external channel category (such as Heureka, Aukro, Zboží, Amazon, Glami …), to which products from this product category belong. You need to define which category from the external channel corresponds to category in your products catalog.

This mapping will be applied on all products from the product category. It can be subsequently used in product feeds and for the purposes of external sales channels. If you need, you can set the mapping for particular products too (use the External Mapping button in the toolbar in the Products application).

Select the category for which you want to set the external mapping. Click the External Mapping icon in the toolbar. A new window will appear. There are two types of mapping: external and custom. External is used for selected services (such as Heureka, Aukro, Zboží, Amazon, Glami …) and custom is your own mapping.

External Mapping Tab¶

Here all available external channels are displayed. Select (or search for) particular categories to which products from the category belongs (fill in the value for all external channels you want to use) and click the Save button in the toolbar.

Mapped category can be used in the product feeds. If you want to sell in an external channel, you have to add its category mapping for categories which products you intend to sell (Aukro).

Available External Channels:

Google - to work with the defined mapping in the product feed use the product.mapping.google.category.externalName parameter.
Heureka - to work with the defined mapping in the product feed use the product.mapping.heureka.category.externalName parameter.
Heureka SK - to work with the defined mapping in the product feed use the product.mapping.heureka-sk.category.externalName parameter.
Aukro - to work with the defined mapping in the product feed use the product.mapping.aukro.category.externalName parameter.
Zboží - to work with the defined mapping in the product feed use the product.mapping.zbozi.category.externalName parameter.
Glami - to work with the defined mapping in the product feed use the product.mapping.glami.category.externalName parameter.

Note

External mapping can also be imported. See the List of Column Names.

Custom Mapping¶

Custom mapping is used when you need to do mapping for a service BizBox do not offer in the external mapping services.

Click the Add button and define your own custom mapping (or select an existing one).

In the Identification section select a service for which you want to add the mapping. if the mapping does not exist, create it using the green plus button - insert the mapping’s name (this should be typically a name of the service for which you want to create the mapping), internal name (this name will be used in templates and product feeds) and language. If the Custom Mapping is selected, you can insert the External ID of a category in the external service, to which products from your BizBox category belong. You can also optionally enter the entire path to the category in the external service in the External Name field.