Thèmes personnalisés

phpMyAdmin peut gérer les thèmes de tiers. Vous pouvez télécharger des thèmes supplémentaires sur notre site Web <https://www.phpmyadmin.net/themes/>.

Configuration

Themes are configured with $cfg['ThemeManager'] and $cfg['ThemeDefault']. Under ./public/themes/, you should not delete the directory pmahomme or its underlying structure, because this is the system theme used by phpMyAdmin. pmahomme contains all images and styles, for backwards compatibility and for all themes that would not include images or css-files. If $cfg['ThemeManager'] is enabled, you can select your favorite theme on the main page. Your selected theme will be stored in a cookie.

Création d’un thème personnalisé

Pour créer un thème :

  • créez un nouveau sous-répertoire (par exemple « votre_nom_de_theme ») dans ./public/themes/.
  • copiez les fichiers et les répertoires de pmahomme vers « votre_nom_de_theme »
  • éditez vos fichiers css dans « votre_nom_de_theme/css »
  • mettez vos nouvelles images dans « votre_nom_de_theme/img »
  • éditez _variables.scss dans « votre_nom_de_theme/scss »
  • éditez theme.json dans « votre_nom_de_theme » pour qu’il contienne les méta-données du thème (voir ci-dessous)
  • faites un nouveau cliché de votre thème et enregistrez-le sous « votre_nom_de_theme/screen.png »

Méta-données de thème

Modifié dans la version 4.8.0: Avant la version 4.8.0, les méta-données de thème étaient passées dans le fichier info.inc.php. Ceci a été remplacé par le fichier file:theme.json pour permettre une analyse plus facile (sans avoir besoin de faire du code PHP) et pour gérer des fonctionnalités supplémentaires.

Dans le répertoire des thèmes se trouve le fichier theme.json qui contient les méta-données de thème. Il se compose actuellement ainsi :

name

Afficher le nom du thème.

Ce champ est obligatoire.

version

Le numéro de version du thème, qui peut être arbitraire et qui n’a pas besoin de correspondre au numéro de version de phpMyAdmin.

Ce champ est obligatoire.

description

Description du thème. Ceci sera affiché sur le site Web.

Ce champ est obligatoire.

author

Nom de l’auteur du thème.

Ce champ est obligatoire.

url

Lien vers le site Web de l’auteur du thème. C’est une bonne idée pour indiquer comment obtenir de l’assistance.

supports

Tableau des versions majeures de phpMyAdmin gérées.

Ce champ est obligatoire.

Exemple : définition du thème Original livré avec phpMyAdmin 4.8 :

{
    "name": "Original",
    "version": "4.8",
    "description": "Original phpMyAdmin theme",
    "author": "phpMyAdmin developers",
    "url": "https://www.phpmyadmin.net/",
    "supports": ["4.8"]
}

Partage d’images

Si vous ne voulez pas utiliser vos propres symboles et boutons, supprimez le répertoire « img » dans « votre_nom_de_theme ». phpMyAdmin utilisera les icônes et boutons par défaut (du thème système pmahomme).