Product Tags & Tag Pages

Flow ID: CF-18 | Module(s): eshop | Complexity: Medium

Business Overview

Product tags organize products into curated collections independent of the category tree. Two-level hierarchy: tag categories (e.g., "Material") → tag values (e.g., "Cotton", "Polyester"). Customers browse tag pages to find products matching specific attributes.

Key business behaviors:

• Hierarchical: tag categories → tags → products (many-to-many)
• Language-scoped slugs, names, content
• Cached via PSCache for performance
• Used in category sidebar filtering (CF-01) and coupon targeting (CF-13)
• Route toggle: enable_tag_page_routes registry key

---

API Reference

REST Endpoints

Method	Path	Auth	Description
GET	/rest/product/tag	Guest	List tags
GET	/rest/product/tag-category	Guest	List tag categories

Legacy Storefront

URL	Controller	Method
/tag/{category-slug}	Adv_product_tags.php	tag_cat($slug)
/tag/{category}/{tag}	same	tag($catSlug, $tagSlug)

---

Code Flow

Category listing (tag_cat): Category lookup → load sub-tags → SEO/breadcrumbs → render grid

Tag products (tag): Category + tag lookup → product query via shop_product_product_tags join → enrichment → render

---

Domain Layer

Component	Path
Tag Service	src/Domains/Product/Tag/Tag/Service.php
Category Service	src/Domains/Product/Tag/Category/Service.php
REST Controllers	src/Rest/Product/Controllers/Tag.php, TagCategory.php

Client Extension Points

• View templates: {client_views}/tag/
• Controller override: Custom filtering in Adv_product_tags.php
• Route toggle: enable_tag_page_routes registry

Data Model

Table	Purpose
shop_product_tag_categories / _mui	Tag category hierarchy
shop_product_tags / _mui	Individual tags
shop_product_product_tags	Product-tag junction

Related Flows

• CF-01 Product Browsing — sidebar tag filters
• CF-04 Search — tags used in search result filtering
• CF-13 Coupons — coupon tag targeting
• AD-15 Attributes & Tags — admin management of tag categories and values