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

4 discussions

  • Chessnaute

    Ok, j’en ferais un article sur mon site pour préciser qu’il s’agit donc d’un plugin .

    Répondre à ce message

  • 1
    Chessnaute

    Bonsoir

    Quelles différences avec http://www.spip-contrib.net/Afficher-des-bases-de-donnees-de ?

    Personnellement j’utilise la première version avec beaucoup de plaisir (exemple les parties de Bobby Fischer)

    • Bonsoir.

      Pour un webmaster assez doué comme toi, peut être il ne verra pas de différence.
       
      Mais pour les rédacteurs qui n’ont pas les connaissances requises pour le faire, ça leurs facilite la tache.
       
      <PGN_VIEWER> dans la description de fichier leurs sera plus facile que le code habituel ( que tu utilise déjà ).
       
      Bonne continuation.

    Répondre à ce message

  • 2

    Bonsoir.

    Le code de la partie squelette a été modifié, il n’est plus correcte ici.

    Un administrateur a ouvert mon article en édition, ce qui a donné la disparition de 2 caractères nécessaires.

    La copie correcte est à l’adresse : http://spip.echecs.ma/spip.php?article40

    • L’article etait rédigé en html et non en texte+raccourcis typo. Il n’aurait pas du etre publié en l’état. J’ai donc nettoyé tout cela.

      J’ai relu le code correct, et la seule différence que je vois est le $ dans <$BOUCLE_documents_joints..>

      Tu parles bien de cela ?
      Qu’est ce que ce $ signifie ici ?

    • $ était une erreur qui m’a échappé, il n’a rien à faire dans <$BOUCLE_documents_joints..>
       
      j’ai parlé des caractères { & } (même cas sur Maroc-Echecs)

      C’est visible après votre dernière modification, mais <BOUCLE_documents_joints..> est déclaré 2 fois maintenant ( ligne 2 & 3 ), il faut supprimer la ligne 2.
       
      Pour le HTML, je suis habitué à l’utiliser .. Est ce que ça peut avoir des inconvénients avec Spip ?
       
      Merci pour la correction.

    Répondre à ce message

  • Bravo Averty pour cette contribution et avancement de ce projet .

    Les sites spip qui tournent autour des échecs seront gâtés ..

    J’ai testé ton innovation et c’est très beau de l’utiliser ..

    Je suggère que tu travailles sur le plug-in pour encapsuler ce bijou ..

    Bonne continuation Azerty

    Répondre à ce message

Ajouter un commentaire

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

Dernière modification de cette page le 13 octobre 2008