Guide complet pour dépanner les problèmes de configuration courants avec les notifications Web Push OneSignal sur WordPress, incluant la compatibilité des navigateurs (Chrome, Firefox, Safari), l’intégration du plugin et la résolution des conflits CDN ou de cache.
Le plugin WordPress OneSignal inclut automatiquement le script d’initialisation et le Service Worker.
N’ajoutez pas le code JavaScript init de OneSignal à votre site.
N’utilisez pas la Configuration de code personnalisé avec le plugin WordPress. Si vous devez personnaliser la méthode init, désinstallez le plugin et ajoutez le code et le Service Worker manuellement.
Envoyer une notification lors de la publication d’un article
Lorsque vous publiez un article, une page ou un type d’article personnalisé, OneSignal peut automatiquement envoyer une notification à vos abonnés.
Metabox OneSignal Push Notifications——faites-la glisser pour la repositionner si nécessaire
Si vous ne voyez pas la case à cocher Envoyer une notification lors de la publication ou de la mise à jour de l’article, vérifiez les éléments suivants :
Vérifiez les metaboxes à droite et en bas de l’éditeur. Vous pouvez les glisser-déposer selon vos besoins.
Vérifiez les Options d’écran en haut de l’éditeur pour vous assurer que la metabox OneSignal Push Notifications est cochée.
Options d'écran montrant la metabox OneSignal Push Notifications cochée
Vérifiez si vous utilisez un Type d’article personnalisé. Celui-ci se trouve généralement dans l’URL sous la forme post_type=your_custom_type. Si c’est le cas, ajoutez le type d’article personnalisé au champ Types d’articles personnalisés dans les paramètres du plugin WordPress OneSignal.
Exemple d'emplacement du nom du type d'article personnalisé
Vérifiez que le plugin est actif et ouvrez les outils de développement
Chargez votre site dans une fenêtre de navigateur normale (non incognito) avec le plugin activé.
Faites un clic droit sur votre site, cliquez sur Inspecter et ouvrez l'onglet Console.
2
Vérifiez la console pour les erreurs OneSignal
Ouvrez l’onglet Console, actualisez la page et recherchez les erreurs liées à OneSignal en rouge ou jaune.
Voir Erreurs de console OneSignal courantes pour obtenir de l’aide.
3
Vérifiez le statut d'abonnement dans le navigateur
Une fois la page chargée et en l’absence d’erreurs OneSignal dans la Console, collez ceci :
JavaScript
OneSignal.User.PushSubscription.id
Si le visiteur est abonné, cela retourne une chaîne (l’ID d’abonnement). Si l’abonnement n’est pas actif ou pas encore prêt, vous pouvez voir null ou une valeur vide. Si vous voyez OneSignal is not defined, attendez quelques secondes et réessayez, ou corrigez d’abord les erreurs de Console dans Erreurs de console OneSignal courantes——le SDK est peut-être encore en cours de chargement via le chargeur différé.
Trouvez votre ID d'abonnement OneSignal dans la console.
4
Vérifiez l'ID d'abonnement dans le tableau de bord OneSignal
Dans le tableau de bord OneSignal, allez dans Audience > Subscriptions et recherchez l’ID retourné ci-dessus.
Recherchez votre ID d'abonnement dans le tableau de bord OneSignal.
5
Envoyez une notification push de test
Si l’abonnement existe et le statut est Abonné, suivez le guide Push pour envoyer une notification.
Si rien n’apparaît, voir Notifications non affichées pour les correctifs spécifiques au navigateur.
SdkInitError: OneSignal: This web push config can only be used on … Your current origin is …
Erreur de non-concordance de l'URL du site.
Votre URL de site dans le tableau de bord OneSignal ne correspond pas à votre domaine réel.
Assurez-vous qu’elle correspond exactement au domaine que vous voyez dans le navigateur.
PushPermissionNotGrantedError: The user dismissed the permission prompt.
Le visiteur a refusé l’invite du navigateur. Elle ne réapparaîtra pas avant l’expiration d’une période de refroidissement.
Voir Invites d’autorisation Web pour les règles du navigateur ou effacez les données du site pour réessayer immédiatement.
Installing service worker failed.. 403 or 404 error
Fichier Service Worker manquant (403/404).
Assurez-vous que ce fichier est accessible (remplacez your-site.com et adaptez le nom réel du dossier du plugin s’il diffère de la valeur par défaut) :
https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.jsSi ce n’est pas le cas, voir Support de plugins courants pour corriger les problèmes de CDN ou de cache.
Les CDN et les plugins de cache peuvent bloquer les fichiers requis par OneSignal. Les chemins ci-dessous supposent que le répertoire du plugin est onesignal-free-web-push-notifications ; ajustez si votre installation utilise un nom de dossier différent.
WP Engine peut réécrire les URLs des plugins via son CDN. Les règles de Traitement post-HTML sont spécifiques à chaque environnement ; l’extrait ci-dessous est fourni à titre d’exemple uniquement——confirmez les chemins avec le support WP Engine ou votre Portail Utilisateur avant de les appliquer.Dans WP Engine plugin > Paramètres généraux > Traitement post-HTML, vous aurez peut-être besoin de règles similaires aux suivantes. Remplacez chaque espace réservé par les valeurs de votre site et du nom d’hôte CDN WP Engine :
Espace réservé
Remplacer par
YOURSITEHERE
Votre domaine nu (segment regex), ex. example pour example.com
mywpenginehandleHere
Le nom de votre installation WP Engine (sous-domaine avant .wpengine.com)
wpengineCDNpathHere
Votre segment de chemin NetDNA / CDN de WP Engine (souvent visible dans les URLs CDN)
mywebsiteHere
L’origine de votre site actif sans chemin, ex. https://example.com
Allez dans Hummingbird > Optimisation des ressources. Sous JavaScript (et CSS si les ressources OneSignal y apparaissent), repérez les fichiers dont les URLs contiennent onesignal-free-web-push-notifications ou OneSignalSDK. Excluez-les de la minification/combinaison/différement, ou basculez ces ressources en optimisation Ne pas charger pour que le plugin ne les réécrive ni ne les retarde.
<Files *.php>Order allow,denyDeny from all</Files><Files OneSignalSDKWorker.js.php>Allow from allForceType 'application/javascript; charset=UTF-8'</Files><Files OneSignalSDKWorker.js>Allow from allForceType 'application/javascript; charset=UTF-8'</Files>
Apache 2.4+ utilise souvent Require all denied / Require all granted au lieu de Order allow,deny. Renseignez-vous auprès de votre hébergeur ou adaptez les règles à la version d’Apache de votre serveur.
Ralentissements du serveur ou site inaccessible après l’envoi de notifications
Si votre serveur subit des ralentissements ou devient inaccessible après l’envoi de notifications, c’est souvent dû à une charge accrue provenant des ressources de notification ou à des ressources serveur limitées.
Évitez d’auto-héberger les images utilisées dans les notifications. Lorsque vous hébergez vos propres icônes ou images de notification, votre serveur peut être surchargé car le navigateur de chaque destinataire tente de récupérer l’image en même temps qu’une notification est envoyée.
Pour réduire la charge du serveur, utilisez des solutions d’hébergement d’images ou des services CDN optimisés pour un accès à forte concurrence.
Envisagez de mettre à niveau les ressources d’hébergement
Si les problèmes de serveur persistent, vous devrez peut-être :
Mettre à niveau votre plan d’hébergement : Une bande passante plus élevée ou un hébergement plus puissant peut être nécessaire pour gérer les envois de notifications à grande échelle.
Consulter votre fournisseur d’hébergement : Votre fournisseur peut offrir des informations ou des optimisations spécifiques à votre environnement d’hébergement.
