/*
   Usage example:
   $cms->section_link("section_name", "link_text");
   $cms->section_slink("section_name", "");
   $cms->section_llink("section_name", "link_text");
*/

/*
| Section core API | TODO: finish to define various api
This section cover the APIs people can use to interact with sections for the
user templates.

# Variables
$file			- String containing the file for this section
$section		- String containing the selected section name
$sectionid		- Integer containing the selected sectionID number
$description		- String containing the short description for this section
$longdescription	- String containing the long description for this section
$subsections[]		- Array containing all the branch subsections for this section
$n_subsections		- Integer containing this branch subsections number
$Section_arr[]		- Array containing all the section names of your site
$Visible_arr[]		- Array. Are sections visible? YES || NO
$Visible_logged_arr[]	- Array. Are sections visible for logged users? YES || NO
$Search_arr[]		- Array. Are sections searchable? YES || NO
$Search_logged_arr[]	- Array. Are sections searchable for logged in users? YES || NO
$Section_file_arr[]	- Array. File names of all the sections, path relative to "templates"
$Shortdescription_arr[]	- Array. Short description for all the sections
$Longdescription_arr[]	- Array. Long description for all the sections

# Methods

- GENERAL PORPOSE -
$cms->function general_cmsdamversion ()
	This method return the cmsdAm long version, useful if you want to
	insert the "powered by cmsdAm" string.
$cms->function general_metakeywords ()
	This method return the meta keywords, useful for search engines
	like altavista, ecc...
	
- SECTIONS -
$cms->section_link ($Section, $linktext)
	This method create a html link that points to the specified section $Section.
	You can use the link text $text if you don't want to use the Longdescription
	defined with the section.

$cms->section_slink ($Section, $linktext)
	This method return a html link that points to the specified section $Section.
        You can use the link text $text if you don't want to use the Shortdescription
        defined with the section.

$cms->section_llink ($Section, $linktext)
	This method return a html link that points to the specified section $Section.
        You can use the link text $text if you don't want to use the Longdescription
        defined with the section.

$cms->section_ldesc ($Section)
	This method return the string of the specified section $Section long description.
        If the requested section is not valid this method returns the passed string.

$cms->section_sdesc ($Section)
	This method return the string of the specified section $Section short description.
        If the requested section is not valid this method returns the passed string.

$cms->section_filename ($Section)
	This method return the string of the specified section $Section file name.
        If the requested section is not valid this method returns null.

*/