README.txt

FORMAGIC README
===============
Thank you for downloading Formagic beta.
The source files within are subject to the new BSD license that is bundled
with this package in the file LICENSE.txt.

This is a beta release of Formagic. Please check http://formagic.sourceforge.net
for updates of Formagic. There will be a final release as soon as all intended
features are implemented and fully tested.


SYSTEM REQUIREMENTS
===================
There are not many requirements for using Formagic, any PHP 5 will do (PHP 4 is
not supported). Formagic will run with any php.ini settings. It is designed to
be without errors or warnings down to E_STRICT level.


GETTING STARTED
===============
Just unpack the ZIP-File into a directory of your choice and include
formagic.php in your code.

As long as a full Manual/HowTo-section is still missing on the Formagic project
page, have a look at a very simple usage example:

<?php
    include('formagic.php');
    $form = new formagic('myForm');
    $input = $form->addItem('input', 'myInput', array('label' => 'My first input'));
    $input = $form->addItem('submit', 'mySubmit', array('label' => 'Send'));
    if ($form->validate()) {
        echo "submitted and ok<br />";
        $form->block();
    }
    echo $form->fetch();
?>

Of course there is much more to Formagic than this, but perhaps this will get
you a picture how easy it is to create HTML forms with Formagic.


API DOCUMENTATION
=================
The API documentation is created using phpDocumentor.
You will find the current API documentation here:
http://formagic.weasle.de/docs/api/


FORMAGIC LINKS
==============
You will find the official Formagic project site here:
http://formagic.sourceforge.net

Please feel free to report any feature request or bugs here:
http://sourceforge.net/tracker/?group_id=202176