Le module Boutique vous permet de vendre vos produits en ligne. Gérez vos catégories, produits, commandes, codes promo et moyens de paiement depuis l'interface d'administration.

Catégories

Organisez vos produits dans des catégories et sous-catégories pour faciliter la navigation de vos clients.

Créer une catégorie

Sur l'interface de gestion, rendez-vous dans Boutique → Catégories. Cliquez sur "Créer une nouvelle catégorie".

  • Saisissez le nom de la catégorie
  • Choisissez le parent s'il s'agit d'une sous-catégorie, ou laissez vide pour une catégorie principale
  • Ajoutez une description (optionnel)
  • Définissez l'ordre d'affichage
Important : Les catégories peuvent être créées à la volée lors de la création d'un produit, mais dans ce cas, créez-les AVANT d'entrer tout autre contenu car la page sera rafraîchie et tout contenu non sauvegardé sera perdu.
Modifier ou Supprimer une catégorie

Sur la liste des catégories :

  • Modification : Cliquez sur le bouton vert d'édition, modifiez et enregistrez
  • Suppression : Cliquez sur le bouton rouge, puis confirmez

Produits

Créez et gérez le catalogue de produits de votre boutique.

Créer un produit

Rendez-vous dans Boutique → Produits, puis cliquez sur "Créer un produit".

Informations principales :
  • Nom du produit : Titre visible sur la boutique
  • Description complète : Contenu détaillé (éditeur riche)
  • Extrait : Résumé affiché sur la page catalogue
  • Prix : Prix unitaire TTC
  • Stock : Quantité disponible
  • SKU/Référence : Code produit unique
Organisation et médias :
  • Catégorie(s) : Assignez le produit à une ou plusieurs catégories
  • Attributs : Taille, couleur, etc. (voir section Attributs)
  • Image principale : Photo illustrant le produit dans le catalogue
  • Galerie d'images : Images supplémentaires pour la fiche produit
Publication :

Dans la box "État", choisissez :

  • Publié : Le produit est visible sur le site
  • Brouillon : Le produit est en préparation
Astuce : Utilisez les brouillons pour préparer vos nouveaux produits sans les rendre visibles immédiatement.

Attributs

Les attributs permettent de créer des variantes pour vos produits (tailles, couleurs, matériaux, etc.).

Créer un attribut

Rendez-vous dans Boutique → Attributs, cliquez sur "Créer un attribut".

  1. Saisissez le nom de l'attribut (ex: Taille, Couleur, Matière)
  2. Cliquez sur "Ajouter une valeur"
  3. Entrez la valeur (ex: XL, Rouge, Coton)
  4. Répétez pour ajouter d'autres valeurs
  5. Enregistrez
Exemple d'utilisation :
Attribut : Taille

Valeurs :

XS S M L XL
Attribut : Couleur

Valeurs :

Rouge Bleu Noir Blanc
Modifier ou Supprimer un attribut
  • Modification : Bouton vert - Modifiez le nom ou les valeurs
  • Suppression : Bouton rouge - Confirmez la suppression

Commandes

Consultez et gérez toutes les commandes passées sur votre boutique.

Consulter une commande

Accédez à Boutique → Commandes pour voir la liste de toutes les commandes.

Informations disponibles :
  • Numéro de commande : Référence unique
  • Client : Nom et coordonnées
  • Produits commandés : Liste avec quantités
  • Montant total : TTC avec détails
  • Statut : En attente, Payée, Expédiée, Livrée, Annulée
  • Date : Date de la commande
  • Moyen de paiement : Stripe, PayPal, etc.
Modifier le statut d'une commande

Cliquez sur le bouton vert d'édition, modifiez le statut selon l'avancement :

  • En attente : Commande reçue, paiement en attente
  • Payée : Paiement confirmé
  • En préparation : Commande en cours de traitement
  • Expédiée : Colis envoyé
  • Livrée : Commande complétée
  • Annulée : Commande annulée
Notifications : Le client est automatiquement notifié par email lors du changement de statut.
Supprimer une commande

Cliquez sur le bouton rouge, puis confirmez. Utilisez avec précaution !

Codes promo

Créez des codes promotionnels pour offrir des réductions à vos clients.

Créer un code promo

Naviguez vers Boutique → Codes promo, puis cliquez sur "Nouvelle saisie".

Paramètres d'un code promo :
  • Code : Le code que le client saisira (ex: XMAS2024, SOLDES50)
  • Type de remise : Pourcentage ou montant fixe
  • Valeur : Montant de la réduction (ex: 10% ou 5€)
  • Date d'expiration : Date limite d'utilisation
  • Nombre d'utilisations : Limite d'utilisation (optionnel)
  • Montant minimum : Panier minimum requis (optionnel)
  • Statut : Actif ou inactif
Exemple : Réduction en %
  • Code : BIENVENUE10
  • Type : Pourcentage
  • Valeur : 10%
  • Expire le : 31/12/2026
Exemple : Montant fixe
  • Code : NOEL2026
  • Type : Montant fixe
  • Valeur : 15€
  • Panier min : 50€
Modifier ou Supprimer un code promo
  • Modification : Bouton vert - Changez les paramètres
  • Suppression : Bouton rouge - Supprime définitivement le code

Moyens de paiement

Configurez les méthodes de paiement acceptées dans votre boutique. Toutes les configurations sont stockées en base de données, ce qui facilite leur gestion sans accès serveur.

Fonctionnement général
1. Configuration par méthode

Chaque méthode de paiement dispose de sa propre carte avec ses paramètres spécifiques :

  • Activation/Désactivation : Active ou désactive la méthode
  • Credentials : Clés API, secrets, tokens selon la méthode
  • Mode : Test (sandbox) ou Production (live)
  • Ordre d'affichage : Position dans la liste des moyens de paiement
2. Stockage des configurations

Les données sont sauvegardées dans la table payment_config :

| id | method | is_active | api_key      | api_secret   | mode    | display_order |
|----|--------|-----------|--------------|--------------|---------|---------------|
| 1  | stripe | 1         | pk_test_xxx  | sk_test_xxx  | test    | 1             |
| 2  | paypal | 1         | AY123xxx     | EL456xxx     | sandbox | 2             |
3. Utilisation automatique

Les services lisent automatiquement depuis la base de données via les factories :

// Les services sont créés automatiquement avec les credentials de la DB
$stripeService = $this->stripeServiceFactory->create();
$paypalService = $this->paypalServiceFactory->create();
Méthodes de paiement disponibles
Stripe

Paiement par carte bancaire via Stripe. Configuration des clés API, webhook et mode de fonctionnement.

Doc officielle Stripe
PayPal

Paiement via PayPal. Configuration des credentials (Client ID et Secret) et mode sandbox/live.

Doc officielle PayPal
Autres méthodes

Virement bancaire et chèque. Configuration des coordonnées bancaires et instructions.

Prochainement
Sécurité
Important : Les credentials sont stockés en base de données. Assurez-vous que :
  • Vos backups de base de données sont sécurisés
  • Seuls les administrateurs ont accès à la configuration des paiements
  • Vous utilisez HTTPS en production
Migration depuis .env

Si vous aviez des credentials dans le fichier .env, migrez-les via l'interface :

  1. Copiez les valeurs depuis votre .env
  2. Accédez à Gestion → Boutique → Paiements
  3. Remplissez les formulaires pour chaque méthode
  4. Activez les méthodes souhaitées
  5. Les valeurs du .env ne sont plus utilisées
Avantage : Vous pouvez modifier les configurations sans accès serveur et les changements sont instantanés !

Configuration de la boutique

Paramètres généraux pour configurer le fonctionnement global de votre boutique.

Méthodes d'expédition

Configurez les transporteurs et les tarifs de livraison.

Transporteurs disponibles
Colissimo
  • Tarifs par paliers de poids
  • Livraison à domicile
  • Point de retrait
  • Poids max : 30kg
UPS
  • Services : Standard, Express, Express Plus
  • Gestion par zones géographiques
  • Tarif de base + coût par kg
Mondial Relay
  • Point Relais : 4.95€ (max 30kg)
  • Lockers : 3.95€ (max 10kg)
  • Domicile : 7.95€

Pour créer une méthode d'expédition :

  1. Cliquez sur "Nouvelle méthode d'expédition"
  2. Choisissez le transporteur
  3. Saisissez les tarifs manuellement ou importez un fichier CSV
  4. Enregistrez
Import CSV : Vous pouvez importer les tarifs via CSV pour gagner du temps. Le format varie selon le transporteur.
Configuration de la TVA

Paramétrez les taux de TVA applicables à vos produits.