QuickInstall 1.2.1 : Comment l'installer et l'utiliser ? Facile

Partager sur FacebookPartager sur TwitterPartager sur Google+

QuickInstall 1.2.1 : Comment l'installer et l'utiliser ?


» QuickInstall : Comment l'installer et l'utiliser ?
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

    1. 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
    2. 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.

    3. Extraire le contenu de l'archive phpBB et copier le répertoire nommé phpBB3 dans {QI_Chemin_Installation}/sources

    4. 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
      Bonus :
    5. 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

    6. 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
    7. Le répertoire Extra permet l'ajout de fichiers autres que AutoMOD et phpBB3.
      vous pouvez par exemple ajouter STK à vos forums.
        L'arborescence finale doit ressembler à ceci :

        Image

    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 :wink:

      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) :

      • 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).

      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

    1. 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)

    2. 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.
    3. 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)
    Voilà, il n'y a rien de plus sorcier :)
    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 :
      • Options de configuration (Config options)
      • Options de remplissage (Populate options)
      • Options avancées (Advanced options)
    1. 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.
      Conditions d'utilisation :
      • 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.
      Exemple non valide
      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 :wink:

      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 :
        • 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.

    Remerciements à ABDev et papicx qui ont grandement participé aux corrections.
    17/02/2015 - modifié par Skouat pour mettre l’article à jour : quickinstall 1.2.1
    14/02/2015 - modifié par Skouat pour mettre à jour la documentation : quickinstall 1.2.0
    14/02/2015 - modifié par Skouat pour mettre à jour les liens
    15/03/2014 - modifié par Skouat pour mettre l’article à jour
    12/02/2014 - modifié par Geo pour ajouter des contributeurs
    11/02/2014 - modifié par Geo pour convertir le sujet en article.
    Skouat
    Traducteur
    Traducteur
     
    Rédigé le: 11 Fév 2014 à 04:26
    Articles: 2
    Contributeurs:
    Noter cet article: 123456 Votants: 3
    Mots-clés: QuickInstall, 1.2.1, :, Comment, l'installer, et, l'utiliser, ?

    Retourner vers Modifications