Plugin joomla pour maxiGos

Version du plugin: v2.01, avec maxiGos v8.03.

Description

Ce plugin nommé "maxiGos sgf player content plugin" permet d'insérer un lecteur sgf maxiGos dans un article joomla.

Une fois le plugin installé et paramétré, le code à insérer dans l'article est de la forme {gos xxx.sgf} où xxx.sgf est le fichier sgf qu'on veut afficher.

On peut aussi ajouter comme deuxième paramètre une configuration. Le code d'insertion aura alors la forme {gos xxx.sgf,yyy}. Si la valeur du paramètre "maxigos theme" est sa valeur par défaut (c'est à dire pour cette version-ci "neo-classic"), yyy peut être un mot clé parmi "basic", "comment", "diagram", "game", "problem" et "tree". Sinon, il peut être le nom de n'importe quelle configuration disponible pour le thème spécifié par le paramètre "maxigos theme". En l'absence de ce paramètre yyy, la valeur par défaut est la valeur du paramètre "maxigos config" si celle-ci est spécifiée, sinon "basic". Ces différentes configurations permettent des utilisations variées du lecteur.

On peut également remplacer le nom du fichier sgf par un texte représentant un enregistrement sgf (uniquement si le paramètre maxigosSgfAsIs vaut 1).

Note : un enregistrement sgf est le contenu d'un fichier sgf (comme par exemple une chaine de caractères du genre "(;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])").

Installation

Pour installer ce plugin (la procédure ci-dessous a été testée avec joomla version 3.10.4 en anglais) :

• Cliquez ici pour télécharger la dernière version (2.01) du plugin avec maxiGos version 8.03
• Se connecter au site utilisant joomla en tant qu'administrateur, et afficher la page d'administration
• Sélectionner dans le menu "Extension", "Manage", "Install"
• Sélectionner "Upload Package File" et rechercher le fichier du plugin qui vient d'être télécharger
• Cliquer sur "Open". Le fichier est téléversé, et le plugin installé
• Sélectionner dans le menu "Extension", "Plugins"
• Rechercher le plugin "maxiGos" dans la liste des plugins
• Activer le plugin "maxiGos" en cliquant sur l’icône dans la colonne "status" (le statut doit passer de rouge à vert)
• Cliquer sur le nom du plugin (une nouvelle fenêtre apparait avec à droite la liste des paramètres du plugin)
• Vérifier si le dossier des fichiers sgf (SGF folder) est bien celui où se trouve les fichiers sgf, et si ce n'est pas le cas, le modifier (indiquer le chemin relatif entre la racine de Joomla et le dossier contenant les sgf)
• Modifier éventuellement les autres paramètres si cela apparait nécessaire (la plupart du temps, ce n'est pas nécessaire de le faire tout de suite après l'installation)

Le plugin est ensuite en théorie prêt à l'emploi.

Questions et réponses

J'envisage d'installer une nouvelle version du plugin. Quelles précautions prendre ?

En cas de réinstallation du plugin sans désinstallation du plugin de la version précédente, les fichiers n'existant plus dans la nouvelle version mais existants dans la version précédente sont toujours présents, ce qui peut poser des problèmes.

Par contre, le paramètrage du plugin est conservé, ce qui simplifie l'installation de la nouvelle version.

Il se peut donc dans certains cas que vous ayez à désinstaller la version précédente du plugin avant de réinstaller la nouvelle mais ce n'est pas toujours une obligation, en particulier lorsqu'il s'agit de version très proche, ou que vous avez vous-même légèrement modifiées.

En tout cas, l'installateur de plugin Joomla ne semble pas faire cette désinstallation automatiquement.

N'oubliez pas aussi avant de désinstaller de noter la valeur des paramètres du plugin de la version précédente. Joomla ne les conservera pas et cela peut servir.

Est-ce que je peux changer le style du lecteur en utilisant les feuilles de style de Joomla ?

On peut le faire en créant (si ce n'est déjà) un fichier user.css via l'interface d'administration de Joomla et en le modifiant.