powerdlz23 1.1.7 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/web/CPagination.php

@@ -0,0 +1,161 @@
+<?php
+/**
+ * CPagination class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CPagination represents information relevant to pagination.
+ *
+ * When data needs to be rendered in multiple pages, we can use CPagination to
+ * represent information such as {@link getItemCount total item count},
+ * {@link getPageSize page size}, {@link getCurrentPage current page}, etc.
+ * These information can be passed to {@link CBasePager pagers} to render
+ * pagination buttons or links.
+ *
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CPagination.php 562 2009-01-21 15:36:03Z qiang.xue $
+ * @package system.web
+ * @since 1.0
+ */
+class CPagination extends CComponent
+{
+	/**
+	 * The default page size.
+	 */
+	const DEFAULT_PAGE_SIZE=10;
+	/**
+	 * @var string name of the GET variable storing the current page index. Defaults to 'page'.
+	 */
+	public $pageVar='page';
+	/**
+	 * @var string the route (controller ID and action ID) for displaying the paged contents.
+	 * Defaults to empty string, meaning using the current route.
+	 */
+	public $route='';
+
+	private $_pageSize=self::DEFAULT_PAGE_SIZE;
+	private $_itemCount=0;
+	private $_currentPage;
+
+	/**
+	 * Constructor.
+	 * @param integer total number of items.
+	 * @since 1.0.1
+	 */
+	public function __construct($itemCount=0)
+	{
+		$this->setItemCount($itemCount);
+	}
+
+	/**
+	 * @return integer number of items in each page. Defaults to 10.
+	 */
+	public function getPageSize()
+	{
+		return $this->_pageSize;
+	}
+
+	/**
+	 * @param integer number of items in each page
+	 */
+	public function setPageSize($value)
+	{
+		if(($this->_pageSize=$value)<=0)
+			$this->_pageSize=self::DEFAULT_PAGE_SIZE;
+	}
+
+	/**
+	 * @return integer total number of items. Defaults to 0.
+	 */
+	public function getItemCount()
+	{
+		return $this->_itemCount;
+	}
+
+	/**
+	 * @param integer total number of items.
+	 */
+	public function setItemCount($value)
+	{
+		if(($this->_itemCount=$value)<0)
+			$this->_itemCount=0;
+	}
+
+	/**
+	 * @return integer number of pages
+	 */
+	public function getPageCount()
+	{
+		return (int)(($this->_itemCount+$this->_pageSize-1)/$this->_pageSize);
+	}
+
+	/**
+	 * @param boolean whether to recalculate the current page based on the page size and item count.
+	 * @return integer the zero-based index of the current page. Defaults to 0.
+	 */
+	public function getCurrentPage($recalculate=true)
+	{
+		if($this->_currentPage===null || $recalculate)
+		{
+			if(isset($_GET[$this->pageVar]))
+			{
+				$this->_currentPage=(int)$_GET[$this->pageVar]-1;
+				$pageCount=$this->getPageCount();
+				if($this->_currentPage>=$pageCount)
+					$this->_currentPage=$pageCount-1;
+				if($this->_currentPage<0)
+					$this->_currentPage=0;
+			}
+			else
+				$this->_currentPage=0;
+		}
+		return $this->_currentPage;
+	}
+
+	/**
+	 * @param integer the zero-based index of the current page.
+	 */
+	public function setCurrentPage($value)
+	{
+		$this->_currentPage=$value;
+		$_GET[$this->pageVar]=$value+1;
+	}
+
+	/**
+	 * Creates the URL suitable for pagination.
+	 * This method is mainly called by pagers when creating URLs used to
+	 * perform pagination. The default implementation is to call
+	 * the controller's createUrl method with the page information.
+	 * You may override this method if your URL scheme is not the same as
+	 * the one supported by the controller's createUrl method.
+	 * @param CController the controller that will create the actual URL
+	 * @param integer the page that the URL should point to. This is a zero-based index.
+	 * @return string the created URL
+	 */
+	public function createPageUrl($controller,$page)
+	{
+		$params=($this->route==='')?$_GET:array();
+		if($page>0) // page 0 is the default
+			$params[$this->pageVar]=$page+1;
+		else
+			unset($params[$this->pageVar]);
+		return $controller->createUrl($this->route,$params);
+	}
+
+	/**
+	 * Applies LIMIT and OFFSET to the specified query criteria.
+	 * @param CDbCriteria the query criteria that should be applied with the limit
+	 * @since 1.0.1
+	 */
+	public function applyLimit($criteria)
+	{
+		$criteria->limit=$this->pageSize;
+		$criteria->offset=$this->currentPage*$this->pageSize;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/CSort.php

@@ -0,0 +1,292 @@
+<?php
+/**
+ * CSort class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CSort represents information relevant to sorting.
+ *
+ * When data needs to be sorted according to one or several attributes,
+ * we can use CSort to represent the sorting information and generate
+ * appropriate hyperlinks that can lead to sort actions.
+ *
+ * CSort is designed to be used together with {@link CActiveRecord}.
+ * When creating a CSort instance, you need to specify {@link modelClass}.
+ * You can use CSort to generate hyperlinks by calling {@link link}.
+ * You can also use CSort to modify a {@link CDbCriteria} instance so that
+ * it can cause the query results to be sorted according to the specified
+ * attributes.
+ *
+ * CSort is primarily used for active record involving a single DB table.
+ * In order to use it with relational active record, special care needs to be taken.
+ * We use an example to illustrate this use case. Assume 'Post' is the main
+ * active record class, and 'author' is one of its related attributes. We would
+ * like to sort by post's title as well as its author's name. First, we need
+ * to define aliases for the two attributes by setting the {@link attributes} property:
+ * <pre>
+ * array(
+ *     'title',
+ *     'author.name'=>'authorName',
+ * )
+ * </pre>
+ *
+ * We also need to modify the 'author' relation in 'Post' class and explicitly
+ * specify the 'alias' option with value 'author':
+ * <pre>
+ * 'author'=>array(self::BELONGS_TO, 'User', 'alias'=>'author')
+ * </pre>
+ *
+ * Finally, we can use the following code to generate hyperlinks:
+ * <pre>
+ * echo CSort::link('title');
+ * echo CSort::link('author.name');
+ * </pre>
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CSort.php 699 2009-02-17 21:25:52Z qiang.xue $
+ * @package system.web
+ * @since 1.0.1
+ */
+class CSort extends CComponent
+{
+	/**
+	 * @var boolean whether the sorting can be applied to multiple attributes simultaneously.
+	 * Defaults to true. If false, each time the data can only be sorted by one attribute.
+	 */
+	public $multiSort=true;
+	/**
+	 * @var string the class name of data models that need to be sorted.
+	 * This should be a child class of {@link CActiveRecord}.
+	 */
+	public $modelClass;
+	/**
+	 * @var array list of attributes that are allowed to be sorted.
+	 * For example, array('user_id','create_time') would specify that only 'user_id'
+	 * and 'create_time' can be sorted.
+	 * Defaults to null, meaning all attributes of the {@link modelClass} can be sorted.
+	 * This property can also be used to specify attribute aliases that should appear
+	 * in the 'sort' GET parameter in place of the original attribute names.
+	 * In this case, the aliases should be array values while the attribute names
+	 * should be the corresponding array keys. Do not use '-' and '.' in the aliases
+	 * as they are used as {@link separators}.
+	 */
+	public $attributes;
+	/**
+	 * @var string the name of the GET parameter that specifies which attributes to be sorted
+	 * in which direction. Defaults to 'sort'.
+	 */
+	public $sortVar='sort';
+	/**
+	 * @var string the default order that should be applied to the query criteria when
+	 * the current request does not specify any sort.
+	 */
+	public $defaultOrder;
+	/**
+	 * @var string the route (controller ID and action ID) for generating the sorted contents.
+	 * Defaults to empty string, meaning using the currently requested route.
+	 */
+	public $route='';
+	/**
+	 * @var array separators used in the generated URL. This must be an array consisting of
+	 * two elements. The first element specifies the character separating different
+	 * attributes, while the second element specifies the character separating attribute name
+	 * and the corresponding sort direction. Defaults to array('-','.').
+	 */
+	public $separators=array('-','.');
+
+	private $_directions;
+
+	/**
+	 * Constructor.
+	 * @param string the class name of data models that need to be sorted.
+	 * This should be a child class of {@link CActiveRecord}.
+	 */
+	public function __construct($modelClass)
+	{
+		$this->modelClass=$modelClass;
+	}
+
+	/**
+	 * Modifies the query criteria by changing its ORDER BY property.
+	 * @param CDbCriteria the query criteria
+	 */
+	public function applyOrder($criteria)
+	{
+		$directions=$this->getDirections();
+		if(empty($directions))
+			$order=$this->defaultOrder;
+		else
+		{
+			$schema=CActiveRecord::model($this->modelClass)->getDbConnection()->getSchema();
+			$orders=array();
+			foreach($directions as $attribute=>$descending)
+			{
+				if(($pos=strpos($attribute,'.'))!==false)
+					$attribute=$schema->quoteTableName(substr($attribute,0,$pos)).'.'.$schema->quoteColumnName(substr($attribute,$pos+1));
+				else
+					$attribute=$schema->quoteColumnName($attribute);
+				$orders[]=$descending?$attribute.' DESC':$attribute;
+			}
+			$order=implode(', ',$orders);
+		}
+
+		if(!empty($order))
+		{
+			if(!empty($criteria->order))
+				$criteria->order.=', ';
+			$criteria->order.=$order;
+		}
+	}
+
+	/**
+	 * Generates a hyperlink that can be clicked to cause sorting.
+	 * @param string the attribute name. This must be the actual attribute name, not alias.
+	 * If it is an attribute of a related AR object, the name should be prefixed with
+	 * the relation name (e.g. 'author.name', where 'author' is the relation name).
+	 * @param string the link label. If null, the label will be determined according
+	 * to the attribute (see {@link CActiveRecord::getAttributeLabel}).
+	 * @param array additional HTML attributes for the hyperlink tag
+	 * @return string the generated hyperlink
+	 */
+	public function link($attribute,$label=null,$htmlOptions=array())
+	{
+		$directions=$this->getDirections();
+		if(isset($directions[$attribute]))
+		{
+			$descending=!$directions[$attribute];
+			unset($directions[$attribute]);
+		}
+		else
+			$descending=false;
+		if($this->multiSort)
+			$directions=array_merge(array($attribute=>$descending),$directions);
+		else
+			$directions=array($attribute=>$descending);
+
+		if($label===null)
+			$label=$this->resolveLabel($attribute);
+		$url=$this->createUrl(Yii::app()->getController(),$directions);
+
+		return $this->createLink($attribute,$label,$url,$htmlOptions);
+	}
+
+	/**
+	 * Resolves the attribute label based on label definition in the AR class.
+	 * @param string the attribute name.
+	 * @return string the attribute label
+	 * @since 1.0.2
+	 */
+	protected function resolveLabel($attribute)
+	{
+		if(($pos=strpos($attribute,'.'))!==false)
+		{
+			$baseModel=CActiveRecord::model($this->modelClass);
+			if(($relation=$baseModel->getActiveRelation(substr($attribute,0,$pos)))!==null)
+				return CActiveRecord::model($relation->className)->getAttributeLabel(substr($attribute,$pos+1));
+			else
+				return $baseModel->getAttributeLabel(substr($attribute,$pos+1));
+		}
+		return CActiveRecord::model($this->modelClass)->getAttributeLabel($attribute);
+	}
+
+	/**
+	 * Returns the currently requested sort information.
+	 * @return array sort directions indexed by attribute names.
+	 * The sort direction is true if the corresponding attribute should be
+	 * sorted in descending order.
+	 */
+	public function getDirections()
+	{
+		if($this->_directions===null)
+		{
+			$this->_directions=array();
+			if(isset($_GET[$this->sortVar]))
+			{
+				$attributes=explode($this->separators[0],$_GET[$this->sortVar]);
+				foreach($attributes as $attribute)
+				{
+					if(($pos=strpos($attribute,$this->separators[1]))!==false)
+					{
+						$descending=substr($attribute,$pos+1)==='desc';
+						$attribute=substr($attribute,0,$pos);
+					}
+					else
+						$descending=false;
+
+					if(($attribute=$this->validateAttribute($attribute))!==false)
+						$this->_directions[$attribute]=$descending;
+				}
+				if(!$this->multiSort)
+				{
+					foreach($this->_directions as $attribute=>$descending)
+						return $this->_directions=array($attribute=>$descending);
+				}
+			}
+		}
+		return $this->_directions;
+	}
+
+	/**
+	 * Creates a URL that can lead to generating sorted data.
+	 * @param CController the controller that will be used to create the URL.
+	 * @param array the sort directions indexed by attribute names.
+	 * The sort direction is true if the corresponding attribute should be
+	 * sorted in descending order.
+	 * @return string the URL for sorting
+	 */
+	public function createUrl($controller,$directions)
+	{
+		$sorts=array();
+		foreach($directions as $attribute=>$descending)
+		{
+			if(is_array($this->attributes) && isset($this->attributes[$attribute]))
+				$attribute=$this->attributes[$attribute];
+			$sorts[]=$descending ? $attribute.$this->separators[1].'desc' : $attribute;
+		}
+		$params=$_GET;
+		$params[$this->sortVar]=implode($this->separators[0],$sorts);
+		return $controller->createUrl($this->route,$params);
+	}
+
+	/**
+	 * Validates an attribute that is requested to be sorted.
+	 * The validation is based on {@link attributes} and {@link CActiveRecord::attributeNames}.
+	 * False will be returned if the attribute is not allowed to be sorted.
+	 * If the attribute is aliased via {@link attributes}, the original
+	 * attribute name will be returned.
+	 * @param string the attribute name (could be an alias) that the user requests to sort on
+	 * @return string the real attribute name. False if the attribute cannot be sorted
+	 */
+	protected function validateAttribute($attribute)
+	{
+		if(empty($this->attributes))
+			$attributes=CActiveRecord::model($this->modelClass)->attributeNames();
+		else
+			$attributes=$this->attributes;
+		foreach($attributes as $name=>$alias)
+		{
+			if($alias===$attribute)
+				return is_string($name) ? $name : $alias;
+		}
+		return false;
+	}
+
+	/**
+	 * Creates a hyperlink based on the given label and URL.
+	 * You may override this method to customize the link generation.
+	 * @param string the name of the attribute that this link is for
+	 * @param string the label of the hyperlink
+	 * @param string the URL
+	 * @param array additional HTML options
+	 * @return string the generated hyperlink
+	 */
+	protected function createLink($attribute,$label,$url,$htmlOptions)
+	{
+		return CHtml::link($label,$url,$htmlOptions);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/CTheme.php

@@ -0,0 +1,124 @@
+<?php
+/**
+ * CTheme class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CTheme represents an application theme.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CTheme.php 837 2009-03-14 11:51:40Z qiang.xue $
+ * @package system.web
+ * @since 1.0
+ */
+class CTheme extends CComponent
+{
+	private $_name;
+	private $_basePath;
+	private $_baseUrl;
+
+	/**
+	 * Constructor.
+	 * @param string name of the theme
+	 * @param string base theme path
+	 * @param string base theme URL
+	 */
+	public function __construct($name,$basePath,$baseUrl)
+	{
+		$this->_name=$name;
+		$this->_baseUrl=$baseUrl;
+		$this->_basePath=$basePath;
+	}
+
+	/**
+	 * @return string theme name
+	 */
+	public function getName()
+	{
+		return $this->_name;
+	}
+
+	/**
+	 * @return string the relative URL to the theme folder (without ending slash)
+	 */
+	public function getBaseUrl()
+	{
+		return $this->_baseUrl;
+	}
+
+	/**
+	 * @return string the file path to the theme folder
+	 */
+	public function getBasePath()
+	{
+		return $this->_basePath;
+	}
+
+	/**
+	 * @return string the path for controller views. Defaults to 'ThemeRoot/views'.
+	 */
+	public function getViewPath()
+	{
+		return $this->_basePath.DIRECTORY_SEPARATOR.'views';
+	}
+
+	/**
+	 * @return string the path for system views. Defaults to 'ThemeRoot/views/system'.
+	 */
+	public function getSystemViewPath()
+	{
+		return $this->getViewPath().DIRECTORY_SEPARATOR.'system';
+	}
+
+	/**
+	 * Finds the view file for the specified controller's view.
+	 * @param CController the controller
+	 * @param string the view name
+	 * @return string the view file path. False if the file does not exist.
+	 */
+	public function getViewFile($controller,$viewName)
+	{
+		return $controller->resolveViewFile($viewName,$this->getViewPath().'/'.$controller->getUniqueId(),$this->getViewPath());
+	}
+
+	/**
+	 * Finds the layout file for the specified controller's layout.
+	 * @param CController the controller
+	 * @param string the layout name
+	 * @return string the layout file path. False if the file does not exist.
+	 */
+	public function getLayoutFile($controller,$layoutName)
+	{
+		$basePath=$this->getViewPath();
+		if(empty($layoutName))
+		{
+			$module=$controller->getModule();
+			while($module!==null)
+			{
+				if($module->layout===false)
+					return false;
+				if(!empty($module->layout))
+					break;
+				$module=$module->getParentModule();
+			}
+			if($module===null)
+				return $controller->resolveViewFile(Yii::app()->layout,$basePath.'/layouts',$basePath);
+			else
+			{
+				$basePath.='/'.$module->getId();
+				return $controller->resolveViewFile($module->layout,$basePath.'/layouts',$basePath);
+			}
+		}
+		else
+		{
+			if(($module=$controller->getModule())!==null)
+				$basePath.='/'.$module->getId();
+			return $controller->resolveViewFile($layoutName,$basePath.'/layouts',$basePath);
+		}
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/CThemeManager.php

@@ -0,0 +1,127 @@
+<?php
+/**
+ * CThemeManager class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CThemeManager manages the themes for the Web application.
+ *
+ * A theme is a collection of view/layout files and resource files
+ * (e.g. css, image, js files). When a theme is active, {@link CController}
+ * will look for the specified view/layout under the theme folder first.
+ * The corresponding view/layout files will be used if the theme provides them.
+ * Otherwise, the default view/layout files will be used.
+ *
+ * By default, each theme is organized as a directory whose name is the theme name.
+ * All themes are located under the "WebRootPath/themes" directory.
+ *
+ * To activate a theme, set the {@link CWebApplication::setTheme theme} property
+ * to be the name of that theme.
+ *
+ * Since a self-contained theme often contains resource files that are made
+ * Web accessible, please make sure the view/layout files are protected from Web access.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CThemeManager.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.web
+ * @since 1.0
+ */
+class CThemeManager extends CApplicationComponent
+{
+	/**
+	 * default themes base path
+	 */
+	const DEFAULT_BASEPATH='themes';
+
+	/**
+	 * @var string the name of the theme class for representing a theme.
+	 * Defaults to {@link CTheme}. This can also be a class name in dot syntax.
+	 */
+	public $themeClass='CTheme';
+
+	private $_basePath=null;
+	private $_baseUrl=null;
+
+
+	/**
+	 * @param string name of the theme to be retrieved
+	 * @return CTheme the theme retrieved. Null if the theme does not exist.
+	 */
+	public function getTheme($name)
+	{
+		$themePath=$this->getBasePath().DIRECTORY_SEPARATOR.$name;
+		if(is_dir($themePath))
+		{
+			$class=Yii::import($this->themeClass);
+			return new $class($name,$themePath,$this->getBaseUrl().'/'.$name);
+		}
+		else
+			return null;
+	}
+
+	/**
+	 * @return array list of available theme names
+	 */
+	public function getThemeNames()
+	{
+		static $themes;
+		if($themes===null)
+		{
+			$themes=array();
+			$basePath=$this->getBasePath();
+			$folder=@opendir($basePath);
+			while($file=@readdir($folder))
+			{
+				if($file!=='.' && $file!=='..' && $file!=='.svn' && is_dir($basePath.DIRECTORY_SEPARATOR.$file))
+					$themes[]=$file;
+			}
+			closedir($folder);
+			sort($themes);
+		}
+		return $themes;
+	}
+
+	/**
+	 * @return string the base path for all themes. Defaults to "WebRootPath/themes".
+	 */
+	public function getBasePath()
+	{
+		if($this->_basePath===null)
+			$this->setBasePath(dirname(Yii::app()->getRequest()->getScriptFile()).DIRECTORY_SEPARATOR.self::DEFAULT_BASEPATH);
+		return $this->_basePath;
+	}
+
+	/**
+	 * @param string the base path for all themes.
+	 * @throws CException if the base path does not exist
+	 */
+	public function setBasePath($value)
+	{
+		$this->_basePath=realpath($value);
+		if($this->_basePath===false || !is_dir($this->_basePath))
+			throw new CException(Yii::t('yii','Theme directory "{directory}" does not exist.',array('{directory}'=>$value)));
+	}
+
+	/**
+	 * @return string the base URL for all themes. Defaults to "/WebRoot/themes".
+	 */
+	public function getBaseUrl()
+	{
+		if($this->_baseUrl===null)
+			$this->_baseUrl=Yii::app()->getBaseUrl().'/'.self::DEFAULT_BASEPATH;
+		return $this->_baseUrl;
+	}
+
+	/**
+	 * @param string the base URL for all themes.
+	 */
+	public function setBaseUrl($value)
+	{
+		$this->_baseUrl=rtrim($value,'/');
+	}
+}