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

Une liste des propriétés des formulaires CFG se trouve ici : API CFG : Paramètres des formulaires

Personnalisation des auteurs

Grace au dépôt ’tablepack’ (un alias ’extrapack’ existe, et sélectionne la table spip_auteurs), 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{~8/nom_du_champ} : où 8 est l’identifiant de l’auteur, affiche les paramètres de cet l’auteur ;
-  [(#CONFIG{~[(#SESSION{id_auteur})]/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.
-  <!-- depot=tablepack -->, avec "table" et "colonne" Déclare de stocker dans les champs Extras de la table ’spip_auteurs’
-  <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{id_auteur})]/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}