shopsys/form-types-bundle

Shopsys Framework custom Symfony form types

Shopsys Form Types Bundle

, _(*1)

Symfony bundle adding form types for usage in Shopsys Framework, its components and plugins., _(*2)

This repository is maintained by shopsys/shopsys monorepo, information about changes is in monorepo CHANGELOG.md., _(*3)

Installation

The plugin is a Symfony bundle and is installed in the same way:, _(*4)

Download

First, you download the package using Composer:, _(*5)

composer require shopsys/form-types

Register

For the bundle to be loaded in your application you need to register it in the app/AppKernel.php file of your project:, _(*6)

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new Shopsys\FormTypesBundle\ShopsysFormTypesBundle(),
            // ...
        ];

        // ...

        return $bundles;
    }

    // ...
}

How to use a custom form type

The form types in this package are regular Symfony form types. See Symfony Forms Documentation for detailed explanation., _(*7)

Contents

MultidomainType

Compound type that renders one form of given type for each domain., _(*8)

It can be configured via the following options: * entry_type - The type of the inner form. Defaults to TextType::class. * entry_options - The options of the inner forms. Defaults to []. * options_by_domain_id - The options of the inner forms based on the domain ID. Provide arrays indexed by the domain ID, values are merged with the entry_options. Defaults to []., _(*9)

The data of the inner forms are returned as an array indexed by the domain ID., _(*10)

, _(*11)

YesNoType

Natural looking choice type for boolean value inputs., _(*12)

It has no notable options., _(*13)

A boolean value is accepted/returned as data. A null value can be accepted/returned when no radio button is checked., _(*14)

, _(*15)

Contributing

Thank you for your contributions to Shopsys Form Types Bundle package. Together we are making Shopsys Framework better., _(*16)

This repository is READ-ONLY. If you want to report issues and/or send pull requests, please use the main Shopsys repository., _(*17)

Please, check our Contribution Guide before contributing., _(*18)

Support

What to do when you are in troubles or need some help? The best way is to join our Slack., _(*19)

If you want to report issues, please use the main Shopsys repository., _(*20)