> For the complete documentation index, see [llms.txt](https://docs.prestashop-project.org/1-5-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/caracteristiques-dun-theme-back-office.md).

# Caractéristiques d'un thème back-office

**Contenu**

* [Caractéristiques d'un thème back-office](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/pages/-MEbUSgPuc86LXcc6EAV#Caractéristiquesd%27unthèmeback-office-Caractéristiquesd%27unthèmeback-office)
  * [Les dossiers du thème](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/pages/-MEbUSgPuc86LXcc6EAV#Caractéristiquesd%27unthèmeback-office-Lesdossiersduthème)
  * [Fichiers CSS et images](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/pages/-MEbUSgPuc86LXcc6EAV#Caractéristiquesd%27unthèmeback-office-FichiersCSSetimages)
  * [Fichiers de vue des contrôleurs](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/pages/-MEbUSgPuc86LXcc6EAV#Caractéristiquesd%27unthèmeback-office-Fichiersdevuedescontrôleurs)
  * [Fichier de vue des Helpers](https://docs.prestashop-project.org/1-5-documentation/documentation-francaise/guide-de-lintegrateur/pages/-MEbUSgPuc86LXcc6EAV#Caractéristiquesd%27unthèmeback-office-FichierdevuedesHelpers)

## Caractéristiques d'un thème back-office <a href="#caracteristiquesdunthemeback-office-caracteristiquesdunthemeback-office" id="caracteristiquesdunthemeback-office-caracteristiquesdunthemeback-office"></a>

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 <a href="#caracteristiquesdunthemeback-office-lesdossiersdutheme" id="caracteristiquesdunthemeback-office-lesdossiersdutheme"></a>

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.

![](https://2105846932-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fprestashop-1-5-documentations%2F-MEbUB2GbdU68Aa0-FPo%2F-MEbUSmjnEpGkA-OBDED%2F14581835.png?generation=1597316685169446\&alt=media)

### Fichiers CSS et images <a href="#caracteristiquesdunthemeback-office-fichierscssetimages" id="caracteristiquesdunthemeback-office-fichierscssetimages"></a>

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 <a href="#caracteristiquesdunthemeback-office-fichiersdevuedescontroleurs" id="caracteristiquesdunthemeback-office-fichiersdevuedescontroleurs"></a>

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`.

![](https://2105846932-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fprestashop-1-5-documentations%2F-MEbUB2GbdU68Aa0-FPo%2F-MEbUSmkgymCI-2X5rub%2F14581836.png?generation=1597316685716555\&alt=media)

### Fichier de vue des Helpers <a href="#caracteristiquesdunthemeback-office-fichierdevuedeshelpers" id="caracteristiquesdunthemeback-office-fichierdevuedeshelpers"></a>

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`.
