BBCode phpBB pour maxiGos
Version des BBCodes : v3, avec maxiGos v8.
Description
Ces BBCodes permettent d'insérer un lecteur sgf maxiGos dans les messages postés sur un forum fonctionnant à l'aide de phpBB.
La procédure ci-dessous a été testée avec phpBB 3.0.12, version en anglais.
Préparatifs
- Téléchargez les scripts des lecteurs du thème "forum" de maxiGos (voir la page de téléchargement)
- Copiez ces scripts sur le site où est installé votre phpBB dans un dossier quelconque (par exemple "scripts/_maxigos")
- Connectez-vous au site utilisant votre phpBB en tant qu'administrateur et affichez la page d'administration
- Cliquez sur l'onglet "Posting"
BBCode utilisant une URL récupérant un fichier sgf
Paramétrage
On suppose que l'URL a une forme du genre (nnn représente un nombre entier quelconque) :
http://nomDeDomaineDuForum.org/download/file.php?id=nnn
Dans le "HTML replacement", on aura besoin d'ajouter une expression régulière qui "match" cette URL (par exemple, pour l'URL ci-dessus, "^http://nomDeDomaineDuForum\.org/download/file\.php\?id=[0-9]+$").
En théorie, l'URL peut avoir n'importe quelle forme. Adaptez cette expression régulière en fonction de la situation.
- Cliquez sur le bouton "Add a new BBCode"
- Ajoutez le BBCode suivant (on suppose que maxiGos est dans un dossier nommé "scripts/_maxigos" mais ça peut être ailleurs,
et on suppose que le nom du BBCode est "gos" mais ça peut être n'importe quel autre nom : adaptez le code ci-dessous si tel est le cas)
- "BBCode usage:"
[gos]{URL}[/gos] - "HTML replacement:"
<script data-maxigos-source-filter="^http://nomDeDomaineDuForum\.org/download/file\.php\?id=[0-9]+$" src="scripts/_maxigos/maxigos-forum-basic.js">{URL}</script> - "Help line:"
Affiche un lecteur de fichiers sgf
- "BBCode usage:"
- "BBCode usage:"
[gos={IDENTIFIER}]{URL}[/gos] - "HTML replacement:"
<script data-maxigos-source-filter="^http://nomDeDomaineDuForum\.org/download/file\.php\?id=[0-9]+$" src="scripts/_maxigos/maxigos-forum-{IDENTIFIER}.js">{URL}</script> - "Help line:"
Affiche un lecteur de fichiers sgf - Cliquez sur le bouton "Submit"
- Si vous n'avez pas déjà ajouté "sgf" dans la liste des extensions autorisées pour les fichiers joints, cliquez sur "manage Extention group" et créez un nouveau groupe, par exemple nommé "Go files", puis cliquez sur "manage Extention", et ajoutez l'extension "sgf" (extention group: "Go files").
Le BBCode est ensuite en théorie prêt à l'emploi.
Usage
Il suffit d'insérer dans les messages des lignes comme ci-dessous :
Lecteur basique
[gos]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
ou
[gos=basic]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
Lecteur avec commentaires
[gos=comment]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
Lecteur affichant un diagramme
[gos=diagram]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
Lecteur affichant une partie
[gos=game]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
Lecteur affichant un problème
[gos=problem]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
Lecteur avec commentaires et arbre des coups
[gos=tree]http://nomDeDomaineDuForum.org/download/file.php?id=1[/gos]
N'oubliez d'effacer les autres paramètres tel que "mode=view" de l'URL s'il y en a. Ou bien adaptez l'expression régulière qui vérifie la forme de l'URL en conséquence. Par exemple :
data-maxigos-source-filter="^http://nomDeDomaineDuForum\.org/download/file\.php\?(mode=view&(amp;)?)?id=[0-9]+(&(amp;)?mode=view)?$"
BBCode utilisant une chaine de caractères représentant du sgf
Paramétrage
- Cliquez sur le bouton "Add a new BBCode"
- Ajoutez le BBCode suivant (on suppose que maxiGos est dans un dossier nommé "scripts/_maxigos" mais ça peut être ailleurs,
et on suppose que le nom du BBCode est "gos2" mais ça peut être n'importe quel autre nom : adapter le code ci-dessous si tel est le cas)
- "BBCode usage:"
[gos2]{TEXT}[/gos2] - "HTML replacement:"
<script data-maxigos-html-parenthesis="1" src="scripts/_maxigos/maxigos-forum-basic.js">{TEXT}</script> - "Help line:"
Affiche un lecteur sgf
- "BBCode usage:"
[gos2={IDENTIFIER}]{TEXT}[/gos2] - "HTML replacement:"
<script data-maxigos-html-parenthesis="1" src="scripts/_maxigos/maxigos-forum-{IDENTIFIER}.js">{TEXT}</script> - "Help line:"
Affiche un lecteur sgf
- "BBCode usage:"
- Cliquez sur le bouton "Submit"
Le BBCode est ensuite en théorie prêt à l'emploi.
Usage
Il suffit d'insérer dans les messages des lignes comme ci-dessous :
Lecteur simple
[gos2](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
ou
[gos2=basic](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
Lecteur avec commentaires
[gos2=comment](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
Lecteur affichant un diagramme
[gos2=diagram](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
Lecteur affichant une partie
[gos2=game](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
Lecteur affichant un problème
[gos2=problem](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
Lecteur avec commentaires et arbre des coups
[gos2=tree](;GM[1]FF[4]CA[UTF-8]SZ[19]PW[A]PB[B]WR[6d]BR[6d];B[qd];W[dp])[/gos2]
On peut insérer un enregistrement sgf provenant d'un fichier sgf en copiant/collant le contenu du fichier entre [gos2] et [/gos2] en utilisant l'éditeur de phpBB. Mais cet éditeur modifie le contenu : il ajoute une balise html <br> quand un retour à la ligne est trouvé dans le fichier sgf, il remplace les "(" et ")" par leurs codes html, etc. MaxiGos essaie de gérer ça, mais il se peut qu'il faille faire quelques adaptations supplémentaires en fonction de la situation.
Notes
Il est possible d'utiliser d'autres variantes du lecteur. Il suffit de télécharger depuis la page de téléchargement de maxiGos le lecteur approprié, de le copier dans le dossier "scripts/_maxigos" de phpBB, et d'adapter le BBCode.