documentation des champs

src/Form/CsvType.php

@@ -26,6 +26,7 @@ class CsvType extends AbstractType
                         'mimeTypesMessage' => 'Type MIME inattendu',
                     ])
                 ],
+                'help' => 'Fichier CSV classique (encodé en UTF8, séparé par des virgules, entouré avec des doubles guillemets, échappé avec des barres obliques et avec des retours chariots UNIX) contenant une ligne de noms de colonnes « name,description,osm,geojson,status » et enfin dans la colonne « status » la valeur « todo », « doing » ou « done ».',
             ])
         ;
     }

src/Form/TaskType.php

@@ -14,13 +14,37 @@ class TaskType extends AbstractType
     public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder
-            ->add('name', null, ['label' => 'Nom'])
-            ->add('description', null, ['label' => 'Description'])
-            ->add('geojson', TextareaType::class, ['label' => 'GeoJSON', 'required' => false])
-            ->add('osm', TextareaType::class, ['label' => 'OSM', 'required' => false])
-            ->add('status', TaskLifecycleType::class, ['label' => 'État'])
-            ->add('urgent', null, ['label' => 'Urgence', 'required' => false])
-            ->add('important', null, ['label' => 'Importance', 'required' => false])
+            ->add('name', null, [
+                'label' => 'Nom',
+            ])
+            ->add('description', null, [
+                'label' => 'Description',
+            ])
+            ->add('geojson', TextareaType::class, [
+                'label' => 'GeoJSON',
+                'required' => false,
+                'help_html' => true,
+                'help' => 'Ce qu’il faut dessinner sur la carte au format <a href="https://fr.wikipedia.org/wiki/GeoJSON" target="_blank">GeoJSON</a> et mettre à disposition à l’export sous forme de <a href="https://fr.wikipedia.org/wiki/GPX_(format_de_fichier)" target="_blank">GPX</a> pour l’import dans JOSM. Outil pratique&nbsp;: <a href="ttps://geojson.io/" target="_blank">geojson.io</a>.',
+            ])
+            ->add('osm', TextareaType::class, [
+                'label' => 'OSM',
+                'required' => false,
+                'help_html' => true,
+                'help' => 'XML décrivant ce qu’il faut charger dans la feuille de données de JOSM (cf <a href="https://wiki.openstreetmap.org/wiki/FR:OSM_XML" target="_blank">FR:OSM XML - OpenStreetMap Wiki</a>)',
+            ])
+            ->add('status', TaskLifecycleType::class, [
+                'label' => 'État'
+            ])
+            ->add('urgent', null, [
+                'label' => 'Urgence',
+                'required' => false,
+                'help' => 'Un entier signé optionnel.',
+            ])
+            ->add('important', null, [
+                'label' => 'Importance',
+                'required' => false,
+                'help' => 'Un entier signé optionnel.',
+            ])
         ;
     }