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 :
<!-- autoriser=voir -->
<!-- titre=Personnalisation-->
<!-- depot=tablepack -->
<!-- table=spip_auteurs -->
<!-- colonne=extra -->
<form method="post">[(#ENV{_cfg_}|form_hidden)]
<fieldset>
<input type="hidden" name="id" class="cfg_id" value="#SESSION{id_auteur}" />
<label>Afficher ses articles ?</label>
<select name="mes_articles">
<option value="oui"[(#ENV{mes_articles}|=={oui}|?{' selected="selected"'})]>Oui</option>
<option value="non"[(#ENV{mes_articles}|=={non}|?{' selected="selected"'})]>Non</option>
</select>
<br />
</fieldset>
<input type="submit" name="_cfg_ok" value="<:OK:>" />
<input type="reset" value="<:Reset:>" />
<input type="submit" name="_cfg_delete" value="<:Supprimer:>" />
</form>
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 :
Connecté : [(#SESSION{nom}|sinon{visiteur})]
[(#CONFIG{~[(#SESSION{id_auteur})]/mes_articles}|=={oui}|?{' ',''})
[(#INCLURE{fond=inc-mes-articles}{visiteur=#SESSION{id_auteur}})]
]
- #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.
<!-- depot=tablepack -->
<!-- table=spip_rubriques -->
<!-- colonne=extra -->
<form method="post">[(#ENV{_cfg_}|form_hidden)]
<fieldset>
<input type="hidden" name="id" class="cfg_id" value="#ENV{id}" size="15" />
<label>Nom du contact :</label>
<input type="text" name="nom_contact" />
<br />
</fieldset>
<input type="submit" name="_cfg_ok" value="<:OK:>" />
<input type="reset" value="<:Reset:>" />
<input type="submit" name="_cfg_delete" value="<:Supprimer:>" />
</form>
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}
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |