phil/commerce-product-template

phil/commerce-product-template décrit un produit fabriqué sur commande à partir d'un article vierge. Un gabarit est l'article vierge : ses axes — une taille, une couleur, une version — avec leurs valeurs dans l'ordre, chacune avec son code, son libellé en plusieurs langues, sa pastille, le nom que lui donne le fournisseur et la photo de l'article vierge sur chaque face ; le prix de chaque combinaison, à partir d'une base, d'un prix par valeur d'un axe et de suppléments sur n'importe quel axe ; les faces et leurs zones d'impression en millimètres ; les combinaisons que le fournisseur ne fabrique pas ; et le patron de l'UGS (unité de gestion de stock), {design}{lang}{version}{size}{colour} ou tout autre. Un visuel est ce qui est imprimé : son code, ses versions linguistiques, ses illustrations par face et par zone, les gabarits sur lesquels il est fabriqué et les valeurs qu'il permet. Le planificateur transforme un visuel sur un gabarit en un produit par langue et par combinaison, refuse un patron qui donnerait la même UGS à deux produits, et donne le même plan pour les mêmes entrées : un catalogue régénéré à partir de lui est donc mis à jour plutôt que dupliqué.

Il s'adresse à une boutique qui vend des articles imprimés en de nombreuses tailles et couleurs à partir d'une poignée d'articles vierges : chandails, kangourous, tasses, affiches. Un chandail est l'exemple que suit la documentation ; rien dans la bibliothèque ne sait ce qu'est un chandail.

C'est une bibliothèque PHP simple avec phil/money pour ses prix et rien d'autre. Le bundle Symfony phil/commerce-product-template-bundle stocke les gabarits et les visuels, génère les produits d'un catalogue à partir du plan, compose leurs maquettes et déclare leurs options.

État

Documentation

Démarrage rapide

composer require phil/commerce-product-template

use Phil\CommerceProductTemplate\{Artwork, Axis, AxisValue, Design, Exclusion, Face, Label, LanguageVersion};
use Phil\CommerceProductTemplate\{Pricing, PrintZone, SkuPattern, Swatch, Template, VariantPlanner};
use Phil\Money\{Currency, Money};

$cad = static fn (int $cents): Money => Money::of($cents, Currency::of('CAD'));

$shirt = Template::of('unisex', Label::of(['en' => 'Unisex shirt', 'fr' => 'T-shirt unisexe']),
    SkuPattern::parse('{design}{lang}{version}{size}{colour}'),
    Pricing::of($cad(2_500))->withPrice('size', '2X', $cad(2_800))->withSupplement('version', 'C', $cad(1_000)),
    [
        Axis::of('version', Label::of(['en' => 'Version']),
            AxisValue::of('O', Label::of(['en' => 'Regular'])),
            AxisValue::of('C', Label::of(['en' => 'Convention']), channels: ['convention'])),
        Axis::of('size', Label::of(['en' => 'Size']),
            AxisValue::of('M', Label::of(['en' => 'M'])), AxisValue::of('2X', Label::of(['en' => '2XL']))),
        Axis::of('colour', Label::of(['en' => 'Colour']),
            AxisValue::of('BK', Label::of(['en' => 'Black']), Swatch::colour('#1A1A1A'), 'black', ['front' => 'blanks/front-bk.jpg']),
            AxisValue::of('PK', Label::of(['en' => 'Pink']), Swatch::colour('#F4A7C0'), 'azalea')),
    ],
    [Face::of('front', Label::of(['en' => 'Front']), PrintZone::of('chest', 50, 60, 300, 400))],
    [Exclusion::of(['colour' => ['PK'], 'size' => ['2X']])],
);

$gnome = Design::of('NAQ001', Label::of(['fr' => 'Le gnome', 'en' => 'The gnome']),
    [LanguageVersion::of('F', 'fr'), LanguageVersion::of('E', 'en')],
    [Artwork::of('front', 'art/naq001-front.png'), Artwork::of('front', 'art/naq001-front-en.png', language: 'E')]);

foreach (new VariantPlanner()->plan($shirt, $gnome) as $variant) {
    echo $variant->sku, ' ', $variant->price->toDecimal(), ' ', $variant->name('en'), "\n";
}
// NAQ001FOMBK 25.00 Le gnome – T-shirt unisexe (Regular, M, Black)
// ...

Prérequis

PHP 8.5 ou plus récent avec ext-mbstring, et phil/money.

Contribuer

Les contributions sont les bienvenues sur le monodépôt PHIL : lisez le guide de contribution et le code de conduite. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

Licence

MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. Voir LICENSE.