CFG fournit pour les scripts php 3 fonctions pour manipuler les données comme le ferait un formulaire CFG, en plus de la balise #CONFIG.

Ces fonctions sont lire_config(), ecrire_config() et effacer_config().

#CONFIG

Cette balise SPIP est étendue par CFG pour lire aussi les informations stockées depuis celui-ci. Elle permet d’extraire des informations d’un dépot (meta, metapack, tablepack, table ou php).

Cette balise admet 2 arguments, le lieu/adresse de la chaine à lire, et la valeur par défaut si cette dernière est vide.

Dépot meta

• #CONFIG{meta::descriptif_site} : affiche le descriptif du site
• #CONFIG{meta::entree_serialisee} : affiche la chaine sérialisée (la sérialisation, généralement faite par CFG, permet de stocker plusieurs informations dans une seule méta de SPIP)

Dépot metapack
CFG, par défaut, stocke les informations avec le dépot ’metapack’ qui sérialise les champs du formulaire CFG dans une seule méta de SPIP. Les informations lue avec ce dépot sont déserialisée et peuvent donc retourner dans certains cas des tableaux php.

• #CONFIG{metapack::descriptif_site} : sera vide car ’descriptif_site’ est une chaine non serialisée
• #CONFIG{metapack::entree_serialisee} : retournera la valeur désérialisée. Si c’est un tableau, celui-ci sera donc retourné.
• #CONFIG{metapack::nom/champ} : retournera la valeur du champ stocké dans la meta ’nom’.
• #CONFIG{metapack::nom/casier/champ} : retournera la valeur du champ stocké dans la meta ’nom’ rangée dans le dossier ’casier’.

Dépot tablepack
permet de récupérer des informations sérialisées dans une colonne d’une table SPIP, telle que la colonne ’extra’ :

• #CONFIG{tablepack::auteur:3/nom/champ} : récupère la valeur de ’nom/champ’ dans la colonne ’cfg’ de la table spip_auteurs (id_auteur=3) (/ !\ cette colonne par défaut est encore en discussion)
• #CONFIG{tablepack::rubrique@extra:5/nom/champ} : récupère la valeur de ’nom/champ’ dans la colonne ’extra’ de la table spip_rubriques (id_rubrique = 5)
• #CONFIG{tablepack::~13/nom/champ} : pour histoire, cela sélectionne la table ’spip_auteurs’ avec id_auteur=13.

Dépot php
récupère des informations stockés par CFG dans un fichier php :

• #CONFIG{php::nom} : récupère le tableau ’nom’ (stocké dans /local/cfg/nom.php)(A voir s’il ne serait pas mieux dans /tmp, non accessible)
• #CONFIG{php::nom/champ} : récupère la valeur de ’nom/champ’
• #CONFIG{php::adresse/fichier.php:nom/champ} : récupère la valeur de ’nom/champ’ d’un fichier dont l’adresse est indiquée.

Raccourcis
Si le nom du dépot n’est pas passé à la balise #CONFIG, voilà ce qui se passe :

• #CONFIG{nom} : lecture avec le depot ’meta’
• #CONFIG{nom/} : (présence d’un /) lecture avec le depot ’metapack’ (sera donc déserialisé et pourra retourner un tableau). Une syntaxe utile peut être [(#ID_RUBRIQUE|in_array{#CONFIG{nom/,#ARRAY}})]
• #CONFIG{nom,'',''} : pour histoire, déserialise ’nom’, comme l’écriture ci-dessus
• #CONFIG{table:id/} : lecture avec ’tablepack’
• #CONFIG{~id_auteur/} : lecture avec ’tablepack’

lire_config()

Cette fonction est identique à la balise #CONFIG étendue par CFG. Elle lit la donnée demandée. Si le nom du dépot n’est pas donné (depot ::), ce sont les mêmes raccourcis que la balise #CONFIG qui s’appliquent... à une exception historique près : si lire_config('nom') peut être déserialisée, elle le sera.

• lire_config($chemin='', $defaut=null);
• $chemin : le chemin comme celui de #CONFIG,
• $defaut : une valeur par défaut éventuelle

Lire le descriptif du site :

Lire une donnée sérialisée dans spip_meta :

Cette commande lira la valeur de ’nom_champ’ (on peut l’imaginer comme un tableau $meta['nom']['casier']['mon_champ'])

Pour que la valeur demandée existe, il faut soit l’avoir créé avec ecrire_config('nom/casier/mon_champ', $valeur) ou avec un formulaire CFG en utilisant les paramètres :

Lire la colonne extra d’un auteur :

C’est la colonne extra qui est lue par défaut. Ce comportement est susceptible d’évoluer (utilisation d’une colonne ’cfg’ ?)

Lire une colonne quelconque (ici, ’prefs’) d’une table :

ecrire_config()

Introduit en version 1.2 de CFG, cette fonction permet d’écrire une configuration.

• ecrire_config($chemin, $valeur);
• $chemin : le chemin comme celui de la fonction lire_config(),
• $valeur : la valeur à écrire. Peut être un tableau de valeurs.

change le descriptif du site !

stocker une meta de spip_meta !

stocker un extra d’auteur :

stocker une colonne ’extra’ de rubrique :

effacer_config()

Introduit en version 1.2 de CFG, cette fonction permet d’effacer une configuration.

• effacer_config($chemin);
• $chemin : le chemin comme celui de la fonction lire_config() ou ecrire_config().

Exemples :