Carnet Wiki

Saisies : faire son marché

Version 9 — Octobre 2013 YannX

Le plugin SAISIE propose de nombreuses facilités (cf. Doc Saisies complémentaire) pour organiser les formulaires avec Vérifier : récapitulons le contenu de ce .saisies/saisies/.

Attention, cette page présente actuellement des notes simples, non encore complètement testées.. Je reviendrais les compléter peu à peu ; mais vous pouvez aussi les compléter, et mieux, les corriger !!


Les codes de SAISIES proposés


En dehors des saisies autonomes (voir plus bas) les traitements génériques des options (label, explication, les ’attention’ et traitements de obligatoire...affichage d’une erreur associée si il y en a une) sont assurés par une saisies/_base générique...

Ces saisies peuvent etre améliorées par l’usage de nombreuses options, et par l’utilisation intégrant des options de Verifier, avec

verifier=[(#ARRAY{ 
                                #ARRAY{type,entier},
                                #ARRAY{option,   #ARRAY{
                                                                                }
                               })]

(à controler/préciser)

Les choix de cases et boutons


-  case : rend « on » ou «  » (avec label_case à coté de la case )
oui_non renvoie « on » ou «  »

-  checkbox
penser à utiliser la notation tableau pour les éléments de choix (multiple)

-  choisir_objet et
choisir_objets : spécifique SPIP 3 parmi les objets editables formulaires/inc-choisir-objets

  • defaut : peut être une chaine (plusieurs valeurs ou pas) qu’on sait décomposer ]
    #SETdefaut, #ENVdefaut|saisies_chaine2tableau
  • valeur : doit être un tableau ! ]
  • exclus : peut être une chaine (plusieurs valeurs ou pas) qu’on sait décomposer

true_false : renvoie true or false sur deux boutons radio
radio sur un seul bouton-radio

Gestion calendaire des dates

date
Zone de saisie de date proposée à l’affichage au format jj/mm/aaaa. utilisant le dateur de Bonux si présent.
Pour tous on utilise class=« date » et class=« heure » pour activer le dateur.

  • La valeur fournie peut être :
    - au format spip jj/mm/aaaa (date uniquement)
    - au format SQL aaaa-mm-jj (date uniquement)
    - au format SQL aaaa-mm-jj hh:mm:ss (date et heure)
    - un tableau avec une entrée « date » et une entrée « heure » séparée, au format SQL (date et heure obligatoire)
  • Pour utiliser les heures, il faut utiliser l’option « horaire=oui » et class=« heure » pour activer le dateur.

date_jour_mois_année [1]à partir d’un DATETIME MySQL, par Options  : création de trois sous-champs affichés ( avant la gestion du champ de saisie )
Options  :
- label_(jour|mois|annee)
- size_(jour|mois|annee)
- maxlength_(jour|mois|annee)
- datetime=oui

La saisie normalisée proposera un champ au format MySQL datetime, sauf si on donne à l’option datetime une autre valeur que oui (il semble qu’il y ait un test « 

L’usage de l’option ’normaliser’ de la fonction vérifier permet de rétablir un date au format MySQL

Autres Saisies

email

explication [2]

fieldset [3]

hidden

input (voir aussi couleurs et recherche : zone stylisée)

pays : pour rechercher automatiquement dans la table spip_GEO_PAYS

police choix des polices .TTF trouvées dans le chemin

position_construire_formulaire

Les sélecteurs en liste déroulante

Ces modes utilisent SPIP Bonux et les ./formulaires/selecteurs/...

-  secteur : rend in #ID_SECTEUR
Parametres :
- 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 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

selecteur_langue

selecteur_rubrique

selecteur_rubrique_article

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 SPIP 3

groupe_mots

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 : groupe des mots clés à afficher
- 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

telephone

textarea
Parametres :
- class : classe(s) css ajoutes au textarea
- rows : nombre de ligne, par defaut : 20
- cols : nombre de caracteres de large, par defaut : 40 (cela depend aussi et surtout du CSS)
- inserer_barre : barre d’outils du porte plume à insérer (forum ou edition par défaut)
- previsualisation : si égale à ’oui’, ajoute l’onglet de prévisualisation
- defaut : valeur par defaut si pas présente dans l’environnement
- valeur_forcee : valeur utilisee meme si une valeur est dans l’environnement

url

Les saisies autonomes

Les saisies qui sont autonomes sont définies par la fonction saisies_autonomes qui appelle le pipeline du même nom qui permet d’en ajouter de nouvelles. Ce sont par défaut les saisies :
-  fieldset
-  hidden
-  destinataires
-  explication


Les Saisies-Vues

articles_originaux auteurs
case
checkbox
date
destinataires
explication
fieldset
groupe_mots
oui_non
radio
secteur
selecteur
selecteur_article
selecteur_article_fonctions.php
selecteur_document
selecteur_langue
selecteur_rubrique
selecteur_rubrique_article
selecteur_site
selection
selection_multiple


Classes utiles

class=inserer_barre_edition
li_class=haut