3 * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
4 * Copyright (C) 2002-2009 The Nucleus Group
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 * (see nucleus/documentation/index.html#license for more info)
13 * Class representing a skin
15 * @license http://nucleuscms.org/license.txt GNU General Public License
16 * @copyright Copyright (C) 2002-2009 The Nucleus Group
17 * @version $Id: SKIN.php 1784 2012-04-22 04:28:30Z sakamocchi $
20 if ( !function_exists('requestVar') )
27 // after creating a SKIN object, evaluates to true when the skin exists
30 // skin characteristics. Use the getXXX methods rather than accessing directly
34 private $includeMode; // either 'normal' or 'skindir'
35 private $includePrefix;
39 private $action_class;
40 private $event_identifier;
44 * Constructor for a new SKIN object
46 * @param integer $id id of the skin
47 * @param string $action_class name of class extended from BaseActions
48 * @param string $event_identifier event identifier. for example, InitAdminSkinParse if AdminSkin is used
51 public function __construct($id, $action_class='Actions', $event_identifier='Skin')
55 $this->id = (integer) $id;
58 * NOTE: include needed action class
60 if ( $action_class != 'Actions' )
62 if ( !class_exists($action_class, FALSE)
63 && (!file_exists("{$DIR_LIBS}{$action_class}.php")
64 || !include("{$DIR_LIBS}{$action_class}.php")) )
71 if ( !class_exists('Actions', FALSE)
72 && (!file_exists("{$DIR_LIBS}ACTIONS.php")
73 || !include("{$DIR_LIBS}ACTIONS.php")) )
79 $this->action_class = $action_class;
80 $this->event_identifier = $event_identifier;
82 // read skin name/description/content type
83 $query = "SELECT * FROM %s WHERE sdnumber=%d;";
84 $query = sprintf($query, sql_table('skin_desc'), $this->id);
85 $res = DB::getRow($query);
87 $this->valid = !empty($res);
90 $this->name = $res['sdname'];
91 $this->description = $res['sddesc'];
92 $this->contentType = $res['sdtype'];
93 $this->includeMode = $res['sdincmode'];
94 $this->includePrefix = $res['sdincpref'];
105 * @return integer id for this skin instance
107 public function getID()
109 return (integer) $this->id;
118 public function isValid()
120 return (boolean) $this->valid;
128 * @return string name of this skin instance
130 public function getName()
132 return (string) $this->name;
136 * Skin::getDescription()
137 * Get SKIN description
140 * @return string description of this skin instance
142 public function getDescription()
144 return (string) $this->description;
148 * Skin::getContentType()
149 * Get SKIN content type
150 * e.g. text/xml, text/html, application/atom+xml
153 * @return string name of this skin instance
155 public function getContentType()
157 return (string) $this->contentType;
161 * Skin::getIncludeMode()
162 * Get include mode of the SKIN
164 * Returns either 'normal' or 'skindir':
165 * 'normal': if a all data of the skin can be found in the databse
166 * 'skindir': if the skin has data in the it's skin driectory
169 * @return string normal/skindir
171 public function getIncludeMode()
173 return (string) $this->includeMode;
177 * Skin::getIncludePrefix()
178 * Get include prefix of the SKIN
180 * Get name of the subdirectory (with trailing slash) where
181 * the files of the current skin can be found (e.g. 'default/')
184 * @return string include prefix of this skin instance
186 public function getIncludePrefix()
188 return (string) $this->includePrefix;
193 * Checks if a skin with a given shortname exists
196 * @param string $name Skin short name
197 * @return integer number of skins with the given ID
199 static public function exists($name)
201 $query = "SELECT COUNT(*) AS result FROM %s WHERE sdname=%s;";
202 $query = sprintf($query, sql_table('skin_desc'), DB::quoteValue($name));
203 return (DB::getValue($query) > 0);
208 * Checks if a skin with a given ID exists
211 * @param string $id Skin ID
212 * @return integer number of skins with the given ID
214 static public function existsID($id)
216 $query = "SELECT COUNT(*) AS result FROM %s WHERE sdnumber=%d;";
217 $query = sprintf($query, sql_table('skin_desc'), (integer) $id);
218 return (DB::getValue($query) > 0);
222 * Skin::createFromName()
223 * Returns a skin given its shortname
226 * @param string $name Skin shortname
227 * @return object instance of Skin class
229 static public function createFromName($name)
231 return new SKIN(SKIN::getIdFromName($name));
235 * Skin::getIdFromName()
236 * Returns a skin ID given its shortname
239 * @param string $name Skin shortname
240 * @return integer Skin ID
242 static public function getIdFromName($name)
244 $query = "SELECT sdnumber FROM %s WHERE sdname=%s;";
245 $query = sprintf($query, sql_table('skin_desc'), DB::quoteValue($name));
246 return DB::getValue($query);
250 * Skin::getNameFromId()
251 * Returns a skin shortname given its ID
254 * @param string $name
255 * @return string Skin short name
257 static public function getNameFromId($id)
259 $query = "SELECT sdname AS result FROM %s WHERE sdnumber=%d;";
260 $query = sprintf($query, sql_table('skin_desc'), (integer) $id);
261 return DB::getValue($query);
266 * Creates a new skin, with the given characteristics.
269 * @param String $name value for nucleus_skin.sdname
270 * @param String $desc value for nucleus_skin.sddesc
271 * @param String $type value for nucleus_skin.sdtype
272 * @param String $includeMode value for nucleus_skin.sdinclude
273 * @param String $includePrefix value for nucleus_skin.sdincpref
274 * @return Integer ID for just inserted record
276 public function createNew($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')
284 'description' => &$desc,
286 'includeMode' => &$includeMode,
287 'includePrefix' => &$includePrefix
291 $query = "INSERT INTO %s (sdname, sddesc, sdtype, sdincmode, sdincpref) VALUES (%s, %s, %s, %s, %s);";
292 $sdname = DB::quoteValue($name);
293 $sddesc = DB::quoteValue($desc);
294 $sdtype = DB::quoteValue($type);
295 $sdincmode = DB::quoteValue($includeMode);
296 $sdincpref = DB::quoteValue($includePrefix);
297 $query = sprintf($query, sql_table('skin_desc'), $sdname, $sddesc, $sdtype, $sdincmode, $sdincpref);
299 $newid = DB::getInsertId();
306 'description' => $desc,
308 'includeMode' => $includeMode,
309 'includePrefix' => $includePrefix
319 * @param string $type
320 * @param string $path path to file if using fileparser
323 public function parse($type, $path='')
325 global $currentSkinName, $manager, $CONF, $DIR_NUCLEUS;
327 $manager->notify("Init{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type));
329 // include skin locale file for <%text%> tag if useable
330 $this->includeLocaleFile(i18n::get_current_locale());
333 sendContentType($this->getContentType(), 'skin');
335 // set skin name as global var (so plugins can access it)
336 $currentSkinName = $this->getName();
339 if ( $type != 'fileparse' )
341 $contents = $this->getContent($type);
343 else if ( $path !== '' && i18n::strpos(realpath($path), realpath("$DIR_NUCLEUS/../")) == 0 )
345 $contents = $this->getFileContent($path);
350 // use base skin if this skin does not have contents
351 $defskin = new SKIN($CONF['BaseSkin']);
352 $contents = $defskin->getContent($type);
360 $manager->notify("Pre{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type, 'contents' => &$contents));
362 // set IncludeMode properties of parser
363 Parser::setProperty('IncludeMode', $this->getIncludeMode());
364 Parser::setProperty('IncludePrefix', $this->getIncludePrefix());
366 $action_class = $this->action_class;
367 $handler = new $action_class($type);
369 $actions = $handler->getDefinedActions($type);
370 $parser = new Parser($actions, $handler);
372 $handler->setParser($parser);
373 $handler->setSkin($this);
374 $parser->parse($contents);
376 $manager->notify("Post{$this->event_identifier}Parse", array('skin' => &$this, 'type' => $type));
382 * Get content of the skin part from the database
384 * @param string $type type of the skin (e.g. index, item, search ...)
385 * @return string content of scontent
387 public function getContent($type)
389 $query = "SELECT scontent FROM %s WHERE sdesc=%d and stype=%s;";
390 $query = sprintf($query, sql_table('skin'), (integer) $this->id, DB::quoteValue($type));
391 $res = DB::getValue($query);
393 return $res ? $res : '';
397 * Skin::getFileContent()
399 * @param string $fullpath fullpath to the file to parse
400 * @return mixed file contents or FALSE
402 public function getFileContent($fullpath)
404 $fsize = filesize($fullpath);
410 $fd = fopen ($fullpath, 'r');
416 $contents = fread ($fd, $fsize);
417 if ( $contents === FALSE )
428 * Updates the contents for one part of the skin in the database
430 * @param string $type type of the skin part (e.g. index, item, search ...)
431 * @param string $content new content for this skin part
435 public function update($type, $content)
439 $query = "SELECT sdesc FROM %s WHERE stype=%s and sdesc=%d;";
440 $query = sprintf($query, sql_table('skin'), DB::quoteValue($type), (integer) $this->id);
441 $res = DB::getValue($query);
443 $skintypeexists = !empty($res);
444 $skintypevalue = ($content == true);
446 if( $skintypevalue && $skintypeexists )
449 'skinid' => $this->id,
451 'content' => &$content
454 // PreUpdateSkinPart event
455 $manager->notify("PreUpdate{{$this->event_identifier}}Part", $data);
457 else if( $skintypevalue && !$skintypeexists )
460 'skinid' => $this->id,
462 'content' => &$content
465 $manager->notify("PreAdd{$this->event_identifier}Part", $data);
467 else if( !$skintypevalue && $skintypeexists )
470 'skinid' => $this->id,
474 $manager->notify("PreDelete{$this->event_identifier}Part", $data);
477 // delete old thingie
478 $query = "DELETE FROM %s WHERE stype=%s and sdesc=%d";
479 $query = sprintf($query, sql_table('skin'), DB::quoteValue($type), (integer) $this->id);
485 $query = "INSERT INTO %s (scontent, stype, sdesc) VALUE (%s, %s, %d)";
486 $query = sprintf($query, sql_table('skin'), DB::quoteValue($content), DB::quoteValue($type), (integer) $this->id);
490 if( $skintypevalue && $skintypeexists )
493 'skinid' => $this->id,
495 'content' => &$content
498 // PostUpdateSkinPart event
499 $manager->notify("PostUpdate{$this->event_identifier}Part", $data);
501 else if( $skintypevalue && (!$skintypeexists) )
504 'skinid' => $this->id,
506 'content' => &$content
509 // PostAddSkinPart event
510 $manager->notify("PostAdd{$this->event_identifier}Part", $data);
512 else if( (!$skintypevalue) && $skintypeexists )
515 'skinid' => $this->id,
519 $manager->notify("PostDelete{$this->event_identifier}Part", $data);
525 * Skin::deleteAllParts()
526 * Deletes all skin parts from the database
531 public function deleteAllParts()
533 $query = "DELETE FROM %s WHERE sdesc=%d;";
534 $query = sprintf($query, sql_table('skin'), (integer) $this->id);
539 * Skin::updateGeneralInfo()
540 * Updates the general information about the skin
542 * @param string $name name of the skin
543 * @param string $desc description of the skin
544 * @param string $type type of the skin
545 * @param string $includeMode include mode of the skin
546 * @param string $includePrefix include prefix of the skin
549 public function updateGeneralInfo($name, $desc, $type = 'text/html', $includeMode = 'normal', $includePrefix = '')
551 $name = DB::quoteValue($name);
552 $desc = DB::quoteValue($desc);
553 $type = DB::quoteValue($type);
554 $includeMode = DB::quoteValue($includeMode);
555 $includePrefix = DB::quoteValue($includePrefix);
557 $query ="UPDATE %s SET sdname=%s, sddesc=%s, sdtype=%s, sdincmode=%s, sdincpref=%s WHERE sdnumber=%d";
558 $query = sprintf($query, sql_table('skin_desc'), $name, $desc, $type, $includeMode, $includePrefix, (integer) $this->id);
565 * Skin::includeLocaleFile()
567 * @param string $locale locale name
570 private function includeLocaleFile($locale)
574 if( $this->includeMode == "normal" )
576 $filename = "./locale/{$locale}.php";
578 elseif( $this->includeMode == "skindir" )
580 if ( $this->includePrefix == '' )
582 $filename = "{$DIR_SKINS}locale/{$locale}.php";
586 $filename = "{$DIR_SKINS}{$this->includePrefix}locale/{$locale}.php";
594 if ( !file_exists($filename) )
599 include_once($filename);
605 * Skin::getDefaultTypes()
608 * @return array default skin types
610 public function getDefaultTypes()
612 return call_user_func(array($this->action_class, 'getDefaultSkinTypes'));
616 * Skin::getAvailableTypes()
619 * @return array registered skin types
621 public function getAvailableTypes()
623 $default_skintypes = $this->getDefaultTypes();
624 $query = "SELECT stype FROM %s WHERE sdesc=%d;";
625 $query = sprintf($query, sql_table('skin'), (integer) $this->id);
627 /* NOTE: force to put default types in the beginning */
628 $in_default = array();
629 $no_default = array();
631 $res = DB::getResult($query);
632 foreach ( $res as $row )
634 if ( !array_key_exists($row['stype'], $default_skintypes) )
636 $no_default[$row['stype']] = FALSE;
640 $in_default[$row['stype']] = $default_skintypes[$row['stype']];
644 return array_merge($in_default, $no_default);
648 * Skin::getAllowedActionsForType()
649 * Get the allowed actions for a skin type
650 * returns an array with the allowed actions
652 * @param string $type type of the skin
653 * @return array allowed action types
655 public function getAllowedActionsForType($type)
657 return call_user_func(array($this->action_class, 'getDefinedActions'), $type);