SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

289 Plugins, 197 contribs sur SPIP-Zone, 122 visiteurs en ce moment

Accueil > Outils pour plugins > Config (CFG) > API CFG : Paramètres des formulaires

API CFG : Paramètres des formulaires

30 mars 2008 – par Matthieu Marcillaud – commentaires

3 votes

CFG offre de nombreuses options pour paramétrer les formulaires CFG.

Ces paramètres interprétés après compilation par CFG du formulaire. Ils se déclarent en utilisant la syntaxe suivante :

Accès rapide


Descriptions : autoriser, boite, casier, colonne, depot, descriptif, head, liens, liens_multi, nom, onglet, refus, table, titre

Exemples : casier,onglets,liens

Aperçu des paramètres

Propriété Description
autoriser Type d’autorisation pour l’accès au formulaire
boite Titre de la boite du formulaire
casier Faire une arborescence dans le stockage
colonne Colonne de stockage
depot Choix du lieu de depot : meta, metapack, php, table, tablepack
descriptif Descriptif affiché
head Ajoute du contenu dans le head de l’espace privé
liens* Liens vers d’autres CFG
liens_multi* Liens vers des CFG « multi »
nom Nom du stockage
onglet Cacher/afficher l’onglet du formulaire CFG
refus Message de refus en cas de non autorisation
table Table de stockage
titre Titre du formulaire

Les paramètres en détail


autoriser
Permet de déclarer le type d’autorisation nécessaire pour l’accès à la page de configuration


boite
Le titre de la boite formulaire, défaut titre si présent, ’Configuration quelque_chose" sinon


casier
Elle permet optionnellement de stocker les champs de formulaire dans un tableau.

Si nom=monsquelette et casier=chose, alors on récupère les valeurs par #CONFIG{monsquelette/chose/nom_du_champ}

Note sur casier :
Il est possible d’indiquer des sous tableau dans casier :
<!-- casier=option/navigation -->. On récupère alors les valeurs du formulaire par #CONFIG{squelette/option/navigation/champ_du_formulaire}


colonne
Selectionne une colonne particulière avec le storage ’tablepack’ (par défaut ’extra’ qui évoluera peut être)


depot
Permet de stocker les valeurs ailleurs que dans spip_meta (metapack). Stockage possible :

  • meta : comme le fait SPIP avec le stockage des metas,
  • metapack : dans une entrée de la table spip_meta
  • php : dans un fichier php dans le repertoire /local/cfg,
  • table : dans une ligne d’une table sql (nécessite un champs cfg_id)
  • tablepack : colonne que l’on choisit dans une table (défaut ’extra’)


descriptif
Le descriptif affiché en haut de colonne gauche


head
(v1.3.7) Ajoute du contenu dans le head (html) de l’espace privé.
Attention, ce contenu ne sera pas présent en passant par #FORMULAIRE_CFG


liens*
Les liens sur autre cfg affichés dans cette colonne

  • exemple : <!-- liens*=prefixe:quelque_chose -->
  • ’prefixe :’ permet de selectionner la chaine de langue
    <:prefixe:quelque_chose :> comme titre du lien.
  • Ce paramètre nécessite une * [1]


liens_multi*
(v1.3) Liens vers un fond cfg qui utilise des identifiants multiples : ce lien ajoute un formulaire


nom
Le nom du meta où sera stockée la configuration, par défaut c’est le nom du formulaire, xxx dans fonds/cfg_xxx


onglet
Elle permet d’afficher (par défaut) ou non un onglet dans la page ecrire/?exec=cfg. Cet onglet prend le nom du fichier fond (toto, si le fichier s’appelle cfg_toto.html).

Ainsi, si un plugin/squelette possède plusieurs fonds, cela permet de limiter le nombre d’onglets sur la page. Il est possible d’indiquer quel est l’onglet "parent" dans un fond CFG en mettant <!-- onglet=nom_du_parent -->


refus
Permet de définir un message spécifique en cas de non autorisation à la page de configuration


table
Permet de définir la table de stockage (dans les cas avec storage=tablepack ou table)


titre
Un des 2 titres, fera le gros titre si boite est aussi présent

Exemple des propriétés onglets, liens et casier

Prenons l’exemple d’un squelette qui utilise 2 fonds distincts (cfg_squelette, cfg_squelette_complement). On peut définir les fichiers comme cela :

  • cfg_squelette
  • cfg_squelette_complement

Les 2 fonds vont s’enregistrer dans la variable de spip_meta ’squelette’. Le fonds/cfg_squelette_complement.html va se stocker dans ’squelette/option’ (casier=option) : on pourra donc faire #CONFIG{squelette/option/champ_du_formulaire}.

Seul un lien vers le premier fond (squelette) sera affiché dans la page /ecrire/?exec=cfg car l’autre fond à la variable onglet définie (et différent de ’oui’).

Notes

[1Lorsque la propriété est un tableau auquel on veut rajouter un élément, il faut faire précéder le = par une astérisque * comme :
<!--  liens*=crayons -->

Dernière modification de cette page le 15 mai 2009

Retour en haut de la page

Vos commentaires

Répondre à cet article

Qui êtes-vous ?

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 Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Hyperspace : squelette responsive

    8 mars 2016 – 45 commentaires

    Description Ce squelette distribué en plugin est un portage pour SPIP du thème responsive « Hyperspace », proposé sur le site . Voir la démo originale : Sites utilisant le plugin : C’est une base de départ pour l’intégration d’un site simple de (...)

  • Escal-V3 et Escal-V4

    16 février 2012 – 320 commentaires

    Un jeu de squelettes proposant un affichage en 2 ou 3 colonnes avec un large choix de noisettes à insérer ou pas, fortement paramétrable depuis l’espace privé. Présentation A l’instar de sa petite soeur plugin Escal-V2 dont elle reprend toutes les (...)

  • Planning simple

    9 septembre 2015 – commentaires

    Ce plugin permet de créer et imprimer un emploi du temps de façon simple. Il dispose de deux méthodes, l’une est d’écrire une liste des évènements dans le corps de l’article, l’autre requiert le plugin agenda. Le plugin planning simple permet (...)

  • Réservation d’événements

    16 mars 2015 – 348 commentaires

    Ce plugin permet d’offrir aux visiteurs de s’inscrire pour un évènement du plugin Agenda et de gérer les réservations enregistrées. Installation Le plugin s’installe comme n’importe quel plugin. il nécessite : Agenda API de vérification Facteur (...)

  • Enluminures typographiques V3

    25 juillet 2009 – 201 commentaires

    Les Enluminures typographiques V3 permettent d’ajouter au Porte plume les raccourcis typographiques présents dans le Plugin Barre Typographique Enluminée. C’est une extension du PortePlume. Pour la documentation d’usage, se reporter à celle du (...)