Plugin wordpress pour maxiGos
Version du plugin : v2.02, avec maxiGos v8.03.
Usage
Ce plugin nommé "maxiGos sgf player content plugin" permet d'insérer un lecteur sgf maxiGos dans une page wordpress.
Une fois le plugin installé et paramétré, le code à insérer dans l'article est de la forme [gos]xxx.sgf[/gos], [gos cfg="yyy"]xxx.sgf[/gos], [gos]ccc[/gos] ou [gos cfg="yyy"]ccc[/gos] avec :
- "xxx.sgf" le fichier sgf que l'on veut afficher.
- "yyy" le nom de n'importe quelle configuration maxigos du thème spécifié par le paramètre "maxigos theme" (voir le chapitre "Paramètres" ci-dessous).
- "ccc" un texte représentant un enregistrement sgf (exemple : "(;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])").
Le nom d'un lecteur maxiGos est de la forme "maxigos-" + theme + "-" + configuration + ".js". Pour s'assurer qu'une configuration de maxiGos est possible dans un thème donné, il suffit juste de vérifier que le script du lecteur correspondant est bien présent dans wordpress.
Si la valeur du paramètre "maxigos theme" est sa valeur par défaut (c'est à dire "neo-classic" pour cette version-ci du plugin), 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 la valeur du paramètre "maxigos config" si celle-ci est spécifiée, ou "basic" sinon. Ces différentes configurations permettent des utilisations variées du lecteur.
Pour que les formes [gos]ccc[/gos] ou [gos cfg="yyy"]ccc[/gos] où ccc est un texte représentant un enregistrement sgf fonctionnent, il faut que le paramètre "maxigos_sgf_as_is" valle 1 (voir le chapitre "Paramètres" ci-dessous), que la page soit en UTF-8, et que l'enregistrement sgf soit lui aussi en UTF-8.
Installation
Pour installer ce plugin (la procédure ci-dessous a été testée avec wordpress 6.2.2 en français) :
- Cliquez ici pour télécharger la version 2.02 du plugin avec maxiGos version 8.03
- Se connecter au site utilisant wordpress en tant qu'administrateur.
- Selectionner "Plugins" dans le menu de gauche. La page "Plugins" s'affiche.
- Cliquer sur le bouton "Add New". La page "Install Plugins" s'affiche.
- Cliquer sur "Upload".
- Cliquer sur le bouton "Select a file", rechercher l'archive du plugin, puis cliquer sur "Install Now".
- Cliquer sur "Activate Plugin".
- Créer le sous-dossier "wp-sgf" dans le dossier "wordpress" et mettez-y vos fichiers sgf.
Le plugin est alors en théorie prêt à l'emploi.
Paramètres
Un certain nombre de paramètres peuvent être éventuellement modifiés (pour les modifier, affichez la page d'administration wordpress de votre site, cliquez sur "Settings" ou son équivalent dans votre langue dans le menu de gauche, puis sur "MaxiGos". Modifiez ensuite ce que vous voudrez). Ces paramètres sont :
- maxigosTag (valeur par défaut : "gos"): n'importe quel chaine de caractères alphanumériques. Changez cette valeur si "gos" est utilisé par un autre plugin.
- maxigos_sgf_folder (valeur par défaut : "wp-sgf"): chemin entre le dossier racine de wordpress et le dossier des fichiers sgf. Changez cette valeur si vous ne voulez pas stocker vos fichiers sgf dans le dossier "wp-sgf".
- maxigos_folder (valeur par défaut : "wp-content/plugins/maxigos-wp"): chemin entre le dossier racine de wordpress et le dossier où est le plugin maxigos. En théorie, vous ne devriez pas avoir besoin de le modifier.
- maxigos_config (valeur par défaut : ""): configuration par défaut utilisée par maxigos quand "yyy" is omis. Si ce paramètre est une chaine de caractère vide, maxigos utilise la configuration "basic".
- maxigos_theme (valeur par défaut : "neo-classic").
- maxigos_lang (valeur par défaut : "en"): langage utilisé par maxigos ("en" pour l'anglais, "fr" pour le français, "ja", "zh-hans", et "zh-hant").
- maxigos_sgf_max_length (valeur par défaut : "32767"): longueur maximum du contenu d'une balise [gos][/gos] si celui-ci est un enregistrement sgf. Cette longueur peut-être en théorie infinie.
- maxigos_sgf_as_is (valeur par défaut : "0"): s'il vaut 1, le contenu de la balise [gos][/gos] peut être soit un enregistrement sgf, soit un nom de fichier sgf. S'il vaut 0, le contenu de la balise [gos][/gos] ne peut être qu'un nom de fichier sgf.