Skip to main content

​
Overview

The Site Store Pro shop catalog (GET /shop) is the primary product discovery surface for your customers. It combines real-time search, category and brand filtering, flexible pagination, and optional advanced filtering into a single, cohesive experience. All filters can work simultaneously and the resulting state is reflected in a shareable URL.
The main catalog is available at GET /shop. All query parameters are sanitized server-side before any database interaction.
Customers land on a paginated, searchable grid of all active products. A persistent search input at the top of the page delivers live results as they type — no page reload required. The catalog reacts instantly to any combination of:
  • Free-text keyword search
  • Category selection
  • Brand selection
  • Price range (when Advanced Search is enabled)
  • Variant attribute values (when Advanced Search is enabled)

​
Grid / List View Toggle

Customers can switch between two display modes using the toggle in the catalog toolbar: The selected mode is preserved during the session. No configuration is required — both views are always available.

​
Pagination

A dropdown control lets shoppers choose how many products appear per page. The perPage query parameter is validated against a strict server-side whitelist — values outside the list are rejected and reset to the default.
Arbitrary perPage values (e.g. ?perPage=999) are silently sanitized to the nearest allowed value. This prevents denial-of-service through oversized queries.

​
Product Image Orientation

Admins control the aspect ratio used for all product card thumbnails across the catalog. The setting is found at: Admin → Settings → Shop Display → Product Image Orientation
Changes take effect immediately for all shoppers. The image cache is cleared automatically when you save the setting — no manual cache flush is needed.

​
Hierarchical Category Navigation

​
Category Pages

Each category has a dedicated SEO-friendly landing page:
When a shopper is viewing a category page, a contextual nested categories panel appears in the sidebar or header area. Clicking a subcategory entry drills into that child category, updating the URL and filtering the product grid in place. Example navigation path:

​
Dynamic Header & Descriptions

Category and brand landing pages automatically replace the generic “Shop” title with the database-stored name and description for that entity. This means every category page has unique, SEO-relevant heading copy without any template changes.

​
Categories Mega-Menu

The global site header includes a recursive dropdown mega-menu that reflects your category tree in real time:
  • Only categories with at least one active product are shown
  • Nested children render as indented sub-groups
  • Menu data is cached and invalidated automatically when categories or products change

​
Brand Filtering & Brand Pages

​
Brand Landing Pages

Every brand has its own SEO-friendly page:
Like category pages, brand pages display the brand’s name, logo, and description from the database.

​
Brands Mega-Menu

A dedicated Brands panel in the header shows all active brands with their logos and short descriptions:
  • Desktop: full slide-out or dropdown panel
  • Mobile: collapsible accordion within the mobile navigation drawer

​
Combined Brand & Category Filters

Brand and category filters can be active simultaneously. When both are selected, products must satisfy both constraints (logical AND). The URL reflects the current state cleanly:
When a brand filter is active, the subcategory options in the category panel are dynamically narrowed to only show subcategories that contain products from that brand. This prevents empty result pages.

​
Advanced Shop Search Filtering

Advanced Search Filtering is disabled by default. Enable it via: Admin → Settings → Shop Display → Enable Advanced Search Filtering PanelAdmin setting key: enable_advanced_shop_search
When enabled, a slide-out drawer replaces the basic filter bar with a comprehensive set of filtering tools. An “Advanced Filters” button appears in the catalog toolbar; an active filter badge shows the count of currently applied filters at a glance.

​
Available Filter Controls

Shoppers can select one or more brands simultaneously. Results show products from any of the checked brands (logical OR within brand selections).
The full category tree is rendered as nested checkboxes. Checking a parent category implicitly includes all its children. Individual subcategories can be selected independently.
A min/max price slider bounded to the maximum price in the current catalog. Customers can also type exact values directly into the min and max input fields. The slider updates the inputs and vice versa.
Site Store Pro automatically extracts attribute keys from your product variant JSON (e.g., Color, Size, Material, Storage). Each discovered attribute becomes its own filter group with all observed values as checkboxes.No manual configuration is required — add new variant attributes to your products and they appear in the filter drawer automatically.Examples of auto-generated filter groups:
  • Color: Red, Blue, Midnight Black, Space Gray
  • Size: XS, S, M, L, XL, XXL
  • Material: Cotton, Polyester, Wool
  • Storage: 128 GB, 256 GB, 512 GB, 1 TB

​
Drawer Controls

​
URL State Synchronization

Every combination of advanced filters is serialized into the page URL as query parameters. This means customers can bookmark or share their filtered view, and the exact filter state is restored when the link is opened.
Example Advanced Filter URL

​
Quick Reference

Main Catalog

GET /shop — paginated, searchable, filterable product listing

Category Pages

GET /section/{category_slug} — SEO-friendly category landing

Brand Pages

GET /brands/{brand_slug} — SEO-friendly brand landing

Advanced Filters

Admin key: enable_advanced_shop_search — off by default