Référence des saisies

Publié le : 27 mars 2010 – Dernière modification le 19 mars 2024 – par Jean-Baptiste Pressac, RastaPopoulos – 160 commentaires

1
2
3
4
5
35 votes

Cette documentation a été générée à partir de la v5.4.1 du plugin Saisies.

Sauter à : Toutes les saisies, Toutes les options de base, Toutes les options de dev.

Utilisation des options de base


Champ libreChoix restreintStructureContenu éditorialDivers
Options \ Saisiestextareainputemaildateradiocasecheckboxselectiondestinataireschoix_grillefieldsetexplicationconteneur_inlineselecteur_articleselecteur_rubrique_articleauteursselecteur_documentmotselecteur_rubriquehidden
afficher_art_dans_langue_interface-------------XX-----
afficher_langue-------------XX---X-
afficher_rub_dans_langue_interface--------------X---X-
afficher_siXXXXXXXXXXXX-XXXXXXX
afficher_si_avec_postXXXXXXXXXXXX-XXXXXXX
afficher_si_remplissage_uniquementXXXXXXXXXXXX-XXXXXXX
attentionXXXXXXXXXXX--XXXXXX-
attribut_title------X-------------
autocomplete-XX-----------------
cacher_option_intro-------X-------X-X--
choix_alternatif----X-XX------------
choix_alternatif_explication----X-XX------------
choix_alternatif_label----X-XX------------
choix_destinataires--------X-----------
classXXXXXXXX-X--X----X-X
colonnes------------X-------
colsX-------------------
conteneur_classXXXXXXXX-XXX-------X
data----X-XX------------
data_cols---------X----------
data_rows---------X----------
defautXXXXXXXX-------X-X-X
defaut_session-XX-----------------
depublie_choix----X-XX------------
disableXXXXXXXX-----XXX-XX-
disable_avec_postXXXXXXXX-----XXX-XX-
disable_choix----X-XX------------
erreur_obligatoireXXXXXXXXXX---XXXXXX-
explicationXXXXXXXXXXX--XXXXXX-
explication_apresXXXXXXXXXXX--XXXXXX-
forcer_select-----------------X--
heure_pas---X----------------
horaire---X----------------
id_groupe-----------------X--
info_obligatoireXXXXXXXXXX---XXXXXX-
inserer_barreX-------------------
labelXXXXXXXXXXX--XXXXXXX
label_case-----X--------------
label_non-----X--------------
label_oui-----X--------------
liens_meme_fenetre-----------X--------
limite_branche-------------X----X-
longueur_maxX-------------------
masquer-----------X--------
maximum_choix------X-------------
maxlength-XX-----------------
minlength-X------------------
multiple-------X-X---XXX-XX-
obligatoireXXXXXXXXXX---XXXXXX-
onglet----------X---------
onglet_vertical----------X---------
option_intro-------XX------X-X--
option_statut---------------X----
placeholderXXX-----------------
pliable----------X---------
plie----------X---------
previsualisationX-------------------
readonlyXXXX-X-------XX---X-
rowsX-------------------
size-XX----X-------X-X--
statut---------------X----
texte-----------X--------
titre-----------X--------
type-XX-----------------
type_choix--------X-----------
valeur_non-----X--------------
valeur_oui-----X--------------
vue_masquer_sous_groupe----X-XX------------

Utilisation des options de dev

Options disponibles uniquement pour le dévellopement PHP/Squelette.


Champ libreChoix restreintStructureContenu éditorialDivers
Options \ Saisiestextareainputemaildateradiocasecheckboxselectiondestinataireschoix_grillefieldsetexplicationconteneur_inlineselecteur_articleselecteur_rubrique_articleauteursselecteur_documentmotselecteur_rubriquehidden
alerte_role-----------X--------
alerte_type-----------X--------
attributsXXXXXXXXXXXX-XXXXXXX
idXXXXXXXXXXXX-XXXXXXX
inserer_debutXXXXXXXXXXXX-XXXXXXX
inserer_finXXXXXXXXXXXX-XXXXXXX

Toutes les saisies, par catégories

Champ libre

Bloc de texte (textarea)

Description : Un champ de texte sur plusieurs lignes.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, class, cols, conteneur_class, defaut, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, inserer_barre, label, longueur_max, obligatoire, placeholder, previsualisation, readonly, rows

Options de dev :
attributs, id, inserer_debut, inserer_fin

Ligne de texte (input)

Description : Une simple ligne de texte, pouvant être visible ou masquée (mot de passe).

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, autocomplete, class, conteneur_class, defaut, defaut_session, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, maxlength, minlength, obligatoire, placeholder, readonly, size, type

Options de dev :
attributs, id, inserer_debut, inserer_fin

Adresse email (email)

Description : Permet d’avoir un champ de type email en HTML5.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, autocomplete, class, conteneur_class, defaut, defaut_session, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, maxlength, obligatoire, placeholder, readonly, size, type

Options de dev :
attributs, id, inserer_debut, inserer_fin

Date (date)

Description : Permet de saisir une date à l’aide d’un calendrier

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, class, conteneur_class, defaut, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, heure_pas, horaire, info_obligatoire, label, obligatoire, readonly

Options de dev :
attributs, id, inserer_debut, inserer_fin

Choix restreint

Boutons radios (radio)

Description : Permet de choisir une option parmi plusieurs disponibles.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, choix_alternatif, choix_alternatif_explication, choix_alternatif_label, class, conteneur_class, data, defaut, depublie_choix, disable, disable_avec_post, disable_choix, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, obligatoire, vue_masquer_sous_groupe

Options de dev :
attributs, id, inserer_debut, inserer_fin

Case unique (case)

Description : Permet d’activer ou de désactiver quelque chose.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, class, conteneur_class, defaut, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, label_case, label_non, label_oui, obligatoire, readonly, valeur_non, valeur_oui

Options de dev :
attributs, id, inserer_debut, inserer_fin

Cases à cocher (checkbox)

Description : Permet de choisir plusieurs options avec des cases.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, attribut_title, choix_alternatif, choix_alternatif_explication, choix_alternatif_label, class, conteneur_class, data, defaut, depublie_choix, disable, disable_avec_post, disable_choix, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, maximum_choix, obligatoire, vue_masquer_sous_groupe

Options de dev :
attributs, id, inserer_debut, inserer_fin

Liste déroulante / sélection (selection)

Description : Choisir une option dans une liste déroulante.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, cacher_option_intro, choix_alternatif, choix_alternatif_explication, choix_alternatif_label, class, conteneur_class, data, defaut, depublie_choix, disable, disable_avec_post, disable_choix, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, multiple, obligatoire, option_intro, size, vue_masquer_sous_groupe

Options de dev :
attributs, id, inserer_debut, inserer_fin

Destinataires (destinataires)

Description : Permet de choisir des destinataires parmi des comptes pré-sélectionnés.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, choix_destinataires, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, obligatoire, option_intro, type_choix

Options de dev :
attributs, id, inserer_debut, inserer_fin

Grille de questions (choix_grille)

Description : Permet de poser une série de questions à choix multiple d’une manière uniformisé et sous forme de grille

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, class, conteneur_class, data_cols, data_rows, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, multiple, obligatoire

Options de dev :
attributs, id, inserer_debut, inserer_fin

Structure

Groupe de champs (fieldset)

Description : Un cadre qui pourra englober plusieurs champs.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, conteneur_class, explication, explication_apres, label, onglet, onglet_vertical, pliable, plie

Options de dev :
attributs, id, inserer_debut, inserer_fin

Explication (explication)

Description : Un texte explicatif général.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, conteneur_class, liens_meme_fenetre, masquer, texte, titre

Options de dev :
alerte_role, alerte_type, attributs, id, inserer_debut, inserer_fin

Affichage en ligne (conteneur_inline)

Description : Pour regrouper visuellement des champs en ligne.

Options de base :
class, colonnes

Options de dev :
alerte_role, alerte_type, attributs, id, inserer_debut, inserer_fin

Contenu éditorial

Article (selecteur_article)

Description : Affiche un navigateur de sélection d’article

Options de base :
afficher_art_dans_langue_interface, afficher_langue, afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, limite_branche, multiple, obligatoire, readonly

Options de dev :
attributs, id, inserer_debut, inserer_fin

Article ou rubrique (selecteur_rubrique_article)

Description : Affiche un navigateur de sélection d’article ou de rubrique

Options de base :
afficher_art_dans_langue_interface, afficher_langue, afficher_rub_dans_langue_interface, afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, multiple, obligatoire, readonly

Options de dev :
attributs, id, inserer_debut, inserer_fin

Autrices et auteurs (auteurs)

Description : Permet de sélectionner un auteur, une autrice, ou plusieurs

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, cacher_option_intro, defaut, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, multiple, obligatoire, option_intro, option_statut, size, statut

Options de dev :
attributs, id, inserer_debut, inserer_fin

Document (selecteur_document)

Description : Affiche un sélecteur de document

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, obligatoire

Options de dev :
attributs, id, inserer_debut, inserer_fin

Mot-clé (mot)

Description : Des mots-clés d’un groupe de mot

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, cacher_option_intro, class, defaut, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, forcer_select, id_groupe, info_obligatoire, label, multiple, obligatoire, option_intro, size

Options de dev :
attributs, id, inserer_debut, inserer_fin

Rubrique (selecteur_rubrique)

Description : Affiche un navigateur de sélection de rubrique

Options de base :
afficher_langue, afficher_rub_dans_langue_interface, afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, attention, disable, disable_avec_post, erreur_obligatoire, explication, explication_apres, info_obligatoire, label, limite_branche, multiple, obligatoire, readonly

Options de dev :
attributs, id, inserer_debut, inserer_fin

Divers

Champ caché (hidden)

Description : Un champ pré-rempli que l’internaute ne pourra pas voir.

Options de base :
afficher_si, afficher_si_avec_post, afficher_si_remplissage_uniquement, class, conteneur_class, defaut, label

Options de dev :
attributs, id, inserer_debut, inserer_fin

Toutes les options de base

Affichage multilingue (afficher_art_dans_langue_interface)

Description : Afficher uniquement les articles de la langue de l’internaute

Utilisée par :
selecteur_article, selecteur_rubrique_article

Afficher la langue (afficher_langue)

Description : Affiche la langue de l’article ou rubrique sélectionné devant le titre

Utilisée par :
selecteur_article, selecteur_rubrique, selecteur_rubrique_article

Affichage multilingue (afficher_rub_dans_langue_interface)

Description : Afficher uniquement les rubriques de la langue de l’internaute

Utilisée par :
selecteur_rubrique, selecteur_rubrique_article

Affichage conditionnel (afficher_si)

Description : Indiquez les conditions pour afficher le champ en fonction de la valeur des autres champs. L’identifiant des autres champs doit être mis entre @.
Exemple @selection_1@=="Toto" conditionne l’affichage du champ à ce que le champ selection_1 ait pour valeur la clé Toto.
Il est possible d’utiliser les opérateurs booléens || (ou) et && (et).
Vous trouverez la documentation complète de la syntaxe sur SPIP-contrib.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Poster tout de même -Poster la valeur en cas de masquage de saisie (afficher_si_avec_post)

Description : Par défaut les valeurs des saisies masquées par l’affichage conditionnel ne sont pas postées, donc pas enregistrées. Cochez cette case pour changer ce comportement.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Uniquement lors du remplissage -Masquer la saisie uniquement lors du remplissage (afficher_si_remplissage_uniquement)

Description : En cochant cette case, l’affichage conditionnel s’appliquera uniquement lors du remplissage du formulaire, pas lors de l’affichage des résultats.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Avertissement (attention)

Description : Un message plus important que l’explication.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, fieldset, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Valeur en attribut title -Mettre un attribut title dans le label, contenant la valeur technique du champ. À utiliser avec modération. (attribut_title)

Description : Mettre un attribut title dans le label, contenant la valeur technique du champ. À utiliser avec modération.

Utilisée par :
checkbox

Pré-remplissage du champ (autocomplete)

Description : Au chargement de la page, votre navigateur peut pré-remplir le champ en fonction de son historique

Utilisée par :
email, input

Choix possibles :

  • « defaut » : Laisser par défaut
  • « on » : Activer
  • « off » : Désactiver

Cacher le premier choix vide (cacher_option_intro)

Utilisée par :
auteurs, mot, selection

Proposer un choix alternatif (choix_alternatif)

Utilisée par :
checkbox, radio, selection

Explication du choix alternatif (choix_alternatif_explication)

Utilisée par :
checkbox, radio, selection

Label de ce choix alternatif (choix_alternatif_label)

Utilisée par :
checkbox, radio, selection

Destinataires possibles (choix_destinataires)

Description : Liste d’auteurs et d’autrices pour une sélection de destinataires par l’internaute, à défaut ce sera la personne qui a installé le site.

Utilisée par :
destinataires

Classes CSS supplémentaires (class)

Utilisée par :
case, checkbox, choix_grille, conteneur_inline, date, email, hidden, input, mot, radio, selection, textarea

Mode d’affichage (colonnes)

Utilisée par :
conteneur_inline

Choix possibles :

  • « 1ligne_max » : Largeur automatique, sur une seule ligne, prendre le plus de place
  • « 1ligne » : Largeur automatique, sur une seule ligne, prendre le moins de place
  • « xlignes_max » : Largeur automatique, sur plusieurs lignes, prendre le plus de place
  • « xlignes » : Largeur automatique, sur plusieurs lignes, prendre le moins de place
  • « col2 » : Deux champs par ligne
  • « col3 » : Trois champs par ligne
  • « col4 » : Quatre champs par ligne

Largeur (cols)

Description : Largeur du bloc en nombre de caractères. Cette option n’est pas toujours appliquée car les styles CSS de votre site peuvent l’annuler.

Utilisée par :
textarea

Classes CSS supplémentaires sur le conteneur (conteneur_class)

Utilisée par :
case, checkbox, choix_grille, date, email, explication, fieldset, hidden, input, radio, selection, textarea

Liste des choix possibles (data)

Description : Vous devez indiquez un choix par ligne sous la forme « cle|Label du choix ».
La clé doit être unique, brève, claire et ne doit plus être modifiée par la suite.

Description pour les devs : Fournir une liste de choix sous la forme d’un tableau PHP (array()) ou SPIP (#ARRAY) sous forme "clé" => "valeur".
Vous pouvez regrouper en sous groupe. Pour ce faire, la clé doit être le titre du sous groupe, et la valeur doit être elle-même un tableau associatif de type "clé" => "valeur".

Utilisée par :
checkbox, radio, selection

Réponses possibles (en colonne) (data_cols)

Description : Vous devez indiquez un choix par ligne sous la forme « cle|Label du choix ».
La clé doit être unique, brève, claire et ne doit plus être modifiée par la suite.

Description pour les devs : Fournir un liste de choix sous la forme d’un tableau PHP (array()) ou SPIP (#ARRAY) de type "cle"=>"Label du choix".

Utilisée par :
choix_grille

Questions (en ligne) (data_rows)

Description : Vous devez indiquer un choix par ligne sous la forme « cle|Label du choix » ou bien « cle|Label à gauche|Label à droite »
La clé doit être unique, brève, claire et ne doit plus être modifiée par la suite.

Description pour les devs : Fournir une liste de choix sous la forme d’un tableau PHP (array()) ou SPIP (#ARRAY) de type "cle"=>"Label du choix" ou bien "cle"=>"Label à gauche|Label à droite".

Utilisée par :
choix_grille

Valeur par défaut (defaut)

Utilisée par :
auteurs, case, checkbox, date, email, hidden, input, mot, radio, selection, textarea

Valeur par défaut depuis la session de l’internaute (defaut_session)

Description : Mettre le champ de session à utiliser. Si ce champ existe dans la session courante, sa valeur l’emportera sur la valeur par défaut.

Utilisée par :
email, input

Choix possibles :

  • « 0 » : email
  • « 1 » : nom

Dépublier certains choix (depublie_choix)

Description : Un choix dépublié ne sera plus proposé pour les nouveaux formulaires. Il restera visible si on modifie un enregistrement qui contenait ce choix.
Indiquer les choix séparés par une virgule, exemple : choix1,choix3.

Description pour les devs : Un choix dépublié ne sera plus proposé pour les nouveaux formulaires. Il restera visible si on modifie un enregistrement qui contenait ce choix.
Indiquer les choix sous forme de tableau, exemple : ["choix1","choix3"].

Utilisée par :
checkbox, radio, selection

Désactiver le champ (disable)

Description : Le champ ne peut plus obtenir le focus.

Utilisée par :
auteurs, case, checkbox, date, email, input, mot, radio, selecteur_article, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Désactiver mais poster (disable_avec_post)

Description : Identique à l’option précédente mais poste quand même la valeur dans un champ caché.

Utilisée par :
auteurs, case, checkbox, date, email, input, mot, radio, selecteur_article, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Désactiver certains choix (disable_choix)

Description : Indiquer les choix séparés par une virgule, exemple : choix1,choix3.

Description pour les devs : Indiquer les choix sous forme de tableau, exemple : ["choix1","choix3"].

Utilisée par :
checkbox, radio, selection

Message d’erreur pour l’obligation (erreur_obligatoire)

Description : Vous pouvez personnaliser le message d’erreur affiché pour indiquer l’obligation (sinon laisser vide).

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Explication (explication)

Description : Si besoin, une courte phrase décrivant l’objet du champ.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, fieldset, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Explication après le champ (explication_apres)

Attention : Pour des raisons d’accessibilité, les explications importantes doivent toujours être avant la saisie.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, fieldset, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Forcer l’utilisation d’un select (forcer_select)

Description : Si un groupe de mots est sélectionné, par défaut il s’agira d’une saisie radio. Vous pouvez forcer l’utilisation d’un select.

Utilisée par :
mot

Intervalle des minutes dans le menu d’aide à la saisie (heure_pas)

Description : Lorsque vous utilisez l’horaire, un menu s’affiche pour aider à saisir heures et minutes. Vous pouvez ici choisir l’intervalle de temps entre chaque choix (par défaut 30min).

Utilisée par :
date

Choix possibles :

  • « 0 » : 1 minute
  • « 1 » : 2 minutes
  • « 2 » : 5 minutes
  • « 3 » : 15 minutes
  • « 4 » : 30 minutes

Horaire -Permettre de saisir aussi l’horaire (horaire)

Description : Permettre de saisir aussi l’horaire

Utilisée par :
date

Groupe de mots (id_groupe)

Utilisée par :
mot

Indication d’obligation (info_obligatoire)

Description : Vous pouvez modifier l’indication d’obligation par défaut : [Obligatoire]. Pour garder l’information par défaut, ne rien mettre. Pour ne rien afficher, mettre un texte composé uniquement d’espace.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Insérer une barre d’outils (inserer_barre)

Description : Insère une barre d’outils du porte-plume si ce dernier est activé.

Utilisée par :
textarea

Choix possibles :

  • « edition » : barre d’édition complète
  • « forum » : barre des forums

Label (label)

Description : Le titre qui sera affiché.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Label placé à côté de la case (label_case)

Utilisée par :
case

Label si la case n’est pas cochée (label_non)

Description : Sera visible lors de l’affichage des résultats.

Utilisée par :
case

Label si la case est cochée (label_oui)

Description : Sera visible lors de l’affichage des résultats.

Utilisée par :
case

Ouvrir les liens dans la même fenêtre (liens_meme_fenetre)

Utilisée par :
explication

Limiter à une branche (limite_branche)

Description : Limitera le choix à une branche spécifique du site

Utilisée par :
selecteur_article, selecteur_rubrique

Nombre de caractères maximum (longueur_max)

Description : L’internaute ne pourra pas saisir plus de caractères que ce nombre.

Utilisée par :
textarea

Ajouter un bouton afficher/masquer l’explication (masquer)

Utilisée par :
explication

Limiter le nombre de choix (maximum_choix)

Description : Nombre de choix maximum ?

Utilisée par :
checkbox

Nombre de caractères maximum (maxlength)

Description : L’internaute ne pourra pas saisir plus de caractères que ce nombre.

Utilisée par :
email, input

Nombre de caractères minimum (minlength)

Description : L’internaute ne pourra pas saisir moins de caractères que ce nombre.

Utilisée par :
input

Sélection multiple (multiple)

Description : L’internaute pourra sélectionner plusieurs valeurs

Utilisée par :
auteurs, choix_grille, mot, selecteur_article, selecteur_rubrique, selecteur_rubrique_article, selection

Champ obligatoire (obligatoire)

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Onglet -Afficher sous forme d’onglet (onglet)

Description : Afficher sous forme d’onglet

Utilisée par :
fieldset

Onglet vertical (onglet_vertical)

Description : Il suffit qu’un seul onglet dans un groupe soit marqué comme vertical pour que l’ensemble des onglets soient verticaux.

Utilisée par :
fieldset

Label du premier choix vide (option_intro)

Utilisée par :
auteurs, destinataires, mot, selection

Afficher les statuts (option_statut)

Utilisée par :
auteurs

Placeholder (placeholder)

Utilisée par :
email, input, textarea

Pliable -Le groupe de champs pourra être replié (pliable)

Description : Le groupe de champs pourra être replié

Utilisée par :
fieldset

Déjà plié -Si le groupe de champs est pliable, il sera déjà plié à l’affichage du formulaire (plie)

Description : Si le groupe de champs est pliable, il sera déjà plié à l’affichage du formulaire

Utilisée par :
fieldset

Activer la prévisualisation (previsualisation)

Description : Si le porte-plume est activé, ajoute un onglet pour prévisualiser le rendu du texte saisi.

Utilisée par :
textarea

Lecture seule (readonly)

Description : Le champ peut être lu, sélectionné, mais pas modifié.

Utilisée par :
case, date, email, input, selecteur_article, selecteur_rubrique, selecteur_rubrique_article, textarea

Nombre de lignes (rows)

Description : Hauteur du bloc en nombre de ligne. Cette option n’est pas toujours appliquée car les styles CSS de votre site peuvent l’annuler.

Utilisée par :
textarea

Taille du champ (size)

Description : Largeur du champ en nombre de caractères. Cette option n’est pas toujours appliquée car les styles CSS de votre site peuvent l’annuler.

Utilisée par :
auteurs, email, input, mot, selection

Statut(s) particulier(s) (statut)

Utilisée par :
auteurs

Choix possibles :

  • « 0minirezo » : Administrateurs
  • « 1comite » : Rédacteurs
  • « 6forum » : Visiteurs

Texte de l’explication (texte)

Description : Un texte explicatif général.

Utilisée par :
explication

Titre de l’explication (titre)

Utilisée par :
explication

Texte masqué lors de la saisie (ex : mot de passe) (type)

Utilisée par :
email, input

Type de choix (type_choix)

Utilisée par :
destinataires

Choix possibles :

  • « tous » : Mettre toutes ces personnes en destinataires. L’internaute n’aura aucun choix.
  • « un » : Permettre à l’internaute de choisir une seule personne (sous forme de liste déroulante).
  • « un_radio » : Permettre à l’internaute de choisir une seule personne (sous forme de liste à puce).
  • « plusieurs » : Permettre à l’internaute de choisir plusieurs destinataires.

Valeur non (valeur_non)

Description : Valeur postée si la case n’est pas cochée. Attention, il s’agit d’une valeur technique et non d’une valeur affichée.

Utilisée par :
case

Valeur oui (valeur_oui)

Description : Valeur postée si la case est cochée. Attention, il s’agit d’une valeur technique et non d’une valeur affichée.

Utilisée par :
case

Lors de l’affichage du résultat, n’afficher que la valeur, sans le sous-groupe (vue_masquer_sous_groupe)

Utilisée par :
checkbox, radio, selection

Toutes les options de dev

Options disponibles uniquement pour le dévellopement PHP/Squelette.

Rôle d’alerte (alerte_role)

Description : Si besoin, pour l’espace privé uniquement choisir un rôle d’alerte (attribut html role : alert, status, etc.).

Utilisée par :
explication

Type d’alerte (alerte_type)

Description : Si besoin, pour l’espace privé uniquement choisir un type d’alerte parmis ceux proposés par SPIP (notice, error, success, info).

Utilisée par :
explication

Attributs HTML supplémentaires (attributs)

Description : Les attributs portent sur chaque champ html, y compris pour les saisies avec plusieurs champs (radio, checkbox, etc.).

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Attribut id de la saisie (id)

Description : Sera automatiquement préfixé par champ_.

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Code à insérer en début de saisie (inserer_debut)

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Code à insérer en fin de saisie (inserer_fin)

Utilisée par :
auteurs, case, checkbox, choix_grille, date, destinataires, email, explication, fieldset, hidden, input, mot, radio, selecteur_article, selecteur_document, selecteur_rubrique, selecteur_rubrique_article, selection, textarea

Addendum historique

  • L’option datas est encore supportée, mais on lui préferera l’option data.
  • La saisie oui_non ne doit plus être utilisée. On lui préférera la saisie radio, avec des libellés pouvant se comprendre hors contexte (« J’accepte telle action » / « Je refuse telle action »).
  • La saisie selection_multiple ne doit plus être utilisée. On lui préféra la saisie selection avec l’option multiple.

Discussion

5 ans 1 an 3 mois Sans limite
par date
Filtrer

39 discussions

  • 7
    stefdn

    bonjour,

    je découvre ce plugin fort utile et j’ai quelques remarques et questions :

    1. il me semble que l’attribut title n’est pas dispo, il serait utile comme option générique non ?
    2. ou, d’une manière plus générale, ne serait-il pas possible d’implémenter une option de saisie attributs qui serait une liste :
      'attributs' => array('attribut' => 'valeur')
    1. je ne trouve pas de références aux boutons (submit, image, reset) ... faut les traiter en dehors des saisies ?
    2. j’essaie d’afficher la saisie explication, sans succès. Une idée ? :

    dans formulaires/testou.php :

    function formulaires_testou_charger_dist() {
$saisies = array(
    array(
      'saisie' => 'explication',
      'options' => array(
        'li_class' => 'laclass',
        'texte' =>  'Bablabla blaaablabla blabal'
      )
    ),
);
  return array('_saisies'=>$saisies);
}

    dans formulaires/testou.html :

    	<form ...><ul> #GENERER_SAISIES{#ENV{_saisies}} </ul></form>

    et dans mon squelette :

    #FORMULAIRE_TESTOU

    ma config : spip 2.0.11 / plugins yaml et bonux activés

    • RastaPopoulos
      1. Oui pour le title ce serait intéressant
      2. Pour un tableau d’attribut ça serait plus compliqué car il faudrait alors gérer les collisions possible avec les attributs ayant leur option à part (comme la class, le title, etc). Et si on ne mettait QUE un tableau d’attributs pour qu’il n’y ait pas de collisions, c’est limite pire car c’est trop abstrait, contrairement aux options pour un attribut précis, ça n’aide pas les gens.
      3. Pour les boutons, ce n’est pas géré, en tout cas pour l’instant. Ça ne gère que le contenu du formulaire. Mais je suis d’accord que parfois pour des cas complexes on peut avoir besoin de boutons à l’intérieur même du formulaire et pas juste à la fin. Donc il faudrait effectivement rajouter les différentes possibilités de boutons existants. À ajouter à la todo.
      4. Pour la saisie explication... chez-moi-ça-marche :( Quel est le retour ? Une erreur, du vide complet, ou les balises <li> sans rien dedans ? Autre ?
    • stefdn

      merci pour ces réponses

      3. pour les boutons, j’ai créé un fichier submit.html dans squelettes/saisies/, en utilisant l’idée des attributs mais effectivement, ça reste délicats

      4. aucune erreur « visible », et rien de rien dans la page (et idem avec spip 2.1.2 et les plugins utiles) . Voilà ce que je trouve dans spip.log :

      (pid 5100) COMPIL (3.070 ms) [plugins/auto/saisies/saisies/fieldset.html]
 html_f8281334c0aeba79e3eb43416c90f732.php
(pid 5100) calcul (0.108 ms) [plugins/auto/saisies/saisies/_base] 
type_saisie=explication, li_class=laclass, texte='Bablabla blaaablabla blabal', lang=fr,
 date='2010-12-24 15:52:03', date_default=1, date_redac='2010-12-24 15:52:03', 
date_redac_default=1 (2 octets)
(pid 5100) Creation du cache d/sai-bas-exp-lac-Bab-arr--20b30930 pour 3600 secondes
(pid 5100) charset probable: utf-8
(pid 5100) trouver_table: table inconnue '' 'POUR'
(pid 5100) COMPIL (7.056 ms) [plugins/auto/saisies/saisies/input.html] 
html_f6706ef3175657d041b7a2476997ef68.php
    • stefdn

      Trouvé ! (?)

      j’ai ajouté l’option ’nom’ et ça passe. la description sur cette page m’aurait induit en erreur ? cette option est-elle systématiquement obligatoire pour tous types de champs ? ou bien ... ?

       array(
    'saisie' => 'explication',
     'options' => array(
         'nom' => 'explik', 
         'li_class' => 'laclass',
         'texte' =>  'Bablabla blaaablabla blabal'
     )
)

      Ceci dit, j’ai d’autres soucis ... (o:

      j’appelle saisies_verifier($form) dans la fonction de vérification CVT et j’ai une fatal error :

      Fatal error: Call to undefined function saisies_verifier()...

      la fonction est pourtant dans inc/saisies.php ... et si je la copie dans mon fichier CVT ... re-fatal error qui paraît plus logique :

      Fatal error: Cannot redeclare saisies_verifier() (previously declared in /www/dev/spip/squelettes/formulaires/testou.php:196) in /www/dev/spip/plugins/auto/saisies/inc/saisies.php on line 442

      bon, faut dire que j’en suis à mon premier jour sur Saisies et j’ai pas encore tout compris (o;

    • RastaPopoulos

      Oui il faut l’option nom à toutes les saisies, ça permet de les identifier même si ce ne sont pas des champs.

      Pour vérifier 1) il faut évidemment d’abord inclure le fichier où se trouve l’API des Saisies, cad include_spip('inc/saisies');, et 2) si c’est pour vérifier plus que l’option obligatoire=oui, cad avec les descriptions de vérifications, là il faut le plugin « Vérifier ». Ça permet plus de choses.

    • stefdn

      ok merci ... j’avais oublié d’includer pfff...

      par contre, j’ai passé le tableau ($formulaire) des saisies en global, hors fonctions CVT pour que saisies_verifier($formulaire) retourne bien les erreurs, sinon, ne retourne rien (je n’ai pas compris comment passer en argument $formulaire à formulaires_monForm_verifier())
      Est-ce la bonne méthode ?

      j’ai bien le plugin Verifier et ça vérifie bien ... Mais ... en retour sur erreur les champs sont tous retournés vides (même si verifier n’est pas défini dans la saisie).

      j’ai essayé en ajoutant l’option defaut à mes saisies mais n’ai pas trouvé comment l’utiliser pour que les champs gardent leur valeur après vérification ...

    • RastaPopoulos

      Euh ça ça n’a sûrement rien à voir avec Saisies mais avec CVT. Vous avez bien déclarer les champs autorisés dans charger() ? Seuls les champs autorisés sont envoyés.

      Quand on déclare les saisies avec un tableau PHP, et qu’on en a besoin dans les 3 fonctions CVT (car dans traiter() aussi on en a souvent besoin), le mieux est d’écrire une fonction qui renvoie le tableau des saisies, et de l’appeler ensuite dans C, puis V, puis T. C’est un peu plus propre qu’une globale...

      J’ai déjà quelques idées pour améliorer encore l’API de Saisies et rendre tout ça automatique avec les CVT (du genre chercher automatiquement une fonction formulaires_truc_saisies()). Encore un truc qui est dans la todo list...

    • stefdn

      -  « Vous avez bien déclarer les champs autorisés dans charger() ? »

      - « a ben... non. Je-croyais-que le tableau des saisies servait aussi à ça » :$

      j’ai donc écrit une fonction qui retourne le tableau des saisies et l’ai ajouté à mon tableau de valeurs autorisées dans charger() ... maintenant tout passe : Merci RastaPopoulos :) !

      J’ai aussi trouvé un petit bug : je vais poster un ticket sur la zone et je pense que je peux écrire un petit tuto du genre Un formulaire avec Saisies par l’exemple !

    Répondre à ce message

  • JLuc

    J’ai créé une page sur le carnet wiki pour compléter la documentation et noter quelques remarques ... et peut être des interrogations aussi :

    http://www.spip-contrib.net/Doc-Sai...

    Pour l’instant y figurent des notes sur le mode d’emploi des boutons radio, des ’select’,... et sur les vérifications avec le plugin verifier.

    Répondre à ce message

  • 2
    JLuc

    Mon but était de mettre 2 saisies côte à côte.

    Même en mettant les styles inline directement dans le formulaire.html qui appelle les saisies, je n’ai pas réussi.

    Pour que ça marche, il m’a fallu recopier localement TOUT le fichier habillage.css et en ajouter à la fin de ce fichier les propriétés ad hoc qui surchargent les valeurs spécifiées plus haut.

    Par exemple, pour un formulaire ’identite’ qui comporte une #saisie{input, prenom} immédiatement suivi d’une #saisie{input, nom}, pour que le nom apparaisse à droite du prénom, j’ai ajouté à la fin de habillage.css :

    .formulaire_identite .editer {
        float: left;
}
.formulaire_identite  .editer_prenom {
        clear: left; 
}
.formulaire_identite  .editer_nom {
        clear: right;
        margin-left: 10px;
}

    Il faudrait peut être spécifier plus précisément pour faire plus générique, mais comme ça ça marche dans mon cas.

    Je m’étonne cependant de devoir recopier localement tout le habillage.css. ça me semble peu portable et je ne pense pas que ça soit la bonne pratique. En effet, dans le cas de la création d’un plugin ’identite’ (dans l’exemple), il est impossible de savoir si d’autres plugins n’ont pas déjà surchargé et modifié habillage.css, et dans un tel cas, le habillage.css fourni par ’identite’ sera en décalage...

    D’où ma question :
    Quelle est donc la bonne pratique pour personnaliser les CSS des saisies ?

    • RastaPopoulos

      Mais de quoi tu parles ? Quel rapport en habillage.css et Saisies ? Et de quel habillage.css tu parles ? de la dist ? d’un site à toi ? de zpip ? autre ?

      Ce plugin n’a aucun rapport avec des CSS, il ne fait que générer du HTML. Après chaque site à ses styles, ce n’est aucunement du ressort de ce plugin.

    • JLuc

      Désolé si ma question est un peu hors sujet, mais ya quand même un rapport puisque habillage.css (de zpip ou de la dist) style les formulaires spip, y compris ceux générés par SAISIE. D’ailleurs cet article l’évoque : Largeur (cols) : Largeur du bloc en nombre de caractères. Cette option n’est pas toujours appliquée car les styles CSS de votre site peuvent l’annuler. En effet, les indications CSS de habillage.css sont prioritaires par rapport aux attributs HTML générés par SAISIE.

      Or en CSS, il n’y a pas moyen d’annuler la valeur d’une propriété : on ne peut que la re-spécifier. En l’occurence, j’ai finalement trouvé comment faire sans recopier localement tout habillage : il suffit de créer un fichier perso.css et d’y mettre les propriétés CSS surchargées.

    Répondre à ce message

  • 2
    JLuc

    Excellent plugin.

    Je remarque un truc étrange avec les textarea.
    Avec rows=2, il y a 3 lignes.
    Avec rows=5, il y a 6 lignes.
    Il faut rows=1 pour avoir 2 lignes,
    et rows=4 pour en avoir 5.

    Y a t il une raison ou bien c’est une erreur ?

    • RastaPopoulos

      Ben non pas d’erreur, ça remplit directement le champs « rows » de la balise « textarea », donc ensuite c’est le navigateur qui fait ça...

    • JLuc

      En effet. Merci Rastapopoulos

    Répondre à ce message

  • 1
    poupougnac

    Salut RastaPopoulos,
    Merci pour Saisies qui m’aide particulièrement en ce moment. Je te fais part d’une fonction qui serait bien pratique pour formidable car j’en ai actuellement besoin et je constate que de nombreux formulaires proposent ce type d’option :
    -  Le fameux champs d’un menu en liste « autre » avec option de proposition dans un input si on le sélectionne, il devient dynamiquement éditable.
    -  L’incontournable champs date avec auto complétion

    -  Beaucoup plus audacieux mais je pense que c’est l’avenir et que prendre une longueur d’avance c’est une opportunité. L’auto-complétion d’adresse postale avec l’api de Google Map.
    Saisir une adresse est PENIBLE (adresse, ville, CP, Pays etc...)
    Ici il n’y a qu’un seul champs et Google retrouve l’adresse précise (et dans le monde entier).
    Test ici (en bas de page)
    et script déjà fait là :
    http://code.google.com/p/geo-autocomplete/

    Voila ces petites propositions qui pourrait rendre ton plugin très populaire.
    Merci pour ton travail.

    • RastaPopoulos

      Merci pour les suggestions. Mais attention ce ne sont que des trucs avec javascript que tu proposes et il faut faire en sorte que les champs fonctionnent aussi sans. Des fois c’est possible, des fois pas, alors il faut bien réfléchir à comment les faire proprement.

    Répondre à ce message

  • 1
    lili44300

    Bonjour,

    Question bête : existe-t-il une balise pour afficher le contenu renseigné par l’utilisateur dans les champs des balises #SAISIE ?
    Et une fois le formulaire envoyé, est-il traité par le plugin (on a la possibilité de définir par exemple un champ comme obligatoire, donc je suppose qu’un contrôle existe ensuite pour la validation), ou bien devons-nous nous-même le faire ?
    Merci d’avance pour ces quelques précisions ! :)

    Aurélie D.

    PS : pas mal comme plugin, ça simplifie drôlement la saisie des champs de formulaires, tâche ô combien rébarbative qui énerve tout développeur (qui se dit à chaque fois qu’il devrait prendre le temps de développer un petit truc maison, pour générer automatiquement les champs et les vérifications qui vont avec, mais qui faute de temps, se refade à chaque fois tout à la main... ^^).

    • RastaPopoulos

      Ce n’est pas encore documenté mais il y a une balise #VOIR_SAISIE avec les mêmes paramètres, mais on lui passe aussi « valeur=truc ». Ça utilise alors les squelettes qui sont dans « /saisies-vues/ ».

      De la même façon il y a une balise #VOIR_SAISIES qui prend deux paramètres, d’abord le tableau de description comme #GENERER_SAISIES puis un autre tableau associatif avec les valeurs des champs (nom_du_champ=>valeur).
      Il faut que je complète la documentation avec ces balises.

      Sinon ce plugin est un outil pour développeur. C’est pas un générateur de formulaires. Pour ça il ya bientôt le plugin Formidable.

    Répondre à ce message

  • RastaPopoulos

    Je me pose la question Rasta de l’option « choix_destinataires ». Est-ce que ce serait possible d’utiliser « datas » comme les autres ? J’ai peur qu’on ait à un moment trop d’options spécifiques à une seule saisies. Qu’en penses tu ?

    Oui tu as raison.

    D’ailleurs pour aller plus loin, on pourrait renommer « datas » en « choix » (un truc comme ça, surtout que datas avec un s...). Mais en gardant la compatibilité bien sûr ! Il suffit de faire #ENV{choix, #ENV{datas}} et hop la compat est assuré avec l’existant.

    Alors si t’as un terme, je remplace à la fois tous les datas et le choix_destinataires.

    Répondre à ce message

  • Matthieu Marcillaud

    Roh, j’étais pas logé :) Je resigne : Matthieu.

    Répondre à ce message

  • 1
    Shnoulle

    Excellent !!!

    Un grand merci !

    • Je me pose la question Rasta de l’option « choix_destinataires ». Est-ce que ce serait possible d’utiliser « datas » comme les autres ? J’ai peur qu’on ait à un moment trop d’options spécifiques à une seule saisies. Qu’en penses tu ?

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

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