Sommaire
Pour rendre l’interface de travail des équipes e-commerce plus professionnelle et immédiatement identifiable, le plugin ACSEO Sylius Admin Branding permet de personnaliser l’identité visuelle du Back Office Sylius, sans avoir à créer ni maintenir un thème d’administration complet.
Le besoin : un Back Office reconnaissable, sans surcharge projet
Personnaliser l’administration Sylius peut vite devenir plus lourd que prévu :
- surcharge de templates ;
- CSS admin spécifique difficile à maintenir ;
- adaptation à chaque évolution de Sylius ;
- différence entre les environnements de recette, démo et production ;
- besoin de paramétrer le nom, le logo ou les couleurs sans ouvrir un chantier front.
Pour beaucoup de projets, l’objectif n’est pas de refaire toute l’interface. Il s’agit plutôt d’ajouter une couche de branding contrôlée : titre, logo, couleurs principales, police et options simples d’affichage.
Le plugin se concentre sur ce périmètre volontairement réduit.
Ce que fait le plugin
Le plugin ACSEO Sylius Admin Branding permet de personnaliser le Back Office Sylius avec une configuration dédiée :
- titre affiché dans l’administration ;
- chemin du logo ;
- famille de police ;
- couleurs principales du thème admin ;
- options pour masquer certains éléments visuels selon les besoins projet.
Le plugin fournit également un logo par défaut et expose des fonctions Twig pour appliquer la configuration dans les templates admin.
Il cible uniquement l’administration Sylius. Il ne modifie pas la boutique, ne fournit pas de routes storefront et ne change pas le parcours client.
Une configuration pilotable par commande Symfony
La personnalisation peut être appliquée via trois commandes :
php bin/console acseo:admin-branding:configure
php bin/console acseo:admin-branding:show
php bin/console acseo:admin-branding:reset
La commande configure fonctionne en mode interactif pour les ajustements manuels. Elle peut aussi être utilisée en mode non interactif dans un script de déploiement ou une CI :
php bin/console acseo:admin-branding:configure –no-interaction –title= »My store » –primary-color= »#0080A0″
Les valeurs non fournies conservent leur configuration actuelle. Cela permet de changer un seul paramètre sans réécrire toute la configuration.
Priorité entre JSON, YAML et valeurs par défaut
Le plugin distingue trois sources de configuration :
- les valeurs par défaut fournies par le plugin ;
- un fichier YAML projet dans config/packages/acseo_sylius_admin_branding_theme.yaml ;
- un fichier JSON généré par la commande dans var/acseo-admin-branding/theme.json.
Le JSON généré par la commande est prioritaire sur le YAML. Le YAML permet de versionner une configuration de base côté projet. Les valeurs par défaut assurent un comportement stable même sans surcharge.
Cette approche couvre les usages courants :
- branding fixe versionné avec le projet ;
- ajustement rapide sur un environnement de démonstration ;
- reset vers la configuration projet ou plugin ;
- vérification de la source active via commande.
Diagnostic et exploitation
La commande show donne une vue claire de la configuration active :
php bin/console acseo:admin-branding:show
Elle affiche la source utilisée, les chemins résolus et les valeurs appliquées. C’est utile pour comprendre pourquoi une couleur, un logo ou un titre n’apparaît pas comme attendu.
La commande reset supprime la configuration JSON et permet de revenir au YAML projet ou aux valeurs par défaut :
php bin/console acseo:admin-branding:reset
En environnement automatisé, l’option –force évite les confirmations interactives.
Une personnalisation volontairement encadrée
Le plugin ne cherche pas à remplacer un vrai design system admin. Il répond à un besoin pragmatique : rendre l’administration Sylius identifiable, propre et cohérente avec une marque ou un contexte projet, sans ouvrir un chantier de theming complet.
Il est particulièrement adapté pour :
- les projets Sylius livrés à des équipes clientes ;
- les plateformes multi-environnements ou demos commerciales ;
- les agences qui veulent standardiser un socle de personnalisation admin ;
- les projets qui doivent distinguer clairement plusieurs back offices.
En résumé
Le plugin ACSEO Sylius Admin Branding ajoute une couche de white-label contrôlée au Back Office Sylius :
- personnalisation du titre, du logo, des couleurs et de la police ;
- configuration YAML ou JSON ;
- commandes Symfony interactives et non interactives ;
- diagnostic de la configuration active ;
- reset vers les valeurs projet ou par défaut ;
- scope limité à l’administration Sylius.
Le plugin s’adresse aux projets Sylius qui veulent un Back Office plus identifiable et plus professionnel, sans maintenir un thème admin complet.
Installez le Plugin ACSEO Sylius Admin Branding dès maintenant ! (lien à venir)
Ces articles pourraient aussi vous intéresser
Poursuivez l’optimisation de votre plateforme Sylius en découvrant d’autres modules pour améliorer l’expérience client et la visibilité de votre boutique :
