Form Generation Library

[eluser]dinhtrung[/eluser]
After 2 hours code and F5, I found Form Generation very useful, but lack some major feature, especially the callback validation.
So here is my experience with Form Generation.
- If you want the form to show up an error, just use $form->add_error('field', 'message'). Because the lack of documentation, I spent more than an hour to use $form->set_error() or $form->set_error_label(). My mistake to not read the code carefully :">
- For callback feature, do it in the ($this->valid) block.
So for a real example: Authenticate using dx_auth, Template library and Form Generation library:
In controller (./applications/controllers/user.php)

Code:

function login()
    {    
        if (! $this->dx_auth->is_logged_in()){
            $this->load->library('form'); // first of all we have to load the library
            $this->form // then we fill the form with elements
            ->open('user/login')        
            ->fieldset("User Login")
            ->text('username', 'Your Username', 'required|trim|alpha_numeric|max_length[30]|xss_clean')
            ->pass('password', 'Your Password', 'required|trim|alpha_numeric|max_length[20]|xss_clean')            
            ->checkbox('loggedin', 'yes', 'I want to stay logged-in')
            ->fieldset()
            ->submit()
            ->reset()
            ->validate();


            $showform = TRUE;
            if ($this->form->valid){
                $tmp = $this->form->get_post();
                if (! $this->dx_auth->login($tmp["username"], $tmp["password"], $tmp["getloggedin"]))
                    $this->form->add_error("password", $this->dx_auth->get_auth_error());
                else $showform = FALSE;
            }

            if ($showform){
                $data['form'] = $this->form->get(); // this returns the validated form as a string
                $data['errors'] = $this->form->errors;  // this returns validation errors as a string
                $this->template->write_view('content', 'login', $data);
            } else
                $this->template->write('content', 'You are already logged in!');
            $this->template->render();
        } else
            redirect("user/dashboard");
    }

Note: in this example, I use $showform as a flag to render the form or not. If the user is successfully logged in, then we don't need to show the form. Instead, write "You are already logged in!" in the view and show that message to the user. This page should be automatically refresh into another page, through the meta tags at header.
- For view, I use the default of Form Generation: applications/views/login.php

Code:

<h3>Login</h3>
&lt;?php echo $errors; ?&gt;
&lt;?php echo $form; ?&gt;

Hope this will help new users save some time...