Toutes les instructions d'installation, de mise à jour ou de conversion se trouvent dans le fichier Install. Si vous devez convertir votre forum phpBB 2.0.x en phpBB 3.0.x, nous vous recommandons fortement de faire toutes les sauvegardes nécessaires avant de commencer toute tentative !

Les utilisateurs des versions beta de phpBB3 ne peuvent pas faire de mise à jour.

Aucun support ne sera assuré pour les installations suivantes :

• Mise à jour d'une version beta de phpBB3 vers une version phpBB3 RC1 ou supérieure
• Conversions de phpBB 2.0.x vers une version beta de phpBB3
• Installation d'une version beta de phpBB3

Un support est apporté aux types d'installations suivantes :

• Mise à jour d'une version phpBB3 RC1 à la version actuelle
• Conversions de phpBB 2.0.x vers la version la plus récente
• Nouvelles installations de phpBB3 - toujours et seulement la version la plus récente

Une fois installé phpBB peut être facilement géré par soit le panneau d'administration, soit par le panneau de modération. Si vous avez besoin d'aide ou de conseils sur la manière de les utiliser correctement, rendez vous à la section 3.

2.i. Traduction (i18n)

Il existe un nombre non exhaustif de pack de langue et de pack d'images disponibles. Vous pouvez les trouver sur la page de téléchargement officielle :

http://www.phpbb.com/downloads/

Cette adresse est la page officielle pour tous les packs de langue supportés par phpBB. Si vous téléchargez un pack de langue sur un autre site, vous comprendrez que vous ne pourrez pas obtenir de support de notre part. Il est donc inutile de nous demander de l'aide.

L'installation de ces packs est très facile, il vous faut simplement télécharger le pack de langue que vous souhaiter ajouter aux forum et le décompresser dans le répertoire languages/. Gardez la même structure des répertoires lorsque vous faites ça ! Une fois les fichiers sur votre serveur, allez dans Administration->Système->Pack de Langue et cliquez sur le lien "install" à coté de votre nouveau pack de langue. De la même manière, procédez facon identique pour le pack d'images en le décompressant dans le répertoire imageset/ du thème choisi (exemple : styles/prosilver/imageset ou styles/subsilver2/imageset), une fois encore en conservant la structure de fichiers de l'archive. Une fois installé le pack d'image est immédiatement disponible.

Si votre pack de langue n'est pas disponible, visitez nos forums ou vous trouverez un sujet indiquant toute les traductions en cours ou disponibles. Ce sujet vous donnera toutes les informations nécessaires si vous voulez devenir traducteur d'un langage qui ne l'est pas encore.

2.ii. Thèmes

Bien que le groupe phpBB est plutôt fier des thèmes inclus dnas cette version, il se peut qu'ils ne soient pas aux gouts de tout le monde. C'est pourquoi phpBB3 permet de changer de thème avec une extrême facilité. Tout d'abord vous devez trouver un thème qui vous plait et le télécharger. Vous pouvez en trouver à cette adresse :

http://www.phpbb.com/styles/

Attention : la plupart des thèmes pour des versions phpBB2 ne fonctionneront pas avec phpBB3.

Après avoir téléchargé votre thème, vous devez en décompresser l'archive, en conservant également la structure, dans le répertoire styles/. Ensuite allez dans Administration -> Styles, vous devriez voir le nouveau thème. Cliquez sur le lien "installer" et il deviendra disponible à tous les membres de votre communauté.

Note importante : si vous créez votre propre thème, ou si vous voulez modifier un thème existant, rappellez vous qu'il vous faut recharger et vider le cache pour que vous puissiez voir les modifications prendre effet. Cela se trouve sur l'écran Administration->Général->Paramètres de chargement. Cela permet au cache de détecter quels changement ont été fait depuis la dernière mise en cache du thème et d'automatiquement les afficher. Si ce paramètre est désactivé, vous ne verrez pas les changements s'afficher.

2.iii. Modifications

Bien que n'étant pas officiellement pris en charge par le groupe phpBB, ces modifications que beaucoup d'entre vous souhaitent apporter à la norme phpBB sont donc effectuées par des tiers et étendent encore plus les capacités des forums. Elles peuvent être trouvés à cette adresse :

http://www.phpbb.com/mods/

Rappellez-vous que les bugs ou autres problèmes issus de ces modifications de code que vous allez apporter à un forum de base (dit "vanilla") ne doivent en aucun cas être rapportés sur le "bug tracker" (voir ci-dessous). La première chose à faire est de supprimer ces modifications et de voir si le problème persiste.

De même, les modifications qui pourraient modifier la base de données de quelque manière que ce soit, pourraient rendre les futures mises à jour très difficiles, voire même impossible. Cela étant dit, un grand nombre d'utilisateur continuent à utiliser la plupart de ces modifications avec succès.

phpBB3 peut sembler un peu intimidant pour ceux d'entre vous qui découvrent ou ne sont pas familiers des forums, en particulier avec le nouveau système de permissions. La première chose que vous devez faire est de lire la FAQ qui couvre la plupart des questions de base que vous pourriez vous poser. Si vous avez besoin d'aide supplémentaire, il existe de nombreux forums de support que vous trouverez facilement (voir plus bas).

3.i. Documentation phpBB3

La documentation est désormais disponible en ligne et accessible à l'adresse suivante :

http://www.phpbb.com/support/documentation/3.0/ (en anglais)

Elle couvre l'ensemble des fonctionnalités de phpBB3, de l'installation à la configuration des permissions et du management des utilisateurs.

3.ii. Forums communautaires

Le groupe phpBB possède une communauté prospère ou bon nombre de membres ont décidé de donner généreusement du temps, du support et de l'aide aux autres membres qui en auraient besoin. Vous pouvez les trouver sur :

http://www.phpbb.com/

Si vous cherchez de l'aide sur nos forums, assurez vous avant d'effectuer une demande de support, d'avoir fait des recherches au préalable. Si une réponse à un problème similaire a été donnée, vous la trouverez, et cela permettra aux developpeurs, modérateurs et groupes de support de passer du temps sur des problèmes qui n'ont pas encore trouvé de solution. Rappellez vous que phpBB est entièrement basé sur le volontariat, qu'il n'y aucune compensation pour le temps donné, que ce soit par les groupes de support, les moderateurs ou les developpeurs. Soyez donc respectueux et attentifs lorsqu'une réponse vous est apportée.

3.iii IRC

Un autre endroit ou vous pouvez trouver de l'aide est sur notre canal IRC. Il se trouve sur le réseau Freenode, irc.freenode.net et le canal est #phpbb. Il est accessible avec n'importe quel client IRC tel que mIRC, XChat, etc... Encore une fois, n'abusez pas du service et soyez respectueux envers les autres utilisateurs.

Ceci est la troisième version stable de phpBB. La ligne 3.0.x est terminée, avec seulement quelques petits points de la version à debugguer et d'eventuels problèmes de sécurité à corriger, pour lesquels quelques petites altérations du code peuvent survenir si cela s'avère nécessaire. La prochaine version majeure de phpBB sera la version 3.2 dont le dévellopement est déjà plannifié (la version de develloppement sera la version 3.1). Ne demandez pas quand cette version sera disponible, aucune date n'est fixée, elle sortira, quand elle sortira.

Ceux qui s'interressent au dévelloppement de cette version, peuvent se rendre à cette adresse pour voir la progression :

http://area51.phpbb.com/phpBB/

Veuillez noter que ce forum ne doit PAS être utilisé pour demander un quelconque support ou poser des questions à propos de phpBB 2.0.x ou phpBB 3.0.x, les forums communautaires sont la pour ca. Ce genre de message sera automatiquement verrouillé et restera sans réponse.

Le groupe phpBB utilise un système de bugtracker (suivi des bugs) pour lister le moindre bug lié à phpBB. Il se trouve à l'adresse que vous trouverez juste après. Attention : ne rapportez pas un message de bugs sur nos forums, ils seront verrouillés. De même n'utilisez pas non plus le bug tracker pour des demandes de support. Chaque chose doit être précisément rapportée au bon endroit.

http://www.phpbb.com/bugs/

Bien que nous apprécions beaucoup recevoir des rapports de bug (plus on a de rapports, plus stable sera phpBB), nous vous demandons de veiller à respecter quelques procédures avant de rapporter un bug :

• Premièrement, déterminer si le bug est reproductible, cela dépends du bug. Si il est reproductible, il est probablement lié à phpBB3. S'il ne l'est pas, les causes peuvent provenir du serveur ou d'une autre cause indépendante de phpBB3, qui n'est donc pas un bug à rapporter. Les rapports de bugs pour ce genre de choses peuvent ralentir les résultats sur la recherche d'un véritable bug existant.
  
  
• Ensuite, lisez ou recherchez sur le bug tracker si votre bug (ou un similaire) n'est pas déjà listé. Si c'est le cas, ajoutez votre commentaire, plutôt que de creer un nouveau sujet pour le même problème (tout cela nous ralenti).
  
  
• Verifiez sur les forums communautaires (utilsez la fonction recherche) pour voir si une discussion à propos de ce problème n'existe pas. Cependant, comme dit précedement de postez pas sur nos forums un message à propos d'un bug à moins qu'il ne soit non-reproductible ou que vous pensiez qu'il n'ai pas un rapport direct avec le code de phpBB3.
  
  
• Si le bug n'est pas encore listé, rajoutez-le.

Si vous postez un nouveau bug (un qui n'existe pas encore dans le bug tracker), connectez vous (le login est le même que celui que vous utilisez sur les forums communautaires) et ajoutez les détails suivants :

• Le type/version de votre serveur, exemple Apache 1.3.28, IIS 4, Sambar, etc...
• La version PHP et le mode opératoire, exemple PHP 5.1.1 comme module, PHP 4.4.4 tournant en CGI, etc...
• Le type/version de la base de données, exemple MySQL 4.0.1, PostgreSQL 7.3.2, MSSQL Server 2000 SP1, etc...

Vous pouvez trouver le type/version de la base de données dans le panneau d'administration.

Donnez en détails les étapes qui vous ont conduit au bug, dans votre rapport, de manière aussi complète que possible, ce qui nous permettra de reproduire ce bug afin de le corriger. Si vous avez trouvé une solution à ce problème, assurez vous qu'elle fonctionne dans tous les cas (et que la solution soit conforme au guide de codage) et n'amène pas un autre problème ou une incompatibilité. Ajoutez votre solution au bugtracker, si nous en avons besoin, nous vous contacterons.

Une fois le bug soumis, un email vous sera envoyé à chaque commentaires ajouté. Merci de répondre à une demande d'information complémentaire, si elle vous est demandée ! Il n'y a rien de plus frustrant que de recevoir un rapport de bug, de demander une information complémentaire et ne ne recevoir aucune réponse. Dans ce cas nous fermons le sujet concernant ce bug, ce qui nous permettra de traiter des problèmes dont nous aurons toutes les informations en priorité. Evidemment nous ne souhaitons pas que cela arrive.

5.i. Les bugs liés à la Securité

Si vous trouvez une faille potentielle de sécutité relatif à la vulnérabilité de phpBB, s'il vous plait, ne postez aucun message sur le bug tracker, ou sur un forum public, etc... Faire cela, peut amener certains individus peu scrupuleux à utiliser ces failles avant que nous ayons pu les corriger. Toutes les failles de sécurité devront impérativement être signalées à cette adresse :

http://www.phpbb.com/security/

Cette liste est incomplète, mais elle représente les bugs qui peuvent survenir à grande échelle. D'autres bugs sont généralement limités à certaines configurations ou à certaines méthodes d'installation, de mise à jour ou de conversion.

• Conversions incomplètes sur certains serveurs en raison de nombreuses données à convertir sur votre forum.
• Mise à jour incomplètes sur certains serveurs pour les mêmes raisons.
• Les émoticones placés juste après un bbcode qui ne s'afficheront pas ou mal. Les émoticones doivent toujours être séparés par au moins un espace.

phpBB ne gère plus PHP3 en raison de plusieurs problèmes de compatibilité et nous vous recommandons d'utiliser au moins une version stable de PHP5 pour utiliser correctement phpBB. La version minimum requise est la version PHP 4.3.3.

Rappellez-vous qu'utiliser une application sur un environnement PHP en develloppement peut amener à des résultats assez étranges ou inattendus et l'apparition de bugs n'est pas rare (qui ne sont pas forcément liés à l'application). Upgradez PHP en version stable avent d'utiliser phpBB3.

Ce forum a été développé et testé sous Linux et Windows (parmis d'autres) en utilisant un serveur Apache, MySQL 3.23, 4.x, 5.x, MSSQL Serveur 2000, PostgreSQL 7.x, Oracle 8, SQLite et Firebird. Les versions de PHP utilisées variaient de la version 4.3.3 à 6.0.0-dev sans problèmes.

7.i. Note sur la sécurité de PHP

A ce jour aucun faille de sécurité liée à PHP n'est à signaler.

Cette application est un logiciel opensource distribué sous licence GPL. Vous pouvez regarder le code source et le répertoire /docs/ pour plus de détails. Le contenu des fichiers et des documents originaux sont copyright (c) 2000, 2002, 2005, 2007 phpBB Group, tous droits réservés.