close

Filter

Connector for commercetools Manual / Version 2204

Table Of Contents

4.2.3 Finding CMS Content for Category Overview Pages

A category overview page is a kind of landing page for a product category. If a user clicks on a category without specifying a certain product, then a page will be rendered that introduces a whole product category with its subcategories. Category overview pages contain a mix of product lists with and promotional content like product teasers, marketing content (that can also be product teasers but of better quality) or other editorial content.

Content Cloud tries to find the required content with a hierarchical lookup, performing the following steps:

  1. Select the Augmented Page that is connected with the shop.

  2. Search in the catalog hierarchy for an Augmented Category content item that references the catalog category page that should be augmented .

    1. If there is no Augmented Category for the category, search the category hierarchy upwards until you find an Augmented Category that references one of the parent categories.

    2. If there is no Augmented Category at all, take the site root Augmented Page.

  3. From the Augmented Category document found take the content from the placement which matches the placement name defined in the client query .

Figure 4.8, “Decision diagram” shows the complete decision tree for the determination of the content for the category overview page or the product detail page (see below for the product detail page).

Decision diagram

Figure 4.8. Decision diagram


Keep the following rules in mind when you define content for category overview pages:

  • You do not have to create an Augmented Category for each category. It's enough to create such a page for a parent category. It is also quite common to create pages only for the top level categories especially when all pages have the same structure.

  • You can even use the site root's Augmented Page to define a placement that is inherited by all categories of the site.

  • If you want to use a completely different layout on a distinct page (a landing page's layout, for example, differs typically from other page's layouts), you should use different placement names for the "Landing Page Layout", for example with a landing-page prefix (as part of the technical identifier in the struct of the layout document). This way, pages below the intermediate landing page, which use the default layout again, can still inherit the elements from pages above the intermediate page (from the root category, for instance), because the elements are not concealed by the intermediate page.

Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.