Custom Themes

phpMyAdmin comes with support for th₩•♠ird party themes. You×★ ≥ can download additional 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 delet↕↑e the directory pmahomme or its underlying stru©  cture, because this is the sy >π©stem theme used by phpMyAdmin. pmahomme contains all images and st♥©‍↕yles, for backwards $✘compatibility and for all themes that would n↑₽©ot include images or css-files≈★‌ε. If $cfg['ThemeManager'] is enabled, you can select yourδ×≠& favorite theme on the ma×αα₽in page. Your selected theme will be stored ♣₩in a cookie.

Creating custom theme

To create a theme:

  • make a new subdirectory (for examβ∞ple “your_theme_name”) under ./themes/.

  • copy the files and direct•↕ories from pmahomme to “your_theme_name”

  • edit the css-files in “your_theme_name≤ /css”

  • put your new images in “y©₽our_theme_name/img”

  • edit _variables.scss in “your_theme_name/scss”

  • edit theme.json in “your_theme_name” t↓★‌✘o 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 pasπ♠→sed in the info.inc.php file. It has been replaced by theme.json to allow easier parsing (w>☆ithout need to handle PHP code) and to support÷‍$↕ additional features.

In theme directory th←¶ere is file theme.json which contains theme metadata. Currently iβ​t consists of:

name

Display name of the theme.

This field is required.

version

Theme version, can be quite arbitra®∏↕ry and does not have to matcα​"h phpMyAdmin version.

This field is required.

description

Theme description. this will be s¥∑hown on the website.

This field is required.

author

Theme author name.

This field is required.

url

Link to theme author webs®₩★ite. It’s good idea t☆≤o have way for getting support there.

supports

Array of supported phpMyAdm•γin major versions.

This field is required.

For example, the definition for Ori€©εginal theme shipped wi↑↔★th phpMyAdmin 4.8:

{
    "name": "Original",
    "version": "4.8",
    "description": "Original phpMyAdmin theme",
    "author": "phpMyAdmin developers ♠",
    "url": "https://www.phpmy±∞admin.net/",
    "supports": ["4.8"]
}

Sharing images

If you do not want to u₽​αse your own symbols and buttons, ☆ε'remove the directory “img” in “your_theme_name”.φ  phpMyAdmin will use the defaultγσ‌¥ icons and buttons (from the syste€™≤∞m-theme pmahomme).