Index: trunk/core/kernel/processors/main_processor.php
===================================================================
diff -u -r932 -r934
--- trunk/core/kernel/processors/main_processor.php	(.../main_processor.php)	(revision 932)
+++ trunk/core/kernel/processors/main_processor.php	(.../main_processor.php)	(revision 934)
@@ -24,13 +24,21 @@
 		return parent::ProcessTag($tag);
 	}
 	
+	/**
+	 * Creates <base href ..> HTML tag for all templates
+	 * affects future css, js files and href params of links
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function Base_Ref($params)
 	{
 		$templates_path = substr(THEMES_PATH,1);
 		return "<base href='".$this->Application->BaseURL().$templates_path."/'>";
 	}
 	
-	function Base_URL($params)
+	/*function Base_URL($params)
 	{
 		$templates_path = substr(THEMES_PATH,1);
 		return $this->Application->BaseURL().$templates_path;
@@ -39,22 +47,18 @@
 	function Base($params)
 	{
 		return $this->Application->BaseURL().$params['add'];
-	}
-	
+	}*/
+
 	/**
-	 * Returns sid of current object
+	 * Used to create link to any template.
+	 * use "pass" paramter if "t" tag to specify
+	 * prefix & special of object to be represented
+	 * in resulting url
 	 *
 	 * @param Array $params
-	 * @return int
-	 * @todo Is really called ?
+	 * @return string
+	 * @access public
 	 */
-	/*function Sid($params)
-	{
-		$session =& $this->Application->recallObject('Session');
-		return $session->GetId();
-	}*/
-	
-	//NEEDS TEST
 	function T($params)
 	{
 		if(!isset($params['pass'])) $params['pass']='';
@@ -63,7 +67,7 @@
 		return $this->Application->HREF($t, isset($params['prefix']) ? $params['prefix'] : '');
 	}
 	
-	// NEEDS TEST
+	/*// NEEDS TEST
 	function Config($params)
 	{
 		return $this->Application->ConfigOption($params['var']);
@@ -83,18 +87,41 @@
 		}
 		else
 			echo "Object $name does not exist in the appliaction<br>";
-	}
+	}*/
 	
+	/**
+	 * Tag, that always returns true.
+	 * For parser testing purposes
+	 *
+	 * @param Array $params
+	 * @return bool
+	 * @access public
+	 */
 	function True($params)
 	{
 		return true;
 	}
 	
+	/**
+	 * Tag, that always returns false.
+	 * For parser testing purposes
+	 *
+	 * @param Array $params
+	 * @return bool
+	 * @access public
+	 */
 	function False($params)
 	{
 		return false;
 	}
 	
+	/**
+	 * Returns block parameter by name
+	 *
+	 * @param Array $params
+	 * @return stirng
+	 * @access public
+	 */
 	function Param($params)
 	{
 		//$parser =& $this->Application->recallObject('TemplateParser');
@@ -105,6 +132,13 @@
 		return $res;
 	}
 		
+	/**
+	 * Compares block parameter with value specified
+	 *
+	 * @param Array $params
+	 * @return bool
+	 * @access public
+	 */
 	function Param_Equals($params)
 	{
 		//$parser =& $this->Application->recallObject('TemplateParser');
@@ -113,104 +147,126 @@
 		return ($this->Application->Parser->GetParam($name) == $value);
 	}
 	
-	/**
-	 * Returns hidden field for template name
-	 *
-	 * @param Array $params
-	 * @return string
-	 * @todo Is really called ?
-	 */
-	/*function Hidden_t($params)
+	/*function PHP_Self($params)
 	{
-		return "<input type=hidden name='t' value='".$this->Application->GetVar('t')."'>";
-	}*/
+		return $HTTP_SERVER_VARS['PHP_SELF'];
+	}
+	*/
 	
 	/**
-	 * Returns hidden field for SID
+	 * Not tag, method for parameter
+	 * selection from list in this TagProcessor
 	 *
 	 * @param Array $params
+	 * @param string $possible_names
 	 * @return string
-	 * @todo Is really called ?
+	 * @access public
 	 */
-	/*function Hidden_SID($params)
-	{
-		$session =& $this->Application->recallObject('Session');
-		return "<input type=hidden name='sid' value='".$session->GetID()."'>";
-	}*/
-	
-	function PHP_Self($params)
-	{
-		return $HTTP_SERVER_VARS['PHP_SELF'];
-	}
-	
 	function SelectParam($params, $possible_names)
 	{
 		if (!is_array($params)) return;
 		if (!is_array($possible_names))
-			$possible_names = explode(',', $possible_names);
-		foreach ($possible_names as $name) {
-			if (array_key_exists($name, $params)) return $params[$name];
+		
+		$possible_names = explode(',', $possible_names);
+		foreach ($possible_names as $name)
+		{
+			if( isset($params[$name]) ) return $params[$name];
 		}
 		return false;
 	}
 	
+	/**
+	 * Returns session variable value by name
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function Recall($params)
 	{
-		$res = $this->Application->RecallVar($this->SelectParam($params, 'name,var,param'));
-		if ($res === false && isset($params['no_null']))
-			return '';
-		else
-			return $res;
+		$res = $this->Application->RecallVar( $this->SelectParam($params,'name,var,param') );
+		return ($res === false && isset($params['no_null']))?'':$res;
 	}
 
-	function Store($params)
+	// bad style to store something from template to session !!! (by Alex)
+	/*function Store($params)
 	{
 		//echo"Store $params[name]<br>";
 		$name = $params['name'];
 		$value = $params['value'];
 		$this->Application->StoreVar($name,$value);
-	}
+	}*/
 	
+	/**
+	 * Sets application variable value(-s)
+	 *
+	 * @param Array $params
+	 * @access public
+	 */
 	function Set($params)
 	{
 		foreach ($params as $param => $value) {
 			$this->Application->SetVar($param, $value);
 		}
 	}
 	
+	/**
+	 * Increment application variable
+	 * specified by number specified
+	 *
+	 * @param Array $params
+	 * @access public
+	 */
 	function Inc($params)
 	{
 		$this->Application->SetVar($params['param'], $this->Application->GetVar($params['param']) + $params['by']);
 	}
 	
+	/**
+	 * Retrieves application variable
+	 * value by name
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function Get($params)
 	{
 		return $this->Application->GetVar($this->SelectParam($params, 'name,var,param'), EMPTY_ON_NULL);
 	}
 	
-	function Config_Equals($params)
+	/*function Config_Equals($params)
 	{
 		foreach ($params as $name => $val) {
 			if (in_array($name, Array( 'prefix', 'function'))) continue;
 			return $this->Application->ConfigOption($name) == $val;
 		}
 		return false;
-	}
+	}*/
 	
+	/**
+	 * Creates all hidden fields
+	 * needed for kernel_form
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function DumpSystemInfo($params)
 	{
 		$actions =& $this->Application->recallObject('kActions');
 		$actions->Set('t', $this->Application->GetVar('t') );
 		
 		$params = $actions->GetParams();
-		$o = '';
-		foreach ($params AS $name => $val) {
+		$o='';
+		foreach ($params AS $name => $val)
+		{
 			$o .= "<input type='hidden' name='$name' id='$name' value='$val'>\n";
 		}
 		return $o;
 	}
 	
-	function Odd_Even($params)
+	/*function Odd_Even($params)
 	{
 		$odd = $params['odd'];
 		$even = $params['even'];
@@ -223,8 +279,15 @@
 			$this->Session->SetProperty('odd_even', 'even');
 			return $odd;
 		}
-	}
+	}*/
 	
+	/**
+	 * Returns phrase translation by name
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function Phrase($params)
 	{
 		// m:phrase name="phrase_name" default="Tr-alala" updated="2004-01-29 12:49"
@@ -257,13 +320,31 @@
 		return $this->is_active($params);
 	}
 	
+	/**
+	 * Checks if session variable
+	 * specified by name value match
+	 * value passed as parameter
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function Recall_Equals($params)
 	{
 		$name = $params['var'];
 		$value = $params['value'];
 		return ($this->Application->RecallVar($name) == $value);
 	}
 
+	/**
+	 * Checks if application variable
+	 * specified by name value match
+	 * value passed as parameter
+	 *
+	 * @param Array $params
+	 * @return bool
+	 * @access public
+	 */
 	function Get_Equals($params)
 	{
 		$name = $this->SelectParam($params, 'var,name,param');
@@ -273,6 +354,15 @@
 		}
 	}
 	
+	/**
+	 * Includes template
+	 * and returns it's
+	 * parsed version
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function MyInclude($params)
 	{
 		$BlockParser =& $this->Application->Factory->makeClass('TemplateParser');
@@ -290,13 +380,13 @@
 		return $res;
 	}
 	
-	function Kernel_Scripts($params)
+	/*function Kernel_Scripts($params)
 	{
 		return '<script type="text/javascript" src="'.PROTOCOL.SERVER_NAME.BASE_PATH.'/kernel3/js/grid.js"></script>';
-	}	
+	}*/	
 
 
-	function GetUserPermission($params)
+	/*function GetUserPermission($params)
 	{
 		// echo"GetUserPermission $params[name]";
 		if ($this->Application->RecallVar('user_type') == 1)
@@ -307,14 +397,15 @@
 			if ($aPermissions)
 				return $aPermissions[$perm_name];
 		}
-	}
+	}*/
 	
-	function t_url($params)
-	{
-		$url = $this->Application->HREF($this->Application->GetVar('t'));
-		return $url;
-	}
-	
+		
+	/**
+	 * Set's parser block param value
+	 *
+	 * @param Array $params
+	 * @access public
+	 */
 	function AddParam($params)
 	{
 		$parser =& $this->Application->Parser; // recallObject('TemplateParser');
@@ -325,7 +416,7 @@
 		}
 	}
 	
-	function ParseToVar($params)
+	/*function ParseToVar($params)
 	{
 		$var = $params['var'];
 		$tagdata = $params['tag'];
@@ -335,20 +426,27 @@
 		$parser->SetParam($var, $res);
 		$parser->AddParam('/\$'.$var.'/', $res);
 		return '';
-	}
+	}*/
 	
-	function TagNotEmpty($params)
+	/*function TagNotEmpty($params)
 	{
 		$tagdata = $params['tag'];
 		$res = $this->Application->ProcessTag($tagdata);
 		return $res != '';
-	}
+	}*/
 	
-	function TagEmpty($params)
+	/*function TagEmpty($params)
 	{
 		return !$this->TagNotEmpty($params);
-	}
+	}*/
 	
+	/**
+	 * Parses block and returns result
+	 *
+	 * @param Array $params
+	 * @return string
+	 * @access public
+	 */
 	function ParseBlock($params)
 	{
 		$parser =& $this->Application->Parser; // recallObject('TemplateParser');