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 libre | Choix restreint | Structure | Contenu éditorial | Divers | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Options \ Saisies | textarea | input | date | radio | case | checkbox | selection | destinataires | choix_grille | fieldset | explication | conteneur_inline | selecteur_article | selecteur_rubrique_article | auteurs | selecteur_document | mot | selecteur_rubrique | hidden | |
afficher_art_dans_langue_interface | - | - | - | - | - | - | - | - | - | - | - | - | - | X | X | - | - | - | - | - |
afficher_langue | - | - | - | - | - | - | - | - | - | - | - | - | - | X | X | - | - | - | X | - |
afficher_rub_dans_langue_interface | - | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | X | - |
afficher_si | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
afficher_si_avec_post | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
afficher_si_remplissage_uniquement | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
attention | X | X | X | X | X | X | X | X | X | X | X | - | - | X | X | X | X | X | X | - |
attribut_title | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - |
autocomplete | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
cacher_option_intro | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | X | - | X | - | - |
choix_alternatif | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
choix_alternatif_explication | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
choix_alternatif_label | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
choix_destinataires | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - |
class | X | X | X | X | X | X | X | X | - | X | - | - | X | - | - | - | - | X | - | X |
colonnes | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - |
cols | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
conteneur_class | X | X | X | X | X | X | X | X | - | X | X | X | - | - | - | - | - | - | - | X |
data | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
data_cols | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - |
data_rows | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - |
defaut | X | X | X | X | X | X | X | X | - | - | - | - | - | - | - | X | - | X | - | X |
defaut_session | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
depublie_choix | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
disable | X | X | X | X | X | X | X | X | - | - | - | - | - | X | X | X | - | X | X | - |
disable_avec_post | X | X | X | X | X | X | X | X | - | - | - | - | - | X | X | X | - | X | X | - |
disable_choix | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
erreur_obligatoire | X | X | X | X | X | X | X | X | X | X | - | - | - | X | X | X | X | X | X | - |
explication | X | X | X | X | X | X | X | X | X | X | X | - | - | X | X | X | X | X | X | - |
explication_apres | X | X | X | X | X | X | X | X | X | X | X | - | - | X | X | X | X | X | X | - |
forcer_select | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - |
heure_pas | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
horaire | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
id_groupe | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - |
info_obligatoire | X | X | X | X | X | X | X | X | X | X | - | - | - | X | X | X | X | X | X | - |
inserer_barre | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
label | X | X | X | X | X | X | X | X | X | X | X | - | - | X | X | X | X | X | X | X |
label_case | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
label_non | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
label_oui | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
liens_meme_fenetre | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
limite_branche | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | X | - |
longueur_max | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
masquer | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
maximum_choix | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - |
maxlength | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
minlength | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
multiple | - | - | - | - | - | - | - | X | - | X | - | - | - | X | X | X | - | X | X | - |
obligatoire | X | X | X | X | X | X | X | X | X | X | - | - | - | X | X | X | X | X | X | - |
onglet | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - |
onglet_vertical | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - |
option_intro | - | - | - | - | - | - | - | X | X | - | - | - | - | - | - | X | - | X | - | - |
option_statut | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - |
placeholder | X | X | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
pliable | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - |
plie | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - |
previsualisation | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
readonly | X | X | X | X | - | X | - | - | - | - | - | - | - | X | X | - | - | - | X | - |
rows | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
size | - | X | X | - | - | - | - | X | - | - | - | - | - | - | - | X | - | X | - | - |
statut | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - |
texte | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
titre | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
type | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
type_choix | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - |
valeur_non | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
valeur_oui | - | - | - | - | - | X | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
vue_masquer_sous_groupe | - | - | - | - | X | - | X | X | - | - | - | - | - | - | - | - | - | - | - | - |
Utilisation des options de dev
Options disponibles uniquement pour le dévellopement PHP/Squelette.
Champ libre | Choix restreint | Structure | Contenu éditorial | Divers | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Options \ Saisies | textarea | input | date | radio | case | checkbox | selection | destinataires | choix_grille | fieldset | explication | conteneur_inline | selecteur_article | selecteur_rubrique_article | auteurs | selecteur_document | mot | selecteur_rubrique | hidden | |
alerte_role | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
alerte_type | - | - | - | - | - | - | - | - | - | - | - | X | - | - | - | - | - | - | - | - |
attributs | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
id | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
inserer_debut | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
inserer_fin | X | X | X | X | X | X | X | X | X | X | X | X | - | X | X | X | X | X | X | X |
Toutes les saisies, par catégories
Champ libre
Bloc de texte (textarea)
Description : Un champ de texte sur plusieurs lignes.
Ligne de texte (input)
Description : Une simple ligne de texte, pouvant être visible ou masquée (mot de passe).
Adresse email (email)
Description : Permet d’avoir un champ de type email en HTML5.
Date (date)
Description : Permet de saisir une date à l’aide d’un calendrier
Choix restreint
Boutons radios (radio)
Description : Permet de choisir une option parmi plusieurs disponibles.
Case unique (case)
Description : Permet d’activer ou de désactiver quelque chose.
Cases à cocher (checkbox)
Description : Permet de choisir plusieurs options avec des cases.
Liste déroulante / sélection (selection)
Description : Choisir une option dans une liste déroulante.
Destinataires (destinataires)
Description : Permet de choisir des destinataires parmi des comptes pré-sélectionnés.
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
Structure
Groupe de champs (fieldset)
Description : Un cadre qui pourra englober plusieurs champs.
Explication (explication)
Description : Un texte explicatif général.
Affichage en ligne (conteneur_inline)
Description : Pour regrouper visuellement des champs en ligne.
Contenu éditorial
Article (selecteur_article)
Description : Affiche un navigateur de sélection d’article
Article ou rubrique (selecteur_rubrique_article)
Description : Affiche un navigateur de sélection d’article ou de rubrique
Autrices et auteurs (auteurs)
Description : Permet de sélectionner un auteur, une autrice, ou plusieurs
Document (selecteur_document)
Description : Affiche un sélecteur de document
Mot-clé (mot)
Description : Des mots-clés d’un groupe de mot
Rubrique (selecteur_rubrique)
Description : Affiche un navigateur de sélection de rubrique
Divers
Champ caché (hidden)
Description : Un champ pré-rempli que l’internaute ne pourra pas voir.
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
Choix possibles :
- « defaut » : Laisser par défaut
- « on » : Activer
- « off » : Désactiver
Cacher le premier choix vide (cacher_option_intro)
Proposer un choix alternatif (choix_alternatif)
Explication du choix alternatif (choix_alternatif_explication)
Label de ce choix alternatif (choix_alternatif_label)
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"
.
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.
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"]
.
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"]
.
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.
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)
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.
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)
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)
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’optiondata
. - La saisie
oui_non
ne doit plus être utilisée. On lui préférera la saisieradio
, 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 saisieselection
avec l’optionmultiple
.
Discussions par date d’activité
39 discussions
bonjour,
je découvre ce plugin fort utile et j’ai quelques remarques et questions :
'attributs' => array('attribut' => 'valeur')
dans formulaires/testou.php :
dans formulaires/testou.html :
et dans mon squelette :
ma config : spip 2.0.11 / plugins yaml et bonux activés
<li>
sans rien dedans ? Autre ?merci pour ces réponses
3. pour les boutons, j’ai créé un fichier
submit.html
danssquelettes/saisies/
, en utilisant l’idée des attributs mais effectivement, ça reste délicats4. 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 :
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 ... ?
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;
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.ok merci ... j’avais oublié d’includer pfff...
par contre, j’ai passé le tableau (
$formulaire
) des saisies englobal
, hors fonctions CVT pour quesaisies_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 ...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...
- « 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
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
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 :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 ?
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.
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
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 ?
Ben non pas d’erreur, ça remplit directement le champs « rows » de la balise « textarea », donc ensuite c’est le navigateur qui fait ça...
En effet. Merci Rastapopoulos
Répondre à ce message
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.
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
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... ^^).
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
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
Roh, j’étais pas logé :) Je resigne : Matthieu.
Répondre à ce message
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 :
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.
Suivre les commentaires : |