update customization guide form

Tomanhez · Tomanhez · commit 7f8a40ec81e8 · 2019-04-16T15:08:59.000+02:00
diff --git a/docs/customization/form.rst b/docs/customization/form.rst
@@ -19,6 +19,11 @@ You can:
 How to customize a Form?
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. tip::
+
+    You can browse the full implementation of this example on GitHub
+    on the `<https://github.com/Sylius/Customizations/pull/8>`_
+
 If you want to modify the form for the ``Customer Profile`` in your system there are a few steps that you should take.
 Assuming that you would like to (for example):
 
@@ -58,9 +63,6 @@ As a result you will get the ``Sylius\Bundle\CustomerBundle\Form\Type\CustomerPr
 
     final class CustomerProfileTypeExtension extends AbstractTypeExtension
     {
-        /**
-         * {@inheritdoc}
-         */
         public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             // Adding new fields works just like in the parent form type.
@@ -78,12 +80,9 @@ As a result you will get the ``Sylius\Bundle\CustomerBundle\Form\Type\CustomerPr
             ]);
         }
 
-        /**
-         * {@inheritdoc}
-         */
-        public function getExtendedType(): string
+        public static function getExtendedTypes(): iterable
         {
-            return CustomerProfileType::class;
+            return [CustomerProfileType::class];
         }
     }
 
@@ -105,8 +104,8 @@ As a result you will get the ``Sylius\Bundle\CustomerBundle\Form\Type\CustomerPr
     Of course remember that you need to render the new fields you have created,
     and remove the rendering of the fields that you have removed **in your views**.
 
-In our case you will need to copy the original template from `vendor/sylius/sylius/src/Sylius/Bundle/ShopBundle/Resources/views/Account/profileUpdate.html.twig`
-to `templates/bundles/SyliusShopBundle/Account/` and add the fields inside the copy
+In our case you will need to copy the original template from ``vendor/sylius/sylius/src/Sylius/Bundle/ShopBundle/Resources/views/Account/profileUpdate.html.twig``
+to ``templates/bundles/SyliusShopBundle/Account/`` and add the fields inside the copy
 
 .. code-block:: html
 
@@ -139,6 +138,14 @@ For instance the ``ProductVariant`` admin form is defined under ``Sylius/Bundle/
 
 your form extension will also be executed. Whether before or after the other extensions depends on priority tag set.
 
+How to customize a Form when form elements are embedded dynamically?
+--------------------------------------------------------------------
+
+.. tip::
+
+    You can browse the full implementation of this example on GitHub
+    on the `<https://github.com/Sylius/Customizations/pull/9>`_
+
 Having a look at the extensions and possible additionally defined event handlers can also be useful when form elements are embedded dynamically,
 as is done in the ``ProductVariantTypeExtension`` by the ``CoreBundle``:
 
@@ -150,9 +157,6 @@ as is done in the ``ProductVariantTypeExtension`` by the ``CoreBundle``:
 
     final class ProductVariantTypeExtension extends AbstractTypeExtension
     {
-        /**
-         * {@inheritdoc}
-         */
         public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             ...
@@ -173,7 +177,6 @@ as is done in the ``ProductVariantTypeExtension`` by the ``CoreBundle``:
                 ]);
             });
         }
-
         ...
     }
 
@@ -202,7 +205,6 @@ you will also have to set up an event listener and then remove the field:
             ;
 
             ...
-
         }
     }
 
@@ -217,6 +219,11 @@ Although it is advised to follow the :doc:`Validation Customization Guide </cust
 want to define the form constraints from inside the form extension. They will not be used unless the correct validation group(s)
 has been added. The example below shows how to add the default `sylius` group to a constraint.
 
+.. tip::
+
+    You can browse the full implementation of this example on GitHub
+    on the `<https://github.com/Sylius/Customizations/pull/8>`_
+
 .. code-block:: php
 
     <?php
