Skip to content

A custom page type that allows mapping of multiple catalogue categories to a page in the CMS

License

Notifications You must be signed in to change notification settings

Dean-Forest-Tech/silverstripe-cataloguepage

Repository files navigation

Silverstripe CataloguePage Module

A custom page type that either allows:

Mapping of product objects (defined via config) to a CMS page

Or

Mapping of multiple categories to a page in the CMS that then renders them (and their products) into a template.

The page type also includes a $PaginatedChildren variable to allow automatically breaking up larger product lists into smaller pages.

Installation

The easiest way to install this module is via composer:

# composer require "dft/silverstripe-cataloguepage"

Otherwise install and download this module to the "cataloguepage" folder in your project root.

Requirements

  • Silverstripe CMS 4 or 5

Recommended

  • Silverstripe Catalogue

Setup

Unless you are using the SilverCommerce catalogue admin or frontend you will need to identify your custom product and category classes.

Custom Product or Categories

To customise the Product and Category objects that are used via this page, you will need to change the "product_class" and "category_class" config variables on CataloguePage.

It is important to be aware that CataloguePage will attempt to hand over the current request to a controller identified by the "base_product_controller" config variable. You will need to ensure that you create a conntroller that can render your product.

The easiest way to do this is to set it in your config.yml as below:

DFT\SilverStripe\CataloguePage\Model\CataloguePage:
  product_class: 'Product'
  category_class: 'Category'
  base_product_controller: 'ProductController'

Usage

Setup the catalogue as normal (add categories and then add products to them).

Then add a catalogue page.

Once the page is created, you should have "Products" and "Categories" tabs in the CMS, use this to add categories that will be displayed on this page.

About

A custom page type that allows mapping of multiple catalogue categories to a page in the CMS

Resources

License

Stars

Watchers

Forks