Doc des options de dev, étape 1 : ajuster la fonction `saisies_generer_aide()` + les .yaml

inc/saisies_aide.php

@@ -26,34 +26,40 @@ function saisies_generer_aide() {
 
 	// On construit une liste par options
 	$options = array();
-	foreach ($saisies as $type_saisie => $saisie) {
-		$options_saisie = saisies_lister_par_nom($saisie['options'], false);
-		if (isset($options_saisie['datas'])) {//Datas devient data
-			$options_saisie['data'] = $options_saisie['datas'];
-			unset($options_saisie['datas']);
-		}
-		foreach ($options_saisie as $nom => $option) {
-			if (isset($option['options']['datas'])) {
-				$option['options']['data'] = $option['options']['datas'];
-				unset($option['options']['datas']);
+	$options_dev = array();
+	foreach (array
+			('options_dev' => &$options_dev, 'options' => &$options)
+			as $nom_type_options => &$type_options
+	) {
+		foreach ($saisies as $type_saisie => $saisie) {
+			$options_saisie = saisies_lister_par_nom($saisie[$nom_type_options], false);
+			if (isset($options_saisie['datas'])) {//Datas devient data
+				$options_saisie['data'] = $options_saisie['datas'];
+				unset($options_saisie['datas']);
 			}
-			// Si l'option n'existe pas encore
-			if (!isset($options[$nom])) {
-				$options[$nom] = _T_ou_typo($option['options']);
+			foreach ($options_saisie as $nom => $option) {
+				if (isset($option['options']['datas'])) {
+					$option['options']['data'] = $option['options']['datas'];
+					unset($option['options']['datas']);
+				}
+				// Si l'option n'existe pas encore
+				if (!isset($type_options[$nom])) {
+					$type_options[$nom] = _T_ou_typo($option['options']);
+				}
+				// On ajoute toujours par qui c'est utilisé
+				$type_options[$nom]['utilisee_par'][] = $type_saisie;
 			}
-			// On ajoute toujours par qui c'est utilisé
-			$options[$nom]['utilisee_par'][] = $type_saisie;
+			ksort($options_saisie);
+			$saisies[$type_saisie][$nom_type_options] = $options_saisie;
 		}
-		ksort($options_saisie);
-		$saisies[$type_saisie]['options'] = $options_saisie;
+		ksort($type_options);
 	}
-	ksort($options);
-
 	return recuperer_fond(
 		'inclure/saisies_aide',
 		array(
 			'saisies' => saisies_regrouper_disponibles_par_categories($saisies),
-			'options' => $options
+			'options' => $options,
+			'options_dev' => $options_dev
 		)
 	);
 }

lang/saisies_fr.php

@@ -148,12 +148,16 @@ Vous trouverez la <a href="https://contrib.spip.net/5080" target="_blank" rel="n
 	'option_horaire_label' => 'Horaire',
 	'option_horaire_label_case' => 'Permettre de saisir aussi l’horaire',
 	'option_id_groupe_label' => 'Groupe de mots',
+	'option_id_label' => 'Attribut <code>id</code> de la saisie',
+	'option_id_explication' => 'Sera automatiquement préfixé par <code>champ_</code>.',
 	'option_info_obligatoire_explication' => 'Vous pouvez modifier l’indication d’obligation par défaut : <i>[Obligatoire]</i>. Pour garder l’information par défaut, ne rien mettre. Pour ne rien afficher, mettre un texte composé uniquement d’espace.',
 	'option_info_obligatoire_label' => 'Indication d’obligation',
 	'option_inserer_barre_choix_edition' => 'barre d’édition complète',
 	'option_inserer_barre_choix_forum' => 'barre des forums',
 	'option_inserer_barre_explication' => 'Insère une barre d’outils du porte-plume si ce dernier est activé.',
 	'option_inserer_barre_label' => 'Insérer une barre d’outils',
+	'option_inserer_debut_label' => 'Code à insérer en début de saisie',
+	'option_inserer_fin_label' => 'Code à insérer en fin de saisie',
 	'option_label_case_label' => 'Label placé à côté de la case',
 	'option_label_explication' => 'Le titre qui sera affiché.',
 	'option_label_label' => 'Label',

saisies/_base/options_dev.yaml

@@ -0,0 +1,16 @@
+-
+  saisie: 'input'
+  options:
+    nom: 'inserer_debut'
+    label: '<:saisies:option_inserer_debut_label:>'
+-
+  saisie: 'input'
+  options:
+    nom: 'inserer_fin'
+    label: '<:saisies:option_inserer_fin_label:>'
+-
+  saisie: 'input'
+  options:
+    nom: 'id'
+    label: '<:saisies:option_id_label:>'
+    explication: '<:saisies:option_id_explication:>'

saisies/auteurs.yaml

@@ -114,6 +114,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_auteurs_titre:>'

saisies/case.yaml

@@ -124,6 +124,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_case_titre:>'

saisies/checkbox.yaml

@@ -132,6 +132,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_checkbox_titre:>'

saisies/choix_grille.yaml

@@ -84,6 +84,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_choix_grille_titre:>'

saisies/date.yaml

@@ -114,6 +114,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_date_titre:>'

saisies/destinataires.yaml

@@ -72,6 +72,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_destinataires_titre:>'

saisies/email.yaml

@@ -133,6 +133,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_email_titre:>'

saisies/explication.yaml

@@ -52,6 +52,8 @@ options:
           nom: 'conteneur_class'
           label: '<:saisies:option_class_label:>'
           size: 50
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     texte: '<:saisies:saisie_explication_titre:>'

saisies/fieldset.yaml

@@ -75,7 +75,8 @@ options:
           explication: '<:saisies:option_tagfield_explication:>'
           placeholder: '<legend>'
           size: 50
-
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_fieldset_titre:>'

saisies/hidden.yaml

@@ -44,6 +44,8 @@ options:
       label: '<:saisies:option_groupe_affichage:>'
     saisies:
       -  'inclure:saisies/_base/afficher_si.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_hidden_titre:>'

saisies/input.yaml

@@ -136,6 +136,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_input_titre:>'

saisies/mot.yaml

@@ -114,6 +114,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_mot_titre:>'

saisies/oui_non.yaml

@@ -86,6 +86,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_oui_non_titre:>'

saisies/radio.yaml

@@ -107,6 +107,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_radio_titre:>'

saisies/selecteur_article.yaml

@@ -95,6 +95,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:public:article:>'

saisies/selecteur_document.yaml

@@ -46,6 +46,8 @@ options:
      label: '<:saisies:option_groupe_validation:>'
    saisies:
      -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
  options:
    label: '<:medias:objet_document:>'

saisies/selecteur_rubrique.yaml

@@ -95,6 +95,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:public:rubrique:>'

saisies/selecteur_rubrique_article.yaml

@@ -95,6 +95,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_selecteur_rubrique_article_titre:>'

saisies/selection.yaml

@@ -136,6 +136,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_selection_titre:>'

saisies/selection_multiple.yaml

@@ -119,6 +119,8 @@ options:
       label: '<:saisies:option_groupe_validation:>'
     saisies:
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_selection_multiple_titre:>'

saisies/textarea.yaml

@@ -137,6 +137,8 @@ options:
           label: '<:saisies:option_maxlength_label:>'
           explication: '<:saisies:option_maxlength_explication:>'
       -  'inclure:saisies/_base/obligatoire.yaml'
+options_dev:
+      - 'inclure:saisies/_base/options_dev.yaml'
 defaut:
   options:
     label: '<:saisies:saisie_textarea_titre:>'