Version 4 — Décembre 2019 — YannX
Le plugin SAISIE propose de nombreuses facilités pour organiser les formulaires : récapitulons le contenu de ce ./saisies/saisies/
.
cette page complète Saisies : faire son marché , en ne traitant que les sélecteurs.
Voir aussi :
- Saisies : Doc complémentaire.
- Plugin vérifier
Attention, cette page présente actuellement des notes simples, non encore complètement testées.... vous aussi pouvez les compléter, et mieux, les corriger !!
rappel : La syntaxe de la balise #SAISIE
nécessite deux paramètres obligatoires, le type de saisie [1], et le nom de variable à utiliser en interne ; les autres paramètres -tous optionnels- sont exprimés de la forme : option=valeur
.
Vous pourrez préférer regarder directement les sources en lecture web.
Ces modes utilisent SPIP Bonux et les ./formulaires/selecteurs/...
- secteur : rend un #ID_SECTEUR
- class : classe(s) css ajoutes au select
- multiple : si quelque chose est passe, le select est multiple, sinon, c’est un select simple
Dans le cas multiple, defaut et valeur doivent etre un array, sinon un int
- recursif : si oui liste les rubriques de facon recursive, et pas uniquement les secteurs
- option_intro : chaine de langue de la premiere ligne vide ? (defaut :« »)
(seulement si non multiple)
- cacher_option_intro : pas de premier option vide (defaut :« »)
- defaut : valeur par defaut si pas présente dans l’environnement
- valeur_forcee : valeur utilisee meme si une valeur est dans l’environnement
selecteur (générique : pour SPIP3 uniquement)
selecteur_article
selecteur_rubrique
selecteur_rubrique_article
rendent un tableau : objet=>id
- selecteur_document
Rq : depuis z100361 la saisie selecteur_document accepte l’option multiple=oui
et génère alors une liste à virgule pour les identifiants plutôt que remplacer l’ancienne valeur à chaque fois, ce qui permet d’avoir plusieurs documents
- selecteur_langue
- selecteur_site
- selection
selection_multiple
selection_par_groupe
Parametres :
-* datas : tableau de donnees
liste simple : cle=>valeur
liste avec groupes : cle=> tableau (cle=>valeur)
-* option_intro : chaine de langue de la premiere ligne vide ? (defaut :« »)
-* cacher_option_intro : pas de premier option vide (defaut :« »)
-* class : classe(s) css ajoutes au select
-* defaut : valeur par defaut si pas présente dans l’environnement
-* valeur_forcee : valeur utilisee meme si une valeur est dans l’environnement
Outre les sélecteurs à usage des rédacteurs, listés ci-dessus, on trouve des types de saisie spécialisés pour d’autres objets standardisés dans SPIP :
groupe_mots ex. :[(#SAISIE{groupe_mots,groupes, .. multiple=oui, table_liaison=articles})]
- class : classe(s) css ajoutes au select
- multiple : si quelquechose est passe, le select est multiple, sinon, c’est un select simple
Dans le cas multiple, defaut et valeur doivent être un array, sinon un int
- option_intro : chaine de langue de la premiere ligne vide ? (defaut :« »)
(seulement si non multiple)
- cacher_option_intro : pas de premier option vide (defaut :« »)
- table_liaison : permet de ne lister que les groupes de mots liés à une table en particulier
(champs tables_liees de spip_groupes_mots)
- defaut : valeur par defaut si pas présente dans l’environnement
- valeur_forcee : valeur utilisee meme si une valeur est dans l’environnement
- groupes_exclus : tableau de groupes exclus
- afficher_id_groupe : afficher le numero du groupe en plus de son titre
mot
Parametres :
- class : classe(s) css ajoutes au select
- option_intro : chaine de langue de la premiere ligne vide ? (defaut :« »)
- cacher_option_intro : pas de premier option vide (defaut :« »)
- id_groupe : limiter à un groupe de mots clés à afficher (en sélecteur si ’un seul mot’,
sinon en liste de cases à cocher, sauf si est rajoutée l’option forcer_select=oui
).
- defaut : valeur par defaut si pas présente dans l’environnement
- valeur_forcee : valeur utilisee meme si une valeur est dans l’environnement
articles_originaux
auteurs
destinataires
statuts_auteurs
url
[objetypespip<-]
Enfin on trouve aussi des sélecteurs d’objets-type, sur le même modèle, avec comme deux paramètres principaux possibles :
defaut
peut être une chaine (plusieurs valeurs ou pas) qu’on sait décomposer par saisies_chaine2tableau()
saisies_chaine2tableau($chaine, $separateur = "\n")
choisir_objet
choisir_objets
choisir_objets_edit