commons/gender-bundle

Gendered User Interfaces and Form Types for human-centered web applications.

Commons Gender Bundle

Since gender is not binary but Symfony documentation and tutorials and popular bundles play as if it were, this bundle attempts to be a starting point for Symfony web applications to offer humane choices for users to identify themselves., _(*1)

Installation

Add the following code to your composer.json file:, _(*2)

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

And then run the Composer update command:, _(*3)

$ php composer.phar update commons/gender-bundle

Then register the bundle in the AppKernel.php file:, _(*4)

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

    return $bundles;
}

Configuration

Configuration is required for this bundle to function. Add the gender options your application supports to your config.yml, _(*5)

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

These are the choices that will be available in the gender form type., _(*6)

The gender form type extends from [Symfony's choice form type][3], which means it supports multiple. However it is your responsibility to create a data model that supports multiple genders., _(*7)

Interfaces

This bundle provides a generic GenderedUserInterface that all other gendered user interfaces should extend from. The GenderedUserInterface tries to make no assumptions and so only defines a GENDER_UNKNOWN constant., _(*8)

Ambitions

The maintainers of this bundle will likely create a freegender form type which allows free input with optional autocompletion., _(*9)