Comment connecter Astrina à WordPress

Comment connecter Astrina à un site WordPress

1. Ce qu'est Astrina et ce dont vous avez besoin pour le connecter

Astrina est une plateforme d'analyse et de surveillance de site web qui est connectée à WordPress pour des widgets, des scripts, des formulaires ou des données internes. Pour commencer, vous avez généralement besoin de deux ensembles d'accès : le panneau d'administration WordPress et votre compte Astrina. Sans eux, la configuration arrive rapidement à une impasse.

Avant de déterminer comment connecter Astrina à un site WordPress, vérifiez qui a des droits d'administrateur. Vous avez besoin non seulement d'un identifiant et d'un mot de passe, mais aussi d'un accès à l'édition de thème, à l'installation de plugins, et, si vous optez pour la méthode manuelle, aux fichiers de modèle ou au panneau de contrôle de l'hébergement. Parfois, un seul compte WordPress suffit. Parfois, ce n'est pas le cas.

Il existe deux façons de se connecter : via un plugin ou manuellement avec du code. La première option est plus pratique si vous souhaitez connecter Astrina à WordPress via un module officiel ou un plugin compatible. La seconde fonctionne pour les projets où le développeur ne veut pas de plugins supplémentaires et ajoute le code directement dans l'en-tête, le pied de page ou via functions.php. En pratique, il ne s'agit pas d'une question de goût, mais de contrôle.

Si le site a déjà une pile complexe avec WooCommerce, un support multilingue et un cache, il est préférable de comprendre à l'avance qui est responsable de quoi. Et si votre sécurité du site est configurée au-dessus du niveau de base, ne changez pas d'autres choses sans une sauvegarde. Une sauvegarde permet d'économiser des heures.

Il est utile de rassembler 4 choses tout de suite : l'adresse du site, l'adresse e-mail de l'administrateur, le token Astrina ou la clé API, et l'accès aux paramètres de cache. Cela suffit généralement pour éviter de courir après l'équipe en plein travail. Oui, il y a des exceptions.

2. Vérification de la compatibilité du site WordPress

WordPress lui-même gêne rarement l'intégration, mais le thème et les plugins aiment causer des surprises. Vérifiez d'abord la version de WordPress, la version de PHP, et si le fournisseur d'hébergement a désactivé les fonctions nécessaires pour charger des scripts externes. Si le site fonctionne sur une ancienne pile, il est préférable de la mettre à jour avant de se connecter, et non après une erreur.

Le thème doit permettre d'insérer du code dans les bonnes zones : en-tête, pied de page, corps, ou via des hooks. Si le thème est verrouillé et ne fournit pas de tels points d'entrée, l'intégration basée sur des plugins semble plus sûre. Sur un modèle propre, tout est plus simple. Sur un modèle fortement personnalisé, ce n'est pas le cas.

Les plugins de cache et d'optimisation déplacent souvent ou suppriment les scripts Astrina. Vérifiez si le projet utilise Autoptimize, LiteSpeed Cache, WP Rocket ou des outils similaires. Dans certains projets, un seul paramètre casse tout — le chargement différé de JS. Dans d'autres, le script n'atteint tout simplement jamais le navigateur.

Si le site utilise une bannière de cookies, le mode de consentement ou une logique similaire, le script Astrina peut ne commencer qu'après que l'utilisateur ait donné son accord. Pour de tels cas, il est utile de regarder à l'avance ce qui a changé dans le consentement des cookies aprèsles mises à jour de Google. Sinon, l'intégration est techniquement en place, mais les rapports restent vides.

La liste de contrôle minimale est simple : WordPress est à jour, le thème est actif, le cache peut être vidé, les erreurs de la console du navigateur ne bloquent rien, et le serveur ne bloque pas les requêtes externes. Cela fait cinq éléments. Pas sept.

3. Obtention des clés, du code ou des paramètres d'Astrina

Dans le tableau de bord Astrina, il y a généralement une section comme Intégrations, Sites, API ou Configuration du code. C'est là que vous cherchez l'ID du projet, la clé publique, la clé privée, le snippet de script ou l'adresse de point de terminaison. Les noms peuvent différer, mais l'idée est la même : WordPress doit savoir à quoi se connecter.

Ouvrez d'abord le projet requis dans Astrina. Ensuite, trouvez le bloc des paramètres de connexion et copiez le code exactement comme le système le fournit. Un espace supplémentaire, un caractère errant ou une URL tronquée casse l'intégration plus souvent que vous ne le souhaiteriez. Littéralement une seule apostrophe.

Si Astrina demande une liste blanche de domaines, ajoutez le domaine principal et, si nécessaire, la version www ou un sous-domaine. Pour un environnement de test, il est préférable de créer une entrée séparée. De cette façon, vous ne mélangerez pas le site en direct avec le brouillon. Cela est particulièrement utile lorsque le développeur et le responsable du contenu travaillent en parallèle.

Pour certains scénarios, Astrina fournit non seulement un script, mais aussi des paramètres pour un formulaire, un événement ou un rappel. Ceux-ci sont généralement insérés là où le modèle HTML est généré, ou via les paramètres du plugin. S'il y a un bouton Copier dans le tableau de bord, utilisez-le. Le taper manuellement est une mauvaise idée.

Une bonne habitude est de stocker toutes les clés immédiatement dans un gestionnaire de mots de passe sécurisé, et non dans un messager. Si le projet est important, cela accélère le transfert d'accès entre le développeur, le marketeur et le propriétaire. Et cela réduit la chance que le token se retrouve au mauvais endroit.

4. Installation et configuration via un plugin WordPress

Si Astrina a un plugin, commencez par installer le plugin WordPress Astrina depuis la zone d'administration WordPress : Plugins → Ajouter Nouveau → Télécharger le Plugin ou recherchez par nom. Après activation, ouvrez la section des paramètres et recherchez les champs pour la clé, l'ID du projet, le domaine et le mode de fonctionnement. En général, le reste est assez simple.

Entrez les données uniquement dans les champs décrits dans la documentation du plugin. Ne collez pas de script dans le champ de la clé et ne mettez pas une clé API là où du HTML est attendu. Le plugin ne lit pas dans les pensées. S'il y a un interrupteur de mode test, commencez par cela. Cela réduit la chance d'une erreur publique.

Après avoir enregistré les paramètres, actualisez le site et ouvrez-le en mode incognito. Parfois, le plugin ne fonctionne que pour les utilisateurs déconnectés, et parfois, au contraire, uniquement pour les administrateurs. À première vue, cela semble mineur. En pratique, c'est une cause fréquente de fausses alertes.

Si le plugin offre un endroit pour insérer un script dans l'en-tête ou le pied de page, choisissez l'option spécifiée dans la documentation d'Astrina. Si vous voyez des recommandations pour le placer avant la balise de fermeture du corps, suivez-les. Vous ne devriez pas mélanger les conseils du plugin avec vos propres suppositions.

Lorsque le projet utilise déjà le support via support du site après le lancement, il est préférable d'inclure l'intégration d'Astrina dans le processus de changement dès le départ. Ainsi, vous n'aurez pas à deviner qui a changé les paramètres et quand. Une entrée dans le journal de travail résout de nombreux litiges.

5. Connexion manuelle via le code du thème ou l'insertion de script

S'il n'y a pas de plugin, la connexion se fait manuellement soit par l'éditeur de thème, un thème enfant, ou des blocs d'insertion de code dans l'en-tête et le pied de page. Pour WordPress, il est préférable de ne pas modifier directement le thème parent si le site est en ligne et que des mises à jour arrivent régulièrement. Sinon, la prochaine mise à jour effacera tout en une minute.

Le chemin le plus sûr est un thème enfant. Là, vous ajoutez le script Astrina via functions.php, le fichier header.php ou footer.php, selon les instructions. Si vous devez ajouter le script Astrina à WordPress sur toutes les pages, le footer est souvent plus pratique. S'il doit s'exécuter plus tôt, placez-le dans le head. Le scénario décide cela.

Une configuration typique ressemble à ceci : copiez le code Astrina depuis le tableau de bord, collez-le à l'emplacement de fichier requis, enregistrez, videz le cache et vérifiez le site dans le navigateur. Ne changez pas le script lui-même à moins qu'il n'y ait une raison. Surtout, ne le raccourcissez pas s'il contient des paramètres de domaine ou un ID de projet.

Lorsque vous éditez le code manuellement, gardez une copie de sauvegarde du fichier à proximité. Ce n'est pas une formalité. Si le site devient blanc après l'insertion, le retour en arrière prend des minutes au lieu d'une soirée. Pour un projet client, c'est la différence entre un appel calme et une discussion urgente.

Si vous n'êtes pas sûr de l'endroit exact où placer le code, il est préférable d'ouvrir la documentation d'Astrina et de confirmer le point d'installation. Dans des thèmes complexes, il y a parfois des hooks séparés pour les scripts d'en-tête et les scripts de pied de page. Ceux-ci sont utilisés plus souvent que l'édition directe de fichiers. Cela réduit le risque de casser la mise en page du modèle.

6. Vérification du bon fonctionnement de l'intégration sur le site

Après l'installation, ouvrez la page d'accueil, une page produit ou un formulaire si Astrina est lié à un scénario spécifique. Ensuite, rafraîchissez la page avec un rechargement complet et voyez si le widget, le code de suivi ou le bloc attendu apparaît. Un clic sur F5 ne vous dira pas grand-chose. Ctrl+F5 ou vider le cache du navigateur est mieux.

Ouvrez ensuite les outils de développement et allez dans Console et Réseau. Là, vous pouvez voir si le script Astrina a été chargé, s'il y a des erreurs 404, 403 ou de contenu mixte, et si une extension de navigateur ou une politique de site bloque la requête. Si la console est silencieuse, c'est un bon signe. Sinon, recherchez la ligne d'erreur par nom de fichier.

Vérifiez le résultat non seulement en tant qu'administrateur, mais aussi en tant que visiteur régulier. Certains plugins, en particulier ceux liés aux rôles d'utilisateur, cachent des scripts aux utilisateurs connectés. Dans ce cas, tester en tant qu'invité donne une image honnête. Et évite des conjectures inutiles.

Si Astrina a un formulaire, soumettez une demande de test et vérifiez si elle a atteint le tableau de bord ou l'email. Si c'est un widget, assurez-vous qu'il ne s'est pas déplacé sur mobile à 360 px. Si c'est un script, assurez-vous qu'il se déclenche après la bonne action, pas immédiatement au chargement de la page.

7. Problèmes courants et comment les résoudre

L'erreur la plus courante est une clé ou un ID de projet incorrect. Cela se produit généralement lorsqu'une ancienne version du script est insérée ou lorsque les données proviennent du mauvais compte Astrina. La vérification est simple : comparez les paramètres dans le tableau de bord et sur le site caractère par caractère. Pas de raccourcissement.

Le deuxième problème est les conflits de plugins. Le cache, la minification, la protection contre les bots et l'optimisation JavaScript peuvent supprimer ou retarder le script Astrina. Désactivez temporairement les plugins suspects un par un et testez après chaque étape. C'est ainsi que vous trouvez le coupable au lieu de vous disputer avec lui.

Le troisième problème est le blocage des requêtes externes au niveau du serveur, du CDN ou du CSP. Si la console indique que le script ne peut pas se charger depuis le domaine Astrina, vérifiez les en-têtes de sécurité et les règles d'accès. Parfois, Cloudflare est responsable, parfois un module d'hébergement, parfois une ancienne liste blanche.

Un autre scénario est que le cache affiche une ancienne version de la page après des modifications de code. D'abord, videz le cache du site, puis le cache du navigateur, et ensuite, si nécessaire, le cache du CDN. L'ordre est important. Si vous sautez la première étape, vous regarderez un problème qui n'existe plus.

Parfois, le script est inséré correctement, mais le thème WordPress ne sort pas le hook requis sur une page spécifique. Cela se produit dans les pages d'atterrissage, les modèles avec des champs personnalisés et les pages assemblées. Dans ce cas, il est plus facile de passer à une insertion manuelle dans le modèle ou de connecter Astrina via un plugin qui fonctionne globalement.

Si le site est construit sur une architecture inhabituelle ou utilise une infrastructure de réseau privé rare, il est préférable de convenir du schéma de connexion avec le développeur à l'avance. Lorsque le projet est complexe, un petit changement à un endroit peut affecter plusieurs écrans. Et là, il ne s'agit plus d'Astrina, mais de l'ensemble de la pile.

8. Que faire après la connexion

Après un lancement réussi, ne laissez pas l'intégration seule. Tout d'abord, documentez où la clé Astrina est stockée, qui y a accès et ce qui ne peut pas être changé sans approbation. Pour une équipe de 2 à 3 personnes, cela fait déjà gagner du temps. Pour une équipe plus grande, encore plus.

Vérifiez les mises à jour de WordPress, des plugins et des thèmes au moins une fois par fenêtre de maintenance régulière. Si le site a des versions fréquentes, il est préférable de tester la connexion Astrina sur une copie de staging avant de passer en production. De cette façon, vous ne serez pas surpris par des surprises sur les visiteurs. Les surprises y sont généralement indésirables.

Si le comportement des formulaires, des analyses ou des widgets change après la connexion, ajoutez-le à la liste de support et de surveillance. Parfois, il est utile de comparer l'intégration avec le plateforme d'analyse et de surveillance de site web · comme montré dans l'exemple de travail, afin de ne pas avoir à deviner le rôle des blocs individuels. Sur un projet en direct, une ligne dans le document de processus vaut plus qu'une longue discussion.

La sécurité ne s'arrête pas à l'installation non plus. Ne partagez pas le token dans des discussions publiques, restreignez l'accès au tableau de bord Astrina par rôle, et faites tourner les clés après avoir changé de prestataire. Si plusieurs personnes modifient le site, activez un journal des modifications. C'est ennuyeux. Mais ça fonctionne.

Lorsque la supervision externe est nécessaire, il est utile de développer comment évaluer la fiabilité d'un site avant de commander avant de donner l'accès à de nouveaux prestataires. Et si le projet nécessite une configuration non standard, comparez-le avec comment quel studio web une startup a besoin à ses débuts est structuré, afin de ne pas prendre de risques supplémentaires au départ.

La dernière étape pratique est de désigner quelqu'un pour vérifier Astrina tous les 7 ou 14 jours. Cette personne regarde la console, teste le script et surveille tout élément manquant après la prochaine mise à jour de WordPress. C'est à ce moment-là que l'intégration cesse d'être une tâche ponctuelle et devient une partie stable du projet.