Passer au contenu principal

​
Problèmes de configuration courants

​
Vérifiez votre configuration du tableau de bord OneSignal

Assurez-vous d’avoir complété chaque étape du guide de configuration WordPress :
  • Sélectionnez l’option Plugin WordPress lors de la création de votre application OneSignal
  • Votre URL de site doit correspondre exactement à l’URL du navigateur
    • Par exemple, https://example.com n’est pas identique à https://www.example.com. Utilisez une version de manière cohérente.
    • Une seule origine de site est prise en charge pour le push. Voir Politique de même origine.
  • Assurez-vous d’avoir ajouté au moins une invite d’autorisation.

​
N’ajoutez pas le code OneSignal manuellement

Le plugin WordPress OneSignal inclut automatiquement le script d’initialisation et le Service Worker. ✅ Cela signifie :
  • Vous ne devez pas ajouter manuellement du code JavaScript OneSignal dans votre thème, pied de page ou autres plugins.
❌ Si vous souhaitez utiliser la Configuration de code personnalisé, désinstallez d’abord le plugin WordPress pour éviter les conflits.

​
Comment dépanner votre site

1

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

Collez ceci dans la console :
OneSignal.User.PushSubscription.id
Si vous êtes abonné, cela retourne une chaîne (votre ID d’abonnement).

Trouvez votre ID d'abonnement OneSignal dans la console.

4

Vérifiez l'ID d'abonnement dans le tableau de bord OneSignal

Allez dans OneSignal.com > Audience > Abonnements 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.

​
Erreurs de console OneSignal courantes

​
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.

​
The OneSignal web SDK can only be initialized once.

Erreur d'initialisation en double de OneSignal.

Vous chargez OneSignal deux fois. Supprimez le code OneSignal ajouté manuellement si vous utilisez le plugin.

​
Installing service worker failed.. 403 or 404 error

Fichier Service Worker manquant (403/404).

Assurez-vous que ce fichier est accessible : https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js Si ce n’est pas le cas, voir Support de plugins courants pour corriger les problèmes de CDN ou de cache.

​
Support de plugins courants

Les CDN et les plugins de cache peuvent bloquer les fichiers requis par OneSignal. Utilisez ces paramètres spécifiques aux plugins :

​
Autoptimize

Dans Scripts exclus, ajoutez : 
wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/(.*)

​
WP Rocket

Sous CDN > Exclure les fichiers du CDN, ajoutez : 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)

​
LiteSpeed Cache

Sous CDN > Exclure le chemin, ajoutez : 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
Ensuite, appuyez sur enregistrer.

​
WP Super Cache

  1. Allez dans Paramètres > WP Super Cache > CDN
  2. Dans Exclure si sous-chaîne, incluez : onesignal-free-web-push-notifications
  3. Cliquez sur Contenu > Supprimer le cache

​
WP Engine

Dans WP Engine plugin > Paramètres généraux > Traitement post-HTML, ajoutez ceci, en remplaçant YOURSITEHERE :
text
#https?://(www\.)?(YOURSITEHERE\.com|mywpenginehandleHere.wpengine.com|wpengineCDNpathHere.wpengine.netdna-(ssl|cdn).com)/wp-(content|includes)#
=> https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-$4
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-content/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/

​
W3 Total Cache

  1. Allez dans Performance > CDN
  2. Sous Fichiers rejetés, ajoutez :
{plugins_dir}/onesignal-free-web-push-notifications/sdk_files/*

Paramètres d'exclusion W3 Total Cache.

​
BunnyCDN

Excluez onesignal dans les chemins CDN exclus du plugin.

Exemple d'exclusion BunnyCDN.

​
CDN Enabler

Dans Paramètres > CDN Enabler, ajoutez ceci aux “Exclusions” : 
onesignal-free-web-push-notifications

​
PressCDN

Dans Exclure les répertoires, ajoutez : 
/wp-content/plugins/onesignal-free-web-push-notifications/

​
Breeze

Dans Paramètres > CDN > Exclure le contenu, ajoutez : 
/onesignal-free-web-push-notifications/sdk_files/

Exemple d'exclusion Breeze.

​
Hummingbird Pro

Allez dans Optimisation des ressources, trouvez le fichier SDK OneSignal et retirez-le de l’optimisation.

Optimisation des ressources Hummingbird Pro.

​
Sucuri

Suivez le guide de liste blanche de Sucuri pour autoriser les fichiers OneSignal.

​
Plugin iThemes Security

Désactivez l’option “Désactiver PHP dans les plugins” sous Ajustements système.

Paramètre de plugin PHP iThemes.

​
Plugin Defender Security

N’activez pas “Empêcher l’exécution de PHP”. Allez dans Plugin Defender > Ajustements de sécurité et vérifiez que le paramètre est désactivé.

​
Exemple .htaccess pour l’accès au Service Worker

html
<Files *.php>
Order allow,deny
Deny from all
</Files>
<Files OneSignalSDKWorker.js.php>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>
<Files OneSignalSDKWorker.js>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>

​
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.

​
N’hébergez pas vos propres icônes de notification

É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.