Migrations
Migrations
FastComments fournit des outils en libre-service ainsi qu'une assistance directe des développeurs pour les migrations vers notre plateforme, migrations de données au sein de notre plateforme, et les exportations depuis notre produit.
Dans ce guide, vous apprendrez tout sur ces trois.
Migration depuis d'autres fournisseurs 
Lors de la migration depuis un autre fournisseur, il y a quelques points à prendre en compte :
- Les données de commentaires existantes, y compris les réponses.
- Les comptes utilisateur, y compris les avatars.
- Le style personnalisé.
L'importation de données en libre-service présentée dans les sections suivantes couvre les deux premiers points. Pour la personnalisation, consultez notre guide de personnalisation.
Importation des données
Bien que le support FastComments puisse aider lors des migrations, la plupart peuvent être effectuées et surveillées facilement sans aucune intervention du personnel de support.
Nous prenons en charge nativement l'importation d'exports provenant des fournisseurs suivants :
- Commento
- Disqus
- Hyvor Talk
- Muut Comments
- IntenseDebate
- Just-Comments
- Cusdis
- WordPress (via le plugin, ou un export XML ou CSV)
- AnyComment (Via l'import/export WordPress)
En naviguant ici, nous pouvons télécharger le fichier contenant les données à migrer.
Surveillance des importations
FastComments utilise un système de traitement des tâches pour gérer les importations et les exportations. Une fois que le système a récupéré votre tâche, il rapporte périodiquement le statut de la tâche dans l'interface d'importation ou d'exportation.
Notez que le statut des importations et des exportations est visible par tous les administrateurs du compte.
Si votre tâche échoue, elle ne sera pas redémarrée automatiquement. L'importation devra être réessayée. Si une importation ou une exportation échoue, nos administrateurs système sont automatiquement notifiés. Si nous identifions un problème, nous vous contacterons pour voir si nous pouvons aider.
Relancer l'importation
Lors de certaines migrations, il est nécessaire d'exécuter l'importation plusieurs fois. Par exemple, il est courant de faire une première migration de test, puis de relancer l'importation avec les données les plus récentes avant de basculer.
Réimporter le même contenu ne créera pas de doublons.
Sécurité des données et expiration
Les fichiers d'importation ne sont pas accessibles par des requêtes externes de quelque manière que ce soit, et les fichiers d'importation sont supprimés de notre système dès que l'importation est terminée.
Importation des commentaires WordPress
Notre plugin WordPress dispose d'un puissant mécanisme d'importation basé sur une interface utilisateur. Après l'installation du plugin, il vous guidera pour lier votre installation WordPress à FastComments et copier vos données de commentaires existantes.
Cela se fait sans copier ni télécharger quoi que ce soit manuellement.
Le processus de migration vous sera indiqué via l'interface utilisateur pendant la migration. La plupart des migrations ne prennent que quelques minutes.
Le mécanisme est conçu pour ne pas mettre une charge excessive sur votre installation WordPress pendant la migration.
Si vous déplacez votre site hors de WordPress, vous pouvez importer un export WordPress XML ou CSV au lieu d'utiliser le plugin. Voir Déplacer vos commentaires vers un nouveau site.
CloudFlare et pare-feux
Pour que la configuration automatisée de WordPress fonctionne, nous devons effectuer des appels vers votre installation WordPress. Les pare-feux comme Cloudflare peuvent nous bloquer et provoquer l'échec de l'intégration. Dans ce cas, nous pouvons vous fournir une liste d'IP à mettre en liste blanche pour l'intégration.
Propriété des données
Dans le cas de notre migration WordPress, toutes les données de commentaires nouvelles ou mises à jour sont automatiquement resynchronisées vers votre installation WordPress en arrière-plan. Cela signifie que, bien que les commentaires soient servis par FastComments lui-même afin de réduire la charge de votre déploiement WordPress, nous les enregistrons également dans votre base de données en tant que sauvegarde. Cela signifie aussi que si vous souhaitez quitter FastComments, vos données sont déjà migrées et à jour.
Migration des utilisateurs et des modérateurs
Avec FastComments, de nombreux utilisateurs peuvent être ajoutés à votre locataire, et leurs autorisations peuvent être configurées en fonction des rôles de votre
organisation.
Les utilisateurs peuvent être ajoutés via cette interface. Si vous avez de nombreux utilisateurs, nous pouvons les importer pour vous via le support client.
Pour ajouter des modérateurs, consultez la documentation correspondante.
Une note sur l'authentification
Vos utilisateurs peuvent chercher un endroit où saisir leur mot de passe. FastComments utilise "magic links" pour se connecter – aucun mot de passe n'est requis.
Migration des domaines
FastComments fournit un moyen automatisé pour vous de migrer vos commentaires entre domaines.
La migration de domaine nécessite simplement un domaine from et un domaine to.
Cela déplace les commentaires, cela ne les copie pas. Si vous souhaitez copier les commentaires, contactez‑nous.
Ceci est également utile, par exemple, si une partie de votre migration vers FastComments implique une migration depuis un autre fournisseur, de sorte que vos données d'importation de commentaires peuvent contenir des données qui doivent être migrées. Dans ce cas, vous pouvez exécuter l'importation, puis la migration de domaine.
Suivi de la progression
L'outil de migration de domaine utilise le même système de traitement des tâches FastComments que les autres outils de gestion de données.
Il peut y avoir un délai avant le démarrage de votre migration. C'est normal, car le système vérifie périodiquement les nouvelles tâches à traiter.
Au fur et à mesure que la tâche s'exécute, elle affichera le nombre de commentaires trouvés à migrer, ainsi que le nombre déjà migrés.
Migration de domaines via API
Les domaines peuvent également être migrés avec POST /api/v1/pages/migrations, en utilisant type défini sur domain. La progression est disponible via GET /api/v1/batch-jobs/:id, et la migration peut être annulée pendant 90 jours.
Migration des pages
Bien que son nom soit l'outil de migration de domaine, il peut également être utilisé pour migrer des commentaires entre des pages individuelles.
Saisissez simplement les anciennes et nouvelles valeurs urlId dans les champs de saisie from et to.
Migration de pages via l'API
Pour migrer plusieurs pages à la fois, utilisez POST /api/v1/pages/migrations. Elle accepte jusqu'à 100 paires from et to par requête et les exécute en tant que tâche par lots.
Avec type défini sur urlId, seule la page dont le urlId correspond exactement à from est déplacée, donc post-1 ne correspond pas à post-10. L'outil du tableau de bord ne dispose pas de cette option.
Chaque migration via l'API peut être annulée pendant 90 jours avec POST /api/v1/pages/migrations/:undoId/undo.
Copie des commentaires
Dans le cas où des données doivent être déplacées, FastComments propose un outil en libre-service permettant de déplacer les commentaires entre les pages et les articles.
Voici à quoi ressemble le formulaire de copie de commentaires :
Remplir les champs « From »
Pour déterminer d'où déplacer les commentaires, nous devons simplement connaître le URL ID source.
Si vous ne transmettez pas de valeur pour urlId dans la configuration du widget de commentaires, alors il s'agira d'une version « clean » de l'URL de la page.
Vous pouvez voir quelles valeurs vos commentaires ont pour le URL ID en les exportant.
Remplir les champs « To »
Pour déterminer où déplacer les commentaires, nous devons connaître le URL ID cible et l'URL.
Le URL ID sera le compartiment dans lequel le commentaire sera placé. Le champ URL est utilisé afin que vous puissiez accéder directement au commentaire depuis les e‑mails et les outils de modération.
WordPress
Si vous utilisez WordPress, vous saisiriez par exemple les ID d'articles dans les champs URL ID To/From de l'outil de migration, plutôt qu'une URL.
Exportation des données
Toutes les données de commentaires peuvent être exportées depuis notre plateforme au format CSV.
Veuillez noter que les dates dans ce fichier seront en fuseau horaire UTC, au format ISO.
Si vous souhaitez récupérer périodiquement des données depuis FastComments, nous vous suggérons d'utiliser les Webhooks.
WordPress
Dans le cas des intégrations WordPress, FastComments synchronise automatiquement les données vers votre installation WordPress périodiquement. Par conséquent, pour migrer depuis FastComments, il vous suffit de le désactiver.