loading table of contents...

5.10.5.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 typically a mix of promotional content like product teasers, marketing content (that can also be product teasers but of better quality) or other editorial content. You can use the CoreMedia Content Widget in the commerce-led scenario in order to add content from the CoreMedia CMS to the category overview page.

Category overview page with CMS content

Figure 5.31. Category overview page with CMS content


When a category page contains the CoreMedia Content Widget, then, on request, the current category ID and the name of the placement configured in the Content Widget are passed to the CoreMedia system. The CoreMedia system uses this information to locate the content in the CoreMedia repository that should be shown on the category overview page.

CoreMedia DXP 8 tries to find the required content with a hierarchical lookup using the category ID and placement name information. The lookup involves the following steps:

  1. Select the Augmented Page that is connected with the IBM store (see Section 5.4, “Connecting with an IBM WCS Shop” on how to connect an IBM shop with CoreMedia DXP 8).

  2. Search in the catalog hierarchy for an Augmented Category content item that references the catalog category page that should be augmented and that contains a placement with the name defined in the CoreMedia Content Widget.

    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 found Augmented Category or Augmented Page take the content from the placement which matches the placement name defined in the Content Widget.

Figure 5.32, “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 5.32. 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.