Caractéristiques d'un thème back-office
Contenu
Caractéristiques d'un thème back-office
L'administration de PrestaShop est totalement personnalisable, car elle utilise le même langage de template que les thèmes front-office : Smarty.
Chaque employé peut avoir son propre thème personnalisé :
si vous êtes un employé : cliquez sur le lien "Mes préférences" en haut de n'importe quelle page, et sélectionnez votre thème à l'aide de la liste déroulante "Thème".
si vous souhaitez modifier le thème back-office de n'importe quel employé : allez dans la page "Employés" du menu "Administration", cliquez sur le bouton "Modifier" de l'employé, et sélectionnez son thème à l'aide de la liste déroulante "Thème".
Les dossiers du thème
Un thème back-office partage de nombreuses caractéristiques avec un thème front-office, mais il a également ses propres caractéristiques.
L'une des principales caractéristiques consiste au fait que le thème back-office est lié au thème front-office : ses fichiers et dossiers sont stockés dans le dossier du thème front-office.
Le thème du back-office est conçu à l'aide des dossiers standards suivants, au sein du dossier du thème principal :
/css: contient les feuilles de style. Les fichiers CSS du thème back-office sont au nombre de deux (voir ci-dessous)./img: contient les images du thème./templates: ce dossier est propre au thème du back-office. Il contient tous les fichiers template du thème :/templates/controllers: contient les fichiers template utilisés par les contrôleurs du back-office./templates/helpers: contient les fichiers template utilisés par les helpers du back-office.
Notez qu'il n'y a pas de dossier /js : vous ne devriez pas toucher au code JavaScript du back-office, qui est stocké dans le dossier /js à la racine du dossier de PrestaShop.
Fichiers CSS et images
Le thème du back-office utilise uniquement deux fichiers CSS :
admin.css: les règles de style principales du back-office.modules.css: les règles de style propres aux modules, utilisées pour les contrôleurs du back-office. VoirAdminModulesControllerCore::initContent().
Les fichiers d'images du thème du back-office devraient être au format PNG. Cela permet d'avoir recours à la transparence afin de mieux gérer les réglages de couleur de fond.
Fichiers de vue des contrôleurs
Les contrôleurs du back-office (les classes AdminController*) utilisent les fichiers de Vue situés dans le dossier /themes/nom_du_theme/template/controllers/nom_du_controleur.
Vous pouvez surcharger la Vue d'un contrôleur du back-office en utilisant le dossier /override/controllers/admin/templates/nom_du_controleur.
Les modules qui ont des contrôleurs pour le back-office (classes ModuleAdminController*) utilisent les fichiers de Vue qui sont situés dans le dossier /modules/nom_du_module/views/templates/admin/nom_du_controleur.
Vous pouvez surcharger la Vue d'un module du back-office en utilisant le dossier /admin/themes/nom_du_theme/template.
Bien qu'il faille que les contrôleurs utilisent la convention de nommage CamelCase, le fichier de vue correspondant doit utiliser des caractères minuscules et des soulignés ("_") pour son nom.
Par exemple : pour le contrôleur RangePrice, le fichier de vue correspondant devra être range_price.
Fichier de vue des Helpers
PrestaShop recherche les fichiers vue dans un ordre précis pour chaque type de contrôleur.
Pour un contrôleur du back-office (AdminController*), l'ordre est le suivant :
/override/controllers/admin/templates/nom_du_controleur/helpers/nom_du_helper/list_content.tpl/admin/themes/nom_du_theme/template/controllers/nom_du_controleur/helpers/nom_du_helper/list_content.tpl/admin/themes/nom_du_theme/helpers/name_of_the_helper
Pour un module (page de configuration), l'ordre est le suivant :
/modules/nom_du_module/views/templates/admin/_configure/nom_du_module/helpers/nom_du_helper/list_content.tpl/admin/themes/nom_du_theme/helpers/nom_du_helper
Pour un contrôleur de module (ModuleAdminController*), l'ordre est le suivant :
/modules/nom_du_module/views/templates/admin/nom_du_controleur/helpers/nom_du_helper/list_content.tpl/admin/themes/nom_du_theme/helpers/nom_du_helper
Bien qu'il faille que les contrôleurs utilisent la convention de nommage CamelCase, le fichier de vue correspondant doit utiliser des caractères minuscules et des soulignés ("_") pour son nom.
Par exemple : pour le contrôleur RangePrice, le fichier de vue correspondant devra être range_price.
Last updated
