powerdlz23 1.1.6 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/web/widgets/CTreeView.php

@@ -0,0 +1,232 @@
+<?php
+/**
+ * CTreeView 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/
+ */
+
+/**
+ * CTreeView displays a tree view of hierarchical data.
+ *
+ * It encapsulates the excellent tree view plugin for jQuery
+ * ({@link http://bassistance.de/jquery-plugins/jquery-plugin-treeview/}).
+ *
+ * To use CTreeView, simply sets {@link data} to the data that you want
+ * to present and you are there.
+ *
+ * CTreeView also supports dynamic data loading via AJAX. To do so, set
+ * {@link url} to be the URL that can serve the tree view data upon request.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CTreeView.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.web.widgets
+ * @since 1.0
+ */
+class CTreeView extends CWidget
+{
+	/**
+	 * @var array the data that can be used to generate the tree view content.
+	 * Each array element corresponds to a tree view node with the following structure:
+	 * <ul>
+	 * <li>text: string, required, the HTML text associated with this node.</li>
+	 * <li>expanded: boolean, optional, whether the tree view node is in expanded.</li>
+	 * <li>id: string, optional, the ID identifying the node. This is used
+	 *   in dynamic loading of tree view (see {@link url}).</li>
+	 * <li>hasChildren: boolean, optional, defaults to false, whether clicking on this
+	 *   node should trigger dynamic loading of more tree view nodes from server.
+	 *   The {@link url} property must be set in order to make this effective.</li>
+	 * <li>children: array, optional, child nodes of this node.</li>
+	 * </ul>
+	 * Note, anything enclosed between the beginWidget and endWidget calls will
+	 * also be treated as tree view content, which appends to the content generated
+	 * from this data.
+	 */
+	public $data;
+	/**
+	 * @var mixed the CSS file used for the widget. Defaults to null, meaning
+	 * using the default CSS file included together with the widget.
+	 * If false, no CSS file will be used. Otherwise, the specified CSS file
+	 * will be included when using this widget.
+	 */
+	public $cssFile;
+	/**
+	 * @var string|array the URL to which the treeview can be dynamically loaded (in AJAX).
+	 * See {@link CHtml::normalizeUrl} for possible URL formats.
+	 * Setting this property will enable the dynamic treeview loading.
+	 * When the page is displayed, the browser will request this URL with a GET parameter
+	 * named 'source' whose value is 'root'. The server script should then generate the
+	 * needed tree view data corresponding to the root of the tree (see {@link saveDataAsJson}.)
+	 * When a node has a CSS class 'hasChildren', then expanding this node will also
+	 * cause a dynamic loading of its child nodes. In this case, the value of the 'source' GET parameter
+	 * is the 'id' property of the node.
+	 */
+	public $url;
+	/**
+	 * @var string|integer animation speed. This can be one of the three predefined speeds
+	 * ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
+	 * If not set, no animation is used.
+	 */
+	public $animated;
+	/**
+	 * @var boolean whether the tree should start with all branches collapsed. Defaults to false.
+	 */
+	public $collapsed;
+	/**
+	 * @var string container for a tree-control, allowing the user to expand, collapse and toggle all branches with one click.
+	 * In the container, clicking on the first hyperlink will collapse the tree;
+	 * the second hyperlink will expand the tree; while the third hyperlink will toggle the tree.
+	 * The property should be a valid jQuery selector (e.g. '#treecontrol' where 'treecontrol' is
+	 * the ID of the 'div' element containing the hyperlinks.)
+	 */
+	public $control;
+	/**
+	 * @var boolean set to allow only one branch on one level to be open (closing siblings which opening).
+	 * Defaults to false.
+	 */
+	public $unique;
+	/**
+	 * @var string Callback when toggling a branch. Arguments: "this" refers to the UL that was shown or hidden
+	 */
+	public $toggle;
+	/**
+	 * @var string Persist the tree state in cookies or the page location. If set to "location", looks for
+	 * the anchor that matches location.href and activates that part of the treeview it.
+	 * Great for href-based state-saving. If set to "cookie", saves the state of the tree on
+	 * each click to a cookie and restores that state on page load.
+	 */
+	public $persist;
+	/**
+	 * @var string The cookie name to use when persisting via persist:"cookie". Defaults to 'treeview'.
+	 */
+	public $cookieId;
+	/**
+	 * @var boolean Set to skip rendering of classes and hitarea divs, assuming that is done by the serverside. Defaults to false.
+	 */
+	public $prerendered;
+	/**
+	 * @var array additional options that can be passed to the constructor of the treeview js object.
+	 */
+	public $options=array();
+	/**
+	 * @var array additional HTML attributes that will be rendered in the UL tag.
+	 * The default tree view CSS has defined the following CSS classes which can be enabled
+	 * by specifying the 'class' option here:
+	 * <ul>
+	 * <li>treeview-black</li>
+	 * <li>treeview-gray</li>
+	 * <li>treeview-red</li>
+	 * <li>treeview-famfamfam</li>
+	 * <li>filetree</li>
+	 * </ul>
+	 */
+	public $htmlOptions;
+
+
+	/**
+	 * Initializes the widget.
+	 * This method registers all needed client scripts and renders
+	 * the tree view content.
+	 */
+	public function init()
+	{
+		if(isset($this->htmlOptions['id']))
+			$id=$this->htmlOptions['id'];
+		else
+			$id=$this->htmlOptions['id']=$this->getId();
+		if($this->url!==null)
+			$this->url=CHtml::normalizeUrl($this->url);
+		$cs=Yii::app()->getClientScript();
+		$cs->registerCoreScript('treeview');
+		$options=$this->getClientOptions();
+		$options=$options===array()?'{}' : CJavaScript::encode($options);
+		$cs->registerScript('Yii.CTreeView#'.$id,"jQuery(\"#{$id}\").treeview($options);");
+		if($this->cssFile===null)
+			$cs->registerCssFile($cs->getCoreScriptUrl().'/treeview/jquery.treeview.css');
+		else if($this->cssFile!==false)
+			$cs->registerCssFile($this->cssFile);
+
+		echo CHtml::tag('ul',$this->htmlOptions,false,false)."\n";
+		echo self::saveDataAsHtml($this->data);
+	}
+
+	/**
+	 * Ends running the widget.
+	 */
+	public function run()
+	{
+		echo "</ul>";
+	}
+
+	/**
+	 * @return array the javascript options
+	 */
+	protected function getClientOptions()
+	{
+		$options=$this->options;
+		foreach(array('url','animated','collapsed','control','unique','toggle','persist','cookieId','prerendered') as $name)
+		{
+			if($this->$name!==null)
+				$options[$name]=$this->$name;
+		}
+		return $options;
+	}
+
+	/**
+	 * Generates tree view nodes in HTML from the data array.
+	 * @param array the data for the tree view (see {@link data} for possible data structure).
+	 * @return string the generated HTML for the tree view
+	 */
+	public static function saveDataAsHtml($data)
+	{
+		$html='';
+		if(is_array($data))
+		{
+			foreach($data as $node)
+			{
+				if(!isset($node['text']))
+					continue;
+				$id=isset($node['id']) ? (' id="'.$node['id'].'"') : '';
+				if(isset($node['expanded']))
+					$css=$node['expanded'] ? 'open' : 'closed';
+				else
+					$css='';
+				if(isset($node['hasChildren']) && $node['hasChildren'])
+				{
+					if($css!=='')
+						$css.=' ';
+					$css.='hasChildren';
+				}
+				if($css!=='')
+					$css=' class="'.$css.'"';
+				$html.="<li{$id}{$css}>{$node['text']}";
+				if(isset($node['children']))
+				{
+					$html.="\n<ul>\n";
+					$html.=self::saveDataAsHtml($node['children']);
+					$html.="</ul>\n";
+				}
+				$html.="</li>\n";
+			}
+		}
+		return $html;
+	}
+
+	/**
+	 * Saves tree view data in JSON format.
+	 * This method is typically used in dynamic tree view loading
+	 * when the server code needs to send to the client the dynamic
+	 * tree view data.
+	 * @param array the data for the tree view (see {@link data} for possible data structure).
+	 * @return string the JSON representation of the data
+	 */
+	public static function saveDataAsJson($data)
+	{
+		if(empty($data))
+			return '[]';
+		else
+			return CJavaScript::jsonEncode($data);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/widgets/CWidget.php

@@ -0,0 +1,202 @@
+<?php
+/**
+ * CWidget 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/
+ */
+
+/**
+ * CWidget is the base class for widgets.
+ *
+ * A widget is a self-contained component that may generate presentation
+ * based on model data.  It can be viewed as a micro-controller that embeds
+ * into the controller-managed views.
+ *
+ * Compared with {@link CController controller}, a widget has neither actions nor filters.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CWidget.php 916 2009-04-04 21:54:27Z qiang.xue $
+ * @package system.web.widgets
+ * @since 1.0
+ */
+class CWidget extends CBaseController
+{
+	/**
+	 * @var string the prefix to the IDs of the {@link actions}.
+	 * When a widget is declared an action provider in {@link CController::actions},
+	 * a prefix can be specified to differentiate its action IDs from others.
+	 * The same prefix should then also be used to configure this property
+	 * when the widget is used in a view of the controller.
+	 * @since 1.0.1
+	 */
+	public $actionPrefix;
+
+	/**
+	 * @var array view paths for different types of widgets
+	 */
+	private static $_viewPaths;
+	/**
+	 * @var integer the counter for generating implicit IDs.
+	 */
+	private static $_counter=0;
+	/**
+	 * @var string id of the widget.
+	 */
+	private $_id;
+	/**
+	 * @var CBaseController owner/creator of this widget. It could be either a widget or a controller.
+	 */
+	private $_owner;
+
+	/**
+	 * Returns a list of actions that are used by this widget.
+	 * The structure of this method's return value is similar to
+	 * that returned by {@link CController::actions}.
+	 *
+	 * When a widget uses several actions, you can declare these actions using
+	 * this method. The widget will then become an action provider, and the actions
+	 * can be easily imported into a controller.
+	 *
+	 * Note, when creating URLs referring to the actions listed in this method,
+	 * make sure the action IDs are prefixed with {@link actionPrefix}.
+	 *
+	 * @see actionPrefix
+	 * @see CController::actions
+	 * @since 1.0.1
+	 */
+	public static function actions()
+	{
+		return array();
+	}
+
+	/**
+	 * Constructor.
+	 * @param CBaseController owner/creator of this widget. It could be either a widget or a controller.
+	 */
+	public function __construct($owner=null)
+	{
+		$this->_owner=$owner===null?Yii::app()->getController():$owner;
+	}
+
+	/**
+	 * @return CBaseController owner/creator of this widget. It could be either a widget or a controller.
+	 */
+	public function getOwner()
+	{
+		return $this->_owner;
+	}
+
+	/**
+	 * @param boolean whether to generate an ID if it is not set previously
+	 * @return string id of the widget.
+	 */
+	public function getId($autoGenerate=true)
+	{
+		if($this->_id!==null)
+			return $this->_id;
+		else if($autoGenerate)
+			return $this->_id='yw'.self::$_counter++;
+	}
+
+	/**
+	 * @param string id of the widget.
+	 */
+	public function setId($value)
+	{
+		$this->_id=$value;
+	}
+
+	/**
+	 * @return CController the controller that this widget belongs to.
+	 */
+	public function getController()
+	{
+		if($this->_owner instanceof CController)
+			return $this->_owner;
+		else
+			return Yii::app()->getController();
+	}
+
+	/**
+	 * Initializes the widget.
+	 * This method is called by {@link CBaseController::createWidget}
+	 * and {@link CBaseController::beginWidget} after the widget's
+	 * properties have been initialized.
+	 */
+	public function init()
+	{
+	}
+
+	/**
+	 * Executes the widget.
+	 * This method is called by {@link CBaseController::endWidget}.
+	 */
+	public function run()
+	{
+	}
+
+	/**
+	 * Returns the directory containing the view files for this widget.
+	 * The default implementation returns the 'views' subdirectory of the directory containing the widget class file.
+	 * @return string the directory containing the view files for this widget.
+	 */
+	public function getViewPath()
+	{
+		$className=get_class($this);
+		if(isset(self::$_viewPaths[$className]))
+			return self::$_viewPaths[$className];
+		else
+		{
+			$class=new ReflectionClass(get_class($this));
+			return self::$_viewPaths[$className]=dirname($class->getFileName()).DIRECTORY_SEPARATOR.'views';
+		}
+	}
+
+	/**
+	 * Looks for the view script file according to the view name.
+	 * This method will look for the view under the widget's {@link getViewPath viewPath}.
+	 * The view script file is named as "ViewName.php". A localized view file
+	 * may be returned if internationalization is needed. See {@link CApplication::findLocalizedFile}
+	 * for more details.
+	 * Since version 1.0.2, the view name can also refer to a path alias
+	 * if it contains dot characters.
+	 * @param string name of the view (without file extension)
+	 * @return string the view file path. False if the view file does not exist
+	 * @see CApplication::findLocalizedFile
+	 */
+	public function getViewFile($viewName)
+	{
+		if(strpos($viewName,'.')) // a path alias
+			$viewFile=Yii::getPathOfAlias($viewName).'.php';
+		else
+			$viewFile=$this->getViewPath().DIRECTORY_SEPARATOR.$viewName.'.php';
+		return is_file($viewFile) ? Yii::app()->findLocalizedFile($viewFile) : false;
+	}
+
+	/**
+	 * Renders a view.
+	 *
+	 * The named view refers to a PHP script (resolved via {@link getViewFile})
+	 * that is included by this method. If $data is an associative array,
+	 * it will be extracted as PHP variables and made available to the script.
+	 *
+	 * @param string name of the view to be rendered. See {@link getViewFile} for details
+	 * about how the view script is resolved.
+	 * @param array data to be extracted into PHP variables and made available to the view script
+	 * @param boolean whether the rendering result should be returned instead of being displayed to end users
+	 * @return string the rendering result. Null if the rendering result is not required.
+	 * @throws CException if the view does not exist
+	 * @see getViewFile
+	 */
+	public function render($view,$data=null,$return=false)
+	{
+		if(($viewFile=$this->getViewFile($view))!==false)
+			return $this->renderFile($viewFile,$data,$return);
+		else
+			throw new CException(Yii::t('yii','{widget} cannot find the view "{view}".',
+				array('{widget}'=>get_class($this), '{view}'=>$view)));
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/widgets/captcha/CCaptcha.php

@@ -0,0 +1,132 @@
+<?php
+/**
+ * CCaptcha 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/
+ */
+
+/**
+ * CCaptcha renders a CAPTCHA image element.
+ *
+ * CCaptcha is used together with {@link CCaptchaAction} to provide {@link http://en.wikipedia.org/wiki/Captcha CAPTCHA}
+ * - a way of preventing site spam.
+ *
+ * The image element rendered by CCaptcha will display a CAPTCHA image generated
+ * by an action of class {@link CCaptchaAction} belonging to the current controller.
+ * By default, the action ID should be 'captcha', which can be changed by setting {@link captchaAction}.
+ *
+ * CCaptcha may also render a button next to the CAPTCHA image. Clicking on the button
+ * will change the CAPTCHA image to be a new one in an AJAX way.
+ *
+ * Since version 1.0.8, if {@link clickableImage} is set true, clicking on the CAPTCHA image
+ * will refresh the CAPTCHA.
+ *
+ * A {@link CCaptchaValidator} may be used to validate that the user enters
+ * a verification code matching the code displayed in the CAPTCHA image.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CCaptcha.php 1285 2009-08-01 01:57:50Z qiang.xue $
+ * @package system.web.widgets.captcha
+ * @since 1.0
+ */
+class CCaptcha extends CWidget
+{
+	/**
+	 * @var string the ID of the action that should provide CAPTCHA image. Defaults to 'captcha',
+	 * meaning the 'captcha' action of the current controller. This property may also
+	 * be in the format of 'ControllerID/ActionID'. Underneath, this property is used
+	 * by {@link CController::createUrl} to create the URL that would serve the CAPTCHA image.
+	 * The action has to be of {@link CCaptchaAction}.
+	 */
+	public $captchaAction='captcha';
+	/**
+	 * @var boolean whether to display a button next to the CAPTCHA image. Clicking on the button
+	 * will cause the CAPTCHA image to be changed to a new one. Defaults to true.
+	 */
+	public $showRefreshButton=true;
+	/**
+	 * @var boolean whether to allow clicking on the CAPTCHA image to refresh the CAPTCHA letters.
+	 * Defaults to false. Hint: you may want to set {@link showRefreshButton} to false if you set
+	 * this property to be true because they serve for the same purpose.
+	 * To enhance accessibility, you may set {@link imageOptions} to provide hints to end-users that
+	 * the image is clickable.
+	 * @since 1.0.8
+	 */
+	public $clickableImage=false;
+	/**
+	 * @var string the label for the refresh button. Defaults to 'Get a new code'.
+	 */
+	public $buttonLabel;
+	/**
+	 * @var string the type of the refresh button. This should be either 'link' or 'button'.
+	 * The former refers to hyperlink button while the latter a normal push button.
+	 * Defaults to 'link'.
+	 */
+	public $buttonType='link';
+	/**
+	 * @var array HTML attributes to be applied to the rendered image element.
+	 */
+	public $imageOptions=array();
+	/**
+	 * @var array HTML attributes to be applied to the rendered refresh button element.
+	 */
+	public $buttonOptions=array();
+
+
+	/**
+	 * Renders the widget.
+	 */
+	public function run()
+	{
+		$this->renderImage();
+		$this->registerClientScript();
+	}
+
+	/**
+	 * Renders the CAPTCHA image.
+	 */
+	protected function renderImage()
+	{
+		if(isset($this->imageOptions['id']))
+			$id=$this->imageOptions['id'];
+		else
+			$id=$this->imageOptions['id']=$this->getId();
+		$url=$this->getController()->createUrl($this->captchaAction);
+		$alt=isset($imageOptions['alt'])?$imageOptions['alt']:'';
+		echo CHtml::image($url,$alt,$this->imageOptions);
+	}
+
+	/**
+	 * Registers the needed client scripts.
+	 * @since 1.0.2
+	 */
+	public function registerClientScript()
+	{
+		$cs=Yii::app()->clientScript;
+		$id=$this->imageOptions['id'];
+		$url=$this->getController()->createUrl($this->captchaAction,array(CCaptchaAction::REFRESH_GET_VAR=>true));
+
+		if($this->showRefreshButton)
+		{
+			$cs->registerScript('Yii.CCaptcha#'.$id,'dummy');
+			$label=$this->buttonLabel===null?Yii::t('yii','<br><u>Get a new code</u>'):$this->buttonLabel;
+			$button=$this->buttonType==='button'?'ajaxButton':'ajaxLink';
+			$html=CHtml::$button($label,$url,array('success'=>'js:function(html){jQuery("#'.$id.'").attr("src",html)}'),$this->buttonOptions);
+			$js="jQuery('img#$id').after(\"".CJavaScript::quote($html).'");';
+			$cs->registerScript('Yii.CCaptcha#'.$id,$js);
+		}
+
+		if($this->clickableImage)
+		{
+			$js="jQuery('#$id').click(function(){"
+				.CHtml::ajax(array(
+					'url'=>$url,
+					'success'=>"js:function(html){jQuery('#$id').attr('src',html)}",
+				)).'});';
+			$cs->registerScript('Yii.CCaptcha#2'.$id,$js);
+		}
+	}
+}