Pitchoune
10/07/2005, 16h16
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.
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.
Depuis le logiciel d'administration (./admincp par défaut), sélectionnez Importer puis Importer et sélectionnez le système que vous souhaitez importer de la liste.
Veuillez noter que le système ImpEx est écrit pour vBulletin 3.5.0 et plus.
Attention :
Après chaque importation, vérifiez TOUTES les permissions de TOUS les groupes d'utilisateurs, et remettez en l'ordre si quelque chose ne correspond pas.
Ceci résoud un nombre important de problèmes d'importation.impex1Etape 1 : Introduction au système ImpExImpEx est un système d'importation / exportation pour vBulletin 3.
Il comprend un certains nombre de fichiers moteurs, qui se situe dans le répertoire /impex.
Les importeurs séparés sont dans le répertoire /impex/systems/, auquel chacun est dans son répertoire qui compose le nom du système dans l'importeur et l'ordre des scripts.impex2Etape 2 : Importer un forumAttention :
Soyez sûr d'avoir effectué une sauvegarde fonctionnelle à 100% de vos forums actuels (fichiers et base de données). Si besoin, vous pourrez revenir à la dernière version fonctionnelle.http://forum.vbulletin-fr.org/tutorial/impex/impex_menu.png
Du logiciel d'administration (admincp/ par défaut), sélectionnez Importer puis Importer.
http://forum.vbulletin-fr.org/tutorial/impex/impex_screen.png
Sélectionnez le système que vous souhaitez importer dans la liste et cliquez sur le bouton pour confirmer votre choix et démarrer la procédure d'importation.
http://forum.vbulletin-fr.org/tutorial/impex/impex_modules.png
001 - Check and Update DatabaseCe module va vérifier et modifier les tables des bases de données aussi bien que les connexions. Après avoir cliqué sur le bouton [Start Module], il vérifiera la base de données et si il n'y a aucun problème, retournera sur l'aperçu des modules à lancer auquel vous pourrez lancer le module 002.
ImpEx va modifier les tables de la base vB (cible) pour inclure les numéros importid (ceci est nécessaire pendant le processus d'importation pour maintenir les références entre les tables durant un import).
Si vous avez de grosses tables (ex. un grand nombre de messages), ceci peut prendre du temps. Ils seront aussi laissés après l'importation si vous avez besoin de lier un utilisateur importé avec un userid de vB.
002 - 00xLes modules additionnels parlent d'eux-mêmes par leur nom et peuvent varier en nombre selon l'importation à effectuer.Allez dans chaque module un par un (en commençant par le module 001) et attendez que la page soit chargée à 100% avant de cliquer sur n'importe quel lien, ne cliquez pas sur le bouton « Précédent » de votre navigateur et ne changez pas de fenêtre pendant l'exécution de l'importation. Lisez attentivement tout se qui se trouve sur chaque fenêtre et rédigez toutes les erreurs en entiers avant de contacter le support d'aide.
Pour commencer une importation, cliquez sur le bouton [Start Module] et quand le module sera terminé, les statistiques d'importation seront mis à jour et le nom du bouton changera.impex3[B]Etape 3 : Relancer des modules
Quand vous lancez de nouveau un module, pour n'importe quel raison, il supprimera toutes les données importés de ce module préédemment.
Si vous exécutez le module des messages d'une importation de phpBB pour la première fois, il va importer tous les messages de phpBB et les placera dans la base de données vBulletin.
Tous les messages auront un importpostid qui est le numéro du message sous phpBB. Tous les messages de vBulletin n'auront pas d'importpostid, il seront laissés comme tel.
Quand le module est lancé une deuxième fois (pour un nouvel essai, vous avez modifié quelques paramètres, mis à jour une interface, plus de messages qu'avant, etc.)il supprimera tous les messages dans vBulletin qui auront un importpostid.
Ceci est utile si un module a mal importé une première fois ou que vous avez modifié ou corrigé certains messages.
Attention :
Si vous avez associé des utilisateurs et que vous relancez le module d'importation des utilisateurs, les utilisateurs vBulletin originaux qui auront reçu un importuserid seront supprimés.impex4Etape 4 : Après une importationAttention :
Une importation obtiendra toujours une certaine quantité d'informations du forum source vers vBulletin.Supprimer les fichiers d'ImpEx
Une fois que vous avez fini votre importation et que votre forum est fonctionnel à 100%, supprimez tous les fichiers d'ImpEx, ceci vous évitera d'importer une nouvelle fois par erreur votre ancien forum et d'utiliser la nouvelle version d'ImpEx quand vous en aurez de nouveau besoin.
Deuxièmement, afin d'éviter tout soucis de piraterie, ne gardez aucun fichier d'impEx, ceux-ci peuvent compromettre votre forum.
Permissions
Vérifiez toujours les permissions des modérateurs et des forums après une importation car les permissions peuvent ne pas être correctes selon les permissions du forum source.
Cache du forum
Pour régénérer le cache de vos forums, vous devez aller dans le gestionnaire de forums et sauvegardez l'affichage directement.
Compteurs
Mettez à jour les compteurs de messages et de discussions après une importation pour montrer les vraies valeurs pour chaque forum et discussion.
Forum par défaut
Si vous importez dans une installation récente de vBulletin, vous pouvez vouloir supprimer le forum par défaut, il est conseillé de le faire avant de commencer l'importation. Si vous souhaitez supprimer le forum par défaut après une importation, assurez-vous que rien ne relie ce forum aux discussions et messages, ils seront supprimés avec.
Groupes d'utilisateurs
La plupart des importeurs importera les groupes d'utilisateurs ou créera un groupe d'utilisateur par défaut, ceci est fait afin de gérer vos utilisateurs dans les groupes correspondants.
Index de recherche
Vous devez régénérer l'index de recherche si vous voulez être capable de pouvoir rechercher dans les messages importés.impex5Etape 5 : Mot de passeMots de passe importés
Tous les systèmes n'importent pas les mots de passe, ceci étant du à leur façon d'être crypté par chaque système.
Si vous importez d'un système auquel les mots de passe ne sont pas importés ou qu'une erreur survient lors de l'importation des mots de passe, vous pouvez envoyer un email à tous vos utilisateurs en leur indiquant le lien de la page de régénération de leur mot de passe sur votre forum quand tout sera fini.
Ceci leur permettra de réinitialiser leurs mots de passe, en espérant que leur adresse email soit correcte dans leur profil.
Utilisateurs > Envoyer un email aux utilisateurs
Par exemple :
Bonjour $username,
Nous avons récemment déplacé notre forum vers vBulletin, et ceci nécessite la régénération de votre mot de passe. Si vous suivez le lien ci-dessous et que vous insérez votre adresse email actuelle, vous recevrez toutes les instructions pour régénérer votre mot de passe.
http://www.exemple.com/forum/login.php?do=lostpw
L'équipe de exemple.comimpex6Etape 6 : Que faire maintenant ?Maintenant que vous avez effectué l'importation, la page principale d'ImpEx vous donne une idée du temps que cela prend, plus la reconfiguration.
Essayez d'importer plusieurs fois pour vous assurer d'une bonne importation et de savoir quoi faire une fois la véritable importation arrivée.
Il est maintenant bon de configurer impex/tools/cleaner.php (étape suivante) si vous avez besion de retirer du code HTML ou des liens incorrects des messages de votre importation.
Si vous souhaitez supprimer les ID d'importations de la base de données, veuillez lire la dernière étape.impex7Etape 7 : Cleaner.phpCleaner.php est localisé dans le répertoire impex/tools/.
ImpEx formate le code HTML et les mauvaises balises BB qu'il peut trouver, même si du code HTML ou des balises BB sont mal utilisés.
Pour retirer ceci, vous devez utiliser cleaner.php, sa principale fonction est de rechercher une certaine valeur et de la remplacer par une autre, ou une valeur vide pour indiquer sa suppression.
Une fois que cleaner.php a été exécuté avec succès, vous devez régénérer le cache des messages dans le logiciel d'administration > Maintenance > Mettre à jour les compteurs.
Le fichier en lui-même contient plusieurs commentaires et instructions dont voici un exemple, si j'ai le message :
Bonjour, j'ai voulu en savoir plus sur le web et j'ai trouvé ceci et j'ai pensé que <B>r0x0rs</B>, cela parle de pirates qui sont très bons.
<a href="http://www.exemple.com/mauvaise_page.html">publicité</a>Il y a trois erreurs ici. Les balises <B> doivent être des balises BB, le code HTML doit être retiré et les pirates deviennent des ninjas...
Dans le script, il y a ce code :
$replacer = array(
"<img>" => "[img]",
"" => "",
"" => "",
"" => "",
"" => "",
);Ceci est comment est configuré cleaner.php, nous allons le modifier de la manière suivante :
$replacer = array(
"<B>" => "",
"pirates" => "ninjas",
'<a href="http://www.exemple.com/mauvaise_page.html">publicité</a>' => ""
);Veuillez remarquer que nous avons remplacé les guillemets par des apostrophes dû au code HTML à rechercher.impex8[B]Etape 8 : Help.phpLe lien Database cleanup & restart apparaît en haut de toutes les pages d'ImpEx, vous pouvez y accéder aussi si vous avez une erreur avec ImpEx en allant dans http://www.exemple.com/forum/impex/tools/help.php, assumant que votre forum est installé dans le répertoire forum/.
Il existe quatre options sur cette page.
Cancel
To cancel and return to the import, click here.
En cliquant sur ce lien, vous retournerez à la page d'accueil d'ImpEx.
Delete Session
To delete the import session and continue with the import, click here.
Ceci retirera la session d'importation. La session d'importation contient l'état de l'importation, les valeurs des pages, chemins, système sélectionné, etc... Supprimer ceci va remettre à zéro l'importation tandis qu'aucune donnée ne sera modifiée sur le forum de destination.
Delete Session and all imported data
To delete the import session and all imported data for a clean retry, click here.
Ceci supprimera la session, ainsi que toutes les données importés dans la bae de destination. Ceci inclut les utilisateurs associés.
Remove importids
To delete the importid's in the database, click here, also removes the session. This will allow you to do consecutive imports
Ceci supprimera les ID d'importation des tables qui ont été importées, lisez cette section pour plus d'nformations.
Remove duplicate forums/threads/posts
A certaines occasions, quand un navigateur bloque ou qu'une page échoue au chargement quand vous actualisez, ceci signifiera que des objets ont été dupliquées, comme la page va relancer la requête SQL de la page chargée.
Les objets dupliqués auront le même import<objet>id mais auront un ID différent dans vBulletin dû à l'auto incrémentation des tables, car ImpEx peut trouver les objets qui ont le même ID d'importation, mais un Id différent dans vBulletin. Par exemple :
Discussion A : threadid = 1, importthreadid = 5
Discussion B : threadid = 2, importthreadid = 5
B est une discussion dupliquée.
Lancer cette fonction sur une base de données qui a subi plusieurs importations qui n'ont pas été finalisées entre chaque importation peut supprimer un large pourcentage d'une importation précédente, veuillez donc vous assurer que vous avez finalisé les importations précédents avant d'en exécuter d'autres.
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.
Depuis le logiciel d'administration (./admincp par défaut), sélectionnez Importer puis Importer et sélectionnez le système que vous souhaitez importer de la liste.
Veuillez noter que le système ImpEx est écrit pour vBulletin 3.5.0 et plus.
Attention :
Après chaque importation, vérifiez TOUTES les permissions de TOUS les groupes d'utilisateurs, et remettez en l'ordre si quelque chose ne correspond pas.
Ceci résoud un nombre important de problèmes d'importation.impex1Etape 1 : Introduction au système ImpExImpEx est un système d'importation / exportation pour vBulletin 3.
Il comprend un certains nombre de fichiers moteurs, qui se situe dans le répertoire /impex.
Les importeurs séparés sont dans le répertoire /impex/systems/, auquel chacun est dans son répertoire qui compose le nom du système dans l'importeur et l'ordre des scripts.impex2Etape 2 : Importer un forumAttention :
Soyez sûr d'avoir effectué une sauvegarde fonctionnelle à 100% de vos forums actuels (fichiers et base de données). Si besoin, vous pourrez revenir à la dernière version fonctionnelle.http://forum.vbulletin-fr.org/tutorial/impex/impex_menu.png
Du logiciel d'administration (admincp/ par défaut), sélectionnez Importer puis Importer.
http://forum.vbulletin-fr.org/tutorial/impex/impex_screen.png
Sélectionnez le système que vous souhaitez importer dans la liste et cliquez sur le bouton pour confirmer votre choix et démarrer la procédure d'importation.
http://forum.vbulletin-fr.org/tutorial/impex/impex_modules.png
001 - Check and Update DatabaseCe module va vérifier et modifier les tables des bases de données aussi bien que les connexions. Après avoir cliqué sur le bouton [Start Module], il vérifiera la base de données et si il n'y a aucun problème, retournera sur l'aperçu des modules à lancer auquel vous pourrez lancer le module 002.
ImpEx va modifier les tables de la base vB (cible) pour inclure les numéros importid (ceci est nécessaire pendant le processus d'importation pour maintenir les références entre les tables durant un import).
Si vous avez de grosses tables (ex. un grand nombre de messages), ceci peut prendre du temps. Ils seront aussi laissés après l'importation si vous avez besoin de lier un utilisateur importé avec un userid de vB.
002 - 00xLes modules additionnels parlent d'eux-mêmes par leur nom et peuvent varier en nombre selon l'importation à effectuer.Allez dans chaque module un par un (en commençant par le module 001) et attendez que la page soit chargée à 100% avant de cliquer sur n'importe quel lien, ne cliquez pas sur le bouton « Précédent » de votre navigateur et ne changez pas de fenêtre pendant l'exécution de l'importation. Lisez attentivement tout se qui se trouve sur chaque fenêtre et rédigez toutes les erreurs en entiers avant de contacter le support d'aide.
Pour commencer une importation, cliquez sur le bouton [Start Module] et quand le module sera terminé, les statistiques d'importation seront mis à jour et le nom du bouton changera.impex3[B]Etape 3 : Relancer des modules
Quand vous lancez de nouveau un module, pour n'importe quel raison, il supprimera toutes les données importés de ce module préédemment.
Si vous exécutez le module des messages d'une importation de phpBB pour la première fois, il va importer tous les messages de phpBB et les placera dans la base de données vBulletin.
Tous les messages auront un importpostid qui est le numéro du message sous phpBB. Tous les messages de vBulletin n'auront pas d'importpostid, il seront laissés comme tel.
Quand le module est lancé une deuxième fois (pour un nouvel essai, vous avez modifié quelques paramètres, mis à jour une interface, plus de messages qu'avant, etc.)il supprimera tous les messages dans vBulletin qui auront un importpostid.
Ceci est utile si un module a mal importé une première fois ou que vous avez modifié ou corrigé certains messages.
Attention :
Si vous avez associé des utilisateurs et que vous relancez le module d'importation des utilisateurs, les utilisateurs vBulletin originaux qui auront reçu un importuserid seront supprimés.impex4Etape 4 : Après une importationAttention :
Une importation obtiendra toujours une certaine quantité d'informations du forum source vers vBulletin.Supprimer les fichiers d'ImpEx
Une fois que vous avez fini votre importation et que votre forum est fonctionnel à 100%, supprimez tous les fichiers d'ImpEx, ceci vous évitera d'importer une nouvelle fois par erreur votre ancien forum et d'utiliser la nouvelle version d'ImpEx quand vous en aurez de nouveau besoin.
Deuxièmement, afin d'éviter tout soucis de piraterie, ne gardez aucun fichier d'impEx, ceux-ci peuvent compromettre votre forum.
Permissions
Vérifiez toujours les permissions des modérateurs et des forums après une importation car les permissions peuvent ne pas être correctes selon les permissions du forum source.
Cache du forum
Pour régénérer le cache de vos forums, vous devez aller dans le gestionnaire de forums et sauvegardez l'affichage directement.
Compteurs
Mettez à jour les compteurs de messages et de discussions après une importation pour montrer les vraies valeurs pour chaque forum et discussion.
Forum par défaut
Si vous importez dans une installation récente de vBulletin, vous pouvez vouloir supprimer le forum par défaut, il est conseillé de le faire avant de commencer l'importation. Si vous souhaitez supprimer le forum par défaut après une importation, assurez-vous que rien ne relie ce forum aux discussions et messages, ils seront supprimés avec.
Groupes d'utilisateurs
La plupart des importeurs importera les groupes d'utilisateurs ou créera un groupe d'utilisateur par défaut, ceci est fait afin de gérer vos utilisateurs dans les groupes correspondants.
Index de recherche
Vous devez régénérer l'index de recherche si vous voulez être capable de pouvoir rechercher dans les messages importés.impex5Etape 5 : Mot de passeMots de passe importés
Tous les systèmes n'importent pas les mots de passe, ceci étant du à leur façon d'être crypté par chaque système.
Si vous importez d'un système auquel les mots de passe ne sont pas importés ou qu'une erreur survient lors de l'importation des mots de passe, vous pouvez envoyer un email à tous vos utilisateurs en leur indiquant le lien de la page de régénération de leur mot de passe sur votre forum quand tout sera fini.
Ceci leur permettra de réinitialiser leurs mots de passe, en espérant que leur adresse email soit correcte dans leur profil.
Utilisateurs > Envoyer un email aux utilisateurs
Par exemple :
Bonjour $username,
Nous avons récemment déplacé notre forum vers vBulletin, et ceci nécessite la régénération de votre mot de passe. Si vous suivez le lien ci-dessous et que vous insérez votre adresse email actuelle, vous recevrez toutes les instructions pour régénérer votre mot de passe.
http://www.exemple.com/forum/login.php?do=lostpw
L'équipe de exemple.comimpex6Etape 6 : Que faire maintenant ?Maintenant que vous avez effectué l'importation, la page principale d'ImpEx vous donne une idée du temps que cela prend, plus la reconfiguration.
Essayez d'importer plusieurs fois pour vous assurer d'une bonne importation et de savoir quoi faire une fois la véritable importation arrivée.
Il est maintenant bon de configurer impex/tools/cleaner.php (étape suivante) si vous avez besion de retirer du code HTML ou des liens incorrects des messages de votre importation.
Si vous souhaitez supprimer les ID d'importations de la base de données, veuillez lire la dernière étape.impex7Etape 7 : Cleaner.phpCleaner.php est localisé dans le répertoire impex/tools/.
ImpEx formate le code HTML et les mauvaises balises BB qu'il peut trouver, même si du code HTML ou des balises BB sont mal utilisés.
Pour retirer ceci, vous devez utiliser cleaner.php, sa principale fonction est de rechercher une certaine valeur et de la remplacer par une autre, ou une valeur vide pour indiquer sa suppression.
Une fois que cleaner.php a été exécuté avec succès, vous devez régénérer le cache des messages dans le logiciel d'administration > Maintenance > Mettre à jour les compteurs.
Le fichier en lui-même contient plusieurs commentaires et instructions dont voici un exemple, si j'ai le message :
Bonjour, j'ai voulu en savoir plus sur le web et j'ai trouvé ceci et j'ai pensé que <B>r0x0rs</B>, cela parle de pirates qui sont très bons.
<a href="http://www.exemple.com/mauvaise_page.html">publicité</a>Il y a trois erreurs ici. Les balises <B> doivent être des balises BB, le code HTML doit être retiré et les pirates deviennent des ninjas...
Dans le script, il y a ce code :
$replacer = array(
"<img>" => "[img]",
"" => "",
"" => "",
"" => "",
"" => "",
);Ceci est comment est configuré cleaner.php, nous allons le modifier de la manière suivante :
$replacer = array(
"<B>" => "",
"pirates" => "ninjas",
'<a href="http://www.exemple.com/mauvaise_page.html">publicité</a>' => ""
);Veuillez remarquer que nous avons remplacé les guillemets par des apostrophes dû au code HTML à rechercher.impex8[B]Etape 8 : Help.phpLe lien Database cleanup & restart apparaît en haut de toutes les pages d'ImpEx, vous pouvez y accéder aussi si vous avez une erreur avec ImpEx en allant dans http://www.exemple.com/forum/impex/tools/help.php, assumant que votre forum est installé dans le répertoire forum/.
Il existe quatre options sur cette page.
Cancel
To cancel and return to the import, click here.
En cliquant sur ce lien, vous retournerez à la page d'accueil d'ImpEx.
Delete Session
To delete the import session and continue with the import, click here.
Ceci retirera la session d'importation. La session d'importation contient l'état de l'importation, les valeurs des pages, chemins, système sélectionné, etc... Supprimer ceci va remettre à zéro l'importation tandis qu'aucune donnée ne sera modifiée sur le forum de destination.
Delete Session and all imported data
To delete the import session and all imported data for a clean retry, click here.
Ceci supprimera la session, ainsi que toutes les données importés dans la bae de destination. Ceci inclut les utilisateurs associés.
Remove importids
To delete the importid's in the database, click here, also removes the session. This will allow you to do consecutive imports
Ceci supprimera les ID d'importation des tables qui ont été importées, lisez cette section pour plus d'nformations.
Remove duplicate forums/threads/posts
A certaines occasions, quand un navigateur bloque ou qu'une page échoue au chargement quand vous actualisez, ceci signifiera que des objets ont été dupliquées, comme la page va relancer la requête SQL de la page chargée.
Les objets dupliqués auront le même import<objet>id mais auront un ID différent dans vBulletin dû à l'auto incrémentation des tables, car ImpEx peut trouver les objets qui ont le même ID d'importation, mais un Id différent dans vBulletin. Par exemple :
Discussion A : threadid = 1, importthreadid = 5
Discussion B : threadid = 2, importthreadid = 5
B est une discussion dupliquée.
Lancer cette fonction sur une base de données qui a subi plusieurs importations qui n'ont pas été finalisées entre chaque importation peut supprimer un large pourcentage d'une importation précédente, veuillez donc vous assurer que vous avez finalisé les importations précédents avant d'en exécuter d'autres.