yavin/symfony-form-tree

create select field with indentation for tree structure

v1.0.2 2017-02-11 10:47 UTC

Requires

• php: >=5.5.9
• doctrine/common: ~2.0
• doctrine/orm: ~2.0
• gedmo/doctrine-extensions: ~2.1
• symfony/doctrine-bridge: ~3.0
• symfony/form: ~3.0
• symfony/options-resolver: ~3.0
• symfony/property-access: ~3.0

Requires (Dev)

• ext-pdo_sqlite: *
• phpunit/phpunit: ~4.0

MIT

• Yavin

README

This extension provide displaying doctrine tree entity types in synfony forms. It add a prefix to option names in select list that indicates tree level.

It is tested and should work with symfony 3.0+

If want to use this in symfony 2 look at "symfony-2" branch of this extension

<select name="..." data-level-prefix="-">
    <option value="1">Motors</option>
    <option value="2">Electronics</option>
    <option value="3">-Cell phones</option>
    <option value="4">--Samsung</option>
    <option value="5">-Computers</option>
    <option value="6">Fasion</option>
</select>

Instalation

1. With composer.json

   composer require yavin/symfony-form-tree:^1.0
   

2. Add type guesser in your services file (optional):

   <service class="Yavin\Symfony\Form\Type\TreeTypeGuesser">
       <argument type="service" id="doctrine"/>
       <tag name="form.type_guesser"/>
   </service>

   or if you use yml format:

   services:
       symfony.form.type_guesser.tree:
           class: Yavin\Symfony\Form\Type\TreeTypeGuesser
           arguments: [ "@doctrine" ]
           tags:
               - { name: form.type_guesser }

3. Then add field to tree model. In this example

   use Yavin\Symfony\Form\Type\TreeType;
   
   public function buildForm(FormBuilderInterface $builder, array $options)
   {
       $builder->add('category'); //extension will guess field type
   
       //or this is full example with default options:
   
       $builder->add('category', TreeType::class, [
           'class' => Category::class, // tree class
           'levelPrefix' => '-',
           'orderFields' => ['treeLeft' => 'asc'],
           'prefixAttributeName' => 'data-level-prefix',
           'treeLevelField' => 'treeLevel',
       ]);
   }

   This extension assume that in tree model You have treeLeft and treeLevel fields. It can be changed in field options.

   Here is example tree entity.

Other

• Custom, callback provided prefix
• Set default options to all tree select fields

License

MIT