+ +
+

Custom Themes

+

phpMyAdmin comes with support for third party themes. You can download +additonal themes from our website at <https://www.phpmyadmin.net/themes/>.

+
+

Configuration

+

Themes are configured with $cfg['ThemeManager'] and +$cfg['ThemeDefault']. Under ./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.

+
+
+

Creating custom theme

+

To create a theme:

+
    +
  • make a new subdirectory (for example “your_theme_name”) under ./themes/.
    • +
  • copy the files and directories from pmahomme to “your_theme_name”
    • +
  • edit the css-files in “your_theme_name/css”
    • +
  • put your new images in “your_theme_name/img”
    • +
  • edit layout.inc.php in “your_theme_name”
    • +
  • edit theme.json in “your_theme_name” to contain theme metadata (see below)
    • +
  • make a new screenshot of your theme and save it under +“your_theme_name/screen.png”
    • +
+
+

Theme metadata

+
+

Changed in version 4.8.0: Before 4.8.0 the theme metadata was passed in the info.inc.php file. +It has been replaced by theme.json to allow easier parsing (without +need to handle PHP code) and to support additional features.

+
+

In theme directory there is file theme.json which contains theme +metadata. Currently it consists of:

+
+
+name
+

Display name of the theme.

+

This field is required.

+
+ +
+
+version
+

Theme version, can be quite arbirary and does not have to match phpMyAdmin version.

+

This field is required.

+
+ +
+
+desciption
+

Theme description. this will be shown on the website.

+

This field is required.

+
+ +
+
+author
+

Theme author name.

+

This field is required.

+
+ +
+
+url
+

Link to theme author website. It’s good idea to have way for getting +support there.

+
+ +
+
+supports
+

Array of supported phpMyAdmin major versions.

+

This field is required.

+
+ +

For example, the definition for Original theme shipped with phpMyAdnin 4.8:

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

Sharing images

+

If you do not want to use your own symbols and buttons, remove the +directory “img” in “your_theme_name”. phpMyAdmin will use the +default icons and buttons (from the system-theme pmahomme).

+
+
+
+ + +