Tutoriel réalisé par Skouat
QuickInstall c'est quoi ?
Il s'agit d'un outil dédié à faciliter l'installation d'un ou plusieurs forums phpBB 3.0 ou phpBB 3.1 sur un serveur web local.
A qui s'adresse cet outil et que permet-il ?
Cet outil est principalement destiné aux développeurs et aux testeurs de MOD et d'extensions.
Il permet d'installer en 1 clic un forum de test préconfiguré.
Ceci permet de vous garantir un forum vierge de toute modification, résultant de tests précédemment réalisés.
Avant tout, il faut garder en mémoire que cet outil ne doit être utilisé que localement. De plus, son utilisation sur des environnements web de production est fortement non recommandée et à vos risques et périls.
Autres points :
- Dans ce tutoriel, les références liées à l'interface de QuickInstall seront basées sur la version française de l'outil. Toutefois, la correspondance des termes traduits seront mis entre parenthèses ().
Vous apercevrez dans cette documentation le terme « QI ». Il s'agit évidemment de l'abréviation de « QuickInstall ».
» Sommaire
- » Installation de QuickInstall
- Prérequis et téléchargement des fichiers sources
- Installer QuickInstall
- Configurer QuickInstall
- Sauvegarder la configuration de QuickInstall
» Installation de QuickInstall
- Prérequis et téléchargement des fichiers sources
- WampServer
pour Windows NT/XP/Vista/7 - EasyPHP
Pour Windows Win9x/Me/NT/2000/XP/Vista/7 - MAMP
Pour Mac OS X - XAMPP
Pour LInux, Mac, Solaris et Windows. - phpBB3 - Anglais uniquement ou phpBB3 FR + EN
- QuickInstall + Pack de langue FR
- Automod + Pack de langue FR
- Support Toolkit (STK)
- Extraire le contenu de l'archive et copier le répertoire quickinstall-1.2.1 à la racine de votre serveur web local. Souvent, et selon les serveurs, le repertoire s'appelle www ou htdocs.
- Ex : C:\Program Files\Apache2.2\htdocs\quickinstall-1.2.1
- S'assurer que les répertoires {QI_Chemin_Installation}/boards, {QI_Chemin_Installation}/cache et {QI_Chemin_Installation}/settings sont accessibles en écriture.
Par défaut cela doit être le cas. - Extraire le contenu de l'archive phpBB et copier le répertoire nommé phpBB3 dans {QI_Chemin_Installation}/sources
- Extraire le contenu de l'archive Automod, renommer le répertoire root en automod puis le copier dans {QI_Chemin_Installation}/sources.
- Ce qui devrait donner par exemple :
C:\Program Files\Apache2.2\htdocs\quickinstall-1.2.1\sources\automod - Si vous avez récupéré un pack de langue pour QuickInstall, il faut extraire le contenu de l'archive et copier son contenu dans {QI_Chemin_Installation}/language
- Si vous voulez pouvoir installer différentes versions de phpBB, il faut :
- Récupérer la version de phpBB3 que vous voulez ajouter.
- Extraire le contenu de l'archive.
- Copier son contenu dans {QI_Chemin_Installation}/sources/phpBB3_alt.
- Renommer le répertoire phpBB3 avec un nom plus convivial.
Exemple :- Pour phpBB SEO version 3.0.10, nommer le répertoire phpBB_SEO_3010
Pour phpBB version 3.0.7, nommer le répertoire phpBB_307
- Le répertoire Extra permet l'ajout de fichiers autres que AutoMOD et phpBB3.
vous pouvez par exemple ajouter STK à vos forums. - Langue de QuickInstall (Select QuickInstall language)
=> Si vous avez installé un pack de langue, ce paramètre permet de changer la langue de l'outil.
=> Ce paramètre n'a aucune interaction avec la langue définie par défaut pour installer un forum (cf. Default language). - Utilisateur de la base de données (Database user)
=> Nom d'utilisateur de la base de données ayant les droits de créer une base.
=> Souvent le compte se nomme : root. - Mot de passe de la base de données (Database password)
=> Mot de passe du compte défini dans Utilisateur de la base de données. - Fuseau horaire (Time zone)
=> Fuseau horaire qui sera défini par défaut sur l'ensemble des forums. - Nom d’utilisateur de l’administrateur (Administrator username)
=> Nom du compte Administrateur qui sera créé par défaut sur l'ensemble des forums. - Mot de passe de l’administrateur (Administrator password)
=> mot de passe par défaut pour le compte défini dans Nom d’utilisateur de l’administrateur. - Langue par défaut (Default language)
=> Permet de sélectionner la langue qui sera définie par défaut une fois le forum installé.
Le menu déroulant affiche la liste des langues de phpBB détectées automatiquement par QuickInstall.
Si la langue n'apparait pas dans la liste, assurez-vous d'avoir ajouté le pack de langue dans le répertoire {QI_Chemin_Installation}/sources/phpBB3 et {QI_Chemin_Installation}/sources/phpBB3_alt/phpbb_XXX
Il est vivement recommandé de laisser la langue par défaut sur « British English », car tous les MODs et extensions sont conçus par défaut pour cette langue (Ceci vous évitera bien des problèmes).
- Avant de commencer quoi que ce soit, il est important d'avoir le minimum syndical.
Côté serveur web local, le plus simple étant d'utiliser un serveur pré-packagé, en voici une liste non-exhaustive :
Installer QuickInstall
- L'arborescence finale doit ressembler à ceci :
Configurer QuickInstall
- Pour configurer QuickInstall, Il suffit de se connecter sur votre serveur web avec votre navigateur préféré
Si le lien ne fonctionne pas, vérifiez que le chemin d'installation de QuickInstall est correct et/ou que vous n'avez pas de problème avec votre serveur local
Lors de son premier lancement, QI demande des paramètres de configuration.
Par défaut les paramètres prédéfinis sont globalement corrects, mais certains nécessitent quelques ajustements.
Voici la liste des paramètres (listés de haut en bas par rapport à la page configuration) :
Une fois les paramètres définis, il suffit de cliquer sur « Envoyer » (submit).
En haut de la page vous devriez voir apparaître le message
Vos réglages ont été sauvegardés avec succès.
ou en version EN
Your settings were successfully saved.
A ce stade, QI est opérationnel et prêt à faire chauffer la machine à créer des forums.
Pour l'instant, QI n'a fait aucune modification au niveau de la base de données, il ne faut donc pas s'inquiéter si rien n’est visible dans cette dernière.
Sauvegarder la configuration de QuickInstall
- Si vous souhaitez sauvegarder la configuration de QuickInstall, il vous suffit de faire une copie du répertoire {QI_Chemin_Installation}/settings
» Utilisation de QuickInstall
- Créer son 1er forum de test
- Si vous êtes toujours sur l'interface QI, naviguez dans l'onglet « Installer les forums » (Main page) accessible en haut à droite de la page.
Sinon, retournez sur la page démarrage en allant sur http://localhost/quickinstall-1.2.1/
(chemin à adapter selon le répertoire d'installation) - Depuis la page « Installer les forums », renseignez le champ Nom du répertoire et de la base de données du forum (Board database and directory name)
Attention ! il s'agit du nom qui permettra de créer la base de données et le répertoire dans {QI_Chemin_Installation}/boards.
Notez que, pour éviter tout problème éventuel, il est préférable de pas utiliser d'espace, d'éviter les accents et caractères spéciaux ainsi que de mettre des majuscules.
Si vous souhaitez mettre une espace, utilisez plutôt un caractère de substitution tel que _ (trait de soulignement / underscore / touche 8 du clavier alphanumérique).
Quand le forum sera créé :- la base de données sera nommée selon la convention suivante : qi_phpbb_nom_du_forum
(si vous avez laissé les paramètres par défaut).
Les fichiers (php, html, css, etc...) seront quant à eux installés dans {QI_Chemin_Installation}/boards/nom_du_forum. - Cliquez sur « Envoyer » (Submit) UNE SEULE fois pour lancer la création du forum de test.
Attention ! Selon les performances de l'ordinateur, la création d'un forum peut prendre du temps.
Une fois la création terminée, QI vous redirigera automatiquement sur le nouveau forum. (sauf si vous avez changé l'option de redirection définie par défaut) - Options de configuration (Config options)
- Options de remplissage (Populate options)
- Options avancées (Advanced options)
- Options de configuration
Cette option vous permet d'ajouter/mettre à jour des paramètres de configuration dans la table phpbb_config.
Syntaxe :- Code: Tout sélectionner
config-name; config-setting; dynamic
- config-name => Correspond au nom du paramètre.
- config-setting => Correspond à la valeur.
- dynamic => Défini si le paramètre sera de type dynamique.
Ne rien mettre ou mettre 0 pour désactiver le mode dynamique, sinon mettre 1 pour l'activer.
- Les lignes commençant par un # sont considérées comme un commentaire. Elle seront donc ignorées lors du traitement.
- Un seul paramètre à ajouter par ligne.
- le ; est utilisé comme séparateur de liste.
- Code: Tout sélectionner
load_tplcompile;1;1 session_length;999999
Exemple valide- Code: Tout sélectionner
#exemple de paramètre dynamique load_tplcompile;1;1 #exemple de paramètre non dynamique session_length;999999
- Options de remplissage
Permet de créer automatiquement des utilisateurs, des catégories, des forums, des sujets et des messages selon les paramètres qui seront renseignés.
Plus ces valeurs sont élevées, plus le temps de création du forum sera important (1min, 20min, 1h, 2h ou plus). - Options avancées
C'est à partir de ce bloc d'options que vous pourrez choisir d'installer une version alternative de votre forum de test.
A la seule condition d'avoir installé des forums alternatifs (voir Chapitre 1.2 - Paragraphe f).
Concernant les autres options je vous laisse le soin d'en déduire leurs utilités
- un fichier ouvert avec un éditeur de texte ;
- une page html ouverte directement avec votre navigateur ;
- un logiciel FTP pointant sur l'un des répertoires du forum de test ;
etc.
Il est possible de créer autant de forums de test que vous le souhaitez. La seule limite sera la place disponible du stockage sur lequel QI est installé.
Créer un forum avec les options avancées
- Le chapitre précédent a décrit comment créer un forum avec QI de manière standard.
Si vous retournez sur la page de création des forums (Onglet « Installer les forums ») vous pourrez noter qu'il existe trois liens cliquables :
Supprimer les forums de tests
- Hé oui ! c'est bien beau de créer des forums de tests, mais au bout d'un moment il faut aussi penser à faire du nettoyage
Il existe la méthode manuelle, qui consiste à supprimer le répertoire du forum de test présent dans {QI_Chemin_Installation}/boards et de supprimer la base de données directement depuis l'interface d'administration (phpMyAdmin pour ne pas citer l'un des plus utilisés),
ou alors il est possible d'aller simplement dans l'onglet « Gérer les forums » (Manage boards) présent dans la liste des onglets en haut à droite de la page de QuickInstall.
Attention ! Veillez à ne pas avoir des documents ouverts ou des logiciels accédant aux fichiers/répertoires du forum à supprimer.
Exemple courant :
Remerciements à ABDev et papicx qui ont grandement participé aux corrections.