README

受 genemu/GenemuFormBundle 启发，为 Admingenerator 项目提供的 symfony2 表单扩展。

文档

有关表单类型和扩展（及相关说明）的完整列表，请参阅 文档。

安装

将以下内容添加到您的 composer.json

"require": {
    "symfony2admingenerator/form-extensions-bundle": "^2.0"
}

对于低于 2.7 版本的 Symfony 或低于 1.12 版本的 Twig，将以下内容添加到您的 composer.json

"require": {
    "symfony2admingenerator/form-extensions-bundle": "v2.0-beta.21"
}

然后，在您的 AppKernel.php 中启用此包

<?php
// AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Admingenerator\FormBundle\AdmingeneratorFormBundle(),
        new Admingenerator\FormExtensionsBundle\AdmingeneratorFormExtensionsBundle(),
        // AdmingeneratorGeneratorBundle is optional, however if you're useing it
        // make sure it is loaded AFTER AdmingeneratorFormExtensionsBundle
        new Admingenerator\GeneratorBundle\AdmingeneratorGeneratorBundle(),
    );
}
?>

要使 symfony2admingenerator/form-extensions-bundle 表单正常工作，您需要编辑您的基模板，并包含静态和动态样式表和 JavaScript。

对于 Admingenerator 用户

{% extends 'AdmingeneratorGeneratorBundle::base_admin.html.twig' %}

{% block stylesheets %}
    {{ parent() }}

    {% include '@AdmingeneratorFormExtensions/stylesheets.html.twig' %}
    {% if form is defined and form is not empty %}
        {{ form_css(form) }}
    {% endif %}
{% endblock %}

{% block javascripts %}
    {{ parent() }}

    {% include '@AdmingeneratorFormExtensions/javascripts.html.twig' %}
    {% if form is defined and form is not empty %}
        {{ form_js(form) }}
    {% endif %}
{% endblock %}

对于其他人

{% block stylesheets %}
    {% include '@AdmingeneratorFormExtensions/stylesheets.html.twig' %}
    
    {% if form is defined and form is not empty %}
        {{ form_css(form) }}
    {% endif %}
{% endblock %}

{% block javascripts %}
    {% include '@AdmingeneratorFormExtensions/javascripts.html.twig' %}
    
    {% if form is defined and form is not empty %}
        {{ form_js(form) }}
    {% endif %}
{% endblock %}

请注意，上述模板仅在使用您项目配置了 assetic（启用正确的过滤器，例如 uglifyjs2 和 uglifycss）时可用。此包还提供没有过滤器和 assetic 的视图。只需将 _assetic_basic 或 assetic_less 添加到模板名称中。

配置 assetic 包（仅当您使用 base.html.twig 模板时）

Symfony <2.7

framework:
    templating:
        packages:
            formextensions_css:
                version: 1.0
                version_format: "%%1$s?v%%2$s"
            formextensions_js:
                version: 1.0
                version_format: "%%1$s?v%%2$s"

Symfony 2.7 或更高版本

framework:
    assets:
        packages:
            formextensions_css:
                version: 1.0
                version_format: "%%1$s?v%%2$s"
            formextensions_js:
                version: 1.0
                version_format: "%%1$s?v%%2$s"

需要翻译者！

我们需要您的支持来翻译表单消息 :) 如果您想帮忙，请提交一个 pull request 并提交您语言的包。

许可证

有关许可证信息，请仔细阅读 LICENSE 文件。