Suite à la présentation de CFG à la SPIP Party de Clermont-Ferrand le 10 novembre 2007, voici un article présentant des possibilitées avancées de CFG.

Variables CFG détaillées

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

La propriété 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.

La propriété casier

Elle permet de stocker les champs de formulaire dans un tableau, permettant de classer ses variables.

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}

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

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

 cfg_squelette

 cfg_squelette_complement1

 cfg_squelette_complement2

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

Seul un lien vers le premier fond (squelette) sera affiché dans la page /ecrire/?exec=cfg car les deux autres ont la variable onglet=non. Un lien vers les autres fonds s’affiche lorsque l’on est dans un des trois fichiers (/ecrire/?exec=cfg&cfg=squelette).

Personnalisation des auteurs

Grace au storage extrapack, il est possible d’affecter des paramètres aux auteurs, comme on le ferait pour une entrée dans spip_meta.

On récupère ensuite les paramètres d’un auteur simplement avec un .
 #CONFIG{~/nom_du_champ} : affiche le champ de l’auteur connecté (attention au cache si vous l’utilisez dans la partie publique, qui risquerait de prendre les valeurs d’un autre auteur)
 #CONFIG{~toto/nom_du_champ} : où toto est un login, affiche les paramètres de l’auteur ’toto’ ;
 [(#CONFIG{~[(#SESSION{login})]/nom_du_champ})] : dans la partie publique (La balise #SESSION est introduite dans SPIP en 1.9.3) permet d’afficher les paramètres de l’auteur connecté (la présence de #SESSION invalide le cache).

Voici un formulaire qui permet de dire si un auteur souhaite afficher ou non quelques paramètres :

Explications de code :

 <!-- autoriser=voir  --> : Permet d’afficher le formulaire même pour les redacteurs.
 <!-- storage=extrapack --> : Déclare de stocker dans les champs Extras
 <input type="hidden" name="id" class="cfg_id" value="#SESSION{id_auteur}" /> : définit l’identifiant de la table (par défaut spip_auteurs) où les valeurs seront enregistrées. Le class="cfg_id" permet à CFG de savoir que ce champ est à utiliser comme clé primaire. #SESSION{id_auteur} transmet à ce champ la valeur de l’id_auteur connecté (SPIP >= 1.9.3)

récupération des valeurs :

 #CONFIG{~[(#SESSION{login})]/mes_articles} : récupère la valeur de " toto/mes_articles" si l’auteur toto est connecté.

Personnalisation des extras d’autres tables

Sur le même principe que les auteurs, il est possible de personnaliser des champs extras d’autres tables. Il suffit de déclarer le nom de la table dans le formulaire.

Explications :

 Si l’on appelle le formulaire par ?exec=cfg&cfg=nom_du_fond&cfg_id=id_rubrique, alors le formulaire permet d’ajouter un nom de contact.
 <!-- table=spip_rubriques --> : selectionne la table spip_rubriques.

Récupérer les valeurs :

#CONFIG{rubriques:#ID_RUBRIQUE/nom_contact} : Soit, de façon générique : #CONFIG{Nom_table:ID/nom_du_champ}