<?php
/**
 * Definitions for the examples on the patForms API
 *
 * $Id: sections_api.php 394 2007-06-17 20:04:18Z gerd $
 *
 * @package		patForms
 * @subpackage	Examples
 * @author		Sebastian Mordziol <argh@php-tools.net>
 */
 
	$sections['API'] = array(
		'descr'		=>	'These examples show the basic patForms API methods, and introduce you
						to the different ways to create forms and form elements.',
		'basename'	=>	'example_api_',
		'pages'		=>	array(
			'factory_detailed' => array(
				'title'	=>	'Using the patForms factory - I',
				'descr'	=>	'Here you will see how to use the patForms factory methods
							to create elements and append them to a form, and create and 
							set a renderer.',
				'tabs'  =>  array(
					'annotation' => array(
						'title' => 'Notes',
						'type'  => 'text',
						'text'  => 'In this example, you can see the different components a form
									is made of (like elements and renderers for ex.), and how you 
									can bring these components together - we have built patForms so
									that it does not matter where the components come from. Whether
									you create an element via patForms\' createElement() method or
									recycle an element object stored in a session does not matter at 
									all, everything is possible :)',
					),
				),
			),
			'factory_simple' => array(
				'title'	=>	'Using the patForms factory - II',
				'descr'	=>	'Here you will see how you can automate element creation via
							the patForms factory methods.',
			),
            'factory_customModule' => array(
                'title' =>  'Use custom modules in patForms',
                'descr' =>  'Tell patForms how to include your own modules - like rules, filter, elements and stuff. 
                            This feature allows you to keep project specific code separated from the &quot;officiel&quot;
                            patForms distributen.',
            ),
			'setvalues' => array(
				'title'	=>	'Setting the values from your script',
				'descr'	=>	'This example shows how to create a form and set the values afterwards.',
			),
			'replace_element' => array(
				'title'	=>	'Replacing an element',
				'descr'	=>	'This shows you how to replace an element in the form with another one.',
			),
			'autovalidate' => array(
				'title'	=>	'Automatic form validation',
				'descr'	=>	'Here you can find the auto-validation feature 
							of patForms, which enables the automatic checking whether 
							the form has been submitted by checking for a variable in 
							the request.'
			),
			'default_attributes' => array(
				'title'	=>	'Setting default attributes',
				'descr'	=>	'This example shows how you can set default attributes for
							all elements in a form.'
			),
			'locale' => array(
				'title'	=>	'Localized validation messages',
				'descr'	=>	'Here you can see how to set a locale for a form, to 
							set the language in which validation errors will be returned.'
			),
            'locale_patI18n' => array(
                'title' =>  'Localized messages using patI18n',
                'descr' =>  'patI18n is the sucessor over Gettext. Actually, patI18n provides 
                             the same interface as GNU Gettext but wraps it in a modular design.
                             Of course, there is a GNU Gettext module for patI18n. This what
                             patForms uses.'
            ),
            'locale_gettext' => array(
                'title' =>  'DEPRECATED Localized messages using gettext extension',
                'descr' =>  'The gettext functions implement an NLS (Native Language Support) API 
                              which can be used to internationalize your PHP applications. 
                              Please see the gettext documentation for your system for a thorough 
                              explanation of these functions or view the docs at 
                              http://www.gnu.org/software/gettext/manual/gettext.html.'
            ),
			'toxml' => array(
				'title'	=>	'Serialize an element to XML I',
				'descr'	=>	'patForms gives you the possibility to serialize an element 
							to XML - this is useful if you want to make an XML representation 
							of your form elements.'
			),
			'toxml_ns' => array(
				'title'	=>	'Serialize an element to XML II',
				'descr'	=>	'For easy integration in existing XML data, you can also
							serialize an element with a custom namespace.'
			),
		)
	);

?>