Carnet Wiki

Saisies : faire son marché de sélecteurs

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.

Les sélecteurs en liste déroulante

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

Autres sélections d’objets en SPIP 3

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<-]

Sélection Sélections types d’objets SPIP 3

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()
  • valeur doit être un tableau également décomposable par saisies_chaine2tableau($chaine, $separateur = "\n")

choisir_objet

choisir_objets

choisir_objets_edit