まこと の ブログ

MaKoTo no burogu — Journal de bord…

Aller au contenu | Aller au menu | Aller à la recherche

dimanche, 17 janvier 2010

Plugin Livre d’or pour SPIP 2, HowTo

Ayant migré de SPIP 1.9.2 à SPIP 2.0, certains plugins que j'utilisais jusqu'alors sont devenu obsolètes.

De retour sur le site aux plugins spip-contrib.net, j'ai trouvé la nouvelle version du Livre d’or pour SPIP2, http://www.spip-contrib.net/Livre-d-or-SPIP-2.

Seulement voila, les explications d'utilisations laissées par l'auteur sont trop succintes pour celui qui comme moi, n'a pas touché à sa configuration SPIP depuis 2-3 ans…
J'ai donc passé une après-midi à me remettre dans le bain des squelettes et autres trucs, aidés par les pistes données via les commentaires de l'article, pour enfin réussir à mettre en œuvre ce Livre d’or.

Installation du plugin :

  • à la racine de votre dossier SPIP, créer s'il n'existe pas, un dossier nommé «plugins».
  • Télécharger et décompresser l'archive du plugin dans ce dossier plugins… Chez moi, ça donne :
atelier/plugins/livre d or SPIP 2
  • Dans l'interface d'administration de SPIP, Dans le menu Configuration est apparu lu menu Gestion des plugins.
  • Cocher la case du Livre d’or pour SPIP 2.0 et Valider.

Dans le menu Édition est apparu le menu Livre d'or, qui permettra de gérer les messages et éventuellement d'y répondre, bien que ça ne soit pas la finalité d'une telle fonction.

Comment afficher le formulaire du livre d'or aux visiteurs du site ? :

La page correspondante n'existe tout simplement pas ! Il va falloir la créer avec les quelques codes donnés par l'auteur.

En fait, pour appeler le formulaire, c'est la balise #FORMULAIRE_LIVREDOR qui intervient.
Et pour afficher les messages ce sont les balises #ID_FAVORIS, #ID_AUTH, #NOM, #PRENOM, #EMAIL, #TITRE_LIVRE, #TEXTE_LIVRE, #NOTE, #REPONSE, AUTH_REP, #DATE.

Il faut les placer dans une page de squelette fabriquée maison :

  • à la racine de votre dossier SPIP, créer s'il n'existe pas, un dossier nommé «squelettes».
  • créer un fichier livredor.html… Chez moi, ça donne :
atelier/squelettes/livredor.html
  • éditer ce fichier en y plaçant ces balises…allez-y … démerdez-vous..! Arffff… c'est ici que j'ai passé tout mon temps à faire des essais de manière empirique jusqu'à obtenir un résultat satisfaisant, que vous pouvez télécharger en Pièce Jointe :)

Attention, si vous modifiez ce fichier, faites le avec un éditeur de texte ou html comme Bluefish ou Quanta+, car un WYSIWYG comme KompoZer bidouillera le code et donnera un formulaire abîmé !

  • Enfin, pour «appeler» le livre d'or, il faudra placer dans un de vos articles, un lien vers spip.php?page=livredor pour que le visiteur se retrouve en mesure de pouvoir laisser un mot !


Pour aller plus loin… :

Dans le dossier «plugins/livre d or SPIP 2/formulaires», il y a un fichier formulaire_livredor.html qu'il est possible de modifier afin d'en changer son aspect.