-<?php\r
-/*\r
- * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)\r
- * Copyright (C) 2002-2009 The Nucleus Group\r
- *\r
- * This program is free software; you can redistribute it and/or\r
- * modify it under the terms of the GNU General Public License\r
- * as published by the Free Software Foundation; either version 2\r
- * of the License, or (at your option) any later version.\r
- * (see nucleus/documentation/index.html#license for more info)\r
- */\r
-/**\r
- * Class representing a skin\r
- *\r
- * @license http://nucleuscms.org/license.txt GNU General Public License\r
- * @copyright Copyright (C) 2002-2009 The Nucleus Group\r
- * @version $Id: SKIN.php 1813 2012-05-02 14:41:57Z sakamocchi $\r
- */\r
-\r
-if ( !function_exists('requestVar') )\r
-{\r
- exit;\r
-}\r
-\r
-class Skin\r
-{\r
- // after creating a SKIN object, evaluates to true when the skin exists\r
- private $valid;\r
- \r
- // skin characteristics. Use the getXXX methods rather than accessing directly\r
- private $id;\r
- private $description;\r
- private $contentType;\r
- private $includeMode; // either 'normal' or 'skindir'\r
- private $includePrefix;\r
- private $name;\r
- \r
- /* action class */\r
- private $action_class;\r
- private $event_identifier;\r
- \r
- /**\r
- * Skin::__construct()\r
- * Constructor for a new SKIN object\r
- * \r
- * @param integer $id id of the skin\r
- * @param string $action_class name of class extended from BaseActions\r
- * @param string $event_identifier event identifier. for example, InitAdminSkinParse if AdminSkin is used\r
- * @return void\r
- */\r
- public function __construct($id, $action_class='Actions', $event_identifier='Skin')\r
- {\r
- global $DIR_LIBS;\r
- \r
- $this->id = (integer) $id;\r
- \r
- /*\r
- * NOTE: include needed action class\r
- */\r
- if ( $action_class != 'Actions' )\r
- {\r
- if ( !class_exists($action_class, FALSE)\r
- && (!file_exists("{$DIR_LIBS}{$action_class}.php")\r
- || !include("{$DIR_LIBS}{$action_class}.php")) )\r
- {\r
- return;\r
- }\r
- }\r
- else\r
- {\r
- if ( !class_exists('Actions', FALSE)\r
- && (!file_exists("{$DIR_LIBS}ACTIONS.php")\r
- || !include("{$DIR_LIBS}ACTIONS.php")) )\r
- {\r
- return;\r
- }\r
- }\r
- \r
- $this->action_class = $action_class;\r
- $this->event_identifier = $event_identifier;\r
- \r
- // read skin name/description/content type\r
- $query = "SELECT * FROM %s WHERE sdnumber=%d;";\r
- $query = sprintf($query, sql_table('skin_desc'), $this->id);\r
- $res = sql_query($query);\r
- $obj = sql_fetch_object($res);\r
- \r
- $this->valid = (sql_num_rows($res) > 0);\r
- if ( !$this->valid )\r
- {\r
- return;\r
- }\r
- \r
- $this->name = $obj->sdname;\r
- $this->description = $obj->sddesc;\r
- $this->contentType = $obj->sdtype;\r
- $this->includeMode = $obj->sdincmode;\r
- $this->includePrefix = $obj->sdincpref;\r
- \r
- return;\r
- }\r
- \r
- /**\r
- * Skin::getID()\r
- * Get SKIN id\r
- * \r
- * @param void\r
- * @return integer id for this skin instance\r
- */\r
- public function getID()\r
- {\r
- return (integer) $this->id;\r
- }\r
- \r
- /**\r
- * Skin::isValid()\r
- * \r
- * @param void\r
- * @return boolean\r
- */\r
- public function isValid()\r
- {\r
- return (boolean) $this->valid;\r
- }\r
- \r
- /**\r
- * Skin::getName()\r
- * Get SKIN name\r
- * \r
- * @param void\r
- * @return string name of this skin instance\r
- */\r
- public function getName()\r
- {\r
- return (string) $this->name;\r
- }\r
- \r
- /**\r
- * Skin::getDescription()\r
- * Get SKIN description\r
- * \r
- * @param void\r
- * @return string description of this skin instance\r
- */\r
- public function getDescription()\r
- {\r
- return (string) $this->description;\r
- }\r
- \r
- /**\r
- * Skin::getContentType()\r
- * Get SKIN content type\r
- * e.g. text/xml, text/html, application/atom+xml\r
- * \r
- * @param void\r
- * @return string name of this skin instance\r
- */\r
- public function getContentType()\r
- {\r
- return (string) $this->contentType;\r
- }\r
- \r
- /**\r
- * Skin::getIncludeMode()\r
- * Get include mode of the SKIN\r
- * \r
- * Returns either 'normal' or 'skindir':\r
- * 'normal': if a all data of the skin can be found in the databse\r
- * 'skindir': if the skin has data in the it's skin driectory\r
- * \r
- * @param void\r
- * @return string normal/skindir\r
- */\r
- public function getIncludeMode()\r
- {\r
- return (string) $this->includeMode;\r
- }\r
- \r
- /**\r
- * Skin::getIncludePrefix()\r
- * Get include prefix of the SKIN\r
- * \r
- * Get name of the subdirectory (with trailing slash) where\r
- * the files of the current skin can be found (e.g. 'default/')\r
- * \r
- * @param void\r
- * @return string include prefix of this skin instance\r
- */\r
- public function getIncludePrefix()\r
- {\r
- return (string) $this->includePrefix;\r
- }\r
- \r
- /**\r
- * Skin::exists()\r
- * Checks if a skin with a given shortname exists\r
- * \r
- * @static\r
- * @param string $name Skin short name\r
- * @return integer number of skins with the given ID\r
- */\r
- static public function exists($name)\r
- {\r
- $query = "SELECT COUNT(*) AS result FROM %s WHERE sdname='%s';";\r
- $query = sprintf($query, sql_table('skin_desc'), sql_real_escape_string($name));\r
- return (quickQuery($query) > 0);\r
- }\r
- \r
- /**\r
- * Skin::existsID()\r
- * Checks if a skin with a given ID exists\r
- * \r
- * @static\r
- * @param string $id Skin ID\r
- * @return integer number of skins with the given ID\r
- */\r
- static public function existsID($id)\r
- {\r
- $query = "SELECT COUNT(*) AS result FROM %s WHERE sdnumber=%d;";\r
- $query = sprintf($query, sql_table('skin_desc'), (integer) $id);\r
- return (quickQuery($query) > 0);\r
- }\r
- \r
- /**\r
- * Skin::createFromName()\r
- * Returns a skin given its shortname\r
- * \r
- * @static\r
- * @param string $name Skin shortname\r
- * @return object instance of Skin class\r
- */\r
- static public function createFromName($name)\r
- {\r
- return new SKIN(SKIN::getIdFromName($name));\r
- }\r
- \r
- /**\r
- * Skin::getIdFromName()\r
- * Returns a skin ID given its shortname\r
- * \r
- * @static\r
- * @param string $name Skin shortname\r
- * @return integer Skin ID\r
- */\r
- static public function getIdFromName($name)\r
- {\r
- $query = "SELECT sdnumber FROM %s WHERE sdname='%s';";\r
- $query = sprintf($query, sql_table('skin_desc'), sql_real_escape_string($name));\r
- $res = sql_query($query);\r
- $obj = sql_fetch_object($res);\r
- return $obj->sdnumber;\r
- }\r
- \r
- /**\r
- * Skin::getNameFromId()\r
- * Returns a skin shortname given its ID\r
- * \r
- * @static\r
- * @param string $name\r
- * @return string Skin short name\r
- */\r
- static public function getNameFromId($id)\r
- {\r
- $query = "SELECT sdname AS result FROM %s WHERE sdnumber=%d;";\r
- $query = sprintf($query, sql_table('skin_desc'), (integer) $id);\r
- return quickQuery($query);\r
- }\r
- \r
- /**\r
- * SKIN::createNew()\r
- * Creates a new skin, with the given characteristics.\r
- *\r
- * @static\r
- * @param String $name value for nucleus_skin.sdname\r
- * @param String $desc value for nucleus_skin.sddesc\r
- * @param String $type value for nucleus_skin.sdtype\r
- * @param String $includeMode value for nucleus_skin.sdinclude\r
- * @param String $includePrefix value for nucleus_skin.sdincpref\r
- * @return Integer ID for just inserted record\r
- */\r
- public function createNew($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')\r
- {\r
- global $manager;\r
- \r
- $manager->notify(\r
- 'PreAddSkin',\r
- array(\r
- 'name' => &$name,\r
- 'description' => &$desc,\r
- 'type' => &$type,\r
- 'includeMode' => &$includeMode,\r
- 'includePrefix' => &$includePrefix\r
- )\r
- );\r
- \r
- $query = "INSERT INTO %s (sdname, sddesc, sdtype, sdincmode, sdincpref) VALUES ('%s', '%s', '%s', '%s', '%s');";\r
- $sdname = sql_real_escape_string($name);\r
- $sddesc = sql_real_escape_string($desc);\r
- $sdtype = sql_real_escape_string($type);\r
- $sdincmode = sql_real_escape_string($includeMode);\r
- $sdincpref = sql_real_escape_string($includePrefix);\r
- $query = sprintf($query, sql_table('skin_desc'), $sdname, $sddesc, $sdtype, $sdincmode, $sdincpref);\r
- sql_query($query);\r
- $newid = sql_insert_id();\r
- \r
- $manager->notify(\r
- 'PostAddSkin',\r
- array(\r
- 'skinid' => $newid,\r
- 'name' => $name,\r
- 'description' => $desc,\r
- 'type' => $type,\r
- 'includeMode' => $includeMode,\r
- 'includePrefix' => $includePrefix\r
- )\r
- );\r
- return $newid;\r
- }\r
- \r
- /**\r
- * Skin::parse()\r
- * Parse a SKIN\r
- * \r
- * @param string $type\r
- * @param string $path path to file if using fileparser\r
- * @return void\r
- */\r
- public function parse($type, $path='')\r
- {\r
- global $currentSkinName, $manager, $CONF, $DIR_NUCLEUS;\r
- \r
- $manager->notify("Init{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type));\r
- \r
- // include skin locale file for <%text%> tag if useable\r
- $this->includeTranslation();\r
- \r
- // set output type\r
- sendContentType($this->getContentType(), 'skin');\r
- \r
- /* FIX: should be obsoleted */\r
- $currentSkinName = $this->getName();\r
- \r
- // retrieve contents\r
- $contents = FALSE;\r
- if ( $type != 'fileparse' )\r
- {\r
- $contents = $this->getContentFromDB($type);\r
- }\r
- else if ( $path !== '' && i18n::strpos(realpath($path), realpath("$DIR_NUCLEUS/../")) == 0 )\r
- {\r
- $contents = $this->getContentFromFile($path);\r
- }\r
- // use base skin if this skin does not have contents\r
- if ( $contents === FALSE )\r
- {\r
- $defskin = new SKIN($CONF['BaseSkin']);\r
- $contents = $defskin->getContentFromDB($type);\r
- if ( !$contents )\r
- {\r
- echo _ERROR_SKIN;\r
- return;\r
- }\r
- }\r
- \r
- $manager->notify("Pre{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type, 'contents' => &$contents));\r
- \r
- // set IncludeMode properties of parser\r
- Parser::setProperty('IncludeMode', $this->getIncludeMode());\r
- Parser::setProperty('IncludePrefix', $this->getIncludePrefix());\r
- \r
- // call action handler\r
- $action_class = $this->action_class;\r
- $handler = new $action_class($type);\r
- \r
- // register action handler to parser\r
- $actions = $handler->getDefinedActions($type);\r
- $parser = new Parser($actions, $handler);\r
- \r
- $handler->setParser($parser);\r
- $handler->setSkin($this);\r
- $parser->parse($contents);\r
- \r
- $manager->notify("Post{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type));\r
- return;\r
- }\r
- \r
- /**\r
- * Skin::getContentFromDB()\r
- * \r
- * @param string $skintype skin type\r
- * @return string content for the skin type\r
- */\r
- public function getContentFromDB($skintype)\r
- {\r
- $query = "SELECT scontent FROM %s WHERE sdesc=%d and stype='%s';";\r
- $query = sprintf($query, sql_table('skin'), (integer) $this->id, sql_real_escape_string($skintype));\r
- $res = sql_query($query);\r
- \r
- if ( sql_num_rows($res) == 0 )\r
- {\r
- return FALSE;\r
- }\r
- \r
- return sql_result($res, 0, 0);\r
- }\r
- \r
- /**\r
- * Skin::getContentFromFile()\r
- * \r
- * @param string $fullpath fullpath to the file to parse\r
- * @return mixed file contents or FALSE\r
- */\r
- public function getContentFromFile($fullpath)\r
- {\r
- $fsize = filesize($fullpath);\r
- if ( $fsize <= 0 )\r
- {\r
- return;\r
- }\r
- \r
- $fd = fopen ($fullpath, 'r');\r
- if ( $fd === FALSE )\r
- {\r
- return FALSE;\r
- }\r
- \r
- $contents = fread ($fd, $fsize);\r
- if ( $contents === FALSE )\r
- {\r
- return FALSE;\r
- }\r
- \r
- fclose ($fd);\r
- return $contents;\r
- }\r
- \r
- /**\r
- * SKIN::update()\r
- * Updates the contents for one part of the skin in the database\r
- * \r
- * @param string $type type of the skin part (e.g. index, item, search ...) \r
- * @param string $content new content for this skin part\r
- * @return void\r
- * \r
- */\r
- public function update($type, $content)\r
- {\r
- global $manager;\r
- \r
- $query = "SELECT sdesc FROM %s WHERE stype='%s' and sdesc=%d;";\r
- $query = sprintf($query, sql_table('skin'), sql_real_escape_string($type), (integer) $this->id);\r
- $res = sql_query($query);\r
- \r
- $skintypeexists = sql_fetch_object($res);\r
- $skintypevalue = ($content == true);\r
- \r
- if( $skintypevalue && $skintypeexists )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type,\r
- 'content' => &$content\r
- );\r
- \r
- // PreUpdateSkinPart event\r
- $manager->notify("PreUpdate{{$this->event_identifier}}Part", $data);\r
- }\r
- else if( $skintypevalue && !$skintypeexists )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type,\r
- 'content' => &$content\r
- );\r
- \r
- $manager->notify("PreAdd{$this->event_identifier}Part", $data);\r
- }\r
- else if( !$skintypevalue && $skintypeexists )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type\r
- );\r
- \r
- $manager->notify("PreDelete{$this->event_identifier}Part", $data);\r
- }\r
- \r
- // delete old thingie\r
- $query = "DELETE FROM %s WHERE stype='%s' and sdesc=%d";\r
- $query = sprintf($query, sql_table('skin'), sql_real_escape_string($type), (integer) $this->id);\r
- sql_query($query);\r
- \r
- // write new thingie\r
- if ( $content )\r
- {\r
- $query = "INSERT INTO %s (scontent, stype, sdesc) VALUE ('%s', '%s', %d)";\r
- $query = sprintf($query, sql_table('skin'), sql_real_escape_string($content), sql_real_escape_string($type), (integer) $this->id);\r
- sql_query($query);\r
- }\r
- \r
- if( $skintypevalue && $skintypeexists )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type,\r
- 'content' => &$content\r
- );\r
- \r
- // PostUpdateSkinPart event\r
- $manager->notify("PostUpdate{$this->event_identifier}Part", $data);\r
- }\r
- else if( $skintypevalue && (!$skintypeexists) )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type,\r
- 'content' => &$content\r
- );\r
- \r
- // PostAddSkinPart event\r
- $manager->notify("PostAdd{$this->event_identifier}Part", $data);\r
- }\r
- else if( (!$skintypevalue) && $skintypeexists )\r
- {\r
- $data = array(\r
- 'skinid' => $this->id,\r
- 'type' => $type\r
- );\r
- \r
- $manager->notify("PostDelete{$this->event_identifier}Part", $data);\r
- }\r
- return;\r
- }\r
- \r
- /**\r
- * Skin::deleteAllParts()\r
- * Deletes all skin parts from the database\r
- * \r
- * @param void\r
- * @return void\r
- */\r
- public function deleteAllParts()\r
- {\r
- $query = "DELETE FROM %s WHERE sdesc=%d;";\r
- $query = sprintf($query, sql_table('skin'), (integer) $this->id);\r
- sql_query($query);\r
- }\r
- \r
- /**\r
- * Skin::updateGeneralInfo()\r
- * Updates the general information about the skin\r
- * \r
- * @param string $name name of the skin\r
- * @param string $desc description of the skin\r
- * @param string $type type of the skin\r
- * @param string $includeMode include mode of the skin\r
- * @param string $includePrefix include prefix of the skin\r
- * @return void\r
- */\r
- public function updateGeneralInfo($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')\r
- {\r
- $name = sql_real_escape_string($name);\r
- $desc = sql_real_escape_string($desc);\r
- $type = sql_real_escape_string($type);\r
- $includeMode = sql_real_escape_string($includeMode);\r
- $includePrefix = sql_real_escape_string($includePrefix);\r
- \r
- $query ="UPDATE %s SET sdname='%s', sddesc='%s', sdtype='%s', sdincmode='%s', sdincpref='%s' WHERE sdnumber=%d";\r
- $query = sprintf($query, sql_table('skin_desc'), $name, $desc, $type, $includeMode, $includePrefix, (integer) $this->id);\r
- \r
- sql_query($query);\r
- return;\r
- }\r
- \r
- /**\r
- * Skin::includeTranslation()\r
- * \r
- * @param void\r
- * @return void\r
- */\r
- private function includeTranslation()\r
- {\r
- global $DIR_SKINS;\r
- \r
- $locale = i18n::get_current_locale() . '.' . i18n::get_current_charset();\r
- \r
- if( $this->includeMode == "normal" )\r
- {\r
- $filename = "./locales/{$locale}.php";\r
- }\r
- else if( $this->includeMode == "skindir" )\r
- {\r
- if ( $this->includePrefix == '' )\r
- {\r
- $filename = "{$DIR_SKINS}locales/{$locale}.php";\r
- }\r
- else\r
- {\r
- $filename = "{$DIR_SKINS}{$this->includePrefix}locales/{$locale}.php";\r
- }\r
- }\r
- else\r
- {\r
- return;\r
- }\r
- \r
- if ( !file_exists($filename) )\r
- {\r
- return;\r
- }\r
- \r
- include_once($filename);\r
- \r
- return;\r
- }\r
- \r
- /**\r
- * Skin::getDefaultTypes()\r
- * \r
- * @param string void\r
- * @return array default skin types\r
- */\r
- public function getDefaultTypes()\r
- {\r
- return call_user_func(array($this->action_class, 'getDefaultSkinTypes'));\r
- }\r
- \r
- /**\r
- * Skin::getAvailableTypes()\r
- * \r
- * @param string void\r
- * @return array registered skin types\r
- */\r
- public function getAvailableTypes()\r
- {\r
- $default_skintypes = $this->getDefaultTypes();\r
- $query = "SELECT stype FROM %s WHERE sdesc=%d;";\r
- $query = sprintf($query, sql_table('skin'), (integer) $this->id);\r
- \r
- /* NOTE: force to put default types in the beginning */\r
- $in_default = array();\r
- $no_default = array();\r
- \r
- $res = sql_query($query);\r
- while ( $row = sql_fetch_array($res) )\r
- {\r
- if ( !array_key_exists($row['stype'], $default_skintypes) )\r
- {\r
- $no_default[$row['stype']] = FALSE;\r
- }\r
- else\r
- {\r
- $in_default[$row['stype']] = $default_skintypes[$row['stype']];\r
- }\r
- }\r
- \r
- return array_merge($in_default, $no_default);\r
- }\r
- \r
- /**\r
- * Skin::getAllowedActionsForType()\r
- * Get the allowed actions for a skin type\r
- * returns an array with the allowed actions\r
- * \r
- * @param string $type type of the skin\r
- * @return array allowed action types\r
- */\r
- public function getAllowedActionsForType($type)\r
- {\r
- return call_user_func(array($this->action_class, 'getDefinedActions'), $type);\r
- }\r
- \r
-}\r
+<?php
+/*
+ * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
+ * Copyright (C) 2002-2009 The Nucleus Group
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * (see nucleus/documentation/index.html#license for more info)
+ */
+/**
+ * Class representing a skin
+ *
+ * @license http://nucleuscms.org/license.txt GNU General Public License
+ * @copyright Copyright (C) 2002-2009 The Nucleus Group
+ * @version $Id: SKIN.php 1886 2012-06-17 08:27:27Z sakamocchi $
+ */
+
+if ( !function_exists('requestVar') )
+{
+ exit;
+}
+
+class Skin
+{
+ // after creating a SKIN object, evaluates to true when the skin exists
+ private $valid;
+
+ // skin characteristics. Use the getXXX methods rather than accessing directly
+ private $id;
+ private $description;
+ private $contentType;
+ private $includeMode; // either 'normal' or 'skindir'
+ private $includePrefix;
+ private $name;
+
+ /* action class */
+ private $action_class;
+ private $event_identifier;
+
+ /**
+ * Skin::__construct()
+ * Constructor for a new SKIN object
+ *
+ * @param integer $id id of the skin
+ * @param string $action_class name of class extended from BaseActions
+ * @param string $event_identifier event identifier. for example, InitAdminSkinParse if AdminSkin is used
+ * @return void
+ */
+ public function __construct($id, $action_class='Actions', $event_identifier='Skin')
+ {
+ global $DIR_LIBS;
+
+ $this->id = (integer) $id;
+
+ /* NOTE: include needed action class */
+ if ( $action_class != 'Actions' )
+ {
+ if ( !class_exists($action_class, FALSE)
+ && (!file_exists("{$DIR_LIBS}{$action_class}.php")
+ || !include("{$DIR_LIBS}{$action_class}.php")) )
+ {
+ return;
+ }
+ }
+ else
+ {
+ if ( !class_exists('Actions', FALSE)
+ && (!file_exists("{$DIR_LIBS}ACTIONS.php")
+ || !include("{$DIR_LIBS}ACTIONS.php")) )
+ {
+ return;
+ }
+ }
+
+ $this->action_class = $action_class;
+ $this->event_identifier = $event_identifier;
+
+ // read skin name/description/content type
+ $query = "SELECT * FROM %s WHERE sdnumber=%d;";
+ $query = sprintf($query, sql_table('skin_desc'), $this->id);
+ $res = DB::getRow($query);
+
+ $this->valid = !empty($res);
+ if ( $this->valid )
+ {
+ $this->name = $res['sdname'];
+ $this->description = $res['sddesc'];
+ $this->contentType = $res['sdtype'];
+ $this->includeMode = $res['sdincmode'];
+ $this->includePrefix = $res['sdincpref'];
+ }
+
+ return;
+ }
+
+ /**
+ * Skin::getID()
+ * Get SKIN id
+ *
+ * @param void
+ * @return integer id for this skin instance
+ */
+ public function getID()
+ {
+ return (integer) $this->id;
+ }
+
+ /**
+ * Skin::isValid()
+ *
+ * @param void
+ * @return boolean
+ */
+ public function isValid()
+ {
+ return (boolean) $this->valid;
+ }
+
+ /**
+ * Skin::getName()
+ * Get SKIN name
+ *
+ * @param void
+ * @return string name of this skin instance
+ */
+ public function getName()
+ {
+ return (string) $this->name;
+ }
+
+ /**
+ * Skin::getDescription()
+ * Get SKIN description
+ *
+ * @param void
+ * @return string description of this skin instance
+ */
+ public function getDescription()
+ {
+ return (string) $this->description;
+ }
+
+ /**
+ * Skin::getContentType()
+ * Get SKIN content type
+ * e.g. text/xml, text/html, application/atom+xml
+ *
+ * @param void
+ * @return string name of this skin instance
+ */
+ public function getContentType()
+ {
+ return (string) $this->contentType;
+ }
+
+ /**
+ * Skin::getIncludeMode()
+ * Get include mode of the SKIN
+ *
+ * Returns either 'normal' or 'skindir':
+ * 'normal': if a all data of the skin can be found in the databse
+ * 'skindir': if the skin has data in the it's skin driectory
+ *
+ * @param void
+ * @return string normal/skindir
+ */
+ public function getIncludeMode()
+ {
+ return (string) $this->includeMode;
+ }
+
+ /**
+ * Skin::getIncludePrefix()
+ * Get include prefix of the SKIN
+ *
+ * Get name of the subdirectory (with trailing slash) where
+ * the files of the current skin can be found (e.g. 'default/')
+ *
+ * @param void
+ * @return string include prefix of this skin instance
+ */
+ public function getIncludePrefix()
+ {
+ return (string) $this->includePrefix;
+ }
+
+ /**
+ * Skin::exists()
+ * Checks if a skin with a given shortname exists
+ *
+ * @static
+ * @param string $name Skin short name
+ * @return integer number of skins with the given ID
+ */
+ static public function exists($name)
+ {
+ $query = "SELECT COUNT(*) AS result FROM %s WHERE sdname=%s;";
+ $query = sprintf($query, sql_table('skin_desc'), DB::quoteValue($name));
+ return (DB::getValue($query) > 0);
+ }
+
+ /**
+ * Skin::existsID()
+ * Checks if a skin with a given ID exists
+ *
+ * @static
+ * @param string $id Skin ID
+ * @return integer number of skins with the given ID
+ */
+ static public function existsID($id)
+ {
+ $query = "SELECT COUNT(*) AS result FROM %s WHERE sdnumber=%d;";
+ $query = sprintf($query, sql_table('skin_desc'), (integer) $id);
+ return (DB::getValue($query) > 0);
+ }
+
+ /**
+ * Skin::createFromName()
+ * Returns a skin given its shortname
+ *
+ * @static
+ * @param string $name Skin shortname
+ * @return object instance of Skin class
+ */
+ static public function createFromName($name)
+ {
+ return new SKIN(SKIN::getIdFromName($name));
+ }
+
+ /**
+ * Skin::getIdFromName()
+ * Returns a skin ID given its shortname
+ *
+ * @static
+ * @param string $name Skin shortname
+ * @return integer Skin ID
+ */
+ static public function getIdFromName($name)
+ {
+ $query = "SELECT sdnumber FROM %s WHERE sdname=%s;";
+ $query = sprintf($query, sql_table('skin_desc'), DB::quoteValue($name));
+ return DB::getValue($query);
+ }
+
+ /**
+ * Skin::getNameFromId()
+ * Returns a skin shortname given its ID
+ *
+ * @static
+ * @param string $name
+ * @return string Skin short name
+ */
+ static public function getNameFromId($id)
+ {
+ $query = "SELECT sdname AS result FROM %s WHERE sdnumber=%d;";
+ $query = sprintf($query, sql_table('skin_desc'), (integer) $id);
+ return DB::getValue($query);
+ }
+
+ /**
+ * SKIN::createNew()
+ * Creates a new skin, with the given characteristics.
+ *
+ * @static
+ * @param String $name value for nucleus_skin.sdname
+ * @param String $desc value for nucleus_skin.sddesc
+ * @param String $type value for nucleus_skin.sdtype
+ * @param String $includeMode value for nucleus_skin.sdinclude
+ * @param String $includePrefix value for nucleus_skin.sdincpref
+ * @return Integer ID for just inserted record
+ */
+ public function createNew($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')
+ {
+ global $manager;
+
+ $data = array(
+ 'name' => &$name,
+ 'description' => &$desc,
+ 'type' => &$type,
+ 'includeMode' => &$includeMode,
+ 'includePrefix' => &$includePrefix
+ );
+ $manager->notify('PreAddSkin', $data);
+
+ $query = "INSERT INTO %s (sdname, sddesc, sdtype, sdincmode, sdincpref) VALUES (%s, %s, %s, %s, %s);";
+ $sdname = DB::quoteValue($name);
+ $sddesc = DB::quoteValue($desc);
+ $sdtype = DB::quoteValue($type);
+ $sdincmode = DB::quoteValue($includeMode);
+ $sdincpref = DB::quoteValue($includePrefix);
+ $query = sprintf($query, sql_table('skin_desc'), $sdname, $sddesc, $sdtype, $sdincmode, $sdincpref);
+ DB::execute($query);
+ $newid = DB::getInsertId();
+
+ $data = array(
+ 'skinid' => $newid,
+ 'name' => $name,
+ 'description' => $desc,
+ 'type' => $type,
+ 'includeMode' => $includeMode,
+ 'includePrefix' => $includePrefix
+ );
+ $manager->notify('PostAddSkin', $data);
+
+ return $newid;
+ }
+
+ /**
+ * Skin::parse()
+ * Parse a SKIN
+ *
+ * @param string $type
+ * @param string $path path to file if using fileparser
+ * @return void
+ */
+ public function parse($type, $path='')
+ {
+ global $currentSkinName, $manager, $CONF, $DIR_NUCLEUS;
+
+ $data = array(
+ 'skin' => $this,
+ 'type' => $type
+ );
+ $manager->notify("Init{$this->event_identifier}Parse", $data);
+
+ // include skin locale file for <%text%> tag if useable
+ $this->includeTranslation();
+
+ // set output type
+ sendContentType($this->getContentType(), 'skin');
+
+ /* FIX: should be obsoleted */
+ $currentSkinName = $this->getName();
+
+ // retrieve contents
+ $contents = FALSE;
+ if ( $type == 'pluginadmin' )
+ {
+ $contents = $path;
+ }
+ else
+ {
+ if ( $type != 'fileparse' && $type != 'importAdmin')
+ {
+ $contents = $this->getContentFromDB($type);
+ }
+ else if ( $path !== '' && i18n::strpos(realpath($path), realpath("$DIR_NUCLEUS/../")) == 0 )
+ {
+ $contents = $this->getContentFromFile($path);
+ }
+ }
+ // use base skin if this skin does not have contents
+ if ( $contents === FALSE )
+ {
+ $defskin = new SKIN($CONF['BaseSkin']);
+ $contents = $defskin->getContentFromDB($type);
+ if ( !$contents )
+ {
+ echo _ERROR_SKIN;
+ return;
+ }
+ }
+
+ $data = array(
+ 'skin' => &$this,
+ 'type' => $type,
+ 'contents' => &$contents
+ );
+ $manager->notify("Pre{$this->event_identifier}Parse", $data);
+
+ // set IncludeMode properties of parser
+ Parser::setProperty('IncludeMode', $this->getIncludeMode());
+ Parser::setProperty('IncludePrefix', $this->getIncludePrefix());
+
+ // call action handler
+ $action_class = $this->action_class;
+ $handler = new $action_class($type);
+
+ // register action handler to parser
+ $parser = new Parser($handler);
+ $parser->setSkin($this);
+ $parser->parse($contents);
+
+ $data = array(
+ 'skin' => &$this,
+ 'type' => $type
+ );
+ $manager->notify("Post{$this->event_identifier}Parse", $data);
+
+ return;
+ }
+
+ /**
+ * Skin::getContentFromDB()
+ *
+ * @param string $skintype skin type
+ * @return string content for the skin type
+ */
+ public function getContentFromDB($skintype)
+ {
+ $query = "SELECT scontent FROM %s WHERE sdesc=%d and stype=%s;";
+ $query = sprintf($query, sql_table('skin'), (integer) $this->id, DB::quoteValue($skintype));
+ $res = DB::getValue($query);
+
+ return $res ? $res : '';
+ }
+
+ /**
+ * Skin::getContentFromFile()
+ *
+ * @param string $fullpath fullpath to the file to parse
+ * @return mixed file contents or FALSE
+ */
+ public function getContentFromFile($fullpath)
+ {
+ $fsize = filesize($fullpath);
+ if ( $fsize <= 0 )
+ {
+ return;
+ }
+
+ $fd = fopen ($fullpath, 'r');
+ if ( $fd === FALSE )
+ {
+ return FALSE;
+ }
+
+ $contents = fread ($fd, $fsize);
+ if ( $contents === FALSE )
+ {
+ return FALSE;
+ }
+
+ fclose ($fd);
+ return $contents;
+ }
+
+ /**
+ * SKIN::update()
+ * Updates the contents for one part of the skin in the database
+ *
+ * @param string $type type of the skin part (e.g. index, item, search ...)
+ * @param string $content new content for this skin part
+ * @return void
+ *
+ */
+ public function update($type, $content)
+ {
+ global $manager;
+
+ $query = "SELECT sdesc FROM %s WHERE stype=%s and sdesc=%d;";
+ $query = sprintf($query, sql_table('skin'), DB::quoteValue($type), (integer) $this->id);
+ $res = DB::getValue($query);
+
+ $skintypeexists = !empty($res);
+ $skintypevalue = !empty($content);
+
+ if( $skintypevalue && $skintypeexists )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type,
+ 'content' => &$content
+ );
+ $manager->notify("PreUpdate{$this->event_identifier}Part", $data);
+ }
+ else if( $skintypevalue )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type,
+ 'content' => &$content
+ );
+ $manager->notify("PreAdd{$this->event_identifier}Part", $data);
+ }
+ else if( $skintypeexists )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type
+ );
+ $manager->notify("PreDelete{$this->event_identifier}Part", $data);
+ }
+
+ // delete old thingie
+ $query = "DELETE FROM %s WHERE stype=%s and sdesc=%d;";
+ $query = sprintf($query, sql_table('skin'), DB::quoteValue($type), (integer) $this->id);
+ DB::execute($query);
+
+ // write new thingie
+ if ( $content )
+ {
+ $query = "INSERT INTO %s (scontent, stype, sdesc) VALUES (%s, %s, %d);";
+ $query = sprintf($query, sql_table('skin'), DB::quoteValue($content), DB::quoteValue($type), (integer) $this->id);
+ DB::execute($query);
+ }
+
+ if( $skintypevalue && $skintypeexists )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type,
+ 'content' => &$content
+ );
+ $manager->notify("PostUpdate{$this->event_identifier}Part", $data);
+ }
+ else if( $skintypevalue )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type,
+ 'content' => &$content
+ );
+ $manager->notify("PostAdd{$this->event_identifier}Part", $data);
+ }
+ else if( $skintypeexists )
+ {
+ $data = array(
+ 'skinid' => $this->id,
+ 'type' => $type
+ );
+ $manager->notify("PostDelete{$this->event_identifier}Part", $data);
+ }
+ return;
+ }
+
+ /**
+ * Skin::deleteAllParts()
+ * Deletes all skin parts from the database
+ *
+ * @param void
+ * @return void
+ */
+ public function deleteAllParts()
+ {
+ $query = "DELETE FROM %s WHERE sdesc=%d;";
+ $query = sprintf($query, sql_table('skin'), (integer) $this->id);
+ DB::execute($query);
+ }
+
+ /**
+ * Skin::updateGeneralInfo()
+ * Updates the general information about the skin
+ *
+ * @param string $name name of the skin
+ * @param string $desc description of the skin
+ * @param string $type type of the skin
+ * @param string $includeMode include mode of the skin
+ * @param string $includePrefix include prefix of the skin
+ * @return void
+ */
+ public function updateGeneralInfo($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')
+ {
+ $name = DB::quoteValue($name);
+ $desc = DB::quoteValue($desc);
+ $type = DB::quoteValue($type);
+ $includeMode = DB::quoteValue($includeMode);
+ $includePrefix = DB::quoteValue($includePrefix);
+
+ $query ="UPDATE %s SET sdname=%s, sddesc=%s, sdtype=%s, sdincmode=%s, sdincpref=%s WHERE sdnumber=%d";
+ $query = sprintf($query, sql_table('skin_desc'), $name, $desc, $type, $includeMode, $includePrefix, (integer) $this->id);
+
+ DB::execute($query);
+ return;
+ }
+
+ /**
+ * Skin::includeTranslation()
+ *
+ * @param void
+ * @return void
+ */
+ private function includeTranslation()
+ {
+ global $DIR_SKINS;
+
+ $locale = i18n::get_current_locale() . '.' . i18n::get_current_charset();
+
+ if( $this->includeMode == "normal" )
+ {
+ $filename = "./locales/{$locale}.php";
+ }
+ else if( $this->includeMode == "skindir" )
+ {
+ if ( $this->includePrefix == '' )
+ {
+ $filename = "{$DIR_SKINS}locales/{$locale}.php";
+ }
+ else
+ {
+ $filename = "{$DIR_SKINS}{$this->includePrefix}locales/{$locale}.php";
+ }
+ }
+ else
+ {
+ return;
+ }
+
+ if ( !file_exists($filename) )
+ {
+ return;
+ }
+
+ include_once($filename);
+
+ return;
+ }
+
+ /**
+ * Skin::getNormalTypes()
+ *
+ * @param string void
+ * @return array default skin types
+ */
+ public function getNormalTypes()
+ {
+ return call_user_func(array($this->action_class, 'getNormalSkinTypes'));
+ }
+
+ /**
+ * Skin::getAvailableTypes()
+ *
+ * @param string void
+ * @return array registered skin types
+ */
+ public function getAvailableTypes()
+ {
+ $default_skintypes = $this->getNormalTypes();
+ $query = "SELECT stype FROM %s WHERE sdesc=%d;";
+ $query = sprintf($query, sql_table('skin'), (integer) $this->id);
+
+ /* NOTE: force to put default types in the beginning */
+ $in_default = array();
+ $no_default = array();
+
+ $res = DB::getResult($query);
+ foreach ( $res as $row )
+ {
+ if ( !array_key_exists($row['stype'], $default_skintypes) )
+ {
+ $no_default[$row['stype']] = FALSE;
+ }
+ else
+ {
+ $in_default[$row['stype']] = $default_skintypes[$row['stype']];
+ }
+ }
+
+ return array_merge($in_default, $no_default);
+ }
+
+ /**
+ * Skin::getAllowedActionsForType()
+ * Get the allowed actions for a skin type
+ * returns an array with the allowed actions
+ * @return array allowed action types
+ * @param string $skintype type of the skin
+ * @return array allowed action types
+ */
+ public function getAllowedActionsForType($skintype)
+ {
+ $handler = new $this->action_class($skintype);
+ return $handler->getAvailableActions();
+ }
+
+}