libraries/Theme.class.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * hold PMA_Theme class
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 if (! defined('PHPMYADMIN')) {
   9     exit;
  10 }
  11
  12 /**
  13  * handles theme
  14  *
  15  * @todo add the possibility to make a theme depend on another theme
  16  * and by default on original
  17  * @todo make all components optional - get missing components from 'parent' theme
  18  *
  19  * @package PhpMyAdmin
  20  */
  21 class PMA_Theme
  22 {
  23     /**
  24      * @var string theme version
  25      * @access  protected
  26      */
  27     var $version = '0.0.0.0';
  28
  29     /**
  30      * @var string theme name
  31      * @access  protected
  32      */
  33     var $name = '';
  34
  35     /**
  36      * @var string theme id
  37      * @access  protected
  38      */
  39     var $id = '';
  40
  41     /**
  42      * @var string theme path
  43      * @access  protected
  44      */
  45     var $path = '';
  46
  47     /**
  48      * @var string image path
  49      * @access  protected
  50      */
  51     var $img_path = '';
  52
  53     /**
  54      * @var integer last modification time for info file
  55      * @access  protected
  56      */
  57     var $mtime_info = 0;
  58
  59     /**
  60      * needed because sometimes, the mtime for different themes
  61      * is identical
  62      * @var integer filesize for info file
  63      * @access  protected
  64      */
  65     var $filesize_info = 0;
  66
  67     /**
  68      * @var array List of css files to load
  69      * @access private
  70      */
  71     private $_cssFiles = array(
  72         'common',
  73         'enum_editor',
  74         'gis',
  75         'navigation',
  76         'pmd',
  77         'rte',
  78         'codemirror',
  79         'jqplot',
  80         'resizable-menu'
  81     );
  82
  83     /**
  84      * Loads theme information
  85      *
  86      * @return boolean whether loading them info was successful or not
  87      * @access  public
  88      */
  89     function loadInfo()
  90     {
  91         if (! file_exists($this->getPath() . '/info.inc.php')) {
  92             return false;
  93         }
  94
  95         if ($this->mtime_info === filemtime($this->getPath() . '/info.inc.php')) {
  96             return true;
  97         }
  98
  99         @include $this->getPath() . '/info.inc.php';
 100
 101         // was it set correctly?
 102         if (! isset($theme_name)) {
 103             return false;
 104         }
 105
 106         $this->mtime_info = filemtime($this->getPath() . '/info.inc.php');
 107         $this->filesize_info = filesize($this->getPath() . '/info.inc.php');
 108
 109         if (isset($theme_full_version)) {
 110             $this->setVersion($theme_full_version);
 111         } elseif (isset($theme_generation, $theme_version)) {
 112             $this->setVersion($theme_generation . '.' . $theme_version);
 113         }
 114         $this->setName($theme_name);
 115
 116         return true;
 117     }
 118
 119     /**
 120      * returns theme object loaded from given folder
 121      * or false if theme is invalid
 122      *
 123      * @param string $folder path to theme
 124      *
 125      * @return PMA_Theme|false
 126      * @static
 127      * @access public
 128      */
 129     static public function load($folder)
 130     {
 131         $theme = new PMA_Theme();
 132
 133         $theme->setPath($folder);
 134
 135         if (! $theme->loadInfo()) {
 136             return false;
 137         }
 138
 139         $theme->checkImgPath();
 140
 141         return $theme;
 142     }
 143
 144     /**
 145      * checks image path for existence - if not found use img from fallback theme
 146      *
 147      * @access public
 148      * @return bool
 149      */
 150     public function checkImgPath()
 151     {
 152         // try current theme first
 153         if (is_dir($this->getPath() . '/img/')) {
 154             $this->setImgPath($this->getPath() . '/img/');
 155             return true;
 156         }
 157
 158         // try fallback theme
 159         $fallback = $GLOBALS['cfg']['ThemePath'] . '/'
 160             . PMA_Theme_Manager::FALLBACK_THEME
 161             . '/img/';
 162         if (is_dir($fallback)) {
 163             $this->setImgPath($fallback);
 164             return true;
 165         }
 166
 167         // we failed
 168         trigger_error(
 169             sprintf(
 170                 __('No valid image path for theme %s found!'),
 171                 $this->getName()
 172             ),
 173             E_USER_ERROR
 174         );
 175         return false;
 176     }
 177
 178     /**
 179      * returns path to theme
 180      *
 181      * @access public
 182      * @return string path to theme
 183      */
 184     public function getPath()
 185     {
 186         return $this->path;
 187     }
 188
 189     /**
 190      * returns layout file
 191      *
 192      * @access public
 193      * @return string layout file
 194      */
 195     public function getLayoutFile()
 196     {
 197         return $this->getPath() . '/layout.inc.php';
 198     }
 199
 200     /**
 201      * set path to theme
 202      *
 203      * @param string $path path to theme
 204      *
 205      * @return void
 206      * @access public
 207      */
 208     public function setPath($path)
 209     {
 210         $this->path = trim($path);
 211     }
 212
 213     /**
 214      * sets version
 215      *
 216      * @param string $version version to set
 217      *
 218      * @return void
 219      * @access public
 220      */
 221     public function setVersion($version)
 222     {
 223         $this->version = trim($version);
 224     }
 225
 226     /**
 227      * returns version
 228      *
 229      * @return string version
 230      * @access public
 231      */
 232     public function getVersion()
 233     {
 234         return $this->version;
 235     }
 236
 237     /**
 238      * checks theme version against $version
 239      * returns true if theme version is equal or higher to $version
 240      *
 241      * @param string $version version to compare to
 242      *
 243      * @return boolean true if theme version is equal or higher to $version
 244      * @access public
 245      */
 246     public function checkVersion($version)
 247     {
 248         return version_compare($this->getVersion(), $version, 'lt');
 249     }
 250
 251     /**
 252      * sets name
 253      *
 254      * @param string $name name to set
 255      *
 256      * @return void
 257      * @access public
 258      */
 259     public function setName($name)
 260     {
 261         $this->name = trim($name);
 262     }
 263
 264     /**
 265      * returns name
 266      *
 267      * @access  public
 268      * @return string name
 269      */
 270     public function getName()
 271     {
 272         return $this->name;
 273     }
 274
 275     /**
 276      * sets id
 277      *
 278      * @param string $id new id
 279      *
 280      * @return void
 281      * @access public
 282      */
 283     public function setId($id)
 284     {
 285         $this->id = trim($id);
 286     }
 287
 288     /**
 289      * returns id
 290      *
 291      * @return string id
 292      * @access public
 293      */
 294     public function getId()
 295     {
 296         return $this->id;
 297     }
 298
 299     /**
 300      * Sets path to images for the theme
 301      *
 302      * @param string $path path to images for this theme
 303      *
 304      * @return void
 305      * @access public
 306      */
 307     public function setImgPath($path)
 308     {
 309         $this->img_path = $path;
 310     }
 311
 312     /**
 313      * Returns the path to image for the theme.
 314      * If filename is given, it possibly fallbacks to fallback
 315      * theme for it if image does not exist.
 316      *
 317      * @param string $file file name for image
 318      *
 319      * @access public
 320      * @return string image path for this theme
 321      */
 322     public function getImgPath($file = null)
 323     {
 324         if (is_null($file)) {
 325             return $this->img_path;
 326         }
 327
 328         if (is_readable($this->img_path . $file)) {
 329             return $this->img_path . $file;
 330         }
 331
 332         return $GLOBALS['cfg']['ThemePath'] . '/'
 333             . PMA_Theme_Manager::FALLBACK_THEME . '/img/' . $file;
 334     }
 335
 336     /**
 337      * load css (send to stdout, normally the browser)
 338      *
 339      * @return bool
 340      * @access  public
 341      */
 342     public function loadCss()
 343     {
 344         $success = true;
 345
 346         if ($GLOBALS['text_dir'] === 'ltr') {
 347             $right = 'right';
 348             $left = 'left';
 349         } else {
 350             $right = 'left';
 351             $left = 'right';
 352         }
 353
 354         foreach ($this->_cssFiles as $file) {
 355             $path = $this->getPath() . "/css/$file.css.php";
 356             $fallback = "./themes/"
 357                 . PMA_Theme_Manager::FALLBACK_THEME .  "/css/$file.css.php";
 358
 359             if (is_readable($path)) {
 360                 echo "\n/* FILE: $file.css.php */\n";
 361                 include $path;
 362             } else if (is_readable($fallback)) {
 363                 echo "\n/* FILE: $file.css.php */\n";
 364                 include $fallback;
 365             } else {
 366                 $success = false;
 367             }
 368         }
 369
 370         include './themes/sprites.css.php';
 371
 372         return $success;
 373     }
 374
 375     /**
 376      * Renders the preview for this theme
 377      *
 378      * @return string
 379      * @access public
 380      */
 381     public function getPrintPreview()
 382     {
 383         $url_params = array('set_theme' => $this->getId());
 384         $url = 'index.php' . PMA_URL_getCommon($url_params);
 385
 386         $retval  = '<div class="theme_preview">';
 387         $retval .= '<h2>';
 388         $retval .= htmlspecialchars($this->getName());
 389         $retval .= ' (' . htmlspecialchars($this->getVersion()) . ') ';
 390         $retval .= '</h2>';
 391         $retval .= '<p>';
 392         $retval .= '<a class="take_theme" ';
 393         $retval .= 'name="' . htmlspecialchars($this->getId()) . '" ';
 394         $retval .=  'href="' . $url . '">';
 395         if (@file_exists($this->getPath() . '/screen.png')) {
 396             // if screen exists then output
 397             $retval .= '<img src="' . $this->getPath() . '/screen.png" border="1"';
 398             $retval .= ' alt="' . htmlspecialchars($this->getName()) . '"';
 399             $retval .= ' title="' . htmlspecialchars($this->getName()) . '" />';
 400             $retval .= '<br />';
 401         } else {
 402             $retval .= __('No preview available.');
 403         }
 404         $retval .= '[ <strong>' . __('take it') . '</strong> ]';
 405         $retval .= '</a>';
 406         $retval .= '</p>';
 407         $retval .= '</div>';
 408         return $retval;
 409     }
 410
 411     /**
 412      * Remove filter for IE.
 413      *
 414      * @return string CSS code.
 415      */
 416     function getCssIEClearFilter()
 417     {
 418         return PMA_USR_BROWSER_AGENT == 'IE'
 419             && PMA_USR_BROWSER_VER >= 6
 420             && PMA_USR_BROWSER_VER <= 8
 421             ? 'filter: none'
 422             : '';
 423     }
 424
 425     /**
 426      * Gets currently configured font size.
 427      *
 428      * @return String with font size.
 429      */
 430     function getFontSize()
 431     {
 432         $fs = $GLOBALS['PMA_Config']->get('fontsize');
 433         if (!is_null($fs)) {
 434             return $fs;
 435         }
 436         if (isset($_COOKIE['pma_fontsize'])) {
 437             return htmlspecialchars($_COOKIE['pma_fontsize']);
 438         }
 439         return '82%';
 440     }
 441
 442     /**
 443      * Generates code for CSS gradient using various browser extensions.
 444      *
 445      * @param string $start_color Color of gradient start, hex value without #
 446      * @param string $end_color   Color of gradient end, hex value without #
 447      *
 448      * @return string CSS code.
 449      */
 450     function getCssGradient($start_color, $end_color)
 451     {
 452         $result = array();
 453         // Opera 9.5+, IE 9
 454         $result[] = 'background-image: url(./themes/svg_gradient.php?from='
 455             . $start_color . '&to=' . $end_color . ');';
 456         $result[] = 'background-size: 100% 100%;';
 457         // Safari 4-5, Chrome 1-9
 458         $result[] = 'background: '
 459             . '-webkit-gradient(linear, left top, left bottom, from(#'
 460             . $start_color . '), to(#' . $end_color . '));';
 461         // Safari 5.1, Chrome 10+
 462         $result[] = 'background: -webkit-linear-gradient(top, #'
 463             . $start_color . ', #' . $end_color . ');';
 464         // Firefox 3.6+
 465         $result[] = 'background: -moz-linear-gradient(top, #'
 466             . $start_color . ', #' . $end_color . ');';
 467         // IE 10
 468         $result[] = 'background: -ms-linear-gradient(top, #'
 469             . $start_color . ', #' . $end_color . ');';
 470         // Opera 11.10
 471         $result[] = 'background: -o-linear-gradient(top, #'
 472             . $start_color . ', #' . $end_color . ');';
 473         // IE 6-8
 474         if (PMA_USR_BROWSER_AGENT == 'IE'
 475             && PMA_USR_BROWSER_VER >= 6
 476             && PMA_USR_BROWSER_VER <= 8
 477         ) {
 478             $result[] = 'filter: '
 479                 . 'progid:DXImageTransform.Microsoft.gradient(startColorstr="#'
 480                 . $start_color . '", endColorstr="#' . $end_color . '");';
 481         }
 482         return implode("\n", $result);
 483     }
 484 }