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. Voir AdminModulesControllerCore::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 :

  1. /override/controllers/admin/templates/nom_du_controleur/helpers/nom_du_helper/list_content.tpl

  2. /admin/themes/nom_du_theme/template/controllers/nom_du_controleur/helpers/nom_du_helper/list_content.tpl

  3. /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