Documentation
Certains articles des la documentation sont en cours de rédaction.
Documentation de la boutique
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
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
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".
- Saisissez le nom de l'attribut (ex: Taille, Couleur, Matière)
- Cliquez sur "Ajouter une valeur"
- Entrez la valeur (ex: XL, Rouge, Coton)
- Répétez pour ajouter d'autres valeurs
- Enregistrez
Exemple d'utilisation :
Attribut : Taille
Valeurs :
XS S M L XLAttribut : Couleur
Valeurs :
Rouge Bleu Noir BlancModifier 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
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 StripePayPal
Paiement via PayPal. Configuration des credentials (Client ID et Secret) et mode sandbox/live.
Doc officielle PayPalAutres méthodes
Virement bancaire et chèque. Configuration des coordonnées bancaires et instructions.
ProchainementSécurité
- 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 :
- Copiez les valeurs depuis votre
.env - Accédez à Gestion → Boutique → Paiements
- Remplissez les formulaires pour chaque méthode
- Activez les méthodes souhaitées
- Les valeurs du
.envne sont plus utilisées
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 :
- Cliquez sur "Nouvelle méthode d'expédition"
- Choisissez le transporteur
- Saisissez les tarifs manuellement ou importez un fichier CSV
- Enregistrez
Configuration de la TVA
Paramétrez les taux de TVA applicables à vos produits.