Saisies

Introduction

Créer un formulaire est une tâche toujours un peu répétitive : les champs ont souvent les mêmes propriétés, le même accompagnement (message d’erreur, explication, ...) et la même structure HTML. Ce plugin est un outil pour les développeurs ayant pour but de faciliter et d’accélérer l’écriture des formulaires.

Pour cela, Saisies propose un ensemble d’outils (balises, API PHP) pour générer et manipuler plus facilement les champs des formulaires. De cette manière, les squelettes de formulaires sont :

  • plus lisibles : il n’y a que le strict nécessaire dedans, pas de répétition ;
  • intégrés au fonctionnement CVT de SPIP 2, notamment pour la gestion des erreurs sur les champs ;
  • automatiquement compatibles avec les recommandations HTML/CSS de SPIP, y compris pour le plugin CFG.

La balise #SAISIE

Cette balise permet de générer une seule saisie en lui donnant directement les paramètres désirés. Chaque saisie va générer une ligne dans un formulaire, c’est-à-dire soit :

La balise a deux arguments obligatoires : le type du champ, et son nom HTML (attribut « name »). Toutes les autres options sont facultatives et servent à configurer le champ ; de ce fait, elles sont de la formes option=valeur.

La forme complète est donc la suivante :
#SAISIE{type, name, option=valeur, option2=valeur2, etc=etc}

Voici quelques exemples d’utilisation, pour comprendre l’approche.

Génère un simple champ texte, indiqué comme étant obligatoire :
#SAISIE{input, email, label=Votre courriel, obligatoire=oui}
 
Génère des boutons radios avec un choix "oui ou non" :
#SAISIE{oui_non, zanini, label=Tu veux ou tu veux pas ?}
 
Génère un choix multiple parmi les utilisateurs du SPIP :
#SAISIE{auteurs, destinataires,
    label=Destinataires du message,
    explication=Choisissez une ou plusieurs personnes à qui sera envoyé le message.,
    multiple=oui}

Comme vous le voyez, des champs qui peuvent être complexes, et fastidieux à écrire de manière complète, s’écrivent ici en quelques lignes.

Consultez également :

-  La référence de la balise #SAISIE

-  Un complément de doc avancée sur les saisies

Multilinguisme

#SAISIE supporte le multilinguisme. Dans ce cas, attention de bien utiliser la syntaxe complète avec les crochets :

  • #SAISIE{input, annee, label=<:monplugin:annee:>,obligatoire=oui} ne fonctionne pas ;
  • [(#SAISIE{input, annee, label=<:monplugin:annee:>,obligatoire=oui})] fonctionne.

Attention, pour utiliser tout ce qui suit, vous devez installer aussi le plugin YAML.


Afficher les erreurs

Saisie gère nativement l’affichage des erreurs.
Si la fonction CVT verifier() retourne une erreur du même nom celle ci sera affichée.
Pour la saisie[(#SAISIE{input, annee, label=<:monplugin:annee:>})] , si verifier retourne : $erreurs['annee'] = "une erreur" alors <span class="erreur_message">une erreur</span> sera affichée à la suite de la saisie.

Gérer les tableaux de saisie

La norme html permet de gérer des variables sous la forme de tableau. Il est recommandé d’utiliser alors le formalisme suivant tableau/variable. Par exemple : [(#SAISIE{input, annee/debut, label=<:monplugin:annee:>})] pour obtenir un tableau annee.

Pour information la forme naturelle [(#SAISIE{input, annee\[debut\], label=<:monplugin:annee:>})] est valide mais est incompatible avec la gestions des erreurs. Cette écriture est donc déconseillée.

La balise #GENERER_SAISIES

Cette balise permet de générer toutes les saisies d’un formulaire, en une seule fois. Pour cela on lui passe en paramètre un tableau suivant une norme précise qui va contenir la description complète de toutes les saisies.

Exemple d’utilisation :

<ul>
	#GENERER_SAISIES{#ENV{_mes_saisies}}
</ul>

On notera l’emploi d’un _ en préfixe de la variable d’environnement. Cela permet que les guillemets présents dans les options afficher_si ne soient pas transformés en entités HTML [1].

La balise #VOIR_SAISIES

Cette balise permet d’afficher toutes les valeurs saisies après validation d’un formulaire. On lui passe en paramètre 2 arguments :

  1. le tableau de description des saisies (au même format que pour #GENERER_SAISIES)
  2. un tableau des valeurs saisies

Exemple d’utilisation, dans le squelette d’un formulaire :

[(#EDITABLE|non)
	#VOIR_SAISIES{#ENV{mes_saisies},#ENV}
]

Une norme pour décrire les saisies

Afin de manipuler plus facilement tout un ensemble de champs de formulaire, que ce soit pour générer leur HTML ou pour les modifier automatiquement dans un script, il a été défini une norme pour décrire des saisies dans un tableau PHP.

Le tableau doit respecter les points suivant :

  • Chaque saisie est un tableau de la forme :
    $une_saisie = array(
    	'saisie' => 'input',
    	'options' => array(
    		'nom' => 'nom',
    		'label' => 'Votre nom',
    		'size' => 50
    	)
    );
  • Chaque ligne du tableau d’ensemble est une saisie, elle-même étant décrite dans un tableau. L’ordre des éléments sera l’ordre des saisies.
    $saisies = array(
    	array(...), // une saisie
    	array(...), // une saisie
    	array(...)  // une saisie
    );
  • Les saisies qui acceptent des enfants (comme les fieldset) les placent dans une case « saisies » qui contiendra un tableau ayant la même structure que le tableau global :
    $un_fieldset = array(
    	'saisie' => 'fieldset',
    	'options' => array(
    		'nom' => 'mon_groupe',
    		'label' => 'Mon groupe de champ'
    	),
    	'saisies' => array(
    		array(), // une autre saisie
    		array(), // une autre saisie
    		array()  // etc
    	)
    );

Exemple complet :

$saisies = array(
	array(
		'saisie' => 'input',
		'options' => array(
			'nom' => 'nom',
			'label' => 'Nom'
		)
	),
	array(
		'saisie' => 'input',
		'options' => array(
			'nom' => 'email',
			'label' => 'Adresse de courriel'
		)
	),
	array(
		'saisie' => 'fieldset',
		'options' => array(
			'nom' => 'adresse',
			'label' => 'Adresse postale'
		),
		'saisies' => array(
			array(
				'saisie' => 'input',
				'options' => array(
					'nom' => 'voie',
					'label' => 'Voie'
				)
			),
			array(
				'saisie' => 'input',
				'options' => array(
					'nom' => 'ville',
					'label' => 'Ville'
				)
			),
		)
	),
	array(
		'saisie' => 'radio',
		'options' => array(
			'nom' => 'livre',
			'label' => 'Votre livre préféré',
			'datas' => array(
				'vermines' => 'Au régal des vermines',
				'bonheur' => 'Le bonheur',
				'alain' => 'Alain Zannini',
				'homme' => "L'homme qui arrêta d'écrire"
			)
		)
	),
);

Problème avec Xdebug

Si vous êtes développeur et que vous utilisez le logiciel Xdebug, il existe un problème connu : par défaut celui-ci affiche une erreur à partir d’un certain niveau d’imbrication de fonctions PHP (« nesting level » dirait Shakespeare).

Le niveau d’imbrication autorisé par défaut est relativement bas, mais on peut le modifier avec une variable. Vous devez donc ajouter cela dans votre configuration PHP/Xdebug :

[xdebug]
xdebug.max_nesting_level = 200 ou 500 ou plus…

Et hop, ça remarche.

Dernière modification de cette page le 21 février 2019

Discussion

136 discussions

  • 4

    Bonjour,

    avec la version 3.12.6, je n’arrive plus à définir de valeurs personnalisées pour la saisie oui_non.

    J’obtiens une erreur « Valeur postée non acceptable. »

    la fonction oui_non_valeurs_acceptables($valeur, $description) semble exclure en effet la possibilité d’utiliser de valeurs personnalisées.

    • arf, j’ai du oublier de mettre cela, parce que je savais pas que c’était possible (pas déclaré dans le yaml)

      j’essaie de m’occuper de cela présentement.

    • voilà, la version 3.12.7 devrait résoudre le problème.

    • Encore un bug ou je comprends mal le fonctionnement

      La valeur par défaut dans« oui_non » et « selection » n’est pas pris en compte.

      Actuellement, dans les saisies correspondantes, la valeur est définie

      1. #SET{valeur,#ENV{valeur_forcee,#ENV{valeur}}|is_null|?{#ENV{defaut},#ENV{valeur_forcee,#ENV{valeur}}}}

      et ma valeur défaut est ignoré.

      Si je remplace par

      1. #SET{valeur,#ENV{valeur_forcee,#ENV{valeur,#ENV{defaut}}}}

      ma valeur défaut est bien prise en compte.

      Spip 3.2.3 avec php 7.2

    Répondre à ce message

  • 16

    Bonjour,
    depuis la mise à jour du plugin vers sa dernière version disponible (v3.12.5) sous SPIP 3.2.1, j’obtiens à la validation d’un formulaire :

    ERREUR : fonction execute_pipeline_saisies_verifier absente : pipeline desactive

    Une idée de la raison ?

    • Quelle était la précédente version de saisies ? on n’a pas touché recemment aux pipelines.

      Est-ce que tu as essayé en supprimant le fichier tmp/cache/charger_pipelines.php ?

    • Merci de ta réponse rapide et de ton aide. Oui j’ai vidé tous les caches. Je ne me souviens plus la version précédentes de saisies installée, mais ma dernière mise à jour des plugins ne remonte pas plus loin que novembre dernier. J’ai fait des tests avec différents formulaires, et j’obtiens toujours le même message.

    • Ce sont des formulaires de SPIP ? ou des formulaires formidable ?

      tu as mis à jour tous les plugins ? ou seulement saisies ?

    • Je pense que la version 3.12.6 binetôt disponible devrait résoudre ce problème, mais à confirmer car je n’arrive pas à le reproduire.

    • Cela se produit avec les formulaires Formidable et oui j’ai mis à jour tous les plugins. J’espère que cela n’est pas trop grave. Ok je verrais avec la MAJ du plugin. Merci de ton attention.

    • J’ai le même log étrange :
      fonction execute_pipeline_saisies_verifier absente : pipeline desactive

      Et je ne parviens pas a en trouver l’origine, d’autant plus que les vérifications fonctionnent très bien, et que rien ne semble désactivé (SPIP 3.2.3 [24211] & API Verifier 1.8.2).

      Bonne soirée,

    • Effectivement il y a un problème. Même message.
      Celui-ci n’apparait pas lorsque le formulaire n’utilise pas afficher_si
      C’est cette utilisation qui génère ce problème.
      Soit notre appel n’est pas convenablement fait, ce qui est probable, soit il y a un autre souci.
      Je travaille sur la question...

    • Non, après un vider le cache, l’erreur se maintien et cela ne semble pas lié à « afficher_si »
      Le test se base sur :
      https://contrib.spip.net/Un-formulaire-C-V-T-avec-Saisies-par-l-exemple
      et le log
      2019-01-31 09:00:43 ::1 (pid 60629) :Pri:ERREUR : fonction execute_pipeline_saisies_verifier absente : pipeline desactive

    • Trouvé. C’était yaml. Le plugin en version test (2.0.10 - en test) n’est pas très sympathique avec SAISIES.

    • Mais de quoi c’est yaml ? Quel rapport avec le pipeline « saisies_verifier » ? Vous avez bien la dernière version de Saisies avec la modif de Maieul qui déclare le pipeline manquant, qui n’était pas déclaré depuis le début ?
      https://zone.spip.net/trac/spip-zone/changeset/113611/spip-zone

    • J’avoue non plus ne pas voir en quoi il y pourrait y avoir un lien avec yaml.

      En attendant, la question reste : quelle version du plugin saisies utilisez vous ?

    • J’étais sous SAISIES 3.12.4, j’ai tout resintallé (dont SAISIES 3.12.6 ) et j’ai eu ce message :
      Erreur dans les plugins :
      /Applications/MAMP/htdocs/plugins/yaml_v2/yaml_fonctions.php,
      /Applications/MAMP/htdocs/plugins/verifier/verifier_fonctions.php
      Après le retrait de Yaml, tout se passe bien.
      D’ou ma conclusion, certainement hâtive...

    • est tu repassé par la page d’admin des plugins après reinstall ?

    • Oui, car j’avais même réinstallé SPIP. J’avais fait table rase en local pour tout reprendre à zéro et comprendre ce qui se passait.

    • bah c’est peut être une coincidence alors.

      le mieux reste encore d’installer le plugin eu mode automatique, pour être sur d’avoir la dernière version à chaque fois.

    • En tout cas plus de problème et merci pour votre aide (ainsi que pour cette API Verfier et ce plugin SAISIES super).

    Répondre à ce message

  • 3

    Je regardais pour rendre obligatoire une saisie « radio » (pour une vérif html5) et en testant je me rends compte que ca ne fonctionne pas tip top.
    Et le fichier radio.html ne fait aucune mention d’un test sur obligatoire.

    1. [(#HTML5|oui)[(#ENV{obligatoire}|et{#ENV{obligatoire}|!={non}}|oui) required="required"]]

    C’est voulu ?

    Du coup je surcharge ma saisie avec le code ci-dessus.

    Répondre à ce message

  • 6

    Bonjour à tous,
    Je rencontre un soucis avec l’utilisation du paramètre « afficher_si » dans un formulaire dont les champs sont généré via PHP, puis en exploitant la balise #GENERER_SAISIE.

    Voici un morceau de mon formulaire CVT en php :

    $saisies[]= array(
                'saisie' => 'selection',
                'options' => array(
                    'nom' => 'select_type_inscrit',
                    'label' => 'Type d\'inscrit',
                    'obligatoire' => 'oui',
                    'datas' => array(
                        'membre' => 'Membre à jour',
                        'non_membre' => 'Non-membre',
                        'public' => 'Personne sans compte'    
                    ),
                    'defaut' => 'membre'
                )
            );
    $saisies[]= array(
                'saisie' => 'input',
                'options' => array(
                    'nom' => 'prenom_inscrit',
                    'label' => 'Prénom',               
                    'afficher_si' =>  '@select_type_inscrit@=="public"'
                ),            
            );

    Je souhaiterais n’afficher dans mon formulaire le champ prenom_inscrit que si le champ précédent est égal à ’public’.

    Malheureusement, je me retrouve avec une erreur Javascript :
    Uncaught SyntaxError : Unexpected token &

    On peut effectivement constater que dans le javascript généré on voit cela :

    1. :val()=&quot;public&quot;)

    Les guillemets sont remplacés par leur code html, je ne pense que cela soit normal, et provoque ensuite une erreur ...


    Voici le début du code javascript généré

    1. $(function(){chargement=true;verifier_saisies_1944237048 = function(form){if ($(form).find("[name='select_type_inscrit']").val()=&quot;public&quot;) {$(form).find(".editer_prenom_inscrit").show(400);

    Coté html, je vois que mon champ est bien généré :

    <div class="editer editer_prenom_inscrit saisie_input" data-afficher_si="@select_type_inscrit@="public"">
    	<label for="champ_prenom_inscrit">Prénom</label>
    	<input type="text" name="prenom_inscrit" class="text" id="champ_prenom_inscrit">
    </div>

    J’ai essayé de nombreuses syntaxes différentes pour définir la condition mais rien n’y fait...

    Merci de vos lumières !
    Jul

    • SPIP protège automatiquement les guillemets pour les variables passé au chargement du formulaire. D’où le « " ».

      Mais tu peux désactiver cela en mettant un _ devant le nom de la variable dans le tableau de retour.

      function formulaires_test_charger() {
      	$saisies[]= array(
                  'saisie' => 'selection',
                  'options' => array(
                      'nom' => 'select_type_inscrit',
                      'label' => 'Type d\'inscrit',
                      'obligatoire' => 'oui',
                      'datas' => array(
                          'membre' => 'Membre à jour',
                          'non_membre' => 'Non-membre',
                          'public' => 'Personne sans compte'
                      ),
                      'defaut' => 'membre'
                  )
              );
      $saisies[]= array(
                  'saisie' => 'input',
                  'options' => array(
                      'nom' => 'prenom_inscrit',
                      'label' => 'Prénom',
                      'afficher_si' =>  '@select_type_inscrit@==\'public\''
                  ),
      					);
      	return array('_saisies' => $saisies);
      }

      et

      1. #GENERER_SAISIES{#ENV{_saisies}}
    • Merci Maïeul !
      Une réponse simple et efficace ! Je viens de tester, et cela fonctionne fort bien !

      J’avoue que je n’aurais jamais trouvé !

      Malgré tout est-ce normal comme comportement vu que c’est obligé d’utilisé les ’ ou ’’ dans la condition de afficher_si ?
      Il n’y a pas mention de cette subtilité dans la doc, est-ce un oubli d’après toi ou c’est moi qui utilise cet outil de manière non-conventionnelle ?

      un grand Merci !

    • En fait :
      -  le comportement de protection des attributs relève du comportement de CVT. Et c’est donc documenté dans la doc de CVT : https://www.spip.net/fr_article4151.html
      -  la présente doc a été écrite avant que _afficher_si soit implémenté.

      Je viens de corriger ici ainsi que dans la doc spécifique à _afficher_si.

    • J’ai eu le même problème avant cette discussion et je l’avais résolu par :

      1. [(#GENERER_SAISIES{#ENV{saisies}}|html_entity_decode)]

      Mais bon je ne sais pas si c’est le mieux :)

    • bof, c’est pas terrible, car tu pourrais avoir besoin d’entité encodées pour x raison.

    • Bon et bien je vais adopter l’astuce du underscore :)

    Répondre à ce message

  • 5

    bonjour,
    je télécharge saisie depuis cette page
    Version 3.8.3
    (ZIP – 193.5 ko) SPIP 3.0, SPIP 3.1, SPIP 3.2
    quand j’active le plugin il me met dans la page des plugins actif :
    Saisies pour formulaires 2.28.0 - stable
    Écrire facilement des champs de formulaires
    Est ce normal ? quelle est vraiment la version
    merci

    • je suis étonné. La version marqué « saisies_v3 » contient bien la version 3.x de saisies

    • Bonjour,
      merci de me répondre., entre temps, pressé par une démo à faire, j’ai posé la question sur la liste et j’ai eu cette réponse de Frank
      « ce qui c’est passé, c’est que au moment de la création de la 3e branche, il y a eu oubli de faire l’ajout du zip dans l’article puisque ce n’est pas automatique (contrairement à plugin.spip). Je viens de mettre à jour les zips dans l’article de contrib😊 »

      Si j’ai bien compris les différentes réponses, il est préférable :
      -  En manuel de prendre en priorité sur plugin.spip
      -  En automatique suivre la procédure expliqué sur https://www.spip.net/fr_article3396.html

    • A oui, c’est bien possible (même si normalement c’est censé être automatique, ca bug)

    • Oui normalement c’est bien automatique (mais pas immédiat) : d’abord ça génère les ZIP, ça se met à jour sur plugins.spip (après déjà un délai) et ensuite un autre robot reporte ces ZIP sur Contrib (deuxième délai).

      Je sais pas si des trucs ont pu sauter avec la mise à jour des squelettes de Contrib…

    • Rasta : c’est surtout que le robot qui met à jour sur contrib le fait de la mnière aléatoire (il prend x plugin au hasard) et pas de manière linéaire...

      LA sortie de la version 3 de saisies date de bien avant la nouvelle version de contrib

    Répondre à ce message

  • 2

    Bonjour,
    Dans la descriptions des saisies, au niveau des styles de l’espace privé des formulaires, l’option d’avertissement (attention) n’est pas stylisée :

    code généré entre « explication » et « la saisie »

    <em class="attention">ça pique</em>

    Est ce possible d’ajouter les styles de saisie qui vont bien ? (attention = notice ?)
    J’oublie peut être quelque chose ?

    Répondre à ce message

  • 2

    Bonjour,
    j’utilise saisie avec un formulaire yaml.
    est-il possible d’avoir un champ <input type=’color’ avec la derniere version de saisie ? si oui comment ?
    merci

    Répondre à ce message

  • 6

    Je note ici pour ne pas oublier : l’option afficher_si ne fonctionne pas pour les saisies enfants d’une saisie fieldset

    • Je m’en sert régulièrement sur un formulaire formidable sans souci.

    • Ah oui, je confirme, ça fonctionne dans formidable.
      Moi c’est dans le contexte de saisies générées à partir d’un yaml, pour une noisette.
      Le JS n’est pas présent dans le squelette compilé (mais il y a bien le data-afficher_si sur le .editer).

      parametres:
        -
          saisie: 'fieldset'
          options:
            nom: 'fieldset_affichage'
            label: 'Options d’affichage'
            saisies:
              -
                saisie: 'radio'
                options:
                  nom: 'choix_titre'
                  label: 'Choix du titre'
                  datas:
                    defaut: 'Par défaut'
                    perso: 'Titre personnalisé'
              -
                saisie: 'input'
                options:
                  nom: 'titre'
                  label: 'Titre personnalisé'
                  afficher_si: "@choix_titre@=='perso'"
    • Ça fonctionne très bien tout compte fait, je n’avais pas indenté le yaml correctement, cf https://contrib.spip.net/noiZetier-v2#forum494678

    • Pierrox

      Salut !

      Lorsque j’utilise un fichier yaml pour générer mes saisies j’ai un gros bug avec la syntaxe des critères afficher_si

      1. afficher_si: "@choix_titre@ IN 'perso'"

      Avec une condition de type == ou != pas de problème

      PHP Parse error :  syntax error, unexpected ’IN’ (T_STRING) in /var/www/spip3.2/sites/dist/plugins/auto/saisies/v2.26.9/inc/saisies_afficher.php(550) : eval()’d code on line 1, referer : http://dist.loc/spip.php?article1&id_article=1&var_mode=recalcul
    • Salut,

      je n’ai jamais utilisé YAML pour des saises. Pas impossible qu’il y ait des soucis dans le parseur. Mais sinon, je suis même pas certains que IN soit acceptés en tant que tel (je me rappelle plus).
      Dans tous les cas, il me faudrait un YAML complet mais minimum pour résoudre le problème.

    • chez moi dans les options ceci fonctionne :

         label: "titre du bloc"
          afficher_si: '@afficher@=="inclusdans"'

      regarde si tu n’as pas un problème d’indentation

    Répondre à ce message

  • Bonjour,
    Je teste le générateur de formulaire qui utilise ceplugin, et il m’a l’air très bien, sauf qu’il me manque des champs importants, la possibilité de saisir des coordonnées gps, et surtout d’afficher des cartes (google map ou open street) avec ses coordonnées et des infos sous forme de bulles sur la carte.
    Des idées pour pouvoir le faire ?
    Merci de votre travail partagé à la communauté.

    Répondre à ce message

  • 6

    Bonjour,

    Pour éviter à d’autres d’avoir le problème.

    Avec formidable, j’ai un formulaire qui a des cases à cocher.
    Il est donc possible de sélectionner plusieurs items dans la liste.

    Mais dans le mail envoyé, et dans ecrire/ ?exec=formulaires_reponses&id_formulaire=1 quand je vais voir le détail, je n’ai que la première option de mémorisée, alors que j’ai mis d’autres valeurs.

    Raison : je faisais :
    165/Hotelvendredi|Hôtel vendredi 9 novembre<br />165 €

    En remplaçant le / par &, plus de problème !

    • Précision : ce qui marche, c’est donc :
      165&Hotelvendredi|Hôtel vendredi 9 novembre<br />165 €

    • A oui, le / est utilisé pour des sous entrées. Du coup je ne sais pas si on peut résoudre ce bug facilement sans casser le reste. Il faudrait pouvoir échapper le / mais je ne suis pas sûr que cela vaille la peine....

    • Non, je ne crois pas que ça vaille la peine.

      Par contre, où est la doc de ce « / » ?

    • Je sais pas s’il y une doc. J’ai vu passer cela récemment en lisant le code pour améliorer un point.

    • Des sous entrées de quoi ?

      Moi je me rappelais juste du truc ajouté par Maieul qui ajoute de la syntaxes pour faire des groupes dans les textarea libres pour les valeurs de select. Mais pour les radios et cases là je me souviens pas d’ajouts.

    • j’ai du confondre avec autre chose, je retrouve pas.

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom