phil / commerce-catalog-bundle
Products, variants and price books for a Symfony shop on phil/commerce-bundle: families, composites, translated names, categories, pay what you want.
Package info
github.com/parler-haut-interagir-librement/commerce-catalog-bundle
Type:symfony-bundle
pkg:composer/phil/commerce-catalog-bundle
Requires
- php: >=8.5
- ext-mbstring: *
- doctrine/dbal: ^4.5
- doctrine/orm: ^3.7
- phil/commerce-bundle: ^0.2@dev || ^0.3@dev
- phil/ddd-bundle: ^0.1@dev
- phil/doctrine-behaviours: ^0.2@dev || ^0.3@dev
- phil/locale-dimensions: ^0.1@dev
- phil/money: ^0.1@dev
- psr/clock: ^1.0
- psr/log: ^3.0
- symfony/config: ^8.2
- symfony/dependency-injection: ^8.2
- symfony/polyfill-php86: ^1.37
- symfony/translation-contracts: ^3.6
Requires (Dev)
- doctrine/doctrine-bundle: ^3.3
- doctrine/persistence: ^4.1
- phil/product-feeds: ^0.1@dev
- phil/resource: ^0.1@dev
- phil/taxonomy-bundle: ^0.2@dev
- phil/url: ^0.1.3@dev
- phpunit/phpunit: ^13.4
- symfony/clock: ^8.2
- symfony/console: ^8.2
- symfony/event-dispatcher: ^8.2
- symfony/event-dispatcher-contracts: ^3.6
- symfony/framework-bundle: ^8.2
- symfony/http-foundation: ^8.2
- symfony/http-kernel: ^8.2
- symfony/messenger: ^8.2
- symfony/routing: ^8.2
- symfony/yaml: ^8.2
Suggests
- phil/commerce-promotions-bundle: For promotions on the products: a share off, an amount off, N for X, bundle prices, free shipping
- phil/product-feeds: For the catalogue published as feed files for comparison sites and marketplaces
- phil/taxonomy-bundle: For the products filed in categories and tags shared with the rest of the site
- symfony/http-foundation: For the product feeds served by the route of config/routes.php, with their cache headers
- symfony/messenger: For the product feeds published by a message, which a schedule of Symfony Scheduler sends
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-21 03:05:07 UTC
README
Products, variants, composite products and price books for a store built on phil/commerce-bundle.
phil/commerce-catalog-bundle is the catalogue module of phil/commerce-bundle. It holds products, physical, digital or
services, with their attributes, and the channels that sell each one. A family names the axes its variants differ by,
and each variant is a product of its own; a composite product is made of others and sold as one line, taxed whole.
Product names are translated, and products are filed in the categories and tags of phil/taxonomy-bundle. It prices
products with price books per customer group, channel, period and quantity tier, each book tried after the books its
after list names. A buyer may choose the price, from a minimum up, and paid orders fund community copies for people
who cannot pay. Physical products may carry serial numbers, kept with the stock of the logistics module. Each product is
listed, reached by its direct link only, or hidden, in each channel that sells it, orderable or not — announced, sold
out for good —, its price shown or not; the pages and the cart read the same answer. Long lists of products are read
page by page on DBAL, and with phil/product-feeds the catalogue is published as feed files for comparison sites and
marketplaces. With DoctrineBundle, all of it is stored. Promotions are phil/commerce-promotions-bundle; reviews and
products a buyer assembles from choices are not held here.
It is for an application that sells goods or services from a catalogue. The core holds orders, their adjustments and
taxes; an application that sells access needs the core and perhaps phil/commerce-subscription-bundle, and never
this module.
It is a Symfony bundle that refuses to load without the core. Installing it is enabling it: there is no list of modules to keep.
It plugs into the core's ports and events and nothing else. Products answer SellableResolver under the reference
type product, price rules under pay_what_you_want — with the core's amount option, SellableOptions — and
community_copy, price books answer UnitPriceResolver,
selections and offers answer SellableAvailability, and community copies listen to OrderPurchased.
Status
| Part | State |
|---|---|
| Products and attributes | Implemented and tested |
| Families and variants, what a variant takes from its family | Implemented and tested |
| Composite products | Implemented and tested |
| Translated names | Implemented and tested |
Categories and tags, through phil/taxonomy-bundle |
Implemented and tested |
Price books ordered by after lists, and the migration from books ordered by number |
Implemented and tested |
| Price rules: pay what you want, community copies | Implemented and tested |
| Serial numbers | Implemented and tested |
| Storage on Doctrine | Implemented and tested |
| Offers — listed, direct link only or hidden; orderable or not; priced or not — in the catalogue, the pages and the cart | Implemented and tested |
| Lists of the products a channel shows, page by page on DBAL | Implemented and tested |
Product feeds through phil/product-feeds: the catalogue as RSS or TSV files, by a command or a scheduled message, served by a route with cache headers |
Implemented and tested |
| Reviews | Not started: they come from phil/reviews-bundle, which holds only its skeleton |
| Products a buyer assembles from choices | Not started: planned after this release |
| A range of prices in words | Not started: it waits for a range filter of phil/money-bundle |
Documentation
| Document | What it covers |
|---|---|
| Installation | Requirements, installing and registering the module beside the core. |
| Configuration | The locales product names are translated in, and the product feeds. |
| Products | Products, kinds, attributes, offers, lists of products, selling through the core, storage. |
| Product feeds | The catalogue published as feed files, the fields read, the command, the message, the schedule and the route that serves them. |
| Variants and composites | Families and their variants, composite products and their parts. |
| Names and classification | Translated names, categories and tags. |
| Price books | Conditions, tiers, the order of the books, which price a line takes, storage, the migration from books ordered by number. |
| Price rules | Pay what you want, community copies, their storage. |
| Scope | What the module holds, what it does not yet, and the ports of the core it implements. |
| Extension points | What an application implements, configures, replaces or relies on. |
| Testing | How the module is tested, and how to run its tests. |
| Reference | Every public type of the module. |
Quick start
composer require phil/commerce-bundle phil/commerce-catalog-bundle
// config/bundles.php return [ // ... Phil\CommerceBundle\PhilCommerceBundle::class => ['all' => true], Phil\CommerceCatalogBundle\PhilCommerceCatalogBundle::class => ['all' => true], ];
Requirements
PHP 8.5 or later with ext-mbstring; phil/commerce-bundle, phil/ddd-bundle, phil/doctrine-behaviours,
phil/locale-dimensions and phil/money 0.1; Doctrine ORM 3.7 and DBAL 4.5; symfony/config and
symfony/dependency-injection 8.2 or later; symfony/translation-contracts 3.6 or later; psr/clock, psr/log and
symfony/polyfill-php86. phil/taxonomy-bundle, phil/product-feeds, symfony/messenger and
symfony/http-foundation are suggested.
Contributing
Contributions are welcome on the PHIL monorepo: read the contribution guide and the code of conduct. Report a vulnerability privately, as the security policy explains, never in a public issue.
License
MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. See LICENSE.