kohana-form: продвинутая функциональность форм для коханы

Как пользоваться:

Создание формы

<?php
defined('SYSPATH') OR die('No direct access allowed.');

class Form_Login extends Form
{
    public static function meta()
    {
        return array(
            "fields" => array(
                "login" => Field::factory("Varchar"),
                "password" => Field::factory("Password"),
            ),

            "options" => array( // заполняется по желанию. может быть пустым массивом.
                "valid_messages_file" => "login", // файл в котором лежат сообщения валидации, должен находиться в папке messages
                "theme" => "base" // тема формы. base - тема по умолчанию, из коробки есть 2 темы: base, nolabels. nolabels это таже тема base только без тегов label
            ),
        );
    }
}

Имеющиеся типы полей:

Email
Belongs To
Many2Many
One2Many
Choice
MultiChoice
Hidden
Image
File
Int
Password
URL
Text
Timestamp
Varchar
Int Unsigned

Как показать форму:

Просто показать

 <form>
     <?php echo $form; ?>
     <input type="submit" value="Add"/>
 </form>

Показать с стилями bootstrap:

       <form method="POST" role="form">
            <?php foreach ($form as $field): ?>
                <div class="form-group">
                    <?php $field->css_class(array("form-control")); ?>
                    <?php foreach ($field->errors() as $error): ?>
                        <div class="alert alert-danger">
                            <?php echo $error; ?>
                        </div>
                    <?php endforeach; ?>
                    <?php echo $field; ?>
                </div>
            <? endforeach; ?>
            <input type="submit" class="btn btn-primary" value="Add"/>
        </form>

Создать модельную форму:

class Form_Article extends ModelForm
{

    public static function meta()
    {
        return array(
            "fields" => array( //необязательно для заполнения. используется для переопределения полей, если это требуется.
                "image" => Field::factory("Image")
            ),
            "options" => array(
                "model" => ORM::factory("Article"), //собственно модель из которой будем генерить форму
                "display_fields" => array("title", "body", "image"), //отображаемые поля
                "valid_messages_file" => "news", //используемый файл для сообщений валидации
                "except_fields" => array() //какие поля скрыть и не показывать
            ),
        );
    }
}

Создать форму для определенной сущности в базе данных

Form::factory("Article", array(), $id);

Создать форму для определенного набора данных

Form::factory("Article", array("title" => "Hello!"));

Получить и сохранить модельную форму:

public function action_add()
    {
       if ($this->request->method() == "POST") {

            $form = Form::factory("Article", $this->request->post());

            $form->add_field(
                Field::factory("Hidden")
                    ->name("user")
                    ->value(Auth::instance()
                        ->get_user())
            );
            if ($form->validate())
                $form->save();
        }       
    }

Создать formset

<?php
defined('SYSPATH') OR die('No direct access allowed.');

class Formset_News extends Formset
{

    public static function meta()
    {
        return array(
            "base_form" => "News",
            "theme" => "bootstrap"
        );
    }
}

Формсеты так же имплементируют Iterator, поэтому можно легко получить доступ к каждому элементу.

timophey/kohana-form

kohana-form: продвинутая функциональность форм для коханы