FAQ

Ce qui suit est une collection de question fréquement posées et de questions anticipées sur PunBB.

Table des matières

Utilisation générale
1. Pourquoi je ne peux pas m'identifier ?
2. Est-ce que PunBB supporte le BBCode et, si oui, comment puis-je l'utiliser ?
Administration
Modifications et intégration dans un site
Licence et copyright

1. Utilisation générale

1.1 - Pourquoi je ne peux pas m'identifier ?: Il y a beaucoup de raisons possibles. La raison la plus commune est que vous avez simplement saisi un nom d’utilisateur et/ou un mot de passe incorrect. Veuillez, s’il vous plait, vérifier à nouveau que vous avez bien écrit des informations correctes et essayez encore. Si cela ne fonctionne toujours pas, vous pouvez demander un nouveau mot de passe en cliquant sur le lien Mot de passe oublié ? à la page d’identification.; Quand vous aurez saisi les nom d’utilisateur et mot de passe corrects, vous serez redirigé à la page depuis laquelle vous avez cliqué sur le lien d’identification. Si vous constatez qu’après avoir été redirigé vous n’êtes toujours pas identifié, le problème est presque certainement lié aux cookies. PunBB se fonde sur des cookies pour déterminer si vous êtes identifié ou non. Assurez-vous que votre navigateur est correctement configuré pour accepter les cookies. Si vous ne pouvez toujours pas vous identifier, vous devriez contacter un administrateur des forums sur lesquels vous avez des problèmes.
1.2 - Est-ce que PunBB supporte le BBCode et, si oui, comment puis-je l'utiliser ?: Oui, PunBB supporte le BBCode. Il supporte un ensemble de balises BBCode présentes dans beaucoup d’autres forums. Les balises prises en charge par PunBB sont gras, souligné, italique, couleur, lien, email, image, citation et code. Les instructions d’installation se trouvent dans le script help.php. Un lien vers ce script est disponible juste après les zones de saisies de texte qui permettent l’utilisation du BBCode (ex : lorsque vous écrivez un message).

2. Administration

2.1 - Je continue à voir des messages comme Bad HTTP_REFERER. Comment puis-je me débarasser d'eux ?

Quand un script dans PunBB reçoit des données de formulaire, il vérifie la variable CGI “HTTP_referer” (mal orthographié dans la norme HTTP) pour s’assurer que le formulaire a été soumis depuis le bon script. Le contrôle est seulement fait pour les administrateurs et les modérateurs. Le contrôle de referrer est un mécanisme de sécurité qui empêche les utilisateurs malveillants de tromper les administrateurs et les modérateurs en soumettant de façon silencieuse et invisible un formulaire depuis une page externe à un des scripts de PunBB.

Le contrôle de referrer peut échouer pour un certain nombre de raisons. Le contrôle se fonde sur l’URL de base renseignée à la page d’options dans l’interface d’administration. Si l’URL de base n’est pas correctement indiquée, le contrôle de referrer échouera. Il est également essentiel que vous visitiez les forum en écrivant dans votre barre d’adresse de navigateur l’URL exacte indiquée pour l’URL de base. Si l’URL de base est réglée à http://unhote.com et que vous visitez les forums en allant à http://www.unhote.com (notez les WWW), le contrôle échouera.

Une autre raison fréquente de l’echec du contrôle est que vous naviguez sur les forums derrière un proxy ou un pare-feu (firewall) qui supprime le HTTP_referer de toutes les demandes. Norton Internet Security et Norton Personal Firewall sont connus pour supprimer le HTTP_referer dans leurs installations par défaut. Certain "bloqueurs" de popup/pub sont également connus pour faire cela (cependant la pluparts d’entre eux ne le font pas).

Vous pouvez trouver des informations sur la façon de paramètrer Norton Internet Security and Norton Personal Firewall pour qu'ils ne supprime pas les informations de referrer aux adresses suivantes (en anglais) : 2002 and earlier et 2003 et 2004.

2.2 - Comment est-ce que j'accorde à un utilisateur un accès de modérateur à un certain forum ?

La première étape est de déplacer l’utilisateur dans le groupe des modérateurs. Ceci peut être fait dans le profil des utilisateurs sous "Administration".

La prochaine étape est de donner les nouveaux droits d’accès de modérateur à un ou plusieurs forum. Ceci est également fait dans le profil d’utilisateur. Juste au-dessous du menu déroulant que nous venons juste d’utiliser, vous trouverez une liste de forum ainsi que des cases à cocher. Choisissez les forums pour lesquels vous voulez accorder l’accès de modérateur à l’utilisateur et cliquer sur "Mettre à jour". L’utilisateur est maintenant un modérateur et peut éditer et supprimer des discussions et des messages dans les forum que vous avez selectionnés.

2.3 - Les téléchargements d'Avatars ne fonctionnent pas. Qu'est-ce qui ne va pas ?

Afin que les téléchargements d’avatars fonctionnent, le compte utilisateur sous lequel le serveur web fonctionne doit avoir des permissions d’écriture dans le repertoire des avatars. Sous les systèmes d’exploitation UNIX (ou UNIX-like), ceci est habituellement réalisé par l’intermédiaire de la commande " chmod". La plupart des clients FTP ont une fonction pour ceci et il est habituellement réalisé en cliquant-droit sur le répertoire et en choisissant quelque chose comme "Attributs", "permissions" ou encore "chmod". Si vous ne savez pas quelles valeurs saisir, essaiyez 0777 (ou juste 777 si vous pouvez seulement écrire trois chiffres).

2.4 - J'obtiens un message disant "Unable to write configuration cache file to cache directory." (impossible d'écrire les fichiers de configuration dans le dossier cache.). Qu'est-ce qui ne va pas ?

Semblable au téléchargement d’avatar, où PunBB doit pouvoir écrire dans le répertoire avatar, PunBB doit pouvoir écrire dans le répertoire de cache. Voyez la question ci-dessus pour plus de détails.

2.5 - Les gens qui utilisent Internet Explorer 6 ne peuvent pas s'identifier. Pourquoi ?

Le problème est lié à la façon dont Internet Explorer 6 manipule les cookies des tiers. Un cookie racine (first party cookie) est un cookie qui provient du domaine hôte des pages, tandis qu’un cookie de tiers provient d’un autre domaine. Le problème surgit quand un site utilise une certaine forme de domaine de redirection ou un service de redirection basé sur des frames. C’est à dire un service qui redirige les utilisateurs au véritable endroit au lieu de pointer directement à lui. (par exemple les service de ulimit) La meilleure solution au problème est de ne pas employer un tel service de redirection de domaine et d’utiliser à la place un “vrai” domaine. Cependant, un patch rapide qui semble fonctionner la majeure partie du temps peut être trouvée dans le script include/functions.php. Recherchez P3P et suivez les instructions (en anglais).

2.6 - J'ai placé le forum dans en mode maintenance et je me suis déconnecté. Comment est-ce que je peux le désactiver ?

Copiez et envoyez sur votre serveur dans le répertoire racine de vos forums le script desactiver_mode_maintenance.php (turn_off_maintenance_mode.php) qui se trouve dans le répertoire extras/ et lancez le depuis à votre navigateur. Un message apparaîtra quand l’opération sera accompli. N’oubliez pas d’enlever le script du répertoire racine de vos forums une fois terminé.

2.7 - Qu'est-ce que ce "DEBUG mode" et comment est-ce que je peux l'activer ?

"DEBUG mode" peut être utilisé pour afficher des messages d’erreur plus détaillés en cas d’échec. Ces messages d’erreur peuvent être utiles pour dépister la cause de l’échec. Quand "DEBUG mode" est activé, PunBB affichera également le temps d’execution du script et le nombre de requêtes SQL exécutées pour chaque page. Ces informations seront affichées dans le pied de page.

Pour activer le "DEBUG mode", ouvrz le fichier include/common.php dans un éditeur de texte et trouvez la ligne qui commence par //define('PUN_DEBUG', 1); Elle est située en haut du fichier juste au-dessous du préambule de licence d’utilisation. Enlevez alors les deux slashes au début de la ligne puis enregistrez et envoyez sur votre serveur le script. Une fois que vous avez résolu le problème, il est recommandé de désactiver le "DEBUG mode" (remettez juste les deux slashes).

2.8 - Est-il possible d'avoir plus d'une "URL de base" ?

No, it's not. However, there is extremely seldom a need to have more than one. The need often arises when you access your forums through one URL externally and one URL internally. The internal URL is often the IP address or the name of the computer that runs the webserver. The problem is easily solved by editing your hosts file. The hosts file contains a list of IP addresses and host names. If you haven't made any changes to it earlier, it unsually only contains the IP address 127.0.0.1 and the hostname localhost. If you enter http://localhost/ into your browsers adress field, your operating system will first check the hosts file to see if localhost can be found in there. If it finds it, it will navigate to the IP address 127.0.0.1 instead of trying to look up the host name localhost with traditional DNS. So, what you want to do is to add a line to this file with the IP address of the webserver and the hostname that you use to access your server externally. If the host name for your forums is www.mycoolforums.com and the IP address of the webserver is 192.168.100.15, you would add the line:

192.168.100.15      www.mycoolforums.com

The hosts file is located in different locations depending on what operating system you run. Here's a list of where the file can usually be found in a few operating systems:

Windows 95/98/ME: c:\windows\hosts
Windows NT/2000/XP: c:\windows\system32\drivers\etc\hosts
Linux/UNIX: /etc/hosts

Once you've added the line to your hosts file, you can set your "Base URL" to www.mycoolforums.com and use that URL to access your forums externally as well as internally.

2.9 - J'ai mis à jour manuellement la base de données, mais les changements n'ont aucun effet. Qu'est-ce qui se passe ?

Afin de diminuer la charge du serveur de base de données, PunBB met en cache (dans le répertoire cache/) des parties de la base de données pour les scripts PHP. Si vous avez fait les changements manuellement à un quelconque des ces éléments : bannissements, config, catégories, forum ou rangs, les données en cache doivent êtres mises à jour. Pour cela, supprimez simplement tous les scripts PHP dans le répertoire cache/. PunBB les régénérera quand il aura besoin d’eux.

3. Modifications et intégration dans un site

3.1 - Comment est-ce que je peut ajouter plus de smilies à mes forums ?

Ajouter plus de smilies sur vos forums n’est pas très difficile, mais cela demande d’éditer un fichier source de PunBB. Voici, étape par étape, la marche à suivre. Il est vivement conseillé de connaître quelque bases de PHP et de programmation en général.

Envoyez les smilies que vous voulez changer ou ajouter sur votre serveur, dans le dossier img/smilies/.
Ouvrez le fichier include/parser.php avec un éditeur de texte (le Bloc-Note par exemple) et trouvez la ligne commençant par "//Here you can add additional smilies if you like" (elle devrait se trouver au début du fichier, vers les lignes 31-32). Vous trouverez alors la définition de deux tableaux PHP : $smiley_text et $smiley_img. $smiley_text contient les codes des smilies (exemple :D ou :rolleyes:) et $smiley_img contient le nom des fichiers images des smilies (exemple big_smile.png ou roll.png).
Pour chaque smiley que vous voulez ajouter, ajoutez le code correspondant au smiley dans $smiley_text et le nom du fichier image dans $smiley_img. Faîtes bien attention de faire précéder le caractère ' (guillemet simple) par un antislash si vous l’utilisez dans n’importe lequel de vos smilies (par exemple :rock’n’roll:). Cela doit être fait pour que PHP puisse comprendre qu’il ne s’agit pas de la fin de la chaîne, mais d’une partie du nom. Il en est de même pour les antislash. Si le code de votre smiley contient un antislash, faîtes-le simplement précéder d’un autre antislash.
Une fois vos smilies ajoutés, vérifiez si les codes de vos smilies contiennent ou non des caractères tels que & (esperluette), " (guillemet double), ' (apostrophe), < (signe inférieur) ou > (signe supérieur). Si c'est le cas, vous devrez décommenter la ligne //$smiley_text = array_map('pun_htmlspecialchars', $smiley_text); (autour de la ligne 35) en enlevant les double-slashs du début.
Sauvegardez et envoyez votre fichier sur votre serveur pour tester. Une liste de tous les smilies installés se situe à la fin du texte d'aide dans help.php.

Si vous obtenez un message d'erreur PHP vous signalant une "Parse error", c'est que vous avez probablement pas échappé les apostrophes ou les anti-slashs dans le tableau $smiley_text.

3.2 - Comment puis-je utiliser des smilies de tailles différentes de 15x15 pixels ?

Pour utiliser des smilies de tailles différentes de 15×15 pixels, vous devez empêcher PunBB d’ajouter les attributs width="15" et height="15" aux balises d’images. Ceci peut être fait en modifiant le fichier include/parser.php dans un éditeur de texte. Ouvrez ce fichier et cherchez :

width="15" height="15"

Le texte devrait être quelque part autour de la ligne 260. Remplacez alors les valeurs par une largeur et une hauteur de votre choix. Si vous voulez utiliser des smilies de tailles variables, enlevez les attributs complètement.

3.3 - Comment est-ce que j'ajoute mon propre footer/header (pied de page/en-tête) de sorte que je puisse intégrer mes forums dans le design de mon site ?

À cette fin, PunBB a un système simple de template. Les fichiers template se trouvent dans include/template/. Il y a cinq templates - main.tpl, admin.tpl, help.tpl, maintenance.tpl et redirect.tpl. Le fichier main.tpl contient le template pour presque toutes les pages qui sont affichées par les forums, admin.tpl est le template de l’interface d’administration, help.php est pour l’écran d’aide, maintenance.tpl est le template pour la page de message qui est affichée quand vos forums sont mis en mode maintenance, et enfin le fichier redirect.tpl est utilisé pour afficher les pages de redirection comme lorsque vous vous identifiez ou que vous écrivez un message.

Les templates contiennent les variables qui sont remplacées par le contenu réel quand une page est affichée. Toutes les variables dans PunBB sont délimitées par un signe "plus petit que" et un "plus grand que" (< et >). Par exemple, la variable pour le titre des forum s’appelle <pun_title>. Lorsque PunBB affiche la page d’index, il lit le fichier main.tpl et remplace <pun_title> par le titre des forums. Il y a 11 variables de remplacement dans main.tpl.

Si vous voulez personnaliser l’apparence de PunBB pour qu’il s’adapte à la charte graphique des autres pages sur votre site web, c’est principalement les fichiers template que vous devriez modifier. Par exemple, si vous vouliez ajouter votre propre logo en haut de chacune des pages des forums, vous éditeriez main.tpl et ajouteriez le balisage nécéssaire pour afficher votre logo à la position appropriée dans le fichier. Il est possible d’inclure des scripts PHP depuis les templates, lisez l’entrée suivante de la FAQ pour plus d’informations.

3.4 - Est-il possible d'inclure mes propres scripts PHP dans les templates ?

Oui. PunBB dispose d’une variable de remplacement spéciale appelée pun_include pour inclure des scripts dans les templates. Par exemple, si vous vouliez inclure un script appelé banner.php en bas de chacunes de vos pages de forums vous devriez placer votre script dans le répertoire include/user/ et ajouter ce qui suit à votre fichier template :

<pun_include "banner.php">

Le script banner.php doit être placé dans le répertoire utilisateur d'inclusion mentionné ci-dessus. PunBB exécutera le script et la variable pun_include sera remplacée par ce que le script produira en sortie. Veuillez noter que tous les scripts inclus ont accès aux variables de PunBB, ainsi si vous -par exemple- vouliez accéder à la base de données, vous pourriez utiliser l’objet $db juste comme le fait PunBB. Le remplacement de la variable pun_include est la dernière chose que PunBB fait quand il produit une page, ainsi vous ne devez pas vous inquiéter de ne pas employer les noms variables que PunBB utilise.

3.5 - Je voudrais afficher des informations provenant des forums sur la page d'accueil de mes sites. Comment est-ce que je puis faire ceci ?

Le script extern.php situé dans le répertoire racine de vos forums peut générer diférentes sortes d’informations sur vos forums. Voir les Informations Développeur pour plus d’information.

3.6 - PunBB fournit-il des fils RSS pour les discussions récentes ?

Oui. Le script extern.php situé dans le répertoire racine de vos forums peut produire sur les discussions récentes des fils RSS 0.91. Voir les Informations Développeurs pour plus d’information.

3.7 - J'ai développé une modification pour PunBB et je veux la délivrer au public. Que dois-je faire maintenant ?

Visit the PunBB.org downloads page and download the Mod SDK. It contains a text file with instructions, a template for the readme file (all mods have a readme.txt) and a template for a mod installation script (if needed).

For more information about PunBB modding, visit the PunBB Resource.

4. Licence et copyright

4.1 - Sous quelle licence PunBB est-il délivré ?: PunBB est délivré sous la licence d’utlisation "GNU General Public License" (GNU/GPL). En quelques mots cela signifie que PunBB est gratuit à télécharger, à utiliser, à distribuer, à modifier. Cependant, si une quelconque de ces modifications est délivrée au public, ce code doit également être délivré sous la même licence d’utlisation que PunBB.
4.2 - Est-ce que je puis enlever le copyright du pied de page ?: Oui, mais veuillez ne pas le faire. Si il le faut, essayez de consever intact au moins "Propulsé par PunBB" (Powered by PunBB) avec le lien vers www.punbb.org.
4.3 - Est-ce que je puis ajouter mon propre copyright au pied de page ?: Oui, mais vous ne pouvez pas modifier le copyright original de telle manière qu'il perde sa signification première. En d'autres termes, il doit être absolument clair que le copyright de PunBB revient à www.punbb.org. Ajouter une ligne additionnelle avec votre propre copyright est correct.
4.4 - Est-ce que je puis enlever copyright du code source ?: Non. La notification de copyright dans tous les fichiers source doit être laissée intacte. N'importe quelle modification ou déplacement de ce copyright est illégal en vertu de la licence GNU GPL.