From 87d7953ba4950fc822f38ece5e8d1904511b337c Mon Sep 17 00:00:00 2001
From: vincent <vincent@caboulot.org>
Date: Tue, 27 Aug 2024 20:40:26 +0200
Subject: [PATCH] documentation des champs

---
 src/Form/CsvType.php  |  1 +
 src/Form/TaskType.php | 38 +++++++++++++++++++++++++++++++-------
 2 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/src/Form/CsvType.php b/src/Form/CsvType.php
index 1adb138..9920aa2 100644
--- a/src/Form/CsvType.php
+++ b/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 ».',
             ])
         ;
     }
diff --git a/src/Form/TaskType.php b/src/Form/TaskType.php
index 78ba1f0..d0176d3 100644
--- a/src/Form/TaskType.php
+++ b/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.',
+            ])
         ;
     }