Kconf

kconf.tar.gz

Version 0.4.3

Ce plugin permet de créer des formulaires de configuration pour les objets éditoriaux de SPIP : rubriques et articles. Il devrait pouvoir sans trop de difficulté être étendu pour les autres objets de SPIP.

À l’intérieur du dossier squelettes/kconf/ le créateur des squelettes peut mettre des fichiers squelettes (extension .html) dans lequel il utilise des balises #KCA qui seront transformés en champs de formulaire.

De manière générale la balise #KCA accepte 3 arguments :
#KCA{type de champs, nom du kconf, option du champs

Il existe plusieurs type de champs :

• #KCA{select,nom,"a,b,c,d"}
  • produira un champ select avec les options a, b, c et d
• #KCA{radio,nom,"a,b,c,d"}
  • produira un champ radio avec les options a, b, c et d
• #KCA{texte,nom,valeur par défaut}
  • produira un champ texte avec "valeur par défaut"
• #KCA{couleur,nom,#FF0000}
  • produira un sélecteur de couleur avec par défaut du rouge
• #KCA{checkbox,nom,#FFAA00}
  • produira une case à cocher
• #KCA{logo,nom,#FFAA00}
  • produira un champ file permettant de charger une image

Une fois les squelettes de configuration créés, il faut les accrocher aux objets SPIP de son choix grâce à l’interface que l’on trouve sur la page exec=naviguer. Là il faut ouvrir la boite kconf (lien configurer) et dans l’onglet avec le petit logo activer "Afficher l’onglet d’administration du kconf". Cela a pour effet d’afficher l’onglet de liaison entre les objets de SPIP et les squelettes de configuration : un nouvelle onglet "Admin de Kconf" apparaît dans lequel on peut lier chacun des squelettes de configuration à un objet selon 3 modalités :

• lier uniquement à cet objet
• lier à cet objet et à ses enfants (la rubrique et ses sous-rubriques par exemple)
• lier à cet objet et à tous ses enfants (la rubrique, ses sous-rubriques, ses sous-sous-rubriques, etc...) Une fois les liaisons faites, il est conseillé de décocher la case "Afficher l’onglet d’administration du kconf" pour ne pas trop faire peur aux rédacteurs du site.

Pour chacun des objets liés à un squelette, les rédacteurs et administrateurs du site auront ainsi la possibilité d’ouvrir la boite de dialogue "configurer" et de remplir les formulaires liés à l’objet sur lequel il se trouve (exec=naviguer et exec=articles).

Coté squelettes du site public il faut pouvoir appeler les valeurs des configurations des rédacteurs, c’est à cela que sert la balise #KCONF qui s’utilise comme ceci :
#KCONF{nom,id_objet,nom_objet}
#KCONF_LOGO{nom,id_objet,nom_objet}

À l’intérieur d’une boucle ARTICLES ou d’une boucle RUBRIQUES on peut utiliser les balises raccourcis :
#KCONF_ART{nom}
#KCONF_LOGO_ART{nom}
#KCONF_RUB{nom}
#KCONF_LOGO_RUB{nom}

Quand on utilise l’id_objet 0 on appel les valeurs choisi sur la page d’accueil de la navigation (exec=naviguer).

Les configurations sont reçu en cascade, c’est à dire qu’une valeur non défini pour une rubrique sera défini par héritage de la rubrique parente.

La balise #KCONF_LOGO produit une balise HTML IMG et peut ainsi bénéficier des filtres images de SPIP.

Les squelettes de configuration contenant des logos #KCA{logo,...} ne contiennent pas de bouton "valider", il ne faut donc pas mélanger les balises logo avec d’autres balises de configuration.