/*

	SAPID DEVELOPER GUIDE 
	
	PROJECT MEMBERSHIP
	
		Mailing-list			http://lists.sourceforge.net/lists/listinfo/sapid-community/
		Bug Tracking System		http://sourceforge.net/tracker/?atid=680099&group_id=118100&func=browse
		Support requests		http://sourceforge.net/tracker/?atid=680100&group_id=118100&func=browse
		Patches					http://sourceforge.net/tracker/?atid=680101&group_id=118100&func=browse
		Feature requests		http://sourceforge.net/tracker/?atid=680102&group_id=118100&func=browse
		Public docs				http://sourceforge.net/docman/?group_id=118100
		
		Project download		http://sourceforge.net/project/showfiles.php?group_id=118100
		
		
	SCRIPTS LOCATIONS
	
		etc/*.* - startup scripts and administrative interfaces logic
			rc.conf.php - configuration of project
		
		kernel/*.*	- API libraries
			kernel.lib.php 	- XML Sapiens processor's library
			tree.lib.php 	- Dynamic trees API library
			vdb.lib.php		- Virtual DB library
			
		lang/*.* 	- languages of interfaces' content
		log/*.* 	- statistics logs
		mvc/*.*
			controller/*.*
				authorization_analysis.inc.php 	-	get site user information
				build_tree.inc.php				-	get site structure information
				getmethod_analysis.inc.php		-	action declaration for _GET queries
				postmethod_analysis.inc.php		-	_POST queries analisis including FEEDBACK mail sending (letter template). Notice: Infochannel _POST analisis located in usr/extentions/get_infochannel.inc.php
				requesturi_analysis.inc.php		-	address string mask analisis, TRACE mode checking, document.url declaration
				user_requests_analysis.inc.php	-	authorization query analisis, analisis user's forms command
			
			model/*.*
				document_identification.inc.php	-	learning of the current document ID and appropriate data ($page array) 
				
			view/*.*
				functions.inc.php 	- common functions 
				
			usr/*.*
				dump/*.*		- backup folder
				extensions/*.* 	- CMS applications (see XML Sapiens specification www.xmlsapiens.org)
				system/*.* 		- CMS auxiliary scripts (see XML Sapiens specification www.xmlsapiens.org)
				
					..
					editor.php	- WYSIWYG editor
					js/startup.js.php - Java-script of WYSIWYG editor
					html2xhtml.js - HTML to XHTML js-convertor
				
				
				templates/*.* 	- document types templates (see XML Sapiens specification www.xmlsapiens.org)
				themes/*.*		- CMS administrative inteface themes
				xml/*.*
					content/*.*	- documents content
					ddc			- DDCs (see XML Sapiens specification www.xmlsapiens.org)
					sdc			- SDCs (see XML Sapiens specification www.xmlsapiens.org)
					vdb			- Virtual DB
					tree.xml 	- structure of the site
					users.xml 	- site users 
				
				
	User's forms command
	
	If we fill in a web form certain fields the SAPID CMS can run different action.
	
	Field 'data_file' contains name of file from data store (Real path to this file will be usr/xml/vdb/filename)
	 
	For example:
	<input type="hidden" name="data_file" value="survey1.xml"> 

	You can point to certain action for CMS by hidden field 'post_action'.
	
	Following command is available.

		ADDROW - add posted data as new entry into a file 
		CHANGEROW - change file content by posted data
		ADDNEWIPROW - add new entry consideration IP filter
		ADDNEWCOOKIESROW - add new entry consideration COOKIES filter

	For example:
	<input type="hidden" name="post_action" value="ADDNEWIPROW"> 

	
	
	Virtual DB library
	
	sapi_vdb() - the class 
	close() - class destructor
	
	set_filter()
		Set filters
	
	get_data($filename=false, $commands=false)
		Get array from certain XML-file
		$filename - target filename
		if $commands = '_ONEROW_' function will return one last row
	
	save_data_row($filename=false, $data=false, $unique_ip=false)
		Save array into certain XML-file
			Appropriate values of $data["post_action"]
				ADDNEWIPROW
				ADDROW
				CHANGEROW
				UPDATEROW
			Source array $data["ROW"][..]

			$unique_ip - trigger (action will done only for unique IP)
			$filename - target filename

	delete_data_row($arg_value, $arg_key="DATE_CREATE")
		Delete row in the file if row with index $arg_key = $arg_value
		
	change_data_row($date_create, $new_row)
		Change row data in the file for row with create date $date_create 
*/