Pitchoune
07/07/2005, 11h09
Etape 1 : Télécharger l'archive vBulletin
La première chose à faire pour installer un forum vBulletin est de télécharger la dernière version dans l'Espace Membres.
Vous avez besoin de vous connecter à l'Espace Membres avec votre Customer Number et Customer Password qui vous ont été envoyé par email à l'achat de votre licence.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/members_login.png
Une fois connecté(e), vous verrez une liste de Licences en cours. Pour chaque licence active que vous possédez, il y a un lien appelé Download vBulletin sur lequel vous pouvez cliquer.
Cliquez sur le bouton de la licence que vous souhaitez utiliser et vous serez amené à la page de téléchargement, où vous seront proposés des options pour pouvoir télécharger la dernière archive de vBulletin.
Vous pouvez choisir parmi les options suivantes :
PHP File Extension
En règle générale, les serveurs web utilisent .php comme extension pour les scripts PHP, mais certains serveurs peuvent utiliser une extension différente, ou vous souhaitez simplement utiliser une extension différente selon votre préférence. Plusieurs extensions variées sont disponibles.
Download File Format
Cette option vous permet de choisir le format de compression de l'archive que vous allez télécharger. La plupart des personnes voudront télécharger l'archive en .zip comme Windows® possède un programme intégré pour les fichiers zip. Cependant, si vous téléchargez l'archive directement sur un serveur Linux, vous pouvez utiliser le format tarball (.tar.gz).
CGI Shebang
Cette option est utile uniquement si votre serveur utilise PHP en CGI plutôt qu'en module. Si votre serveur utilise PHP en CGI et utilise un shebang (comme #!/usr/bin/php), vous devez entrer le texte requis ici et il sera inclus automatiquement dans n'importe quel fichier PHP où vBulletin exige son utilisation.
Download File
Utilisez cette option pour contrôler le contenu de l'archive que vous allez télécharger. Par exemple, si vous avez déjà téléchargé et installé précédemment vBulletin, vous n'avez pas forcément besoin de télécharger les images une nouvelle fois, donc vous pouvez utiliser ce contrôle pour spécifier à votre archive que vous allez télécharger qu'il ne doit pas contenir les répertoires des images.
Quand vous avez choisi vos options de téléchargements, vous pouvez cliquer sur le bouton Download pour commencer le téléchargement. Quand la fenêtre d'enregistrement apparaît, vous devriez choisir l'option Enregistrer et choisir un répertoire dans votre ordinateur pour sauvegarder l'archive.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/package_save.png
L'archive sera ensuite téléchargé et enregistré à l'endroit voulu.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/package_progress.png
Etape 2 : Préparer les fichiers vBulletin pour l'upload
Après avoir téléchargé avec succès l'archive vBulletin sur votre ordinateur, vous avez besoin de préparer les scripts à être uploadés sur votre serveur web.
La première chose à faire est de décompresser l'archive avec les fichiers qui le constitue. Si vous avez téléchargé l'archive .zip et que vous êtes sous une version récente de Windows®, tous les outils dont vous avez besoin sont présents en partie de Windows®. Cette section est décrite avec l'archive en .zip et que vous êtes sous Windows XP.
Pour extraire les fichiers de l'archive, ouvrez le répertoire sur votre ordinateur où vous avez sauvegardé l'archive vBulletin et faites un clic-droit sur son icône, puis choisissez Extraire tout. . . du menu.
http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_files.png
Ceci ouvrira un assistant qui vous guidera à travers le processus de décompression. Acceptez les paramètres par défaut suggérés et le système décompressera les fichiers de l'archive.
http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_progress.png
Quand la progression de la décompression est terminée, vous vous apercevrez que le processus a crée un nouveau répertoire appelé vBulletin_versionnum_licensenum (où versionnum est le numéro de la version de l'archive téléchargé, et licensenum est le numéro de licence vBulletin).
A l'intérieur de ce répertoire, vous trouverez un autre répertoire appelé versionnum.licensenum, et dedans se trouvera une collection de fichiers readme et un répertoire appelé upload. Ce répertoire contient les fichiers vBulletin qui doivent être uploadés sur votre serveur web.
Cependant, avant d'ulpoader les fichiers, vous devez faire quelques changements au fichier de configuration vBulletin. Ce fichier se trouve dans le répertoire includes (dans le répertoire upload) et est appelé config.php.new.
La première chose à faire est de le renommer de config.new.php en config.php (retirer l'extension .new temporaire).
Etape 3 : Modifier le fichier de configuration de vBulletin
Avant d'uploader les fichiers vBulletin sur votre serveur web, vous devez modifier le fichier de configuration vBulletin (includes/config.php) pour indiquer à vBulletin comment communiquer avec votre base de données.
Pour modifier le fichier config.php, vous devez ouvrir le fichier dans un éditeur de texte comme Windows® WordPad (notez que nous ne recommandons pas d'utiliser Windows® Notepad pour modifier config.php, comme Notepad a certains problèmes pour afficher les sauts de ligne avec certains types de fichiers).
http://forum.vbulletin-fr.org/tutorial/config/editor.png
Modifier le fichier config.php de vbulletin est très rare car vous modifiez du code PHP brut. Le fichier contient du texte commenté pour vous aider à remplir les champs nécessaires.
En dehors des paramètres présents dans ce fichier, il y a seulement quelques-uns qui ont besoin d'être modifiés pour créer un fichier de configuration vBulletin fonctionnel. Ces paramètres sont :
$config['Database']['dbname']
Cette valeur doit être modifié pour indiquer le nom de la base de données qui contiendra les fichiers pour installer vBulletin dans votre base de données.
$config['Database']['technicalemail']
Une adresse email doit être inséré ici. Tous les messages d'erreurs de la base de données seront envoyés à l'adresse email indiqué.
$config['Database']['force_sql_mode']
Les nouvelles version de MySQL (4.1+) ont introduit certains paramètres non compatible avec vBulletin. Ces fonctions sont activés par défaut dans MySQL 5. Paramétrer cette valeur à « true » désactive ces paramètres. Vous devez désactiver ce paramètre uniquement si vBulletin vous le recommande.
$config['MasterServer']['servername']
Ceci indique l'adresse du serveur de la base de données. Pour la plupart des installations, le serveur de la base de données est localisé sur le même ordinateur que le serveur web, dans ce cas l'adresse devrait être « localhost », sinon utilisez l'adresse du serveur de la base de données founi par votre hébergeur web.
$config['MasterServer']['username']
Cette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
$config['MasterServer']['password']
Le mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
Note :
Veuillez noter que Jelsoft / le support vBulletin ne peut pas vous indiquer les valeurs qui vous sont demandés pour $config['Database']['dbname'], $config['MasterServer']['servername'], $config['MasterServer']['username'] et $config['MasterServer']['password']. Ces variables sont disponible uniquement par votre hébergeur web.
Si vous avez besoin de créer une nouvelle base de données pour pouvoir utiliser vBulletin, les instructions pour faire ceci sur un nombre variés de systèmes sont disponibles ici (http://forum.vbulletin-fr.org/forumdisplay.php?f=166).
Les variables restantes dans config.php n'ont pas besoin d'être modifiés pour créer une configuration de vBulletin fonctionnel et il est recommandé de ne plus modifier ce fichier jusqu'à ce que le processus d'installation soit terminé à moins que vous soyez conscient de ce que vous faîtes avant. Une description de ces variables restantes est présente ci-dessous.
$config['Database']['dbtype']
Si vous utilisez PHP 5 en combinaison avec MySQL 4.1.x, vous pouvez changer cette variable pour « mysqli » et de bénéficier du moteur MySQL Improved.
$config['Database']['tableprefix']
Afin de faciliter l'identification des tables relatives à vBulletin dans votre base de données, vous pouvez spécifier un préfixe pour nommer toutes les tables avec quelques lettre ou un mot. Par exemple, si vous spécifier la variable $tableprefix avec 'vb_', toutes les tables auront le préfixe vb_, créeant vb_forum, vb_user etc...
Si vous choisissez de changer votre $config['Database']['tableprefix'] à un moment après avoir installé vBulletin, des outils existent pour modifier la base de données.
$config['MasterServer']['usepconnect']
Paramétrer cette variable à 1 permettra à PHP d'utiliser les connexions persistantes (http://http://www.php.net/manual/en/features.persistent-connections.php) sur le serveur MySQL. Pour les très grandes installations vBulletin, l'utilisation des connexions persistantes peuvent causer une légère augmentation de performance, mais dans la plupart des cas, laisser ce paramètre à 0 (off) est un meilleur choix. Si vous êtes incertain, laissez ceci à 0.
Configuration de la base de données secondaire
Ces variables s'appliquent uniquement si vous avez une base de données esclave de configuré. Si vous n'êtes pas certain, vous devez les laisser vide. Ceci est un paramètre avancé !
$config['Misc']['admincpdir']
Par défaut, vBulletin installera les fichiers du Logiciel d'Administration dans un répertoire appelé admincp, mais vous pouvez renommer ce répertoire pour des raisons de sécurité. Si vous renommez le répertoire, entrez le nouveau nom ici. Notez que vous pouvez seulement renommer le répertoire, si vous déplacez le répertoire dans un nouvel endroit, le système sera incapable de fonctionner.
$config['Misc']['modcpdir']
Cette variable est similaire au paramètre $config['Misc']['admincpdir'], avec la différence que $config['Misc']['modcpdir'] se réfère au Logiciel de Modération au lieu du Logiciel d'Administration.
$config['Misc']['cookieprefix']
Quand vBulletin crée des cookies sur les ordinateurs des utilisateurs, ils auront tous un préfixe avec quelques caractères pour rendre leur identification plus facile pour les cookies crées par vBulletin. Par défaut, ce préfixe est bb mais vous pouvez changer pour une autre valeur. Cette option est particulièrement utile si vous avez plusieurs installations de vBulletin sur le même domaine.
$config['Misc']['forumpath']
Certains systèmes peuvent demander un chemin d'accès absolu aux fichiers de vBulletin. Si vBulletin ne vous le demande pas, laisser ce champ vide. $config['SpecialUsers']['canviewadminlog']
Toutes les actions effectuées dans le Logiciel d'Administration vBulletin sont enregistrés dans la base de données. Cette variable contrôle les permissions pour quel(s) utilisateur(s) sont autorisés à voir le journal. La variable prend forme d'une liste d'user IDs séparés par des virgules. Par exemple, si vous souhaitez les utilisateurs avec les ID utilisateurs 1, 15 et 16 soient capable de lire le Journal d'Administration, cette variable doit ressembler à : $config['SpecialUsers']['canviewadminlog'] = '1,15,16';
$config['SpecialUsers']['canpruneadminlog']
De la même façon que pour $config['SpecialUsers']['canviewadminlog'] qui contrôle quel(s) utilisateur(s) peuvent voir le Journal d'Administration, $config['SpecialUsers']['canpruneadminlog'] contrôle quel(s) utilisateur(s) sont autorisés de supprimer les informations du Journal d'Administration. Utilisez les mêmes ID utilisateurs séparés avec des virgules comme avec le paramètre $config['SpecialUsers']['canviewadminlog'].
$config['SpecialUsers']['canrunqueries']
Le Logiciel d'Administration vBulletin contient une interface simple pour lancer des requêtes directement dans la base de données. Cette variable contient les IDs des utilisateurs avec la permission pour lancer des requêtes. Pour des raisons de sécurité, vous devriez laisser cette variable totalement vide.
$config['SpecialUsers']['undeletableusers']
Si votre installation vBulletin est en train d'avoir plusieurs utilisateurs avec des privilèges d'administrations, vous pouvez protéger certains de ces utilisateurs d'un accident (ou même malveillant) de suppression ou de modification. N'importe quel user IDs entrés dans cette liste ne sera pas modifiable ou supprimable depuis le Logiciel d'Administration par n'importe qui.
$config['SpecialUsers']['superadministrators']
N'importe quel utilisateur dont les ID utilisateurs sont spécifiés dans le paramètre $config['SpecialUsers']['superadministrators'] auront automatiquement un accès total à tous les paramètres de vBulletin, incluant la possibilité de paramètrer les niveaux de permissions des autres administrateurs.
$config['Mysqli']['charset']
Quand vous utilisez MySQL 4.1+, MySQLi peut êtr eutilisé pour se connecter à la base de données. Si vous avez besoin de définir un jeu de caractères de connexion par défaut et que votre base de données utilise un autre jeu de caractères que le latin1, vous pouvez définir un jeu de caractères ici. Si vous ne définissez pas le même jeu de caractères que votre base de données, vous pouvez recevoir des erreurs de collation. Ignorez ce paramètre jusqu'à ce que vous soyez certain d'en avoir besoin.
$config['Mysqli']['ini_file']
PHP peut être instruit pour définir des paramètres de connexion en lisant le fichier « ini_file ». Veuillez indiquer un chemin d'accès absolu de ce fichier. Ceci est généralement utilisé pour définir le jeu de caractères de connexion par défaut. Ce paramètre doit aussi être ignoré jusqu'à ce que vous soyez certain d'en avoir besoin.
Note :
Les variables $config['SpecialUsers']['canviewadminlog'],
$config['SpecialUsers']['canpruneadminlog'],
$config['SpecialUsers']['canrunqueries'],
$config['SpecialUsers']['undeletableusers']
et $config['SpecialUsers']['superadministrators']
doivent toutes contenir un simple ID utilisateur, une liste séparé par une virgule d'ID utilisateurs ou rien du tout. Par exemple :
$config['SpecialUsers']['canviewadminlog'] = '1,15,16';
$config['SpecialUsers']['canpruneadminlog'] = '1';
$config['SpecialUsers']['canrunqueries'] = '';
$config['SpecialUsers']['undeletableusers'] = '1,15';
$config['SpecialUsers']['superadministrators'] = '1';
Quand vous avez terminé de modifier votre fichier config.php, vous devriez le sauvegarder une nouvelle fois et préparez-vous à uploader le fichier sur votre serveur web.
Etape 4 : Uploader les scripts de vBulletin sur votre serveur web
Après que votre fichier config.php ait été modifié et sauvegardé, il est temps d'uploader les scripts vBulletin sur votre serveur web prêt pour l'installation.
Le processus d'upload est familier pour toute personne qui a publié des pages sur un site web auparavant, mais une bref description du processus est décrite ici.
Bien qu'il existe plusieurs méthodes disponible pour transférer les fichiers vBulletin de votre ordinateur sur votre serveur web, la méthode la plus utilisée est de transférer via FTP. La plupart des systèmes d'exploitations proposent des outils intégrés pour ouvrir des connexions FTP bien qu'ils ne soient limités dans leurs fonctionnalités et beaucoup de personnes optent pour utiliser un client FTP externe. Pour cette exemple, nous utiliserons Smart FTP (http://www.smartftp.com/).
La meilleure façon de transférer les fichiers et d'uploader le répertoire entier upload sur votre serveur. En utilisant Smart FTP, nous pouvons le faire en déplaçant le répertoire upload de votre ordinateur vers le répertoire final où se trouvera votre forum sur le serveur.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_start.png
La plupart des cliens FTP s'occupe des méthodes de transferts de fichiers automatiquement, mais si pour une raison quelconque votre application ne le fait pas, vous devriez noter ce qui suit :
Tous les fichiers textes doivent être transférés en mode ASCII
Tous les fichiers contenant du texte de l'archive vBulletin doivent être transférés en mode ASCII.
Les types de fichiers textes que vous trouverez dans vBulletin sont : .html, .php, .js, .xml, .css.
Tous les fichiers autres que des fichiers textes doivent être transférés en mode Binaire
Les fichiers restants, en majorité des images, doivent être transférés sur votre serveur web en mode Binaire.
Les types de fichiers binaires utilisés dans vBulletin sont : .gif, .png, .jpg, .ico.
Note :
Le répertoire de publication web est habituellement appelé public_html, www ou htdocs et est situé dans votre répertoire racine. Si vous ne savez pas où trouver votre répertoire de publication web, votre hébergeur sera capable de vous aider.
Dépendant de la vitesse de votre connexion internet, l'upload des fichiers peut prendre quelques minutes pour finir. Après ceci, vous pouvez voir que votre serveur web maintenant contient un répertoire appelé upload contenant une copie parfaite des fichiers du répertoire upload de votre ordinateur.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_complete.png
Quand tous les fichiers ont été uploadés avec succès, vous devriez renommer le répertoire upload de votre serveur web par un autre pour le répertoire du forum. Nous l'appellerons forums.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/rename_folder.png
Ceci fait, vous êtes maintenant prêt à lancer le script d'installation pour préparer votre base de données à utiliser vBulletin.
Etape 5 : Lancer le script d'installation vBulletin
Une fois que tous les fichiers vBulletin ont été uploadés avec succès sur votre serveur web, vous devez lancer le Script d'Installation vBulletin pour préparer votre base de données.
L'installateur est un script PHP utilisé par votre navigateur. Pour commencer le processus d'installation, ouvrez votre navigateur et entrez l'adresse HTTP du répertoire de votre forum, suivi de /install/install.php, puis appuyez sur la touche <Entrée> ou cliquez sur le bouton [OK] pour ouvrir le script.
http://forum.vbulletin-fr.org/tutorial/runinstaller/installer_url.png
La première chose que vous pouvez voir du script d'installation est une demande d'identification, vous demandant d'entrer votre Customer Number. Ceci sert à éviter que d'autres utilisateurs puissent utiliser le script d'installation accidentellement. Vous avez uniquement besoin de votre Customer Number.
Note :
Votre Customer Number est la valeur composé de chiffres et de lettres utilisé pour vous connecter à l'Espace Membres vBulletin. Vous devez entrer votre Customer Number avec précaution afin d'éviter des erreurs. Notez que votre Customer Number n'est pas le même que votre numéro de licence vBulletin.
http://forum.vbulletin-fr.org/tutorial/runinstaller/customer_login.png
Quand vous avez entré votre Customer Number, cliquez sur le bouton [Enter Installer] et vous devriez être amené à la première étape du script d'installation. Si après avoir clique sur le bouton [Enter Installer], vous revenez sur la même page d'identification, c'est que vous avez mal entré votre Customer Number. Vérifiez les fautes et retentez.
La première page du script d'installation vous accueillera et vous donnera quelques instructions basiques en rapport avec les évènements d'installations à venir.
Après avoir lu les informations de la page d'accueil de l'installation, vous pouvez cliquer sur le large bouton [Next Step] en bas à droite de la fenêtre pour aller à la prochaine étape de l'installation.
Attention :
Certains plug-ins des navigateurs, comme la populaire barre Google peuvent provoquer un effet défavorable sur les scripts d'installations et de mise à jour vBulletin. Nous recommandons que tous les plugins des navigateurs doivent être désactivés pendant l'exécution des scripts d'installation ou de mise à jour de vBulletin.
En cliquant sur le bouton [Next Step], vous serez amené à la première étape d'installation, qui effectuera un test pour savoir si le fichier config.php existe et qu'il soit lisible par le système.
Un nouveau clic vous amènera à la deuxième étape, où l'installateur tentera de se connecter à la base de données. Si la connexion est réussie avec succès, l'installateur vous demandera si vous souhaitez vider la base de données. Si vous cliquez dessus, votre base de données sera totalement vidé. Toutes les données enregistrées dans cette base de données (incluant les données n'étant pas en relation avec vBulletin) seront irréversiblement effacées.
Attention :
Ne cliquez pas sur le lien « empty database » si vous n'êtes pas certain(e) de ce que vous faites !
Les quelques étapes suivantes n'offrent pas de choix durant le processus d'installation, vous devez uniquement cliquer sur le bouton [Next Step] en bas à droite des pages pour aller à l'étape suivante.
Cependant, vous aurez bientôt une page appelée Obtain Some Default Settings. Cette page n'a pas de bouton [Next Step], car elle demande de remplir quelques champs à propos de l'installation vBulletin.
Les paramètres requis ici sont :
BB Title
Ceci est le titre que vous donnez à vos forums vBulletin. Il apparaît dans le titre de toutes les pages, et aussi dans les notifications par emails envoyées par vBulletin à vos membres qui les identifieront grâce à ce titre (BB Title est le diminutif de bulletin board title).
Homepage Title
Moins important que le BB Title, ce paramètre est utilisé comme lien en bas de toutes les pages qui renverra à l'adresse spécifié dans Home URL (voir ci-dessous). Il représenté le titre de votre site web.
BB URL
Le paramètre BB URL est très important. Il représente l'adresse URL que les personnes susceptible de visiter votre forum doivent indiquer pour accéder à vos forums vBulletin. Le système fera en sorte d'indiquer l'adresse exacte automatiquement, vous n'aurez à le changer si la valeur indiquée s'avérait fausse. Veuillez noter que ce paramètre ne doit pas se terminer par un slash (/).
Home URL
Ceci est l'adresse web de votre site web, et est utilisé en conjoncture avec la paramètre Home Title pour créer un lien vers votre site web en bas de toutes les pages du forum.
Cookie Path
Quand les cookies sont enregistrés sur les ordinateurs des visiteurs, ce paramètre sera utilisé pour définir où doivent s'appliquer sur votre serveur web. A moins d'avoir une raison de changer ce paramètre, il est préférable de le laisser avec la valeur par défaut « / » (Signifiant que les cookies peuvent être lues sur le site entier).
Cookie Domain
Fonctionnant avec le paramètre du chemin des cookies, ceci vous permet de spécifier le domaine appartenant aux cookies. Généralement parlant, ce paramètre peut rester vide.Après avoir rempli ces valeurs et avancé de quelques étapes, il vous sera demandé de vous enregistrer en tant qu'administrateur.
http://forum.vbulletin-fr.org/tutorial/runinstaller/new_admin.png
Note :
Quand vous choisissez un mot de passe, nous vous suggérons d'utiliser une combinaison de lettres, chiffres et des caractères de ponctuation en majuscule et minuscule, et d'une longueur d'au moins huit caractères.
Remplissez les champs requis et cliquez sur le bouton [Continue] afin de continuer le processus d'installation.
Après quelques pages, l'installation sera terminée, et vous aurez un lien pour aller dans le Logiciel d'Administration. Avant de cliquer sur ce lien, vous devez ouvrir votre client FTP une nouvelle fois et allez dans le répertoire install du répertoire de votre forum.
http://forum.vbulletin-fr.org/tutorial/runinstaller/delete_install.png
Vous devez supprimer le fichier install.php maintenant pour des raisons de sécurité. Une fois que vous avez supprimé le fichier, vous pouvez retourner dans le script d'installation et cliquez sur le lien pour entrer dans le Logiciel d'Administration de votre fraîche installation de vBulletin !
Note :
Vous ne pourrez pas entrer dans le Logiciel d'Administration jusqu'à ce que vous ayez supprimé le fichier install.php.
La première chose à faire pour installer un forum vBulletin est de télécharger la dernière version dans l'Espace Membres.
Vous avez besoin de vous connecter à l'Espace Membres avec votre Customer Number et Customer Password qui vous ont été envoyé par email à l'achat de votre licence.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/members_login.png
Une fois connecté(e), vous verrez une liste de Licences en cours. Pour chaque licence active que vous possédez, il y a un lien appelé Download vBulletin sur lequel vous pouvez cliquer.
Cliquez sur le bouton de la licence que vous souhaitez utiliser et vous serez amené à la page de téléchargement, où vous seront proposés des options pour pouvoir télécharger la dernière archive de vBulletin.
Vous pouvez choisir parmi les options suivantes :
PHP File Extension
En règle générale, les serveurs web utilisent .php comme extension pour les scripts PHP, mais certains serveurs peuvent utiliser une extension différente, ou vous souhaitez simplement utiliser une extension différente selon votre préférence. Plusieurs extensions variées sont disponibles.
Download File Format
Cette option vous permet de choisir le format de compression de l'archive que vous allez télécharger. La plupart des personnes voudront télécharger l'archive en .zip comme Windows® possède un programme intégré pour les fichiers zip. Cependant, si vous téléchargez l'archive directement sur un serveur Linux, vous pouvez utiliser le format tarball (.tar.gz).
CGI Shebang
Cette option est utile uniquement si votre serveur utilise PHP en CGI plutôt qu'en module. Si votre serveur utilise PHP en CGI et utilise un shebang (comme #!/usr/bin/php), vous devez entrer le texte requis ici et il sera inclus automatiquement dans n'importe quel fichier PHP où vBulletin exige son utilisation.
Download File
Utilisez cette option pour contrôler le contenu de l'archive que vous allez télécharger. Par exemple, si vous avez déjà téléchargé et installé précédemment vBulletin, vous n'avez pas forcément besoin de télécharger les images une nouvelle fois, donc vous pouvez utiliser ce contrôle pour spécifier à votre archive que vous allez télécharger qu'il ne doit pas contenir les répertoires des images.
Quand vous avez choisi vos options de téléchargements, vous pouvez cliquer sur le bouton Download pour commencer le téléchargement. Quand la fenêtre d'enregistrement apparaît, vous devriez choisir l'option Enregistrer et choisir un répertoire dans votre ordinateur pour sauvegarder l'archive.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/package_save.png
L'archive sera ensuite téléchargé et enregistré à l'endroit voulu.
http://forum.vbulletin-fr.org/tutorial/downloadpackage/package_progress.png
Etape 2 : Préparer les fichiers vBulletin pour l'upload
Après avoir téléchargé avec succès l'archive vBulletin sur votre ordinateur, vous avez besoin de préparer les scripts à être uploadés sur votre serveur web.
La première chose à faire est de décompresser l'archive avec les fichiers qui le constitue. Si vous avez téléchargé l'archive .zip et que vous êtes sous une version récente de Windows®, tous les outils dont vous avez besoin sont présents en partie de Windows®. Cette section est décrite avec l'archive en .zip et que vous êtes sous Windows XP.
Pour extraire les fichiers de l'archive, ouvrez le répertoire sur votre ordinateur où vous avez sauvegardé l'archive vBulletin et faites un clic-droit sur son icône, puis choisissez Extraire tout. . . du menu.
http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_files.png
Ceci ouvrira un assistant qui vous guidera à travers le processus de décompression. Acceptez les paramètres par défaut suggérés et le système décompressera les fichiers de l'archive.
http://forum.vbulletin-fr.org/tutorial/preparefiles/extract_progress.png
Quand la progression de la décompression est terminée, vous vous apercevrez que le processus a crée un nouveau répertoire appelé vBulletin_versionnum_licensenum (où versionnum est le numéro de la version de l'archive téléchargé, et licensenum est le numéro de licence vBulletin).
A l'intérieur de ce répertoire, vous trouverez un autre répertoire appelé versionnum.licensenum, et dedans se trouvera une collection de fichiers readme et un répertoire appelé upload. Ce répertoire contient les fichiers vBulletin qui doivent être uploadés sur votre serveur web.
Cependant, avant d'ulpoader les fichiers, vous devez faire quelques changements au fichier de configuration vBulletin. Ce fichier se trouve dans le répertoire includes (dans le répertoire upload) et est appelé config.php.new.
La première chose à faire est de le renommer de config.new.php en config.php (retirer l'extension .new temporaire).
Etape 3 : Modifier le fichier de configuration de vBulletin
Avant d'uploader les fichiers vBulletin sur votre serveur web, vous devez modifier le fichier de configuration vBulletin (includes/config.php) pour indiquer à vBulletin comment communiquer avec votre base de données.
Pour modifier le fichier config.php, vous devez ouvrir le fichier dans un éditeur de texte comme Windows® WordPad (notez que nous ne recommandons pas d'utiliser Windows® Notepad pour modifier config.php, comme Notepad a certains problèmes pour afficher les sauts de ligne avec certains types de fichiers).
http://forum.vbulletin-fr.org/tutorial/config/editor.png
Modifier le fichier config.php de vbulletin est très rare car vous modifiez du code PHP brut. Le fichier contient du texte commenté pour vous aider à remplir les champs nécessaires.
En dehors des paramètres présents dans ce fichier, il y a seulement quelques-uns qui ont besoin d'être modifiés pour créer un fichier de configuration vBulletin fonctionnel. Ces paramètres sont :
$config['Database']['dbname']
Cette valeur doit être modifié pour indiquer le nom de la base de données qui contiendra les fichiers pour installer vBulletin dans votre base de données.
$config['Database']['technicalemail']
Une adresse email doit être inséré ici. Tous les messages d'erreurs de la base de données seront envoyés à l'adresse email indiqué.
$config['Database']['force_sql_mode']
Les nouvelles version de MySQL (4.1+) ont introduit certains paramètres non compatible avec vBulletin. Ces fonctions sont activés par défaut dans MySQL 5. Paramétrer cette valeur à « true » désactive ces paramètres. Vous devez désactiver ce paramètre uniquement si vBulletin vous le recommande.
$config['MasterServer']['servername']
Ceci indique l'adresse du serveur de la base de données. Pour la plupart des installations, le serveur de la base de données est localisé sur le même ordinateur que le serveur web, dans ce cas l'adresse devrait être « localhost », sinon utilisez l'adresse du serveur de la base de données founi par votre hébergeur web.
$config['MasterServer']['username']
Cette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
$config['MasterServer']['password']
Le mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
Note :
Veuillez noter que Jelsoft / le support vBulletin ne peut pas vous indiquer les valeurs qui vous sont demandés pour $config['Database']['dbname'], $config['MasterServer']['servername'], $config['MasterServer']['username'] et $config['MasterServer']['password']. Ces variables sont disponible uniquement par votre hébergeur web.
Si vous avez besoin de créer une nouvelle base de données pour pouvoir utiliser vBulletin, les instructions pour faire ceci sur un nombre variés de systèmes sont disponibles ici (http://forum.vbulletin-fr.org/forumdisplay.php?f=166).
Les variables restantes dans config.php n'ont pas besoin d'être modifiés pour créer une configuration de vBulletin fonctionnel et il est recommandé de ne plus modifier ce fichier jusqu'à ce que le processus d'installation soit terminé à moins que vous soyez conscient de ce que vous faîtes avant. Une description de ces variables restantes est présente ci-dessous.
$config['Database']['dbtype']
Si vous utilisez PHP 5 en combinaison avec MySQL 4.1.x, vous pouvez changer cette variable pour « mysqli » et de bénéficier du moteur MySQL Improved.
$config['Database']['tableprefix']
Afin de faciliter l'identification des tables relatives à vBulletin dans votre base de données, vous pouvez spécifier un préfixe pour nommer toutes les tables avec quelques lettre ou un mot. Par exemple, si vous spécifier la variable $tableprefix avec 'vb_', toutes les tables auront le préfixe vb_, créeant vb_forum, vb_user etc...
Si vous choisissez de changer votre $config['Database']['tableprefix'] à un moment après avoir installé vBulletin, des outils existent pour modifier la base de données.
$config['MasterServer']['usepconnect']
Paramétrer cette variable à 1 permettra à PHP d'utiliser les connexions persistantes (http://http://www.php.net/manual/en/features.persistent-connections.php) sur le serveur MySQL. Pour les très grandes installations vBulletin, l'utilisation des connexions persistantes peuvent causer une légère augmentation de performance, mais dans la plupart des cas, laisser ce paramètre à 0 (off) est un meilleur choix. Si vous êtes incertain, laissez ceci à 0.
Configuration de la base de données secondaire
Ces variables s'appliquent uniquement si vous avez une base de données esclave de configuré. Si vous n'êtes pas certain, vous devez les laisser vide. Ceci est un paramètre avancé !
$config['Misc']['admincpdir']
Par défaut, vBulletin installera les fichiers du Logiciel d'Administration dans un répertoire appelé admincp, mais vous pouvez renommer ce répertoire pour des raisons de sécurité. Si vous renommez le répertoire, entrez le nouveau nom ici. Notez que vous pouvez seulement renommer le répertoire, si vous déplacez le répertoire dans un nouvel endroit, le système sera incapable de fonctionner.
$config['Misc']['modcpdir']
Cette variable est similaire au paramètre $config['Misc']['admincpdir'], avec la différence que $config['Misc']['modcpdir'] se réfère au Logiciel de Modération au lieu du Logiciel d'Administration.
$config['Misc']['cookieprefix']
Quand vBulletin crée des cookies sur les ordinateurs des utilisateurs, ils auront tous un préfixe avec quelques caractères pour rendre leur identification plus facile pour les cookies crées par vBulletin. Par défaut, ce préfixe est bb mais vous pouvez changer pour une autre valeur. Cette option est particulièrement utile si vous avez plusieurs installations de vBulletin sur le même domaine.
$config['Misc']['forumpath']
Certains systèmes peuvent demander un chemin d'accès absolu aux fichiers de vBulletin. Si vBulletin ne vous le demande pas, laisser ce champ vide. $config['SpecialUsers']['canviewadminlog']
Toutes les actions effectuées dans le Logiciel d'Administration vBulletin sont enregistrés dans la base de données. Cette variable contrôle les permissions pour quel(s) utilisateur(s) sont autorisés à voir le journal. La variable prend forme d'une liste d'user IDs séparés par des virgules. Par exemple, si vous souhaitez les utilisateurs avec les ID utilisateurs 1, 15 et 16 soient capable de lire le Journal d'Administration, cette variable doit ressembler à : $config['SpecialUsers']['canviewadminlog'] = '1,15,16';
$config['SpecialUsers']['canpruneadminlog']
De la même façon que pour $config['SpecialUsers']['canviewadminlog'] qui contrôle quel(s) utilisateur(s) peuvent voir le Journal d'Administration, $config['SpecialUsers']['canpruneadminlog'] contrôle quel(s) utilisateur(s) sont autorisés de supprimer les informations du Journal d'Administration. Utilisez les mêmes ID utilisateurs séparés avec des virgules comme avec le paramètre $config['SpecialUsers']['canviewadminlog'].
$config['SpecialUsers']['canrunqueries']
Le Logiciel d'Administration vBulletin contient une interface simple pour lancer des requêtes directement dans la base de données. Cette variable contient les IDs des utilisateurs avec la permission pour lancer des requêtes. Pour des raisons de sécurité, vous devriez laisser cette variable totalement vide.
$config['SpecialUsers']['undeletableusers']
Si votre installation vBulletin est en train d'avoir plusieurs utilisateurs avec des privilèges d'administrations, vous pouvez protéger certains de ces utilisateurs d'un accident (ou même malveillant) de suppression ou de modification. N'importe quel user IDs entrés dans cette liste ne sera pas modifiable ou supprimable depuis le Logiciel d'Administration par n'importe qui.
$config['SpecialUsers']['superadministrators']
N'importe quel utilisateur dont les ID utilisateurs sont spécifiés dans le paramètre $config['SpecialUsers']['superadministrators'] auront automatiquement un accès total à tous les paramètres de vBulletin, incluant la possibilité de paramètrer les niveaux de permissions des autres administrateurs.
$config['Mysqli']['charset']
Quand vous utilisez MySQL 4.1+, MySQLi peut êtr eutilisé pour se connecter à la base de données. Si vous avez besoin de définir un jeu de caractères de connexion par défaut et que votre base de données utilise un autre jeu de caractères que le latin1, vous pouvez définir un jeu de caractères ici. Si vous ne définissez pas le même jeu de caractères que votre base de données, vous pouvez recevoir des erreurs de collation. Ignorez ce paramètre jusqu'à ce que vous soyez certain d'en avoir besoin.
$config['Mysqli']['ini_file']
PHP peut être instruit pour définir des paramètres de connexion en lisant le fichier « ini_file ». Veuillez indiquer un chemin d'accès absolu de ce fichier. Ceci est généralement utilisé pour définir le jeu de caractères de connexion par défaut. Ce paramètre doit aussi être ignoré jusqu'à ce que vous soyez certain d'en avoir besoin.
Note :
Les variables $config['SpecialUsers']['canviewadminlog'],
$config['SpecialUsers']['canpruneadminlog'],
$config['SpecialUsers']['canrunqueries'],
$config['SpecialUsers']['undeletableusers']
et $config['SpecialUsers']['superadministrators']
doivent toutes contenir un simple ID utilisateur, une liste séparé par une virgule d'ID utilisateurs ou rien du tout. Par exemple :
$config['SpecialUsers']['canviewadminlog'] = '1,15,16';
$config['SpecialUsers']['canpruneadminlog'] = '1';
$config['SpecialUsers']['canrunqueries'] = '';
$config['SpecialUsers']['undeletableusers'] = '1,15';
$config['SpecialUsers']['superadministrators'] = '1';
Quand vous avez terminé de modifier votre fichier config.php, vous devriez le sauvegarder une nouvelle fois et préparez-vous à uploader le fichier sur votre serveur web.
Etape 4 : Uploader les scripts de vBulletin sur votre serveur web
Après que votre fichier config.php ait été modifié et sauvegardé, il est temps d'uploader les scripts vBulletin sur votre serveur web prêt pour l'installation.
Le processus d'upload est familier pour toute personne qui a publié des pages sur un site web auparavant, mais une bref description du processus est décrite ici.
Bien qu'il existe plusieurs méthodes disponible pour transférer les fichiers vBulletin de votre ordinateur sur votre serveur web, la méthode la plus utilisée est de transférer via FTP. La plupart des systèmes d'exploitations proposent des outils intégrés pour ouvrir des connexions FTP bien qu'ils ne soient limités dans leurs fonctionnalités et beaucoup de personnes optent pour utiliser un client FTP externe. Pour cette exemple, nous utiliserons Smart FTP (http://www.smartftp.com/).
La meilleure façon de transférer les fichiers et d'uploader le répertoire entier upload sur votre serveur. En utilisant Smart FTP, nous pouvons le faire en déplaçant le répertoire upload de votre ordinateur vers le répertoire final où se trouvera votre forum sur le serveur.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_start.png
La plupart des cliens FTP s'occupe des méthodes de transferts de fichiers automatiquement, mais si pour une raison quelconque votre application ne le fait pas, vous devriez noter ce qui suit :
Tous les fichiers textes doivent être transférés en mode ASCII
Tous les fichiers contenant du texte de l'archive vBulletin doivent être transférés en mode ASCII.
Les types de fichiers textes que vous trouverez dans vBulletin sont : .html, .php, .js, .xml, .css.
Tous les fichiers autres que des fichiers textes doivent être transférés en mode Binaire
Les fichiers restants, en majorité des images, doivent être transférés sur votre serveur web en mode Binaire.
Les types de fichiers binaires utilisés dans vBulletin sont : .gif, .png, .jpg, .ico.
Note :
Le répertoire de publication web est habituellement appelé public_html, www ou htdocs et est situé dans votre répertoire racine. Si vous ne savez pas où trouver votre répertoire de publication web, votre hébergeur sera capable de vous aider.
Dépendant de la vitesse de votre connexion internet, l'upload des fichiers peut prendre quelques minutes pour finir. Après ceci, vous pouvez voir que votre serveur web maintenant contient un répertoire appelé upload contenant une copie parfaite des fichiers du répertoire upload de votre ordinateur.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/upload_complete.png
Quand tous les fichiers ont été uploadés avec succès, vous devriez renommer le répertoire upload de votre serveur web par un autre pour le répertoire du forum. Nous l'appellerons forums.
http://forum.vbulletin-fr.org/tutorial/uploadpackages/rename_folder.png
Ceci fait, vous êtes maintenant prêt à lancer le script d'installation pour préparer votre base de données à utiliser vBulletin.
Etape 5 : Lancer le script d'installation vBulletin
Une fois que tous les fichiers vBulletin ont été uploadés avec succès sur votre serveur web, vous devez lancer le Script d'Installation vBulletin pour préparer votre base de données.
L'installateur est un script PHP utilisé par votre navigateur. Pour commencer le processus d'installation, ouvrez votre navigateur et entrez l'adresse HTTP du répertoire de votre forum, suivi de /install/install.php, puis appuyez sur la touche <Entrée> ou cliquez sur le bouton [OK] pour ouvrir le script.
http://forum.vbulletin-fr.org/tutorial/runinstaller/installer_url.png
La première chose que vous pouvez voir du script d'installation est une demande d'identification, vous demandant d'entrer votre Customer Number. Ceci sert à éviter que d'autres utilisateurs puissent utiliser le script d'installation accidentellement. Vous avez uniquement besoin de votre Customer Number.
Note :
Votre Customer Number est la valeur composé de chiffres et de lettres utilisé pour vous connecter à l'Espace Membres vBulletin. Vous devez entrer votre Customer Number avec précaution afin d'éviter des erreurs. Notez que votre Customer Number n'est pas le même que votre numéro de licence vBulletin.
http://forum.vbulletin-fr.org/tutorial/runinstaller/customer_login.png
Quand vous avez entré votre Customer Number, cliquez sur le bouton [Enter Installer] et vous devriez être amené à la première étape du script d'installation. Si après avoir clique sur le bouton [Enter Installer], vous revenez sur la même page d'identification, c'est que vous avez mal entré votre Customer Number. Vérifiez les fautes et retentez.
La première page du script d'installation vous accueillera et vous donnera quelques instructions basiques en rapport avec les évènements d'installations à venir.
Après avoir lu les informations de la page d'accueil de l'installation, vous pouvez cliquer sur le large bouton [Next Step] en bas à droite de la fenêtre pour aller à la prochaine étape de l'installation.
Attention :
Certains plug-ins des navigateurs, comme la populaire barre Google peuvent provoquer un effet défavorable sur les scripts d'installations et de mise à jour vBulletin. Nous recommandons que tous les plugins des navigateurs doivent être désactivés pendant l'exécution des scripts d'installation ou de mise à jour de vBulletin.
En cliquant sur le bouton [Next Step], vous serez amené à la première étape d'installation, qui effectuera un test pour savoir si le fichier config.php existe et qu'il soit lisible par le système.
Un nouveau clic vous amènera à la deuxième étape, où l'installateur tentera de se connecter à la base de données. Si la connexion est réussie avec succès, l'installateur vous demandera si vous souhaitez vider la base de données. Si vous cliquez dessus, votre base de données sera totalement vidé. Toutes les données enregistrées dans cette base de données (incluant les données n'étant pas en relation avec vBulletin) seront irréversiblement effacées.
Attention :
Ne cliquez pas sur le lien « empty database » si vous n'êtes pas certain(e) de ce que vous faites !
Les quelques étapes suivantes n'offrent pas de choix durant le processus d'installation, vous devez uniquement cliquer sur le bouton [Next Step] en bas à droite des pages pour aller à l'étape suivante.
Cependant, vous aurez bientôt une page appelée Obtain Some Default Settings. Cette page n'a pas de bouton [Next Step], car elle demande de remplir quelques champs à propos de l'installation vBulletin.
Les paramètres requis ici sont :
BB Title
Ceci est le titre que vous donnez à vos forums vBulletin. Il apparaît dans le titre de toutes les pages, et aussi dans les notifications par emails envoyées par vBulletin à vos membres qui les identifieront grâce à ce titre (BB Title est le diminutif de bulletin board title).
Homepage Title
Moins important que le BB Title, ce paramètre est utilisé comme lien en bas de toutes les pages qui renverra à l'adresse spécifié dans Home URL (voir ci-dessous). Il représenté le titre de votre site web.
BB URL
Le paramètre BB URL est très important. Il représente l'adresse URL que les personnes susceptible de visiter votre forum doivent indiquer pour accéder à vos forums vBulletin. Le système fera en sorte d'indiquer l'adresse exacte automatiquement, vous n'aurez à le changer si la valeur indiquée s'avérait fausse. Veuillez noter que ce paramètre ne doit pas se terminer par un slash (/).
Home URL
Ceci est l'adresse web de votre site web, et est utilisé en conjoncture avec la paramètre Home Title pour créer un lien vers votre site web en bas de toutes les pages du forum.
Cookie Path
Quand les cookies sont enregistrés sur les ordinateurs des visiteurs, ce paramètre sera utilisé pour définir où doivent s'appliquer sur votre serveur web. A moins d'avoir une raison de changer ce paramètre, il est préférable de le laisser avec la valeur par défaut « / » (Signifiant que les cookies peuvent être lues sur le site entier).
Cookie Domain
Fonctionnant avec le paramètre du chemin des cookies, ceci vous permet de spécifier le domaine appartenant aux cookies. Généralement parlant, ce paramètre peut rester vide.Après avoir rempli ces valeurs et avancé de quelques étapes, il vous sera demandé de vous enregistrer en tant qu'administrateur.
http://forum.vbulletin-fr.org/tutorial/runinstaller/new_admin.png
Note :
Quand vous choisissez un mot de passe, nous vous suggérons d'utiliser une combinaison de lettres, chiffres et des caractères de ponctuation en majuscule et minuscule, et d'une longueur d'au moins huit caractères.
Remplissez les champs requis et cliquez sur le bouton [Continue] afin de continuer le processus d'installation.
Après quelques pages, l'installation sera terminée, et vous aurez un lien pour aller dans le Logiciel d'Administration. Avant de cliquer sur ce lien, vous devez ouvrir votre client FTP une nouvelle fois et allez dans le répertoire install du répertoire de votre forum.
http://forum.vbulletin-fr.org/tutorial/runinstaller/delete_install.png
Vous devez supprimer le fichier install.php maintenant pour des raisons de sécurité. Une fois que vous avez supprimé le fichier, vous pouvez retourner dans le script d'installation et cliquez sur le lien pour entrer dans le Logiciel d'Administration de votre fraîche installation de vBulletin !
Note :
Vous ne pourrez pas entrer dans le Logiciel d'Administration jusqu'à ce que vous ayez supprimé le fichier install.php.