PGN_VIEWER pour Spip est un script PHP facile à intégrer dans Spip et qui permet d’afficher des parties des échecs dans les articles, tout en facilitant la tâche aux auteurs qui trouvent du mal à le faire traditionnellement .. (1)
Utilisant l’Applet MyChessViewer ( Copie modifié), PGN_VIEWER pour Spip lit et affiche tout les fichiers pgn attachés à l’article comme documents joints.
Contenu de package
Les fichiers nécessaires pour le fonctionnement de script :
- inc-pgnviewer.php
- inc-pgnviewer.html
- pgn_viewer2/pgn_viewer_cfg.php
- pgn_viewer2/ChessBoard.class
- pgn_viewer2/ChessMove.class
- pgn_viewer2/ChessScoreKeeper.class
- pgn_viewer2/PgnGameTags.class
- pgn_viewer2/img/p1/bb.gif
- pgn_viewer2/img/p1/bk.gif
- pgn_viewer2/img/p1/bn.gif
- pgn_viewer2/img/p1/bp.gif
- pgn_viewer2/img/p1/bq.gif
- pgn_viewer2/img/p1/br.gif
- pgn_viewer2/img/p1/wb.gif
- pgn_viewer2/img/p1/wk.gif
- pgn_viewer2/img/p1/wn.gif
- pgn_viewer2/img/p1/wp.gif
- pgn_viewer2/img/p1/wq.gif
- pgn_viewer2/img/p1/wr.gif
Installation
Pour installer PGN_VIEWER pour Spip sur votre site, procédez comme suit :
- Télécharger le package http://spip.echecs.ma/spip.php?article40
- Décompresser le fichier zip sur votre disque local, puis transférer son contenu vers le dossier squelettes de votre site.
Si vous utilisez la version 3.2.4 de squelette Epona, et que le fichier article-normal.html n’a pas été déjà modifié, remplacez le par celui situé dans le package.
Et si vous avez déjà fait des modifications sur ce fichier afin de le personnaliser suivant vos besoins, vous devez lui ajouter les ligne suivantes, juste dans la boucle documents joints :
- [(#REM) Traitement des documents joints ]
- +<BOUCLE_documents_joints(DOCUMENTS) {id_article}{mode=document}{par id_type}{doublons}{"<br>"}>
- [(#LOGO_DOCUMENT|#URL_DOCUMENT)][(#TITRE)][ - (#DESCRIPTIF)]
- +<?
- +$urlpgn = "#URL_DOCUMENT";
- +$titrepgn = "#TITRE";
- +$descriptifpgn = "#DESCRIPTIF";
- +?>
- +<BOUCLE_pgn_joint(DOCUMENTS) {id_document}{id_type=47} {"<br>"}> +<INCLURE(inc-pgnviewer.php)>
- +</BOUCLE_pgn_joints>
- +<hr size="1" width="90%" color="#CCCCCC">
- </BOUCLE_documents_joints>
Configuration
Pour personnaliser le texte, les couleurs de l’Applet vous pouvez éditer le fichier "pgn_viewer2/pgn_viewer_config.php"
- $case_blanches ="FFFFFF"; //( Couleur des cases blanches )
- $case_noires = "008800"; //( Couleur des cases noires )
- $table_couleur = "F4F4F4"; //( Couleur de fond )
- $copyright_coleur = "336600"; //( Couleur de texte Copyright )
- $copyright_texte = "Labo Spip Marocain"; //( Texte personalisé à afficher dans la zone Copyright )
- $absolu_pgn_files = "/"; //( Chemin de Spip : par défaut c'est la racine de site )
Utilisation
Une fois tout les fichiers sont situés dans le dossier squelettes, les auteurs de votre site peuvent commencer à afficher des parties dans les articles à partir des fichiers pgn qu’ils peuvent leur attachés.
Pour afficher les parties, il suffit d’ajouter le tag <PGN_VIEWER> dans la déscription de document ( fichier pgn ) à afficher.
Il est important de noter que le résultat n’apparait pas sur l’espace privé de site.
Alors pour visualiser le résultat dans l’article avant sa publication, vous devez passer l’article à l’état "Proposé à l’évaluation" puis "Prévisualiser".
Désinstallation
Si après installation de PGN_VIEWER pour Spip vous n’aviez pas été satisfait et que vous désiriez le dés-installer, procédez comme suit :
- Supprimez le dossier pgn_viewer2 et les fichiers inc-pgn-viewer.php et inc-pgn-viewer.html de votre dossier squelettes.
- rétablir votre fichier article-normal.html
- Pour le Tag
<PGN_VIEWER>inséré dans la description de document joint, il n’aura plus d’influence sur votre site puisque les deux précédentes actions sont suffisantes.
& 
(
RSS 2.0