commons/gender-bundle

面向以人为本的Web应用的性别化用户界面和表单类型。

dev-master / 1.0.x-dev 2014-09-30 00:20 UTC

This package is auto-updated.

Last update: 2024-09-12 03:46:10 UTC


README

由于 性别不是二元,但Symfony文档和教程以及 流行的包 假定它是,这个包试图为Symfony Web应用提供一个起点,为用户提供识别自己的人性化选择。

安装

将以下代码添加到您的 composer.json 文件中

"require": {
    ..
    "commons/gender-bundle": "~1.0@dev"
},

然后运行Composer更新命令

$ php composer.phar update commons/gender-bundle

然后在 AppKernel.php 文件中注册这个包

public function registerBundles()
{
    $bundles = array(
        ...
        new Commons\Bundle\GenderBundle\CommonsGenderBundle(),
        ...
    );

    return $bundles;
}

配置

此包要正常运行,需要配置。将您的应用程序支持的性别选项添加到您的 config.yml

commons_gender:
    genders:
        f: Feminine
        m: Masculine
        q: Genderqueer
        u: Undisclosed

这些是将在 gender 表单类型中可用的选项。

gender 表单类型扩展自 Symfony的 choice 表单类型,这意味着它支持 multiple。然而,创建支持多个性别的数据模型是您的责任。

接口

此包提供了一个通用的 GenderedUserInterface,所有其他性别化用户界面都应该从这个接口扩展。`GenderedUserInterface` 尽量不做出任何假设,因此只定义了一个 `GENDER_UNKNOWN` 常量。

抱负

此包的维护者可能会创建一个 freegender 表单类型,允许自由输入,并可选择自动完成。