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

  • 2
    Teenoo

    Bonjour,

    est-ce qu’à la base « Sélecteur d’article » peut permettre l’ajout de plusieurs articles ? En effet, je teste mais je ne peux insérer qu’un seul article or j’aimerais en sélectionner plusieurs. Comment puis-je faire ?

    Merci pour votre réponse :)

    Répondre à ce message

  • 2
    gilcot

    Bonjour.

    J’ai un souci avec les listes déroulantes, mais je crois que je postais au mauvais endroit.
    Voici la section de formulaire incriminée : [(#SAISIE{selection, type, label=<:coordonnees:label_type_adresse:>, datas=#ARRAY{work,<:coordonnees:type_adr_work:>, home,<:coordonnees:type_adr_home:>, pref,<:coordonnees:type_adr_pref:>, postal,<:coordonnees:type_adr_postal:>, dom,<:coordonnees:type_adr_dom:>, intl,<:coordonnees:type_adr_intl:>, parcel,<:coordonnees:type_adr_parcel:> } })]
    Voici le problème : à l’édition, toutes les saisies récupèrent bien le contexte ...sauf cette sélection ! (il ne met pas la valeur courante en « selected » dans le HTML généré). Du coup j’ai quand même rajouté un « defaut » : [(#SAISIE{selection, type, label=<:coordonnees:label_type_adresse:>, defaut=#ENV{type}, datas=#ARRAY{work,<:coordonnees:type_adr_work:>, home,<:coordonnees:type_adr_home:>, pref,<:coordonnees:type_adr_pref:>, postal,<:coordonnees:type_adr_postal:>, dom,<:coordonnees:type_adr_dom:>, intl,<:coordonnees:type_adr_intl:>, parcel,<:coordonnees:type_adr_parcel:> } })] mais ça ne change rien et je ne sais plus trop quoi faire...

    Merci.

    • RastaPopoulos

      Et il y a bien quelque chose en #ENV{type} ?

    • gilcot

      Ah... Il devrait (les valeurs existent dans la table et sont passées au formulaires) ; mais effectivement je n’ai rien (et c’est le seul paramètre qui semble poser souci) :-S Visiblement le souci ne vient pas de #SAISIE mais est en amont..?

      Merci beaucoup.

    Répondre à ce message

  • 2
    YannX

    Une info récupérée sur IRC, et transcrite pour mémorisation...

    Vous pouvez vouloir utiliser un tableau comme objet saisi dans un CVT (pour utilisation dans une boucle, pour avoir plusieurs valeurs...).

    En .php on utilise souvent directement :
    <input  name="mot[]" ...

    En utilisant le plugin SAISIES, on tente de générer :
    #SAISIE{input,mot[]....} qui ne fonctionne pas...
    utilisez les entites HTML avec &#91; &#92; à la place

    • gilcot

      En général quand on veut utiliser un tableau et passer/récupérer plusieurs valeurs, au lieu d’une saisie « input » pourquoi ne pas utiliser une saisie « checkbox » ou « selection » ? ;-)

    • RastaPopoulos

      @gilcot ça c’est seulement quand les valeurs sont pré-définies. Un input on met ce qu’on veut dedans.

    Répondre à ce message

  • 2

    Salut,

    Dans le sélecteur d’articles, est-il possible de ranger les titres de façon ante-chronologique ?

    [(#SAISIEselecteur_article,ids_article,
    label=<:lettres_objets:label_choisir_articles :>,
    defaut=#ENVids_article,
    multiple=oui    )]

    Merci de vos réponses.

    • Artlogic

      Les articles et non les titres pardon, par ordre ante-chronologique. C’est pour sélectionner des articles d’actualités. Hors pour l’instant nous avons toujours les articles les plus récents en fin fond de pagination.

    • gilcot

      Salut.

      Je me demande s’il n’est pas possible de « surcharger » le code du sélecteur ;-)

    Répondre à ce message

  • 4
    ttseo

    Bonjour,
    avec le mode de saisie date, le format renvoyé est du type 12/04/2012.
    Lorsque je définie dans ma table sql le format date, il impose 2012-04-12.
    Du coup, il y a une erreur au moment de l’enregistrement.
    Y-a-t-il un moyen pour reccupérer ce bon format, ou modifier le format avant l’enregistrement dans la base ?
    merci

    • RastaPopoulos

      Oui, depuis peu la vérification de date sait normaliser la valeur final avant traitement. Pour ça il faut mettre à jour Vérifier et Saisies, et utiliser la vérification de date avec son option de normalisation.

      Cf. : http://zone.spip.org/trac/spip-zone/changeset/57473/_plugins_/verifier/verifier/date.php

    • Merci ... j’ai eu récemment d’autres indications de votre part sur un autre forum !
      Si j’ai bien compris, je dois utiliser vérifier($valeur,’date’,array(’normaliser’ => ’date’) ;

      mais avec le plugin saisies, j’ai dans mon fichier de traitement php du formulaire quelquechose du type :

      function formulaires_editer_programme_colle_identifier_dist($id_programme_colle=’new’,$retour=’’, $config_fonc=’’, $row=array(), $hidden=’’)
      return serialize(array(intval($id_programme_colle))) ;

      function formulaires_editer_programme_colle_verifier_dist($id_programme_colle=’new’, $retour=’’, $config_fonc=’’, $row=array(), $hidden=’’)

      return formulaires_editer_objet_verifier(’programme_colle’, $id_programme_colle) ;

      function formulaires_editer_programme_colle_traiter_dist($id_programme_colle=’new’,$retour=’’,$config_fonc=’’, $row=array(), $hidden=’’)
      return formulaires_editer_objet_traiter(’programme_colle’,$id_programme_colle,$retour,$config_fonc,$row,$hidden) ;

      où alors insérer la vérification ? (je me suis inspirer pour réaliser le plugin de l’exemple « chats »)
      d’avance merci

    • RastaPopoulos

      La vérification se fait dans la fonction... tin tin tin... verifier() ! :)

      $truc = _request('truc'); pour récupérer ce qui a été posté, suivant le nom du champ, et ensuite tu en fais ce que tu veux, donc le passer dans la fonction de l’autre plugin Vérifier (cf sa doc).

      Mais le plus simple, quand on a pas un formulaire horriblement compliqué, ça reste quand même de déclarer ses saisies en PHP. En effet ce plugin permet d’étendre CVT avec un S : function formulaire_montruc_saisies_dist($param1, $param2, etc)

      Cette fonction doit retourner un tableau de saisies valides, comme décrit dans la documentation (cf l’article de base de la doc de ce plugin).

      Avec cette fonction Saisies sait même faire les 2/3 du boulot : ça déclare les champs ET ça vérifie (pour peu qu’on ait décrit les vérifications à faire comme l’explique la doc de Vérifier).

      Ok ok un exemple complet serait bienvenu, je sais...

    • ttseo

      OK, merci.
      Une question qui n’a pas de lien direct, mais je ne vois pas où la poser :
      comment faire migrer une base de spip2 vers spip3 ? la démarche habituelle n’a pas fonctionné chez moi...
      merci

    Répondre à ce message

  • 6
    tcharlss

    Bonjour,

    Avec une saisie ’sélection’, je ne parviens pas à faire en sorte que la valeur par défaut soit pré-sélectionnée.
    Voilà mon bout de squelette, je pécise que c’est dans une boucle DATA, ça a peut-être son importance :

    [(#SAISIE*{#VALEUR{type_saisie}, #VALEUR{parametre},
	datas=#VALEUR*{datas},
	defaut=#VALEUR*{defaut}
})]

    Ce qui me rend perplexe, c’est qu’avec le même code ça marche bien pour une saisie radio (la valeur par défaut est bien cochée). Aurais-je loupé quelque chose ?

    • RastaPopoulos

      Là comme ça ça ressemble à un bug, mais j’ai pas eu le temps de regarder le code encore. Peut-être qu’il faut que ce soit un tableau ? À voir dans saisies/selection.html.

    • tcharlss

      Ah oui, en changeant [(#CLE|=={#GET{valeur}}|oui)selected="selected"] en [(#CLE|=={#ENV{defaut}}|oui)selected="selected"] dans saisies/selection.html, ça marche.
      #GET{valeur} ne renvoie rien, il doit y avoir un souci avec le #SET.

    • RastaPopoulos

      As-tu essayé d’afficher le contenu du #GET pour savoir ce qu’il contient au final ? [(#GET{valeur}|var_dump)]

    • tcharlss

      Ah oui avec |var_dump, la valeur est bien là : string(4) « fade ».
      Du coup en utilisant match à la place du ==, ça semble marcher :
      [(#CLE|match{#GET{valeur}}|oui)selected="selected"]

    • RastaPopoulos

      Ouais mais ça fait faire une regex pour rien alors que c’est juste une comparaison de chaîne toute bête (et en plus si ya « truc » dans « machin truc » ça le trouvera aussi avec ce que tu as mis :) ).

      Il doit y avoir un espace quelque part, un truc dans ce genre. Dans ton tout premier code ça fait quoi si tu fermes la balise #SAISIE juste après le defaut : defaut}})] ?

      Mais c’est bizarre car le dump trouve une chaîne sans espace donc c’est peut-être #CLE (donc ce que tu as mis dans « datas » qui contient des espaces superflues) ? Faudrait dumper #CLE aussi pour comparer.

    • tcharlss

      Dans ton tout premier code ça fait quoi si tu fermes la balise #SAISIE juste après le defaut : defaut}})] ?

      Oh pétard, c’était ça ! Hum, j’étais pourtant sûr d’avoir vérifié avec et sans crochets auparavant.
      Désolé pour le bruit !

    Répondre à ce message

  • 1
    anaïs

    J’essaie de faire un formulaire en utilisant destinataires et type_choix ne me donne pas le résultat escompté. En revanche, multiple=oui produit l’effet attendu (comme mentionné dans l’article sur Saisies).

     :-)

    Répondre à ce message

  • 2
    Fred Montessinos

    Bonjour,

    Pour mettre à jour une table « categories » qui contient les champs suivants : id_categorie , nom, id_sup, infos, j’utilise une formulaire avec saisie. Pour le champ de la categorie parente, actuellement je fais ça :

    [(#SAISIE{input, id_sup,
label=<:categories:label_parent:>})]

    Ce n’est pas très pratique puisqu’il faut renseigner l’id de la categorie voulue. J’ai essayé de faire un champ selection, pour pouvoir sélectionner le nom de la categorie parente et récupérer l’id, mais je n’y arrive pas. Ma dernière tentative était

    [(#SAISIE{selection, id_sup}
        {label=<:categories:label_parent:>}
        {option_intro=Sélectionnez une categorie parente}
        {datas=#INFO_NOM{categorie, #ID_SUP}}
)]

    Mais bien sur ça ne va pas.
    Un coup de pouce serait bienvenue
    merci
    Fred

    • RastaPopoulos

      datas doit être un tableau PHP. Donc #ARRAY{cle1, valeur1, cle2, valeur2, etc} dans un squelette SPIP. À construire avec une boucle sur tes catégories avant d’afficher ta saisie selection.

    • Fred Montessinos

      Merci beaucoup.
      C’est presque bon, il reste juste un petit problème « option_intro » ne s’affiche plus par défaut, il est en deuxième choix dans la liste.

      Pour info :

      Ma boucle

      #SET{array_categories, #ARRAY}
<B_crit>		
<BOUCLE_crit(CATEGORIES)>
        #SET{array_categories,#GET{array_categories} |array_merge{#ARRAY{#NOM,#ID_CATEGORIE}}}       
</BOUCLE_crit>
#SET{array_categories, #GET{array_categories}|array_flip}      
</B_crit>

      et mon champ selection :

      [(#SAISIE{selection, id_sup}
        {label=<:categories:label_parent:>}
        {option_intro=Sélectionnez une categorie parente}
        {datas=#GET{array_categories}}
		)]

    Répondre à ce message

  • 5
    Mojo

    Salut la compagnie !

    A quand une Saisie « DATE », idéalement identique à celle implémentée dans Formidable ?
    C’est a dire un input de taille réduite (10 caractères), un picto « calendrier » sur la droite qui ouvre un calendrier, et remplit le champ automatiquement.

    Mojo

    • RastaPopoulos

      Euh... Formidable utilise UNIQUEMENT ce plugin Saisies. Donc elle y est. :)

      Mais faut mettre la doc à jour de temps en temps... :(

    • Mojo

      Damned, j’ai été eu ^^
      Dans un sens, tant mieux, c’est tellement pratique ce champ date !

    • Mojo

      Par contre, est-il actuellement possible de positionner le datepicker sur la date chargée ou entrée, ou en tout cas de l’initialiser à une certaine date ? Par défaut, il part du 1er janvier 1900 dans tous les cas.

    • RastaPopoulos

      Chez-moi-ça-marche. ©

      Si il n’y a rien, ça part d’aujourd’hui. Et s’il y a une date, ça part de celle-ci.

    • Mojo

      En effet, j’ai eu ce comportement sur des DATETIME à 0000-00-00 par defaut...
      Ca marche nickel Chrome© ^^

    Répondre à ce message

  • 3
    Jean-Baptiste Pressac

    Bonjour,
    Concernant l’option datas, je ne comprends pas la mention :

    Vous devez indiquez un choix par ligne sous la forme « cle|Label du choix »

    Du coup, j’avais essayé de renseigner l’option de cette façon :

    datas=
cle1|valeur1,
cle2|valeur2,
cle3|valeur3

    Qui n’avais pas marché. Mais j’ai trouvé dans selection_mutliple.html l’exemple suivant :

    datas=#ARRAY{cle1,valeur1,cle2,valeur2,cle3,valeur3}

    Si l’utilisation d’un tableau est systématique pour la saisie des valeurs de datas, ne vaudrait-il pas mieux le préciser ci-dessus ?

    • RastaPopoulos

      On peut soit mettre un #ARRAY, soit mettre un choix pas ligne, donc dans une chaine de caractères, ce qui n’est pas le cas de l’exemple ci-dessus avec les virgules. La chaine permet de passer ces valeurs depuis le résultat d’un textarea par exemple.

    • Jean-Baptiste Pressac

      Quand vous dites « mettre un choix pas ligne, donc dans une chaine de caractères » cela signife-t-il qu’on peut écrire ? :

      datas="cle1|valeur1
cle2|valeur2
cle3|valeur3"

      En fait, je ne comprends pas très bien ce que vous entendez par « un choix par ligne ».

    • RastaPopoulos

      Une ligne comme dans dans toute chaine de caractère quoi. « \n ».

      La fonction qui récupère ça :
      http://zone.spip.org/trac/spip-zone/browser/_plugins_/saisies/inc/saisies.php#L746

      Mais quand on est dans un squelette, ça n’a pas d’intérêt, il faut utiliser #ARRAY évidemment.

    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