+ * @version $Id: ApiModel.php 3220 2011-05-13 07:56:48Z mdomba $
+ * @package system.build
+ * @since 1.0
+ */
+class ApiModel
+{
+ public $classes=array();
+ public $packages;
+
+ private $_currentClass;
+
+ public function build($sourceFiles)
+ {
+ $this->findClasses($sourceFiles);
+ $this->processClasses();
+ }
+
+ protected function findClasses($sourceFiles)
+ {
+ $this->classes=array();
+
+ foreach($sourceFiles as $file)
+ require_once($file);
+
+ $classes=array_merge(get_declared_classes(),get_declared_interfaces());
+ foreach($classes as $class)
+ {
+ $r=new ReflectionClass($class);
+ if(in_array($r->getFileName(),$sourceFiles))
+ $this->classes[$class]=true;
+ }
+ ksort($this->classes);
+ }
+
+ protected function processClasses()
+ {
+ $this->packages=array();
+ foreach($this->classes as $class=>$value)
+ {
+ $doc=$this->processClass(new ReflectionClass($class));
+ $this->classes[$class]=$doc;
+ $this->packages[$doc->package][]=$class;
+ }
+ ksort($this->packages);
+
+ // find out child classes for each class or interface
+ foreach($this->classes as $class)
+ {
+ if(isset($class->parentClasses[0]))
+ {
+ $parent=$class->parentClasses[0];
+ if(isset($this->classes[$parent]))
+ $this->classes[$parent]->subclasses[]=$class->name;
+ }
+ foreach($class->interfaces as $interface)
+ {
+ if(isset($this->classes[$interface]))
+ $this->classes[$interface]->subclasses[]=$class->name;
+ }
+ }
+ }
+
+ protected function processClass($class)
+ {
+ $doc=new ClassDoc;
+ $doc->name=$class->getName();
+ $doc->loadSource($class);
+ $this->_currentClass=$doc->name;
+ for($parent=$class;$parent=$parent->getParentClass();)
+ $doc->parentClasses[]=$parent->getName();
+ foreach($class->getInterfaces() as $interface)
+ $doc->interfaces[]=$interface->getName();
+ $doc->isInterface=$class->isInterface();
+ $doc->isAbstract=$class->isAbstract();
+ $doc->isFinal=$class->isFinal();
+ $doc->methods=$this->processMethods($class);
+ $doc->properties=$this->processProperties($class);
+ $doc->signature=($doc->isInterface?'interface ':'class ').$doc->name;
+ if($doc->isFinal)
+ $doc->signature='final '.$doc->signature;
+ if($doc->isAbstract && !$doc->isInterface)
+ $doc->signature='abstract '.$doc->signature;
+ if(in_array('CComponent',$doc->parentClasses))
+ {
+ $doc->properties=array_merge($doc->properties,$this->processComponentProperties($class));
+ $doc->events=$this->processComponentEvents($class);
+ }
+ else if(in_array('XSComponent',$doc->parentClasses))
+ {
+ $doc->properties=array_merge($doc->properties,$this->processComponentProperties($class));
+ }
+ ksort($doc->properties);
+
+ foreach($doc->properties as $property)
+ {
+ if($property->isProtected)
+ $doc->protectedPropertyCount++;
+ else
+ $doc->publicPropertyCount++;
+ if(!$property->isInherited)
+ $doc->nativePropertyCount++;
+ }
+ foreach($doc->methods as $method)
+ {
+ if($method->isProtected)
+ $doc->protectedMethodCount++;
+ else
+ $doc->publicMethodCount++;
+ if(!$method->isInherited)
+ $doc->nativeMethodCount++;
+ }
+ foreach($doc->events as $event)
+ {
+ if(!$event->isInherited)
+ $doc->nativeEventCount++;
+ }
+ $this->processComment($doc,$class->getDocComment());
+
+ return $doc;
+ }
+
+ protected function processComment($doc,$comment)
+ {
+ $comment=strtr(trim(preg_replace('/^\s*\**( |\t)?/m','',trim($comment,'/'))),"\r",'');
+ if(preg_match('/^\s*@\w+/m',$comment,$matches,PREG_OFFSET_CAPTURE))
+ {
+ $meta=substr($comment,$matches[0][1]);
+ $comment=trim(substr($comment,0,$matches[0][1]));
+ }
+ else
+ $meta='';
+ if(($pos=strpos($comment,"\n"))!==false)
+ $doc->introduction=$this->processDescription(substr($comment,0,$pos));
+ else
+ $doc->introduction=$this->processDescription($comment);
+
+ $doc->description=$this->processDescription($comment);
+
+ $this->processTags($doc,$meta);
+ }
+
+ protected function processDescription($text)
+ {
+ if(($text=trim($text))==='')
+ return '';
+ $text=preg_replace_callback('/\{@include\s+([^\s\}]+)\s*\}/s',array($this,'processInclude'),$text);
+ $text=preg_replace('/^(\r| |\t)*$/m',"
",$text);
+ $text=preg_replace_callback('/(.*?)<\/pre>/is',array($this,'processCode'),$text);
+ $text=preg_replace_callback('/\{@link\s+([^\s\}]+)(.*?)\}/s',array($this,'processLink'),$text);
+ return $text;
+ }
+
+ protected function processCode($matches)
+ {
+ $match=preg_replace('//','',$matches[1]);
+ return "".htmlspecialchars($match)."
";
+ }
+
+ protected function resolveInternalUrl($url)
+ {
+ $url=rtrim($url,'()');
+ if(($pos=strpos($url,'::'))!==false)
+ {
+ $class=substr($url,0,$pos);
+ $method=substr($url,$pos+2);
+ }
+ else if(isset($this->classes[$url]))
+ return $url;
+ else
+ {
+ $class=$this->_currentClass;
+ $method=$url;
+ }
+ return $this->getMethodUrl($class,$method);
+ }
+
+ protected function getMethodUrl($class,$method)
+ {
+ if(!isset($this->classes[$class]))
+ return '';
+ if(method_exists($class,$method) || property_exists($class,$method))
+ return $class.'::'.$method;
+ if(method_exists($class,'get'.$method) || method_exists($class,'set'.$method))
+ return $class.'::'.$method;
+ if(($parent=get_parent_class($class))!==false)
+ return $this->getMethodUrl($parent,$method);
+ else
+ return '';
+ }
+
+ protected function processLink($matches)
+ {
+ $url=$matches[1];
+ if(($text=trim($matches[2]))==='')
+ $text=$url;
+
+ if(preg_match('/^(http|ftp):\/\//i',$url)) // an external URL
+ return "$text";
+ $url=$this->resolveInternalUrl($url);
+ return $url===''?$text:'{{'.$url.'|'.$text.'}}';
+ }
+
+ protected function processInclude($matches)
+ {
+ $class=new ReflectionClass($this->_currentClass);
+ $fileName=dirname($class->getFileName()).DIRECTORY_SEPARATOR.$matches[1];
+ if(is_file($fileName))
+ return file_get_contents($fileName);
+ else
+ return $matches[0];
+ }
+
+ protected function processTags($object,$comment)
+ {
+ $tags=preg_split('/^\s*@/m',$comment,-1,PREG_SPLIT_NO_EMPTY);
+ foreach($tags as $tag)
+ {
+ $segs=preg_split('/\s+/',trim($tag),2);
+ $tagName=$segs[0];
+ $param=isset($segs[1])?trim($segs[1]):'';
+ $tagMethod='tag'.ucfirst($tagName);
+ if(method_exists($this,$tagMethod))
+ $this->$tagMethod($object,$param);
+ else if(property_exists($object,$tagName))
+ $object->$tagName=$param;
+ }
+ }
+
+ protected function processMethods($class)
+ {
+ $methods=array();
+ foreach($class->getMethods() as $method)
+ {
+ if($method->isPublic() || $method->isProtected())
+ {
+ $doc=$this->processMethod($class,$method);
+ $methods[$doc->name]=$doc;
+ }
+ }
+ ksort($methods);
+ return $methods;
+ }
+
+ protected function processMethod($class,$method)
+ {
+ $doc=new MethodDoc;
+ $doc->name=$method->getName();
+ $doc->loadSource($method);
+ $doc->definedBy=$method->getDeclaringClass()->getName();
+ $doc->isAbstract=$method->isAbstract();
+ $doc->isFinal=$method->isFinal();
+ $doc->isProtected=$method->isProtected();
+ $doc->isStatic=$method->isStatic();
+ $doc->isInherited=$doc->definedBy!==$class->getName();
+
+ $doc->input=array();
+ foreach($method->getParameters() as $param)
+ {
+ $p=new ParamDoc;
+ $p->name=$param->getName();
+ $p->isOptional=$param->isOptional();
+ if($param->isDefaultValueAvailable())
+ $p->defaultValue=$param->getDefaultValue();
+ $p->isPassedByReference=$param->isPassedByReference();
+ $doc->input[]=$p;
+ }
+ reset($doc->input);
+
+ $this->processComment($doc,$method->getDocComment());
+
+ $params=array();
+ foreach($doc->input as $param)
+ {
+ $type=empty($param->type)?'':$this->getTypeUrl($param->type).' ';
+ if($param->isOptional)
+ $params[]=$type.($param->isPassedByReference?'&':'').'$'.$param->name.'='.str_replace("\r",'',var_export($param->defaultValue,true));
+ else
+ $params[]=$type.($param->isPassedByReference?'&':'').'$'.$param->name;
+ }
+ $doc->signature='{{'.$class->name.'::'.$doc->name.'|'.$doc->name.'}}('.implode(', ',$params).')';
+ if($doc->output!==null)
+ $doc->signature=$this->getTypeUrl($doc->output->type).' '.$doc->signature;
+ else
+ $doc->signature='void '.$doc->signature;
+ if(($modifier=implode(' ',Reflection::getModifierNames($method->getModifiers())))!=='')
+ $doc->signature=$modifier.' '.$doc->signature;
+
+ return $doc;
+ }
+
+ protected function getTypeUrl($type)
+ {
+ if(isset($this->classes[$type]) && $type!==$this->_currentClass)
+ return '{{'.$type.'|'.$type.'}}';
+ else
+ return $type;
+ }
+
+ protected function processProperties($class)
+ {
+ $properties=array();
+ foreach($class->getProperties() as $property)
+ {
+ if($property->isPublic() || $property->isProtected())
+ {
+ $p=$this->processProperty($class,$property);
+ $properties[$p->name]=$p;
+ }
+ }
+ return $properties;
+ }
+
+ protected function processProperty($class,$property)
+ {
+ $doc=new PropertyDoc;
+ $doc->name=$property->getName();
+ $doc->definedBy=$property->getDeclaringClass()->getName();
+ $doc->readOnly=false;
+ $doc->isStatic=$property->isStatic();
+ $doc->isProtected=$property->isProtected();
+ $doc->isInherited=$doc->definedBy!==$class->getName();
+
+ $this->processComment($doc,$property->getDocComment());
+
+ $doc->signature='$'.$doc->name.';';
+ if($doc->type!==null)
+ $doc->signature=$this->getTypeUrl($doc->type) . ' ' . $doc->signature;
+ if(($modifier=implode(' ',Reflection::getModifierNames($property->getModifiers())))!=='')
+ $doc->signature=$modifier.' '.$doc->signature;
+
+ return $doc;
+ }
+
+ protected function processComponentProperties($class)
+ {
+ $properties=array();
+ foreach($class->getMethods() as $method)
+ {
+ if($this->isPropertyMethod($method) && ($method->isPublic() || $method->isProtected()))
+ {
+ $p=$this->processComponentProperty($class,$method);
+ $properties[$p->name]=$p;
+ }
+ }
+ return $properties;
+ }
+
+ protected function processComponentProperty($class,$method)
+ {
+ $doc=new PropertyDoc;
+ $name=$method->getName();
+ $doc->name=strtolower($name[3]).substr($name,4);
+ $doc->isProtected=$method->isProtected();
+ $doc->isStatic=false;
+ $doc->readOnly=!$class->hasMethod('set'.substr($name,3));
+ $doc->definedBy=$method->getDeclaringClass()->getName();
+ $doc->isInherited=$doc->definedBy!==$class->getName();
+ $doc->getter=$this->processMethod($class,$method);
+ if(!$doc->readOnly)
+ $doc->setter=$this->processMethod($class,$class->getMethod('set'.substr($name,3)));
+
+ $this->processComment($doc,$method->getDocComment());
+
+ return $doc;
+ }
+
+ protected function processComponentEvents($class)
+ {
+ $events=array();
+ foreach($class->getMethods() as $method)
+ {
+ if($this->isEventMethod($method) && ($method->isPublic() || $method->isProtected()))
+ {
+ $e=$this->processComponentEvent($class,$method);
+ $events[$e->name]=$e;
+ }
+ }
+ return $events;
+ }
+
+ protected function processComponentEvent($class,$method)
+ {
+ $doc=new EventDoc;
+ $doc->name=$method->getName();
+ $doc->definedBy=$method->getDeclaringClass()->getName();
+ $doc->isInherited=$doc->definedBy!==$class->getName();
+ $doc->trigger=$this->processMethod($class,$method);
+
+ $this->processComment($doc,$method->getDocComment());
+
+ return $doc;
+ }
+
+ protected function tagParam($object,$comment)
+ {
+ if($object instanceof FunctionDoc)
+ {
+ $param=current($object->input);
+ if($param!==false)
+ {
+ $segs=preg_split('/\s+/',$comment,2);
+ $param->type=$segs[0];
+ if(preg_match('/\[\s*\]/',$param->type))
+ $param->type='array';
+ if(isset($segs[1]))
+ {
+ /*
+ * remove $variablename from description
+ */
+ $segs[1]=trim(preg_replace('/^\$\w+/','',$segs[1]));
+ $param->description=$this->processDescription($segs[1]);
+ if(empty($object->introduction))
+ {
+ if(substr($object->name,0,3)=='set')
+ $object->introduction='Sets '.$param->description;
+ }
+ }
+ next($object->input);
+ }
+ }
+ }
+
+ protected function tagReturn($object,$comment)
+ {
+ $segs=preg_split('/\s+/',$comment,2);
+ if($object instanceof FunctionDoc)
+ {
+ $object->output=new ParamDoc;
+ $object->output->type=$segs[0];
+ if(isset($segs[1]))
+ {
+ $object->output->description=$this->processDescription($segs[1]);
+ if(empty($object->introduction))
+ {
+ /*
+ * If no custom introduction, add automatically
+ * with this getters introduction displayed in public methods table is resolved
+ */
+ if(substr($object->name,0,5)=='getIs')
+ $object->introduction='Checks '.$object->output->description;
+ elseif(substr($object->name,0,3)=='get')
+ $object->introduction='Returns '.$object->output->description;
+ elseif(substr($object->name,0,3)=='has')
+ $object->introduction='Determines '.$object->output->description;
+ }
+ }
+ }
+ else if($object instanceof PropertyDoc)
+ {
+ $object->type=$segs[0];
+ if(isset($segs[1]) && empty($object->description))
+ {
+ if(($pos=strpos($segs[1],'.'))!==false)
+ $object->introduction=$this->processDescription(substr($segs[1],0,$pos+1));
+ else
+ $object->introduction=$this->processDescription($segs[1]);
+ $object->description=$this->processDescription($segs[1]);
+ }
+ }
+ }
+
+ protected function tagVar($object,$comment)
+ {
+ if($object instanceof PropertyDoc)
+ {
+ $segs=preg_split('/\s+/',$comment,2);
+ $object->type=$segs[0];
+ if(isset($segs[1]) && empty($object->description))
+ {
+ if(($pos=strpos($segs[1],'.'))!==false)
+ $object->introduction=$this->processDescription(substr($segs[1],0,$pos+1));
+ else
+ $object->introduction=$this->processDescription($segs[1]);
+ $object->description=$this->processDescription($segs[1]);
+ }
+ }
+ }
+
+ protected function tagSee($object,$comment)
+ {
+ $segs=preg_split('/\s+/',trim($comment),2);
+ $matches[1]=$segs[0];
+ $matches[2]=isset($segs[1])?$segs[1]:'';
+ $object->see[]=$this->processLink($matches);
+ }
+
+ protected function isPropertyMethod($method)
+ {
+ $methodName=$method->getName();
+ return $method->getNumberOfRequiredParameters()===0
+ && !$method->isStatic()
+ && strncasecmp($methodName,'get',3)===0
+ && isset($methodName[3]);
+ }
+
+ protected function isEventMethod($method)
+ {
+ $methodName=$method->getName();
+ return strncasecmp($methodName,'on',2)===0
+ && !$method->isStatic()
+ && isset($methodName[2]);
+ }
+
+ protected function getClassFiles($basePath)
+ {
+ $files=array();
+ $folder=opendir($basePath);
+ while($file=readdir($folder))
+ {
+ if($file==='.' || $file==='..')
+ continue;
+ $fullPath=realpath($basePath.DIRECTORY_SEPARATOR.$file);
+ if($this->isValidPath($fullPath))
+ {
+ if(is_file($fullPath))
+ $files[]=$fullPath;
+ else
+ $files=array_merge($files,$this->getClassFiles($fullPath));
+ }
+ }
+ closedir($folder);
+ return $files;
+ }
+
+ protected function isValidPath($path)
+ {
+ if(is_file($path) && substr($path,-4)!=='.php')
+ return false;
+ $path=strtr($path,'\\','/');
+ foreach($this->_excludes as $exclude)
+ {
+ if(($exclude[0]==='/' && $this->_sourcePath.$exclude===$path) || ($exclude[0]!=='/' && basename($path)===$exclude))
+ return false;
+ }
+ return true;
+ }
+
+ protected function findTargets()
+ {
+ $oldClasses=get_declared_classes();
+ $oldInterfaces=get_declared_interfaces();
+ $oldFunctions=get_defined_functions();
+ $oldConstants=get_defined_constants(true);
+
+ $classFiles=$this->getClassFiles($this->_sourcePath);
+ require_once($this->_sourcePath.'/yii.php');
+ foreach($classFiles as $classFile)
+ require_once($classFile);
+
+ $classes=array_values(array_diff(get_declared_classes(),$oldClasses));
+ $interfaces=array_values(array_diff(get_declared_interfaces(),$oldInterfaces));
+ $classes=array_merge($classes,$interfaces);
+
+ $n=count($classes);
+ for($i=0;$i<$n;++$i)
+ {
+ $class=new ReflectionClass($classes[$i]);
+ $fileName=strtr($class->getFileName(),'\\','/');
+ foreach($this->_excludes as $exclude)
+ {
+ if(($exclude[0]==='/' && strpos($fileName,$this->_sourcePath.$exclude)===0))
+ {
+ unset($classes[$i]);
+ break;
+ }
+ }
+ }
+
+ sort($classes);
+ $newFunctions=get_defined_functions();
+ $newConstants=get_defined_constants(true);
+ $functions=array_values(array_diff($newFunctions['user'],$oldFunctions['user']));
+ $constants=$newConstants['user'];
+
+ return array($classes,$functions,$constants);
+ }
+
+ /*
+ * Calls checkSource for every file in $sourceFiles
+ * @param array $sourceFiles array of source file path that we need to check
+ */
+ public function check($sourceFiles)
+ {
+ echo "Checking PHPDoc @param in source files ...\n";
+ foreach($sourceFiles as $no=>$sourceFile)
+ {
+ $this->checkSource($sourceFile);
+ }
+ echo "Done.\n\n";
+ }
+
+ /*
+ * Checks @param directives in a source file
+ * Detects:
+ * missing @param directive (there is no @param directive for a function parameter)
+ * missing function parameter (@param directive exists but that parameter is not in a function declaration)
+ * missmatch parameters (if @param directive has different parameter name than a function - possible spelling error or wrong order of @param directives)
+ */
+ protected function checkSource($sourceFile)
+ {
+ $fileContent=file($sourceFile);
+
+ $docParam=array();
+ foreach($fileContent as $no=>$line)
+ {
+ /*
+ * Get lines with @param, and parameter name
+ */
+ if(preg_match('/^\s*\*\s*@param\s[A-Za-z0-9_\|]+\s(\$\w+)\s./',$line,$matches,PREG_OFFSET_CAPTURE))
+ {
+ $docParam[]=array(
+ 'docLine'=>$no+1,
+ 'docName'=>$matches[1][0],
+ );
+ continue;
+ }
+ /*
+ * If function without parameters, there should be no parameters in $docParam
+ */
+ if(preg_match('/^\s*\w+[\s\w]*\sfunction\s\w+\(\s*\)/',$line,$matches,PREG_OFFSET_CAPTURE))
+ {
+ if(isset($docParam[0])) {
+ $value=$docParam[0];
+ echo "ERROR.............: Parameter name not found!\n";
+ echo "Source file.......: ".$sourceFile."\n";
+ echo "PHPDoc line.......: ".$value['docLine']."\n";
+ echo "PHPDoc parameter..: ".$value['docName']."\n\n";
+ $docParam=array();
+ }
+ continue;
+ }
+ /*
+ * Get function variables in $matches[1][0]
+ */
+ if(preg_match('/^\s*\w+[\s\w]*\sfunction\s\w+\((.+)\)/',$line,$matches,PREG_OFFSET_CAPTURE))
+ {
+ $params=explode(",",$matches[1][0]);
+ foreach($params as $br=>$param)
+ {
+ /*
+ * Strip anything that does not begin with $ (class types) eg. CHttpRequest $request
+ */
+ $param=preg_replace('/^\w+/','',trim($param));
+ /*
+ * Strip default value if exists ex. data=array() (with spaces)
+ */
+ $param=preg_replace('/\s*=.+/','',trim($param));
+ /*
+ * Strip & if pass by reference
+ */
+ if($param[0]=='&')
+ $param=substr($param,1);
+ /*
+ * add parameter info to the docParam array
+ */
+ $docParam[$br]['parameterName']=$param;
+ $docParam[$br]['parameterLine']=$no+1;
+ }
+
+ /*
+ * All info gathered, let's make some checking
+ */
+ foreach($docParam as $value)
+ {
+ if(!isset($value['docLine']) || !isset($value['docName']) && isset($value['parameterName']))
+ {
+ echo "ERROR.............: Documentation not found!\n";
+ echo "Source file.......: ".$sourceFile."\n";
+ echo "Parameter line....: ".$value['parameterLine']."\n";
+ echo "Parameter name....: ".$value['parameterName']."\n\n";
+ }
+ if(!isset($value['parameterName']) || !isset($value['parameterLine']))
+ {
+ echo "ERROR.............: Parameter name not found!\n";
+ echo "Source file.......: ".$sourceFile."\n";
+ echo "PHPDoc line.......: ".$value['docLine']."\n";
+ echo "PHPDoc parameter..: ".$value['docName']."\n\n";
+ }
+ if( isset($value['docName']) && isset($value['parameterName']) && $value['docName']!==$value['parameterName'])
+ {
+ echo "ERROR.............: Wrong parameter order!\n";
+ echo "Source file.......: ".$sourceFile."\n";
+ echo "PHPDoc line.......: ".$value['docLine']."\n";
+ echo "PHPDoc parameter..: ".$value['docName']."\n";
+ echo "Parameter line....: ".$value['parameterLine']."\n";
+ echo "Parameter name....: ".$value['parameterName']."\n\n";
+ }
+ }
+ /*
+ * reset $docParam
+ */
+ $docParam=array();
+ }
+ }
+ }
+
+}
+
+class BaseDoc
+{
+ public $name;
+ public $since;
+ public $see;
+ public $introduction;
+ public $description;
+
+ public $sourcePath;
+ public $startLine;
+ public $endLine;
+
+ public function loadSource($reflection)
+ {
+ $this->sourcePath=str_replace('\\','/',str_replace(YII_PATH,'',$reflection->getFileName()));
+ $this->startLine=$reflection->getStartLine();
+ $this->endLine=$reflection->getEndLine();
+ }
+
+ public function getSourceUrl($baseUrl,$line=null)
+ {
+ if($line===null)
+ return $baseUrl.$this->sourcePath;
+ else
+ return $baseUrl.$this->sourcePath.'#'.$line;
+ }
+
+ public function getSourceCode()
+ {
+ $lines=file(YII_PATH.$this->sourcePath);
+ return implode("",array_slice($lines,$this->startLine-1,$this->endLine-$this->startLine+1));
+ }
+}
+
+class ClassDoc extends BaseDoc
+{
+ public $parentClasses=array();
+ public $subclasses=array();
+ public $interfaces=array();
+ public $isInterface;
+ public $isAbstract;
+ public $isFinal;
+
+ public $signature;
+
+ public $properties=array();
+ public $methods=array();
+ public $events=array();
+ public $constants=array();
+
+ public $protectedPropertyCount=0;
+ public $publicPropertyCount=0;
+ public $protectedMethodCount=0;
+ public $publicMethodCount=0;
+
+ public $nativePropertyCount=0;
+ public $nativeMethodCount=0;
+ public $nativeEventCount=0;
+
+ public $package;
+ public $version;
+}
+
+class PropertyDoc extends BaseDoc
+{
+ public $isProtected;
+ public $isStatic;
+ public $readOnly;
+ public $isInherited;
+ public $definedBy;
+
+ public $type;
+ public $signature;
+
+ public $getter;
+ public $setter;
+}
+
+class FunctionDoc extends BaseDoc
+{
+ public $signature;
+ public $input=array();
+ public $output;
+}
+
+class MethodDoc extends FunctionDoc
+{
+ public $isAbstract;
+ public $isFinal;
+ public $isProtected;
+ public $isStatic;
+ public $isInherited;
+ public $definedBy;
+}
+
+class EventDoc extends BaseDoc
+{
+ public $isInherited;
+ public $definedBy;
+ public $trigger;
+}
+
+class ParamDoc
+{
+ public $name;
+ public $description;
+ public $type;
+ public $isOptional;
+ public $defaultValue;
+ public $isPassedByReference;
+}
diff --git a/dev/commands/api/assets/css/api.css b/dev/commands/api/assets/css/api.css
new file mode 100644
index 0000000..482c04f
--- /dev/null
+++ b/dev/commands/api/assets/css/api.css
@@ -0,0 +1,105 @@
+pre {
+ color: #000000;
+ background-color: #FFF5E6;
+ font-family: "courier new", "times new roman", monospace;
+ line-height: 1.3em;
+ /* Put a nice border around it. */
+ padding: 1px;
+ width: 90%;
+ /* Don't wrap its contents, and show scrollbars. */
+ /* white-space: nowrap;*/
+ overflow: auto;
+ /* Stop after about 24 lines, and just show a scrollbar. */
+ /* max-height: 24em; */
+ margin: 5px;
+ padding-left: 20px;
+ border: 1px solid #FFE6BF;
+ border-left: 6px solid #FFE6BF;
+}
+
+div.code {
+ display: none;
+ color: #000000;
+ background-color: #FFF5E6;
+ font-family: "courier new", "times new roman", monospace;
+ line-height: 1.3em;
+ /* Put a nice border around it. */
+ padding: 1px;
+ width: 90%;
+ /* Don't wrap its contents, and show scrollbars. */
+ /* white-space: nowrap;*/
+ overflow: auto;
+ /* Stop after about 24 lines, and just show a scrollbar. */
+ /* max-height: 24em; */
+ margin: 5px;
+ padding-left: 20px;
+ border-left: 6px solid #FFE6BF;
+}
+
+table.summaryTable {
+ background: #E6ECFF;
+ border-collapse: collapse;
+ width: 100%;
+}
+
+table.summaryTable th, table.summaryTable td {
+ border: 1px #BFCFFF solid;
+ padding: 0.2em;
+}
+
+table.summaryTable th {
+ background: #CCD9FF;
+ text-align: left;
+}
+
+#nav {
+ padding: 3px;
+ margin: 0 0 10px 0;
+ border-top: 1px #BFCFFF solid;
+}
+
+#classDescription {
+ padding: 5px;
+ margin: 10px 0 20px 0;
+ border-bottom: 1px solid #BFCFFF;
+}
+
+.detailHeader {
+ font-weight: bold;
+ font-size: 12pt;
+ margin: 30px 0 5px 0;
+ border-bottom: 1px solid #BFCFFF;
+}
+
+.detailHeaderTag {
+ font-weight: normal;
+ font-size: 10pt;
+}
+
+.signature, .signature2 {
+ padding: 3px;
+ color: #000000;
+ font-family: "courier new", "times new roman", monospace;
+ line-height: 1.3em;
+}
+
+.signature {
+ margin: 10px 0 10px 0;
+ background: #E6ECFF;
+ border: 1px #BFCFFF solid;
+}
+
+.paramNameCol {
+ width: 12%;
+ font-weight: bold;
+}
+
+.paramTypeCol {
+ width: 12%;
+}
+
+.sourceCode {
+ margin: 5px 0;
+ padding:5px;
+ background:#FFF5E6;
+}
\ No newline at end of file
diff --git a/dev/commands/api/assets/css/guide.css b/dev/commands/api/assets/css/guide.css
new file mode 100644
index 0000000..b70e5c9
--- /dev/null
+++ b/dev/commands/api/assets/css/guide.css
@@ -0,0 +1,122 @@
+#guideNav { margin: 10px 0; border-top: 1px solid #ccc; padding-top: 5px; overflow: hidden; }
+#guideNav .prev { float: left; }
+#guideNav .next { float: right; }
+div.revision { color: #888; font-size: 80%; }
+div.clear { clear: both; float: none; height: 0; line-height: 0; }
+.markdown {
+ font-size: 14px;
+}
+.markdown pre {
+ background: none repeat scroll 0 0 #FCFCFC;
+ border-bottom: 1px solid #EEEEEE;
+ border-top: 1px solid #EEEEEE;
+ display: block;
+ font-family: Menlo,Consolas,"Courier New",Courier,mono;
+ font-size: 10pt;
+ margin: 1em 0;
+ padding: 1em;
+ white-space: pre-wrap;
+ word-wrap: break-word;
+}
+.markdown code, .markdown abbr {
+ border-bottom: 1px dotted #CCCCCC;
+ font-family: Menlo,Consolas,"Courier New",Courier,mono;
+}
+.markdown h1 {
+ color: #555555;
+}
+.markdown h2, .markdown h3, .markdown h4 {
+ color: #444444;
+ font-size: 1.3em;
+ margin-bottom: 0.25em;
+ margin-top: 1.5em;
+}
+.markdown h3 {
+ font-size: 1.2em;
+}
+.markdown h4 {
+ font-size: 1.15em;
+}
+.markdown .revision {
+ color: #999999;
+ font-size: 0.8em;
+ margin-top: 5em;
+}
+.markdown .tip, .markdown .info, .markdown .note {
+ background-color: #FFFAE6;
+ background-image: url("tip.gif");
+ background-position: 10px 45%;
+ background-repeat: no-repeat;
+ border-bottom: 1px solid #E4DFB8;
+ border-color: #E4DFB8;
+ border-top: 1px solid #E4DFB8;
+ margin: 1em 0;
+ padding: 1em 1em 0 55px;
+}
+.markdown .note {
+ background-color: #FFE6E6;
+ background-image: url("note.gif");
+ border-color: #D9C3C3;
+}
+.markdown .info {
+ background-color: #EBFFCE;
+ background-image: url("info.gif");
+ border-color: #B4DAA5;
+}
+.markdown .toc {
+ background-color: #F9F9F9;
+ border: 1px solid #EEEEEE;
+ float: right;
+ font-size: 0.95em;
+ line-height: 125%;
+ margin: 0.75em 0 1em 1em;
+ padding: 0.7em 1em;
+ width: 210px;
+}
+.markdown .toc ol {
+ color: #666666;
+ margin: 0.5em 0;
+}
+.markdown .toc li {
+ padding: 0.3em 0;
+}
+.markdown .toc code {
+ font-size: 0.95em;
+}
+.markdown .toc .ref {
+ margin: 0 0 0.3em;
+}
+.markdown .toc .ref.level-3 {
+ margin-left: 20px;
+}
+.markdown .anchor {
+ visibility: hidden;
+ font-size: 12px;
+ color: #666;
+}
+.markdown h2:hover .anchor, .markdown h3:hover .anchor, .markdown h4:hover .anchor {
+ visibility: visible;
+}
+.markdown .image {
+ border: 1px solid #E5E5E5;
+ margin: 1em 0;
+ text-align: center;
+}
+.markdown .image > p {
+ background: none repeat scroll 0 0 #F5F5F5;
+ margin: 0;
+ padding: 0.5em;
+ text-align: center;
+}
+.markdown .image img {
+ margin: 1em;
+}
+table.download { width: 100%; }
+table.download th, .download td {
+ border: 1px solid #DDDDDD;
+ padding: 0.2em 0.5em;
+}
+table.download th {
+ background: none repeat scroll 0 0 #EEEEEE;
+ text-align: left;
+}
diff --git a/dev/commands/api/assets/css/highlight.css b/dev/commands/api/assets/css/highlight.css
new file mode 100644
index 0000000..ba1396d
--- /dev/null
+++ b/dev/commands/api/assets/css/highlight.css
@@ -0,0 +1,383 @@
+.php-hl-default {
+ color: Black;
+}
+.php-hl-code {
+ color: Gray;
+}
+.php-hl-brackets {
+ color: Olive;
+}
+.php-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.php-hl-quotes {
+ color: red;
+}
+.php-hl-string {
+ color: Red;
+}
+.php-hl-identifier {
+ color: green;
+}
+.php-hl-builtin {
+ color: Teal;
+}
+.php-hl-reserved {
+ color: black;
+ font-weight: bold;
+}
+.php-hl-inlinedoc {
+ color: Blue;
+}
+.php-hl-var {
+ color: blue;
+}
+.php-hl-url {
+ color: Blue;
+}
+.php-hl-special {
+ color: Navy;
+}
+.php-hl-number {
+ color: Maroon;
+}
+.php-hl-inlinetags {
+ color: Blue;
+}
+.php-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+ font-size: 12px;
+}
+ol.php-hl-main pre {
+ margin: 0;
+ padding: 0;
+}
+.php-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.php-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+.xml-hl-default {
+ color: Black;
+}
+.xml-hl-code {
+ color: Gray;
+}
+.xml-hl-brackets {
+ color: Olive;
+}
+.xml-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.xml-hl-quotes {
+ color: red;
+}
+.xml-hl-string {
+ color: Red;
+}
+.xml-hl-identifier {
+ color: Blue;
+}
+.xml-hl-builtin {
+ color: Teal;
+}
+.xml-hl-reserved {
+ color: Green;
+}
+.xml-hl-inlinedoc {
+ color: Blue;
+}
+.xml-hl-var {
+ color: #000020;
+}
+.xml-hl-url {
+ color: Blue;
+}
+.xml-hl-special {
+ color: Navy;
+}
+.xml-hl-number {
+ color: Maroon;
+}
+.xml-hl-inlinetags {
+ color: Blue;
+}
+.xml-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+}
+.xml-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.xml-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+.html-hl-default {
+ color: Black;
+}
+.html-hl-code {
+ color: Gray;
+}
+.html-hl-brackets {
+ color: Olive;
+}
+.html-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.html-hl-quotes {
+ color: red;
+}
+.html-hl-string {
+ color: Red;
+}
+.html-hl-identifier {
+ color: Blue;
+}
+.html-hl-builtin {
+ color: Teal;
+}
+.html-hl-reserved {
+ color: Green;
+}
+.html-hl-inlinedoc {
+ color: Blue;
+}
+.html-hl-var {
+ color: #000020;
+}
+.html-hl-url {
+ color: Blue;
+}
+.html-hl-special {
+ color: Navy;
+}
+.html-hl-number {
+ color: Maroon;
+}
+.html-hl-inlinetags {
+ color: Blue;
+}
+.html-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+}
+.html-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.html-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+.css-hl-default {
+ color: Black;
+}
+.css-hl-code {
+ color: Gray;
+}
+.css-hl-brackets {
+ color: Olive;
+}
+.css-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.css-hl-quotes {
+ color: red;
+}
+.css-hl-string {
+ color: Red;
+}
+.css-hl-identifier {
+ color: Blue;
+}
+.css-hl-builtin {
+ color: Teal;
+}
+.css-hl-reserved {
+ color: Green;
+}
+.css-hl-inlinedoc {
+ color: Blue;
+}
+.css-hl-var {
+ color: #000020;
+}
+.css-hl-url {
+ color: Blue;
+}
+.css-hl-special {
+ color: Navy;
+}
+.css-hl-number {
+ color: Maroon;
+}
+.css-hl-inlinetags {
+ color: Blue;
+}
+.css-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+}
+.css-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.css-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+.javascript-hl-default {
+ color: Black;
+}
+.javascript-hl-code {
+ color: Gray;
+}
+.javascript-hl-brackets {
+ color: Olive;
+}
+.javascript-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.javascript-hl-quotes {
+ color: red;
+}
+.javascript-hl-string {
+ color: Red;
+}
+.javascript-hl-identifier {
+ color: Blue;
+}
+.javascript-hl-builtin {
+ color: Teal;
+}
+.javascript-hl-reserved {
+ color: Green;
+}
+.javascript-hl-inlinedoc {
+ color: Blue;
+}
+.javascript-hl-var {
+ color: #000020;
+}
+.javascript-hl-url {
+ color: Blue;
+}
+.javascript-hl-special {
+ color: Navy;
+}
+.javascript-hl-number {
+ color: Maroon;
+}
+.javascript-hl-inlinetags {
+ color: Blue;
+}
+.javascript-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+}
+.javascript-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.javascript-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+
+.sql-hl-default {
+ color: Black;
+}
+.sql-hl-code {
+ color: Gray;
+}
+.sql-hl-brackets {
+ color: Olive;
+}
+.sql-hl-comment {
+ color: #808080;
+ font-style: italic;
+}
+.sql-hl-quotes {
+ color: red;
+}
+.sql-hl-string {
+ color: Red;
+}
+.sql-hl-identifier {
+ color: Blue;
+}
+.sql-hl-builtin {
+ color: Teal;
+}
+.sql-hl-reserved {
+ color: Green;
+}
+.sql-hl-inlinedoc {
+ color: Blue;
+}
+.sql-hl-var {
+ color: #000020;
+}
+.sql-hl-url {
+ color: Blue;
+}
+.sql-hl-special {
+ color: Navy;
+}
+.sql-hl-number {
+ color: Maroon;
+}
+.sql-hl-inlinetags {
+ color: Blue;
+}
+.sql-hl-main {
+ font-family: 'Courier New', Courier, monospace;
+ font-weight: normal;
+}
+.sql-hl-gutter {
+ background-color: #999999;
+ color: White
+}
+.sql-hl-table {
+ font-family: courier;
+ font-size: 12px;
+ border: solid 1px #505050;
+}
+
+.source .copycode
+{
+ text-align: right;
+ float: right;
+}
+
+.source .copycode a
+{
+ cursor: pointer;
+ color: blue;
+}
+
+.source .copycode_hover a
+{
+ color: red;
+}
\ No newline at end of file
diff --git a/dev/commands/api/assets/css/info.gif b/dev/commands/api/assets/css/info.gif
new file mode 100644
index 0000000..7ca4e1b
Binary files /dev/null and b/dev/commands/api/assets/css/info.gif differ
diff --git a/dev/commands/api/assets/css/note.gif b/dev/commands/api/assets/css/note.gif
new file mode 100644
index 0000000..4c9c633
Binary files /dev/null and b/dev/commands/api/assets/css/note.gif differ
diff --git a/dev/commands/api/assets/css/style.css b/dev/commands/api/assets/css/style.css
new file mode 100644
index 0000000..709c8a4
--- /dev/null
+++ b/dev/commands/api/assets/css/style.css
@@ -0,0 +1,32 @@
+body
+{
+}
+
+body, div, span, p, input
+{
+ font-family: Verdana, sans-serif, Arial;
+ font-size: 10pt;
+ color: #333333;
+}
+
+#apiPage {
+}
+
+#apiHeader {
+ padding: 3px;
+ color: white;
+ background: #6078BF;
+ margin-bottom: 5px;
+ font-weight: bold;
+}
+
+#apiHeader a {
+ color: white;
+}
+
+#apiFooter {
+ margin-top: 5px;
+ padding: 3px;
+ border-top: 1px solid #BFCFFF;
+ text-align: center;
+}
diff --git a/dev/commands/api/assets/css/tip.gif b/dev/commands/api/assets/css/tip.gif
new file mode 100644
index 0000000..9356de6
Binary files /dev/null and b/dev/commands/api/assets/css/tip.gif differ
diff --git a/dev/commands/api/assets/js/jquery.js b/dev/commands/api/assets/js/jquery.js
new file mode 100644
index 0000000..88e661e
--- /dev/null
+++ b/dev/commands/api/assets/js/jquery.js
@@ -0,0 +1,3549 @@
+(function(){
+/*
+ * jQuery 1.2.6 - New Wave Javascript
+ *
+ * Copyright (c) 2008 John Resig (jquery.com)
+ * Dual licensed under the MIT (MIT-LICENSE.txt)
+ * and GPL (GPL-LICENSE.txt) licenses.
+ *
+ * $Date: 2008-05-24 14:22:17 -0400 (Sat, 24 May 2008) $
+ * $Rev: 5685 $
+ */
+
+// Map over jQuery in case of overwrite
+var _jQuery = window.jQuery,
+// Map over the $ in case of overwrite
+ _$ = window.$;
+
+var jQuery = window.jQuery = window.$ = function( selector, context ) {
+ // The jQuery object is actually just the init constructor 'enhanced'
+ return new jQuery.fn.init( selector, context );
+};
+
+// A simple way to check for HTML strings or ID strings
+// (both of which we optimize for)
+var quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#(\w+)$/,
+
+// Is it a simple selector
+ isSimple = /^.[^:#\[\.]*$/,
+
+// Will speed up references to undefined, and allows munging its name.
+ undefined;
+
+jQuery.fn = jQuery.prototype = {
+ init: function( selector, context ) {
+ // Make sure that a selection was provided
+ selector = selector || document;
+
+ // Handle $(DOMElement)
+ if ( selector.nodeType ) {
+ this[0] = selector;
+ this.length = 1;
+ return this;
+ }
+ // Handle HTML strings
+ if ( typeof selector == "string" ) {
+ // Are we dealing with HTML string or an ID?
+ var match = quickExpr.exec( selector );
+
+ // Verify a match, and that no context was specified for #id
+ if ( match && (match[1] || !context) ) {
+
+ // HANDLE: $(html) -> $(array)
+ if ( match[1] )
+ selector = jQuery.clean( [ match[1] ], context );
+
+ // HANDLE: $("#id")
+ else {
+ var elem = document.getElementById( match[3] );
+
+ // Make sure an element was located
+ if ( elem ){
+ // Handle the case where IE and Opera return items
+ // by name instead of ID
+ if ( elem.id != match[3] )
+ return jQuery().find( selector );
+
+ // Otherwise, we inject the element directly into the jQuery object
+ return jQuery( elem );
+ }
+ selector = [];
+ }
+
+ // HANDLE: $(expr, [context])
+ // (which is just equivalent to: $(content).find(expr)
+ } else
+ return jQuery( context ).find( selector );
+
+ // HANDLE: $(function)
+ // Shortcut for document ready
+ } else if ( jQuery.isFunction( selector ) )
+ return jQuery( document )[ jQuery.fn.ready ? "ready" : "load" ]( selector );
+
+ return this.setArray(jQuery.makeArray(selector));
+ },
+
+ // The current version of jQuery being used
+ jquery: "1.2.6",
+
+ // The number of elements contained in the matched element set
+ size: function() {
+ return this.length;
+ },
+
+ // The number of elements contained in the matched element set
+ length: 0,
+
+ // Get the Nth element in the matched element set OR
+ // Get the whole matched element set as a clean array
+ get: function( num ) {
+ return num == undefined ?
+
+ // Return a 'clean' array
+ jQuery.makeArray( this ) :
+
+ // Return just the object
+ this[ num ];
+ },
+
+ // Take an array of elements and push it onto the stack
+ // (returning the new matched element set)
+ pushStack: function( elems ) {
+ // Build a new jQuery matched element set
+ var ret = jQuery( elems );
+
+ // Add the old object onto the stack (as a reference)
+ ret.prevObject = this;
+
+ // Return the newly-formed element set
+ return ret;
+ },
+
+ // Force the current matched set of elements to become
+ // the specified array of elements (destroying the stack in the process)
+ // You should use pushStack() in order to do this, but maintain the stack
+ setArray: function( elems ) {
+ // Resetting the length to 0, then using the native Array push
+ // is a super-fast way to populate an object with array-like properties
+ this.length = 0;
+ Array.prototype.push.apply( this, elems );
+
+ return this;
+ },
+
+ // Execute a callback for every element in the matched set.
+ // (You can seed the arguments with an array of args, but this is
+ // only used internally.)
+ each: function( callback, args ) {
+ return jQuery.each( this, callback, args );
+ },
+
+ // Determine the position of an element within
+ // the matched set of elements
+ index: function( elem ) {
+ var ret = -1;
+
+ // Locate the position of the desired element
+ return jQuery.inArray(
+ // If it receives a jQuery object, the first element is used
+ elem && elem.jquery ? elem[0] : elem
+ , this );
+ },
+
+ attr: function( name, value, type ) {
+ var options = name;
+
+ // Look for the case where we're accessing a style value
+ if ( name.constructor == String )
+ if ( value === undefined )
+ return this[0] && jQuery[ type || "attr" ]( this[0], name );
+
+ else {
+ options = {};
+ options[ name ] = value;
+ }
+
+ // Check to see if we're setting style values
+ return this.each(function(i){
+ // Set all the styles
+ for ( name in options )
+ jQuery.attr(
+ type ?
+ this.style :
+ this,
+ name, jQuery.prop( this, options[ name ], type, i, name )
+ );
+ });
+ },
+
+ css: function( key, value ) {
+ // ignore negative width and height values
+ if ( (key == 'width' || key == 'height') && parseFloat(value) < 0 )
+ value = undefined;
+ return this.attr( key, value, "curCSS" );
+ },
+
+ text: function( text ) {
+ if ( typeof text != "object" && text != null )
+ return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) );
+
+ var ret = "";
+
+ jQuery.each( text || this, function(){
+ jQuery.each( this.childNodes, function(){
+ if ( this.nodeType != 8 )
+ ret += this.nodeType != 1 ?
+ this.nodeValue :
+ jQuery.fn.text( [ this ] );
+ });
+ });
+
+ return ret;
+ },
+
+ wrapAll: function( html ) {
+ if ( this[0] )
+ // The elements to wrap the target around
+ jQuery( html, this[0].ownerDocument )
+ .clone()
+ .insertBefore( this[0] )
+ .map(function(){
+ var elem = this;
+
+ while ( elem.firstChild )
+ elem = elem.firstChild;
+
+ return elem;
+ })
+ .append(this);
+
+ return this;
+ },
+
+ wrapInner: function( html ) {
+ return this.each(function(){
+ jQuery( this ).contents().wrapAll( html );
+ });
+ },
+
+ wrap: function( html ) {
+ return this.each(function(){
+ jQuery( this ).wrapAll( html );
+ });
+ },
+
+ append: function() {
+ return this.domManip(arguments, true, false, function(elem){
+ if (this.nodeType == 1)
+ this.appendChild( elem );
+ });
+ },
+
+ prepend: function() {
+ return this.domManip(arguments, true, true, function(elem){
+ if (this.nodeType == 1)
+ this.insertBefore( elem, this.firstChild );
+ });
+ },
+
+ before: function() {
+ return this.domManip(arguments, false, false, function(elem){
+ this.parentNode.insertBefore( elem, this );
+ });
+ },
+
+ after: function() {
+ return this.domManip(arguments, false, true, function(elem){
+ this.parentNode.insertBefore( elem, this.nextSibling );
+ });
+ },
+
+ end: function() {
+ return this.prevObject || jQuery( [] );
+ },
+
+ find: function( selector ) {
+ var elems = jQuery.map(this, function(elem){
+ return jQuery.find( selector, elem );
+ });
+
+ return this.pushStack( /[^+>] [^+>]/.test( selector ) || selector.indexOf("..") > -1 ?
+ jQuery.unique( elems ) :
+ elems );
+ },
+
+ clone: function( events ) {
+ // Do the clone
+ var ret = this.map(function(){
+ if ( jQuery.browser.msie && !jQuery.isXMLDoc(this) ) {
+ // IE copies events bound via attachEvent when
+ // using cloneNode. Calling detachEvent on the
+ // clone will also remove the events from the orignal
+ // In order to get around this, we use innerHTML.
+ // Unfortunately, this means some modifications to
+ // attributes in IE that are actually only stored
+ // as properties will not be copied (such as the
+ // the name attribute on an input).
+ var clone = this.cloneNode(true),
+ container = document.createElement("div");
+ container.appendChild(clone);
+ return jQuery.clean([container.innerHTML])[0];
+ } else
+ return this.cloneNode(true);
+ });
+
+ // Need to set the expando to null on the cloned set if it exists
+ // removeData doesn't work here, IE removes it from the original as well
+ // this is primarily for IE but the data expando shouldn't be copied over in any browser
+ var clone = ret.find("*").andSelf().each(function(){
+ if ( this[ expando ] != undefined )
+ this[ expando ] = null;
+ });
+
+ // Copy the events from the original to the clone
+ if ( events === true )
+ this.find("*").andSelf().each(function(i){
+ if (this.nodeType == 3)
+ return;
+ var events = jQuery.data( this, "events" );
+
+ for ( var type in events )
+ for ( var handler in events[ type ] )
+ jQuery.event.add( clone[ i ], type, events[ type ][ handler ], events[ type ][ handler ].data );
+ });
+
+ // Return the cloned set
+ return ret;
+ },
+
+ filter: function( selector ) {
+ return this.pushStack(
+ jQuery.isFunction( selector ) &&
+ jQuery.grep(this, function(elem, i){
+ return selector.call( elem, i );
+ }) ||
+
+ jQuery.multiFilter( selector, this ) );
+ },
+
+ not: function( selector ) {
+ if ( selector.constructor == String )
+ // test special case where just one selector is passed in
+ if ( isSimple.test( selector ) )
+ return this.pushStack( jQuery.multiFilter( selector, this, true ) );
+ else
+ selector = jQuery.multiFilter( selector, this );
+
+ var isArrayLike = selector.length && selector[selector.length - 1] !== undefined && !selector.nodeType;
+ return this.filter(function() {
+ return isArrayLike ? jQuery.inArray( this, selector ) < 0 : this != selector;
+ });
+ },
+
+ add: function( selector ) {
+ return this.pushStack( jQuery.unique( jQuery.merge(
+ this.get(),
+ typeof selector == 'string' ?
+ jQuery( selector ) :
+ jQuery.makeArray( selector )
+ )));
+ },
+
+ is: function( selector ) {
+ return !!selector && jQuery.multiFilter( selector, this ).length > 0;
+ },
+
+ hasClass: function( selector ) {
+ return this.is( "." + selector );
+ },
+
+ val: function( value ) {
+ if ( value == undefined ) {
+
+ if ( this.length ) {
+ var elem = this[0];
+
+ // We need to handle select boxes special
+ if ( jQuery.nodeName( elem, "select" ) ) {
+ var index = elem.selectedIndex,
+ values = [],
+ options = elem.options,
+ one = elem.type == "select-one";
+
+ // Nothing was selected
+ if ( index < 0 )
+ return null;
+
+ // Loop through all the selected options
+ for ( var i = one ? index : 0, max = one ? index + 1 : options.length; i < max; i++ ) {
+ var option = options[ i ];
+
+ if ( option.selected ) {
+ // Get the specifc value for the option
+ value = jQuery.browser.msie && !option.attributes.value.specified ? option.text : option.value;
+
+ // We don't need an array for one selects
+ if ( one )
+ return value;
+
+ // Multi-Selects return an array
+ values.push( value );
+ }
+ }
+
+ return values;
+
+ // Everything else, we just grab the value
+ } else
+ return (this[0].value || "").replace(/\r/g, "");
+
+ }
+
+ return undefined;
+ }
+
+ if( value.constructor == Number )
+ value += '';
+
+ return this.each(function(){
+ if ( this.nodeType != 1 )
+ return;
+
+ if ( value.constructor == Array && /radio|checkbox/.test( this.type ) )
+ this.checked = (jQuery.inArray(this.value, value) >= 0 ||
+ jQuery.inArray(this.name, value) >= 0);
+
+ else if ( jQuery.nodeName( this, "select" ) ) {
+ var values = jQuery.makeArray(value);
+
+ jQuery( "option", this ).each(function(){
+ this.selected = (jQuery.inArray( this.value, values ) >= 0 ||
+ jQuery.inArray( this.text, values ) >= 0);
+ });
+
+ if ( !values.length )
+ this.selectedIndex = -1;
+
+ } else
+ this.value = value;
+ });
+ },
+
+ html: function( value ) {
+ return value == undefined ?
+ (this[0] ?
+ this[0].innerHTML :
+ null) :
+ this.empty().append( value );
+ },
+
+ replaceWith: function( value ) {
+ return this.after( value ).remove();
+ },
+
+ eq: function( i ) {
+ return this.slice( i, i + 1 );
+ },
+
+ slice: function() {
+ return this.pushStack( Array.prototype.slice.apply( this, arguments ) );
+ },
+
+ map: function( callback ) {
+ return this.pushStack( jQuery.map(this, function(elem, i){
+ return callback.call( elem, i, elem );
+ }));
+ },
+
+ andSelf: function() {
+ return this.add( this.prevObject );
+ },
+
+ data: function( key, value ){
+ var parts = key.split(".");
+ parts[1] = parts[1] ? "." + parts[1] : "";
+
+ if ( value === undefined ) {
+ var data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]);
+
+ if ( data === undefined && this.length )
+ data = jQuery.data( this[0], key );
+
+ return data === undefined && parts[1] ?
+ this.data( parts[0] ) :
+ data;
+ } else
+ return this.trigger("setData" + parts[1] + "!", [parts[0], value]).each(function(){
+ jQuery.data( this, key, value );
+ });
+ },
+
+ removeData: function( key ){
+ return this.each(function(){
+ jQuery.removeData( this, key );
+ });
+ },
+
+ domManip: function( args, table, reverse, callback ) {
+ var clone = this.length > 1, elems;
+
+ return this.each(function(){
+ if ( !elems ) {
+ elems = jQuery.clean( args, this.ownerDocument );
+
+ if ( reverse )
+ elems.reverse();
+ }
+
+ var obj = this;
+
+ if ( table && jQuery.nodeName( this, "table" ) && jQuery.nodeName( elems[0], "tr" ) )
+ obj = this.getElementsByTagName("tbody")[0] || this.appendChild( this.ownerDocument.createElement("tbody") );
+
+ var scripts = jQuery( [] );
+
+ jQuery.each(elems, function(){
+ var elem = clone ?
+ jQuery( this ).clone( true )[0] :
+ this;
+
+ // execute all scripts after the elements have been injected
+ if ( jQuery.nodeName( elem, "script" ) )
+ scripts = scripts.add( elem );
+ else {
+ // Remove any inner scripts for later evaluation
+ if ( elem.nodeType == 1 )
+ scripts = scripts.add( jQuery( "script", elem ).remove() );
+
+ // Inject the elements into the document
+ callback.call( obj, elem );
+ }
+ });
+
+ scripts.each( evalScript );
+ });
+ }
+};
+
+// Give the init function the jQuery prototype for later instantiation
+jQuery.fn.init.prototype = jQuery.fn;
+
+function evalScript( i, elem ) {
+ if ( elem.src )
+ jQuery.ajax({
+ url: elem.src,
+ async: false,
+ dataType: "script"
+ });
+
+ else
+ jQuery.globalEval( elem.text || elem.textContent || elem.innerHTML || "" );
+
+ if ( elem.parentNode )
+ elem.parentNode.removeChild( elem );
+}
+
+function now(){
+ return +new Date;
+}
+
+jQuery.extend = jQuery.fn.extend = function() {
+ // copy reference to target object
+ var target = arguments[0] || {}, i = 1, length = arguments.length, deep = false, options;
+
+ // Handle a deep copy situation
+ if ( target.constructor == Boolean ) {
+ deep = target;
+ target = arguments[1] || {};
+ // skip the boolean and the target
+ i = 2;
+ }
+
+ // Handle case when target is a string or something (possible in deep copy)
+ if ( typeof target != "object" && typeof target != "function" )
+ target = {};
+
+ // extend jQuery itself if only one argument is passed
+ if ( length == i ) {
+ target = this;
+ --i;
+ }
+
+ for ( ; i < length; i++ )
+ // Only deal with non-null/undefined values
+ if ( (options = arguments[ i ]) != null )
+ // Extend the base object
+ for ( var name in options ) {
+ var src = target[ name ], copy = options[ name ];
+
+ // Prevent never-ending loop
+ if ( target === copy )
+ continue;
+
+ // Recurse if we're merging object values
+ if ( deep && copy && typeof copy == "object" && !copy.nodeType )
+ target[ name ] = jQuery.extend( deep,
+ // Never move original objects, clone them
+ src || ( copy.length != null ? [ ] : { } )
+ , copy );
+
+ // Don't bring in undefined values
+ else if ( copy !== undefined )
+ target[ name ] = copy;
+
+ }
+
+ // Return the modified object
+ return target;
+};
+
+var expando = "jQuery" + now(), uuid = 0, windowData = {},
+ // exclude the following css properties to add px
+ exclude = /z-?index|font-?weight|opacity|zoom|line-?height/i,
+ // cache defaultView
+ defaultView = document.defaultView || {};
+
+jQuery.extend({
+ noConflict: function( deep ) {
+ window.$ = _$;
+
+ if ( deep )
+ window.jQuery = _jQuery;
+
+ return jQuery;
+ },
+
+ // See test/unit/core.js for details concerning this function.
+ isFunction: function( fn ) {
+ return !!fn && typeof fn != "string" && !fn.nodeName &&
+ fn.constructor != Array && /^[\s[]?function/.test( fn + "" );
+ },
+
+ // check if an element is in a (or is an) XML document
+ isXMLDoc: function( elem ) {
+ return elem.documentElement && !elem.body ||
+ elem.tagName && elem.ownerDocument && !elem.ownerDocument.body;
+ },
+
+ // Evalulates a script in a global context
+ globalEval: function( data ) {
+ data = jQuery.trim( data );
+
+ if ( data ) {
+ // Inspired by code by Andrea Giammarchi
+ // http://webreflection.blogspot.com/2007/08/global-scope-evaluation-and-dom.html
+ var head = document.getElementsByTagName("head")[0] || document.documentElement,
+ script = document.createElement("script");
+
+ script.type = "text/javascript";
+ if ( jQuery.browser.msie )
+ script.text = data;
+ else
+ script.appendChild( document.createTextNode( data ) );
+
+ // Use insertBefore instead of appendChild to circumvent an IE6 bug.
+ // This arises when a base node is used (#2709).
+ head.insertBefore( script, head.firstChild );
+ head.removeChild( script );
+ }
+ },
+
+ nodeName: function( elem, name ) {
+ return elem.nodeName && elem.nodeName.toUpperCase() == name.toUpperCase();
+ },
+
+ cache: {},
+
+ data: function( elem, name, data ) {
+ elem = elem == window ?
+ windowData :
+ elem;
+
+ var id = elem[ expando ];
+
+ // Compute a unique ID for the element
+ if ( !id )
+ id = elem[ expando ] = ++uuid;
+
+ // Only generate the data cache if we're
+ // trying to access or manipulate it
+ if ( name && !jQuery.cache[ id ] )
+ jQuery.cache[ id ] = {};
+
+ // Prevent overriding the named cache with undefined values
+ if ( data !== undefined )
+ jQuery.cache[ id ][ name ] = data;
+
+ // Return the named cache data, or the ID for the element
+ return name ?
+ jQuery.cache[ id ][ name ] :
+ id;
+ },
+
+ removeData: function( elem, name ) {
+ elem = elem == window ?
+ windowData :
+ elem;
+
+ var id = elem[ expando ];
+
+ // If we want to remove a specific section of the element's data
+ if ( name ) {
+ if ( jQuery.cache[ id ] ) {
+ // Remove the section of cache data
+ delete jQuery.cache[ id ][ name ];
+
+ // If we've removed all the data, remove the element's cache
+ name = "";
+
+ for ( name in jQuery.cache[ id ] )
+ break;
+
+ if ( !name )
+ jQuery.removeData( elem );
+ }
+
+ // Otherwise, we want to remove all of the element's data
+ } else {
+ // Clean up the element expando
+ try {
+ delete elem[ expando ];
+ } catch(e){
+ // IE has trouble directly removing the expando
+ // but it's ok with using removeAttribute
+ if ( elem.removeAttribute )
+ elem.removeAttribute( expando );
+ }
+
+ // Completely remove the data cache
+ delete jQuery.cache[ id ];
+ }
+ },
+
+ // args is for internal usage only
+ each: function( object, callback, args ) {
+ var name, i = 0, length = object.length;
+
+ if ( args ) {
+ if ( length == undefined ) {
+ for ( name in object )
+ if ( callback.apply( object[ name ], args ) === false )
+ break;
+ } else
+ for ( ; i < length; )
+ if ( callback.apply( object[ i++ ], args ) === false )
+ break;
+
+ // A special, fast, case for the most common use of each
+ } else {
+ if ( length == undefined ) {
+ for ( name in object )
+ if ( callback.call( object[ name ], name, object[ name ] ) === false )
+ break;
+ } else
+ for ( var value = object[0];
+ i < length && callback.call( value, i, value ) !== false; value = object[++i] ){}
+ }
+
+ return object;
+ },
+
+ prop: function( elem, value, type, i, name ) {
+ // Handle executable functions
+ if ( jQuery.isFunction( value ) )
+ value = value.call( elem, i );
+
+ // Handle passing in a number to a CSS property
+ return value && value.constructor == Number && type == "curCSS" && !exclude.test( name ) ?
+ value + "px" :
+ value;
+ },
+
+ className: {
+ // internal only, use addClass("class")
+ add: function( elem, classNames ) {
+ jQuery.each((classNames || "").split(/\s+/), function(i, className){
+ if ( elem.nodeType == 1 && !jQuery.className.has( elem.className, className ) )
+ elem.className += (elem.className ? " " : "") + className;
+ });
+ },
+
+ // internal only, use removeClass("class")
+ remove: function( elem, classNames ) {
+ if (elem.nodeType == 1)
+ elem.className = classNames != undefined ?
+ jQuery.grep(elem.className.split(/\s+/), function(className){
+ return !jQuery.className.has( classNames, className );
+ }).join(" ") :
+ "";
+ },
+
+ // internal only, use hasClass("class")
+ has: function( elem, className ) {
+ return jQuery.inArray( className, (elem.className || elem).toString().split(/\s+/) ) > -1;
+ }
+ },
+
+ // A method for quickly swapping in/out CSS properties to get correct calculations
+ swap: function( elem, options, callback ) {
+ var old = {};
+ // Remember the old values, and insert the new ones
+ for ( var name in options ) {
+ old[ name ] = elem.style[ name ];
+ elem.style[ name ] = options[ name ];
+ }
+
+ callback.call( elem );
+
+ // Revert the old values
+ for ( var name in options )
+ elem.style[ name ] = old[ name ];
+ },
+
+ css: function( elem, name, force ) {
+ if ( name == "width" || name == "height" ) {
+ var val, props = { position: "absolute", visibility: "hidden", display:"block" }, which = name == "width" ? [ "Left", "Right" ] : [ "Top", "Bottom" ];
+
+ function getWH() {
+ val = name == "width" ? elem.offsetWidth : elem.offsetHeight;
+ var padding = 0, border = 0;
+ jQuery.each( which, function() {
+ padding += parseFloat(jQuery.curCSS( elem, "padding" + this, true)) || 0;
+ border += parseFloat(jQuery.curCSS( elem, "border" + this + "Width", true)) || 0;
+ });
+ val -= Math.round(padding + border);
+ }
+
+ if ( jQuery(elem).is(":visible") )
+ getWH();
+ else
+ jQuery.swap( elem, props, getWH );
+
+ return Math.max(0, val);
+ }
+
+ return jQuery.curCSS( elem, name, force );
+ },
+
+ curCSS: function( elem, name, force ) {
+ var ret, style = elem.style;
+
+ // A helper method for determining if an element's values are broken
+ function color( elem ) {
+ if ( !jQuery.browser.safari )
+ return false;
+
+ // defaultView is cached
+ var ret = defaultView.getComputedStyle( elem, null );
+ return !ret || ret.getPropertyValue("color") == "";
+ }
+
+ // We need to handle opacity special in IE
+ if ( name == "opacity" && jQuery.browser.msie ) {
+ ret = jQuery.attr( style, "opacity" );
+
+ return ret == "" ?
+ "1" :
+ ret;
+ }
+ // Opera sometimes will give the wrong display answer, this fixes it, see #2037
+ if ( jQuery.browser.opera && name == "display" ) {
+ var save = style.outline;
+ style.outline = "0 solid black";
+ style.outline = save;
+ }
+
+ // Make sure we're using the right name for getting the float value
+ if ( name.match( /float/i ) )
+ name = styleFloat;
+
+ if ( !force && style && style[ name ] )
+ ret = style[ name ];
+
+ else if ( defaultView.getComputedStyle ) {
+
+ // Only "float" is needed here
+ if ( name.match( /float/i ) )
+ name = "float";
+
+ name = name.replace( /([A-Z])/g, "-$1" ).toLowerCase();
+
+ var computedStyle = defaultView.getComputedStyle( elem, null );
+
+ if ( computedStyle && !color( elem ) )
+ ret = computedStyle.getPropertyValue( name );
+
+ // If the element isn't reporting its values properly in Safari
+ // then some display: none elements are involved
+ else {
+ var swap = [], stack = [], a = elem, i = 0;
+
+ // Locate all of the parent display: none elements
+ for ( ; a && color(a); a = a.parentNode )
+ stack.unshift(a);
+
+ // Go through and make them visible, but in reverse
+ // (It would be better if we knew the exact display type that they had)
+ for ( ; i < stack.length; i++ )
+ if ( color( stack[ i ] ) ) {
+ swap[ i ] = stack[ i ].style.display;
+ stack[ i ].style.display = "block";
+ }
+
+ // Since we flip the display style, we have to handle that
+ // one special, otherwise get the value
+ ret = name == "display" && swap[ stack.length - 1 ] != null ?
+ "none" :
+ ( computedStyle && computedStyle.getPropertyValue( name ) ) || "";
+
+ // Finally, revert the display styles back
+ for ( i = 0; i < swap.length; i++ )
+ if ( swap[ i ] != null )
+ stack[ i ].style.display = swap[ i ];
+ }
+
+ // We should always get a number back from opacity
+ if ( name == "opacity" && ret == "" )
+ ret = "1";
+
+ } else if ( elem.currentStyle ) {
+ var camelCase = name.replace(/\-(\w)/g, function(all, letter){
+ return letter.toUpperCase();
+ });
+
+ ret = elem.currentStyle[ name ] || elem.currentStyle[ camelCase ];
+
+ // From the awesome hack by Dean Edwards
+ // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
+
+ // If we're not dealing with a regular pixel number
+ // but a number that has a weird ending, we need to convert it to pixels
+ if ( !/^\d+(px)?$/i.test( ret ) && /^\d/.test( ret ) ) {
+ // Remember the original values
+ var left = style.left, rsLeft = elem.runtimeStyle.left;
+
+ // Put in the new values to get a computed value out
+ elem.runtimeStyle.left = elem.currentStyle.left;
+ style.left = ret || 0;
+ ret = style.pixelLeft + "px";
+
+ // Revert the changed values
+ style.left = left;
+ elem.runtimeStyle.left = rsLeft;
+ }
+ }
+
+ return ret;
+ },
+
+ clean: function( elems, context ) {
+ var ret = [];
+ context = context || document;
+ // !context.createElement fails in IE with an error but returns typeof 'object'
+ if (typeof context.createElement == 'undefined')
+ context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
+
+ jQuery.each(elems, function(i, elem){
+ if ( !elem )
+ return;
+
+ if ( elem.constructor == Number )
+ elem += '';
+
+ // Convert html string into DOM nodes
+ if ( typeof elem == "string" ) {
+ // Fix "XHTML"-style tags in all browsers
+ elem = elem.replace(/(<(\w+)[^>]*?)\/>/g, function(all, front, tag){
+ return tag.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i) ?
+ all :
+ front + ">";
+ });
+
+ // Trim whitespace, otherwise indexOf won't work as expected
+ var tags = jQuery.trim( elem ).toLowerCase(), div = context.createElement("div");
+
+ var wrap =
+ // option or optgroup
+ !tags.indexOf("", "" ] ||
+
+ !tags.indexOf("", "" ] ||
+
+ tags.match(/^<(thead|tbody|tfoot|colg|cap)/) &&
+ [ 1, "" ] ||
+
+ !tags.indexOf("", "" ] ||
+
+ // matched above
+ (!tags.indexOf("", "
" ] ||
+
+ !tags.indexOf("", "" ] ||
+
+ // IE can't serialize and
+<?php echo $this->pageTitle; ?>
+
+
+
+
+
+