Public store, catalogue browsing and cart
This section documents public catalogue eligibility, category/product pages, cart handling and route behaviour.
Open the public shop
Open the public shopBrowse /shop when the store is enabled.
Open guide →GuideUnderstand the disabled-store 404 response
Understand the disabled-store 404 responseKnow the module deliberately hides all public shop actions when disabled.
Open guide →GuideBrowse public product categories
Browse public product categoriesOpen active category routes.
Open guide →GuideOpen a public category page
Open a public category pageUse /shop/category/{slug}.
Open guide →GuideOpen a public product page
Open a public product pageUse /shop/product/{slug}.
Open guide →GuideSearch the public catalogue
Search the public catalogueSearch eligible products by the supported query.
Open guide →GuideUnderstand public catalogue pagination
Understand public catalogue paginationBrowse 24 products per page.
Open guide →GuideUnderstand public search noindex behaviour
Understand public search noindex behaviourKnow search results use noindex,follow to avoid indexing result combinations.
Open guide →GuideUnderstand public-store product eligibility
Understand public-store product eligibilityRequire active/public product and supported stock/backorder state.
Open guide →GuideUnderstand public category eligibility
Understand public category eligibilityRequire an active tenant category.
Open guide →GuideUnderstand product availability messages
Understand product availability messagesDistinguish available now, available to order and unavailable.
Open guide →GuideAdd an item to the cart
Add an item to the cartSubmit a product and valid quantity.
Open guide →GuideAdd a weighed item to the cart
Add a weighed item to the cartUse up to the supported decimal precision.
Open guide →GuideAdd a non-weighed item to the cart
Add a non-weighed item to the cartUse a whole-number quantity.
Open guide →GuideUnderstand the 100-product cart limit
Understand the 100-product cart limitKeep no more than 100 distinct product IDs in one session cart.
Open guide →GuideUnderstand the 100,000 quantity limit
Understand the 100,000 quantity limitKeep each submitted quantity at or below the enforced maximum.
Open guide →GuideUpdate cart quantities
Update cart quantitiesRecalculate the cart after changing values.
Open guide →GuideRemove an item from the cart
Remove an item from the cartDelete the selected product from the session cart.
Open guide →GuideApply a coupon in the cart
Apply a coupon in the cartRecalculate eligible promotions using the submitted code.
Open guide →GuideReview cart subtotal, discount, tax and shipping
Review cart subtotal, discount, tax and shippingUse server-calculated totals.
Open guide →GuideUnderstand cart recalculation after catalogue changes
Understand cart recalculation after catalogue changesKnow unavailable products/promotions can be removed or rejected during recalculation.
Open guide →GuideTroubleshoot an empty cart
Troubleshoot an empty cartAdd an eligible product before checkout.
Open guide →GuideTroubleshoot a product unavailable message
Troubleshoot a product unavailable messageCheck active/public, stock, reservation and backorder conditions.
Open guide →GuideTroubleshoot an invalid cart quantity
Troubleshoot an invalid cart quantityCorrect positivity, maximum, integer or weighed precision rules.
Open guide →GuideUnderstand public navigation and breadcrumbs
Understand public navigation and breadcrumbsUse shop, category, product, cart and checkout links generated by the module.
Open guide →GuideUnderstand public product structured data
Understand public product structured dataKnow the product page emits code-backed product/offer metadata.
Open guide →GuideUnderstand public store company branding
Understand public store company brandingUse the current tenant company identity and saved store content.
Open guide →GuideRun a public catalogue smoke test
Run a public catalogue smoke testTest home, category, product, search, pagination, cart add/update/remove and unavailable paths.
Open guide →