Afficher des bases de données de parties d’Échecs (PGN) dans les articles

PGN_VIEWER pour Spip

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 :

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.

Exemples d’utilisation en ligne

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom