new classes for handling themes

This commit is contained in:
Sebastian Mendel
2005-11-28 07:59:36 +00:00
parent a1f608d0bc
commit 39384a2df2
3 changed files with 376 additions and 0 deletions

View File

@@ -5,6 +5,10 @@ phpMyAdmin - Changelog
$Id$
$Source$
2005-11-28 Sebastian Mendel <cybot_tm@users.sourceforge.net>
* libraries/Theme.class.php, libraries/Theme_Manager.class.php:
new classes for handling themes
2005-11-27 Michal Čihař <michal@cihar.com>
* Documentation.html, scripts/setup.php: Many new features to setup
script.

134
libraries/Theme.class.php Normal file
View File

@@ -0,0 +1,134 @@
<?php
/* $Id$ */
// vim: expandtab sw=4 ts=4 sts=4:
class PMA_Theme {
/**
* @var string version
*/
var $version = '0.0.0.0';
/**
* @var string name
*/
var $name = '';
/**
* @var string id
*/
var $id = '';
/**
* @var string
*/
var $path = '';
/**
* @var string
*/
var $img_path = '';
/**
* returns theme object loaded from given folder
* or false if theme is invalid
*
* @static
* @param string path to theme
* @return object PMA_Theme
*/
function load( $folder ) {
if ( ! file_exists( $folder . '/info.inc.php' ) ) {
return false;
}
@include( $folder . '/info.inc.php' );
// did it set correctly?
if ( ! isset( $theme_name ) ) {
return false;
}
$theme = new PMA_Theme();
$theme->setPath( $folder );
if ( isset( $theme_full_version ) ) {
$theme->setVersion( $theme_full_version );
} elseif ( isset( $theme_generation, $theme_version ) ) {
$theme->setVersion( $theme_generation . '.' . $theme_version );
}
$theme->setName( $theme_name );
if ( is_dir( $theme->getPath() . 'img/' ) ) {
$theme->setImgPath( $theme->getPath() . 'img/' );
} elseif ( is_dir( $GLOBALS['cfg']['ThemePath'] . '/original/img/' ) ) {
$theme->setImgPath( $GLOBALS['cfg']['ThemePath'] . '/original/img/' );
} else {
$GLOBALS['PMA_errors'][] =
sprintf( $GLOBALS['strThemeNoValidImgPath'], $theme_name );
trigger_error(
sprintf( $GLOBALS['strThemeNoValidImgPath'], $theme_name ),
E_USER_WARNING );
}
return $theme;
}
function getPath() {
return $this->path;
}
function setPath( $path ) {
$this->path = trim( $path );
}
/**
* sets version
* @param string new version
*/
function setVersion( $version ) {
$this->version = trim( $version );
}
/**
* sets name
* @param string $name new name
*/
function setName( $name ) {
$this->name = trim( $name );
}
/**
* returns name
* @return string name
*/
function getName() {
return $this->name;
}
/**
* sets id
* @param string $id new id
*/
function setId( $id ) {
$this->id = trim( $id );
}
/**
* returns id
* @return string id
*/
function getId() {
return $this->id;
}
function setImgPath( $path ) {
$this->img_path = $path;
}
function getImgPath() {
return $this->img_path;
}
}
?>

View File

@@ -0,0 +1,238 @@
<?php
/* $Id$ */
// vim: expandtab sw=4 ts=4 sts=4:
require_once('libraries/Theme.class.php');
class PMA_Theme_Manager {
/**
* @var string path to theme folder
*/
var $themes_path;
/**
* @var array available themes
*/
var $themes = array();
/**
* @var string cookie name
*/
var $cookie_name = 'pma_theme';
/**
* @var boolean
*/
var $per_server = false;
/**
* @var string name of active theme
*/
var $active_theme = '';
/**
* @var object PMA_Theme active theme
*/
var $theme = NULL;
function __construct() {
$this->themes_path = trim( $GLOBALS['cfg']['ThemePath'] ) ;
$this->per_server = (bool) $GLOBALS['cfg']['ThemePerServer'];
$this->theme = new PMA_Theme;
if ( ! $this->_checkThemeFolder( $this->themes_path ) ) {
return;
}
$this->loadThemes( $this->themes_path );
if ( ! $this->checkTheme( $GLOBALS['cfg']['ThemeDefault'] ) ) {
$GLOBALS['PMA_errors'][] = sprintf( $GLOBALS['strThemeDefaultNotFound'],
$GLOBALS['cfg']['ThemeDefault'] );
trigger_error(
sprintf( $GLOBALS['strThemeDefaultNotFound'],
$GLOBALS['cfg']['ThemeDefault'] ),
E_USER_WARNING );
$GLOBALS['cfg']['ThemeDefault'] = false;
}
$this->theme_default = $GLOBALS['cfg']['ThemeDefault'];
// check if user have a theme cookie
if ( ! $this->getThemeCookie()
|| ! $this->setActiveTheme( $this->getThemeCookie() ) ) {
if ( $GLOBALS['cfg']['ThemeDefault'] ) {
$this->setActiveTheme( $GLOBALS['cfg']['ThemeDefault'] );
} else {
$this->setActiveTheme( 'original' );
}
}
}
function setActiveTheme( $theme = NULL ) {
if ( ! $this->checkTheme( $theme ) ) {
$GLOBALS['PMA_errors'][] = sprintf( $GLOBALS['strThemeNotFound'],
$theme );
trigger_error(
sprintf( $GLOBALS['strThemeNotFound'], $theme ),
E_USER_WARNING );
return false;
}
$this->active_theme = $theme;
$this->theme = $this->themes[$theme];
$this->setThemeCookie();
return true;
}
/**
* @return string cookie name
*/
function getThemeCookieName() {
// Allow different theme per server
if ( isset( $GLOBALS['server'] ) && $this->per_server ) {
return $this->cookie_name . '-' . $GLOBALS['server'];
} else {
return $this->cookie_name;
}
}
function getThemeCookie() {
if ( isset( $_COOKIE[$this->getThemeCookieName()] ) ) {
return $_COOKIE[$this->getThemeCookieName()];
}
return false;
}
/**
* save theme in cookie
*/
function setThemeCookie() {
if ( $this->theme_default === $this->theme->getId() ) {
// remove cookie
setcookie( $this->getThemeCookieName(), $this->theme->getId(),
time() - 3600, $GLOBALS['cookie_path'], '', $GLOBALS['is_https'] );
return true;
}
if ( $this->getThemeCookie() === $this->theme->getId() ) {
return true;
}
setcookie( $this->getThemeCookieName(), $this->theme->getId(),
time() + 60*60*24*30, $GLOBALS['cookie_path'], '', $GLOBALS['is_https'] );
return true;
}
/**
* old PHP 4 constructor
*/
function PMA_Theme_Manager() {
$this->__construct();
}
/**
* @private
* @param string $folder
* @return boolean
*/
/*private*/ function _checkThemeFolder( $folder ) {
if ( ! is_dir( $folder ) ) {
$GLOBALS['PMA_errors'][] =
sprintf( $GLOBALS['strThemePathNotFound'],
$folder );
trigger_error(
sprintf( $GLOBALS['strThemePathNotFound'],
$folder ),
E_USER_WARNING );
return false;
}
return true;
}
/**
* read all themes
*/
function loadThemes( $folder ) {
$this->themes = array();
if ( $handleThemes = opendir( $folder ) ) {
// check for themes directory
while (FALSE !== ($PMA_Theme = readdir($handleThemes))) {
$new_theme = PMA_Theme::load( $folder . '/' . $PMA_Theme );
if ( $new_theme ) {
$new_theme->setId( $PMA_Theme );
$this->themes[$PMA_Theme] = $new_theme;
}
} // end get themes
closedir( $handleThemes );
} else {
return false;
} // end check for themes directory
ksort( $this->themes );
}
function checkTheme( $theme ) {
if ( ! array_key_exists( $theme, $this->themes ) ) {
return false;
}
return true;
}
function getHtmlSelectBox( $form = true ) {
if ( $form ) {
echo '<form name="setTheme" method="post" action="index.php"'
.' target="_parent">';
echo PMA_generate_common_hidden_inputs();
}
$theme_selected = FALSE;
$theme_preview_path= './themes.php';
$theme_preview_href = '<a href="' . $theme_preview_path . '" target="themes" onclick="'
. "window.open('" . $theme_preview_path . "','themes','left=10,top=20,width=510,height=350,scrollbars=yes,status=yes,resizable=yes');"
. '">';
echo $theme_preview_href . $GLOBALS['strTheme'] . '</a>:' . "\n";
echo '<select name="set_theme" xml:lang="en" dir="ltr"'
.' onchange="this.form.submit();" >';
foreach ( $this->themes as $each_theme_id => $each_theme ) {
echo '<option value="' . $each_theme_id . '"';
if ( $this->active_theme === $each_theme_id ) {
echo ' selected="selected"';
}
echo '>' . htmlspecialchars( $each_theme->getName() ) . '</option>';
}
echo '</select>';
if ( $form ) {
echo '<noscript><input type="submit" value="' . $GLOBALS['strGo'] . '" /></noscript>';
echo '</form>';
}
}
/**
* enables backward compatibility
*/
function makeBc() {
$GLOBALS['theme'] = $this->theme->getId();
$GLOBALS['pmaThemePath'] = $this->theme->getPath();
$GLOBALS['pmaThemeImage'] = $this->theme->getImgPath();
/**
* load layout file if exists
*/
if ( @file_exists( $GLOBALS['pmaThemePath'] . 'layout.inc.php' ) ) {
include( $GLOBALS['pmaThemePath'] . 'layout.inc.php' );
}
}
}
?>