Pitchoune
10/07/2005, 15h11
Le système ImpEx (Importation / Exportation) est le noyau système pour importer des messages et forums depuis d'autres systèmes de forums vers vBulletin 3.5.0 ou supérieur.
Liste de scripts supportés (http://forum.vbulletin-fr.org/showthread.php?t=6138)
Sondage pour le développement et discussion (http://www.vbulletin.com/forum/showthread.php?t=100464)Note : Vous devez avoir le forum source et le forum de destination sur le MEME serveur, MEME compte utilisateur et avec DEUX bases de données DIFFERENTES.
Avant de pouvoir utiliser le système d'importation pour vBulletin 3, vous devez d'abord télécharger ImpEx sur votre disque dur, préparer les fichiers pour l'importeur et l'uploader sur votre serveur web.Etape 1 : Télécharger l'archive ImpExLa première chose à faire pour installer ImpEx 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 vB3 Importers 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 d'ImpEx.
Vous pouvez choisir parmi les options suivantes :
PHP File ExtensionEn 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 FormatCette 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 ShebangCette 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.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 devez choisir l'option Enregistrer et choisir un répertoire dans votre ordinateur pour sauvegarder l'archive.
L'archive sera ensuite téléchargé et enregistré à l'endroit voulu.Etape 2 : Préparer les fichiers d'impEx pour l'uploadAprès avoir téléchargé avec succès l'archive ImpEx sur votre ordinateur, vous avez besoin de préparer les pages à ê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 d'ImpEx et faites un clic-droit sur son icône, puis choisissez Extraire tout. . . du menu.
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.
Quand la progression de la décompression est terminée, vous vous apercevrez que le processus a crée un nouveau répertoire appelé ImpEx_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é licensenum.impex, et dedans se trouvera une collection de fichiers readme et un répertoire appelé upload. Ce répertoire contient les fichiers Impex qui doivent être uploadés sur votre serveur web.
Cependant, avant d'ulpoader les fichiers, vous devez faire quelques changements au fichier de configuration d'ImpEx. Ce fichier se trouve dans le répertoire impex (dans le répertoire upload) et est appelé ImpExConfig.php.new.
La première chose à faire est de le renommer de ImpExConfig.new.php en ImpExConfig.php (retirer l'extension .new temporaire).Etape 3 : Modifier le fichier de configuration d'ImpExAvant d'uploader les fichiers d'ImpEx sur votre serveur web, vous devez modifier le fichier de configuration d'ImpEx (upload/impex/ImpExConfig.php) pour indiquer à ImpEx comment communiquer avec votre base de données.
Pour modifier le fichier ImpExConfig.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/impex/impex_editor.png
Les paramètres de ce fichier doivent être modifiées afin de créer un fichier de configuration fonctionnel. Les paramètres sont divisés en deux groupes : target (cible) et source.
Informations de la base de données cible (Dans quel base de données dois-je importer ?) :
targetdatabasetypeEntrez ici le type de base de données ici, habituellement mysql.
targetserverEntrez ici l'adresse de votre serveur de 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.
targetuserCette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
targetpasswordLe mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
targetdatabaseCette 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.
targettableprefixSi votre base de données utilise un préfixe, indiquez-le ici.Informations de la base de données source (De quel base de données dois-je importer ?) :
sourceexistsSi le système importé vient d'une base de données, entrez les détails dessous et précisez ici TRUE. Si la source ne provient PAS d'une base de données, précisez ici FALSE.
sourcedatabasetypeEntrez ici le type de base de données ici, habituellement mysql.
sourceserverEntrez ici l'adresse de votre serveur de base de données source. 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.
sourceuserCette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
sourcepasswordLe mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
sourcedatabaseCette valeur doit être modifié pour indiquer le nom de la base de données qui contient les données de l'autre système de forums que vous importez.
sourcetableprefixSi votre base de données utilise un préfixe, indiquez-le ici.Note :
Veuillez noter que Jelsoft / le support vBulletin ne peut pas vous indiquer les valeurs qui vous sont demandés pour vos bases de données. 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://www.vbulletin.com/docs/html/main/create_database) (anglais).Quand vous avez terminé de modifier votre fichier ImpExConfig.php, vous devez le sauvegarder une nouvelle fois et préparez-vous à uploader le fichier sur votre serveur web.Etape 4 : Uploader ImpEx sur votre serveur webAprès que votre fichier ImpExConfig.php ait été modifié et sauvegardé, il est temps d'uploader ImpEx sur votre serveur web prêt pour être exécuté.
Le processus d'upload est familier pour toute personne qui a déjà 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 d'ImpEx 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.
La meilleure façon de transférer les fichiers est d'uploader le répertoire entier upload sur votre serveur, c'est-à-dire de mettre les répertoires « impex » et « includes » fournis à la racine de votre forum. Avec votre client FTP, vous pouvez déplacer le répertoire upload de votre ordinateur vers le répertoire final où se trouvera votre forum sur le serveur. Si le transfert ne démarre pas automatiquement, cliquez sur le bouton [Transférer].
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 ASCIITous les fichiers contenant du texte de l'archive d'ImpEx doivent être transférés en mode ASCII.
Les types de fichiers textes que vous trouverez dans vBulletin/ImpEx sont : .html, .php, .js, .xml, .css.
Tous les fichiers autres que des fichiers textes doivent être transférés en mode BinaireLes 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. Uploadez le répertoire d'ImpEx dans le répertoire de vBulletin 3. Comme ceci : public_html/forum/impex/ 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.
Quand tous les fichiers ont été uploadés avec succès, vous êtes prêts à exécuter ImpEx pour importer votre base de données dans vBulletin 3.
Attention :
Avant toute chose ! Toujours faire une sauvegarde à 100% de vos fichiers web et de votre base de données pour pouvoir restaurer si un problème quelconque survient durant l'importation.
Liste de scripts supportés (http://forum.vbulletin-fr.org/showthread.php?t=6138)
Sondage pour le développement et discussion (http://www.vbulletin.com/forum/showthread.php?t=100464)Note : Vous devez avoir le forum source et le forum de destination sur le MEME serveur, MEME compte utilisateur et avec DEUX bases de données DIFFERENTES.
Avant de pouvoir utiliser le système d'importation pour vBulletin 3, vous devez d'abord télécharger ImpEx sur votre disque dur, préparer les fichiers pour l'importeur et l'uploader sur votre serveur web.Etape 1 : Télécharger l'archive ImpExLa première chose à faire pour installer ImpEx 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 vB3 Importers 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 d'ImpEx.
Vous pouvez choisir parmi les options suivantes :
PHP File ExtensionEn 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 FormatCette 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 ShebangCette 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.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 devez choisir l'option Enregistrer et choisir un répertoire dans votre ordinateur pour sauvegarder l'archive.
L'archive sera ensuite téléchargé et enregistré à l'endroit voulu.Etape 2 : Préparer les fichiers d'impEx pour l'uploadAprès avoir téléchargé avec succès l'archive ImpEx sur votre ordinateur, vous avez besoin de préparer les pages à ê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 d'ImpEx et faites un clic-droit sur son icône, puis choisissez Extraire tout. . . du menu.
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.
Quand la progression de la décompression est terminée, vous vous apercevrez que le processus a crée un nouveau répertoire appelé ImpEx_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é licensenum.impex, et dedans se trouvera une collection de fichiers readme et un répertoire appelé upload. Ce répertoire contient les fichiers Impex qui doivent être uploadés sur votre serveur web.
Cependant, avant d'ulpoader les fichiers, vous devez faire quelques changements au fichier de configuration d'ImpEx. Ce fichier se trouve dans le répertoire impex (dans le répertoire upload) et est appelé ImpExConfig.php.new.
La première chose à faire est de le renommer de ImpExConfig.new.php en ImpExConfig.php (retirer l'extension .new temporaire).Etape 3 : Modifier le fichier de configuration d'ImpExAvant d'uploader les fichiers d'ImpEx sur votre serveur web, vous devez modifier le fichier de configuration d'ImpEx (upload/impex/ImpExConfig.php) pour indiquer à ImpEx comment communiquer avec votre base de données.
Pour modifier le fichier ImpExConfig.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/impex/impex_editor.png
Les paramètres de ce fichier doivent être modifiées afin de créer un fichier de configuration fonctionnel. Les paramètres sont divisés en deux groupes : target (cible) et source.
Informations de la base de données cible (Dans quel base de données dois-je importer ?) :
targetdatabasetypeEntrez ici le type de base de données ici, habituellement mysql.
targetserverEntrez ici l'adresse de votre serveur de 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.
targetuserCette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
targetpasswordLe mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
targetdatabaseCette 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.
targettableprefixSi votre base de données utilise un préfixe, indiquez-le ici.Informations de la base de données source (De quel base de données dois-je importer ?) :
sourceexistsSi le système importé vient d'une base de données, entrez les détails dessous et précisez ici TRUE. Si la source ne provient PAS d'une base de données, précisez ici FALSE.
sourcedatabasetypeEntrez ici le type de base de données ici, habituellement mysql.
sourceserverEntrez ici l'adresse de votre serveur de base de données source. 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.
sourceuserCette variable contient le nom d'utilisateur donnée par votre hébergeur web pour vous connecter au serveur de la base de données.
sourcepasswordLe mot de passe qui accompagnait le nom d'utilisateur de la base de données doit être indiqué ici.
sourcedatabaseCette valeur doit être modifié pour indiquer le nom de la base de données qui contient les données de l'autre système de forums que vous importez.
sourcetableprefixSi votre base de données utilise un préfixe, indiquez-le ici.Note :
Veuillez noter que Jelsoft / le support vBulletin ne peut pas vous indiquer les valeurs qui vous sont demandés pour vos bases de données. 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://www.vbulletin.com/docs/html/main/create_database) (anglais).Quand vous avez terminé de modifier votre fichier ImpExConfig.php, vous devez le sauvegarder une nouvelle fois et préparez-vous à uploader le fichier sur votre serveur web.Etape 4 : Uploader ImpEx sur votre serveur webAprès que votre fichier ImpExConfig.php ait été modifié et sauvegardé, il est temps d'uploader ImpEx sur votre serveur web prêt pour être exécuté.
Le processus d'upload est familier pour toute personne qui a déjà 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 d'ImpEx 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.
La meilleure façon de transférer les fichiers est d'uploader le répertoire entier upload sur votre serveur, c'est-à-dire de mettre les répertoires « impex » et « includes » fournis à la racine de votre forum. Avec votre client FTP, vous pouvez déplacer le répertoire upload de votre ordinateur vers le répertoire final où se trouvera votre forum sur le serveur. Si le transfert ne démarre pas automatiquement, cliquez sur le bouton [Transférer].
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 ASCIITous les fichiers contenant du texte de l'archive d'ImpEx doivent être transférés en mode ASCII.
Les types de fichiers textes que vous trouverez dans vBulletin/ImpEx sont : .html, .php, .js, .xml, .css.
Tous les fichiers autres que des fichiers textes doivent être transférés en mode BinaireLes 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. Uploadez le répertoire d'ImpEx dans le répertoire de vBulletin 3. Comme ceci : public_html/forum/impex/ 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.
Quand tous les fichiers ont été uploadés avec succès, vous êtes prêts à exécuter ImpEx pour importer votre base de données dans vBulletin 3.
Attention :
Avant toute chose ! Toujours faire une sauvegarde à 100% de vos fichiers web et de votre base de données pour pouvoir restaurer si un problème quelconque survient durant l'importation.