Skip to main content
Skip table of contents

How is the category tree structured and how do I manage it?

Purpose

To gain an understanding of the category behaviors and category tree regarding the following:

  • A categories visibility & behavior.

  • Structure of the category tree and how it operates.

Introducing terms and concepts used in this article

Term

Definition

Category

a class that contains one or more products from your product listing.

Category tree

a hierarchy containing your product listings consisting of parent and child categories.

Visible

a product whose status is set to Visible, which means that the product can be viewed and purchased by your customers.

More information

What is a category and what can I do with one?

How do categories and products fit together?

When you click Categories in Aphix Management Interface, you are presented with a structured version of your product catalogue. There is a hierarchy to the category tree, which is based on a simple parent:child relationship. Within the category tree, there are parent and child elements. The root category is found at the top of the category tree.  If there is at least one child category under a root, the root becomes a parent category.

Key points

  • Category tree structure is based on a simple parent:child relationship.

  • The root category is a category at the highest level of the category tree.

  • A root category can also be called a parent category to those child category's that live inside the root category.

  • A child category can also be a parent category to another child category within it.

Example

You can see a category tree containing:

  • "Root category", which has two children "Child 1 category" and "Child 2 category".

  • "Child 1 category" is also a parent (or root) category to its two children: "Child 1A category" and "Child 1B category".

  • "Child 2 category" has no children.

In Aphix WebShop, this is displayed as:

How can I display my categories in a particular order?

To display your categories in a particular order in Aphix WebShop, use the Menu Index options. Enter a number (which can be negative or positive) in this box to indicate this category's placement in relation to other categories at the same level in the navigational tree. The lower the number you enter, the higher the category is displayed in Aphix WebShop.

Key points

  • Use the Menu Index option on the Category configuration page in Aphix Management Interface. 

  • The lower the index number, the higher it will be displayed in Aphix WebShop.

Example

The Child 1 category has two children:

  • "Child 1A category" has a menu index of 10 while

  • "Child 1B category" has a menu index of 0.

Since "Child 1B category" has a menu index which is lower than Child 1A category, it will appear higher in the category tree in Aphix WebShop.

How do I create a new child category of an existing parent category?

To make a new child category of a parent category,

  • Click New in the top right of your screen. This opens the New Category screen.

  • Select the name of the parent from the drop down list called Parent.

  • Click Save in the top right of your screen.

When are categories visible or invisible in Aphix Management Interface and Aphix WebShop?

Scenario 1: Scenario has no products listed

When a category has no products in it:

  • you can see that it is listed in the category tree under Category Management in Aphix Management Interface.

  • your customers cannot see it in Aphix WebShop since it has been set as invisible.

Example

A category called "Root category" has been created at the root level of your category tree. It currently has no products listed under it, but it is still visible in your Management Interface.

However, it is not visible in your Aphix WebShop.

Scenario 2: Category has products set to invisible listed

When a category has products listed in it, but the products are set to Invisible:

  • you can see that it is listed in the category tree under Category Management in Aphix Management Interface.

  • your customers cannot see it in Aphix WebShop since it has been set as invisible.

Example

A category called "Root category" has been created at the root level of your category tree. It currently contains one product (product code: 0401) which has a status of Invisible, but the category is visible in Aphix Management Interface.

However, it is not visible in your Aphix WebShop.

Scenario 3: Category has at least one product listed as visible

When a category contains at least one product with a status of visible:

  • you can see that it is listed in the category tree under Category Management in Aphix Management Interface.

  • your customers can see it in Aphix WebShop since the category has products that have been set to visible. 

Example

A category called "Root category" has been created at the root level of your category tree. It currently contains one product (product code: 10) which has a status of Invisible, but the category is visible in Aphix Management Interface.

It is also visible in your Aphix WebShop.

What does my customer see in Aphix WebShop when.. 

I have a category with only one product listed as visible

When a category contains only one product that has been set as Visible:

  • you can see that it is listed in the category tree under Category Management in Aphix Management Interface.

  • once your customers select it, the product page of the visible product is opened.

I have a category with more than one product listed as visible

When a category contains more than one product that has been set as Visible:

  • you can see that they are listed in the category tree under Category Management in Aphix Management Interface.

  • once your customers select the category, a product listing page displaying all visible products is opened.

Example

A category called "Root 2 category" has been created at the root level of your category tree. It currently contains three products, all of which have a status of Visible. The product listing page is displayed in Aphix WebShop when your customer selects "Root 2 category".

My customer have selected a parent category that does not have any child associated with it

When your customer selects a parent category that does not have any child categories associated with it on the product listing page in Aphix WebShop, the category view remains at that parent level within the category tree.

Example

"Root 2 category" is a root category that contains no children categories. In Aphix Management Interface, you have set it up like this:

When your customer selects "Root 2 Category" in Aphix WebShop, the listing page displays its products. It remains at the root level in the category sidebar.

My customer has selected a parent category that has one or more children associated with it

When your customer selects a parent category which has one or more children associated with it on the product listing page in Aphix WebShop, the category view moves down one level to its children categories.

Example

"Root category" contains two children categories. In Aphix Management Interface, you have set it up like this:

When your customer selects "Root Category" in Aphix WebShop, the listing page displays its products. The category view sidebar moves down one level to list the children's categories.

Key points

  • The category tree structure is based on a simple parent:child relationship, where each category contains one or more categories or products.

  • Whether you can see a category or not is based on the product's visibility status. 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.