Papi-web - Installation et mise à jour

Cette page donne les principales étapes à respecter pour l'installation de Papi-web.

Les versions validées sont les suivantes :

Pré-requis

  1. Un ordinateur sous Windows (a priori Papi-web fonctionne sur toutes les version depuis Windows XP)
  2. Le logiciel Papi installé dans la dernière version diffusée par la fédération (page de téléchargement de Papi)
  3. Un serveur Web Apache/PHP, par exemple celui de XAMPP (ou un autre progiciel de type LAMP)

Installation

Installation de XAMPP

Télécharger la dernière version de XAMPP (page de téléchargement de XAMPP).

Installer XAMPP avec les options ci-dessous.

      

Autoriser le serveur Apache sur tous les réseaux :

A la fin de l'installation, le panneau de contrôle de XAMPP se lance et demande la langue (une seule fois) :

Vérifier que le serveur web se lance sans problème en démarrant Apache :

 

Configuration de PHP

Par défaut, l'extension ODBC de PHP n'est pas activée (et sans cette extension, PHP ne peut lire les fichiers Papi au format Access). Pour l'activer, éditer le fichier php.ini :

Rechercher dans le fichier php.ini la chaîne odbc :

 

Ajouter la directive suivante :

Sauvegarder le fichier php.ini (Ctrl-S), fermer l'éditeur (Alt-F4), puis arrêter et re-démarrer le serveur Apache pour appliquer la modification (Panneau de contrôle de XAMPP, Apache Stop puis Apache Start) :

  

Installation de Papi-web

Récupérer la dernière version de Papi-web (en ligne sur le site http://domloup.echecs35.fr/papi-web).

Ouvrir l'archive téléchargée et l'installer dans le répertoire C:\xampp\htdocs :

  • Le fichier .htaccess configure Apache pour le fonctionnement de la saisie des résultats ;
  • Le fichier index.php est la page PHP qui opère la saisie des résultats par les utilisateurs ;
  • Le fichier ffe.bat est le programme qui télécharge les « boules Papi » sur le site web fédéral ;
  • Le répertoire config/ contient les fichiers de configuration de Papi-web :

    • Quatre fichiers d'exemple sont ainsi fournis (tous les fichiers *.inc.php sont considérés comme des configuration de Papi-web) : domloup-fide.inc.php, example.inc.php, france-adultes.inc.php et metz-festival.inc.php.
    • le fichier custom.css contient des règles CSS (Cascading Style Sheets, pour la présentation des pages web), elles sont appliquées à toutes les configurations.
  • Le répertoire include/ contient des fichiers utilisés par papi-web, notamment ffe.php qui est le programme PHP de téléchargement des fichiers Papi sur le site fédéral.
  • Le répertoire papi/ est le répertoire par défaut des « boules Papi »
  • Le répertoire tmp/ est un répertoire temporaire utilisé par Papi-web.

Test de la saisie des résultats

À l'aide d'un navigateur web, accéder à la page http://localhost/papi-web :

Note : en cas d'erreur avec le message « data source name not found and no default driver specified », vérfier que la version de XAMPP installée est bien une version 32bits (dans les dernières versions de XAMPP, seules les versions 64bits proposées en téléchargement, la dernière version 32bits proposée est la version 7.3.1 téléchargeable ici).

Choisir le tournoi d'exemple :

Vérifier que la saisie des résultats sur l'interface web sont bien répercutées dans la « boule Papi » correspondante (papi/99999.papi).

Interactions avec le site fédéral

Il est impossible de tester le lien avec le site fédéral sans avoir à disposition un vrai tournoi homologué, avec le code fourni par la Fédération lors de l'homologation.

Lorsque le code de téléchargement est correctement renseigné (champ upload_password dans la déclaration des tournois), il suffit de lancer le script ffe.bat et suivre les indications.


Test des codes d'accès


Affichage des résultats sur le site fédéral


Récupération des factures d'homologation


Téléchargement des fichiers Papi sur le site fédéral

Mise à jour de Papi-web

La mise à jour de Papi-web est très simple :

  1. renommer l'ancien répertoire papi-web/ du répertoire C:\xampp\htdocs/, par exemple en papi-web.old/ ;
  2. installer la nouvelle version en déployant le répertoire papi-web/ dans le répertoire C:\xampp\htdocs ;
  3. récupérer le contenu des répertoires config/ et papi/ de la version précédente et les placer dans les mêmes répertoires de la nouvelle version.

C'est tout !


Papi-web, programme de saisie des résultats dans Papi et de mise en ligne des résultats sur le site fédéral, a été développé à titre gracieux pour les arbitres et organisateurs de la Fédération Française des Échecs par Pascal AUBRY. Il est livré sans aucune garantie et peut être redistribué, sans aucune contrepartie financière.
http://domloup.echecs35.fr/papi-web