Prérequis
- Site web WordPress avec accès administrateur
- HTTPS activé (requis pour les notifications push web)
- Compte OneSignal (gratuit sur onesignal.com)
Étape 1 : Choisir l’intégration
Créez votre compte OneSignal sur onesignal.com. Si ce n’est pas votre première application, sélectionnez Nouvelle application/site web, nommez votre application, sélectionnez Web et cliquez sur “Suivant”.

Étape 2 : Configuration du site
Configurez les informations de votre site avec soin car ces paramètres affectent toutes les notifications :
| Champ | Description | Exigences |
|---|---|---|
| Nom du site | Nom par défaut affiché dans les notifications push | Restez concis pour un meilleur affichage |
| URL du site | L’URL complète de votre site web | Doit inclure http:// ou https:// et correspondre à votre format d’URL réel |
| Réabonnement automatique | Réabonne automatiquement les utilisateurs qui reviennent (HTTPS uniquement) | Recommandé - Réduit les frictions pour les utilisateurs qui ont effacé les données du navigateur |
| URL de l’icône par défaut | Icône pour les invites et les notifications | Doit être HTTPS, carré de 256x256 pixels, format PNG/JPG/GIF |
Format d’URL important : Assurez-vous que votre URL de site correspond exactement à la façon dont les utilisateurs accèdent à votre site. Des URL incompatibles (www vs non-www, http vs https) peuvent causer des problèmes d’abonnement.
Étape 3 : Paramètres push avancés (optionnel)
OneSignal fournit des certificats push web Safari sans frais. Ne téléchargez des certificats personnalisés que si vous avez des exigences spécifiques.
- Vous avez des certificats Safari existants
- Votre organisation nécessite une gestion spécifique des certificats
- Vous avez besoin d’une marque de certificat personnalisée
Étape 4 : Configurer le plugin WordPress
Installer le plugin
Ajoutez le plugin WordPress OneSignal depuis votre administration WordPress ou en recherchant “OneSignal” dans le répertoire des plugins.Configurer les clés API
Copiez votre ID d’application et votre clé API depuis le tableau de bord OneSignal :

Activer les invites push
Activez l’invite de glissement et la cloche d’abonnement pour demander l’autorisation aux visiteurs :

Étape 5 : Tester votre configuration
Vérifier l’installation
- Visitez votre site web (vous devrez peut-être vider les plugins de cache)
- Recherchez l’invite de glissement OneSignal et la cloche d’abonnement
- Abonnez-vous pour tester le flux
- Vérifiez Tableau de bord OneSignal → Audience → Utilisateurs pour confirmer votre abonnement
Envoyer une notification de test
Naviguez vers Tableau de bord OneSignal → Messages → Nouveau push pour envoyer votre première notification et vérifier que tout fonctionne.Dépannage : Si les invites n’apparaissent pas, vérifiez que les notifications push sont activées dans les paramètres de votre appareil et essayez de vider le cache de votre navigateur.
Étape 6 : Configurer les invites de notification
Configurez comment et quand les utilisateurs voient les invites d’abonnement dans la section Configurer :Cloche d’abonnement
Une icône persistante (généralement dans le coin) que les utilisateurs peuvent cliquer à tout moment pour gérer leur statut d’abonnement.Invite de glissement
Une boîte de dialogue modale qui apparaît en fonction de vos paramètres de timing pour demander l’autorisation. Prochaines étapes : Les utilisateurs souhaitent généralement personnaliser le timing et l’apparence des invites. Consultez la section Personnalisations avancées ci-dessous.Étape 7 : Notifications automatiques d’articles
Configuration de base
Lors de la création d’articles, vous verrez une section OneSignal. Cochez Envoyer une notification lors de la publication de l’article pour notifier les abonnés :
Activer automatiquement les notifications
Pour cocher automatiquement cette case pour tous les nouveaux articles :- Allez dans OneSignal Push → Paramètres de notification automatique
- Activez Envoyer automatiquement une notification push lorsque je crée un article
- Enregistrez les paramètres

Notifications de bienvenue
Configurez des messages de bienvenue optionnels envoyés immédiatement après l’abonnement des utilisateurs. Modifiez ou désactivez-les dans la section Configurer de votre plugin.Limitation de débit : Plusieurs notifications pour le même article sont limitées à une par minute pour éviter le spam.
Personnalisations avancées
Le plugin WordPress OneSignal charge notre SDK push web avec vos options configurées. Vous pouvez utiliser n’importe quelle API JavaScript du SDK push web pour personnaliser davantage l’expérience.Note pour les développeurs : Cette section nécessite des connaissances en JavaScript et PHP. Si vous avez besoin d’aide pour ajouter du code à votre site, envisagez d’utiliser des plugins comme Insert Headers and Footers ou Custom CSS & JS.
Personnalisation des invites d’abonnement
Configuration avancée des invites
Pour une personnalisation sophistiquée des invites incluant des délais, des catégories et la collecte d’e-mails :Étape 1 : Désactiver les invites par défaut
Dans Plugin WordPress OneSignal → Paramètres d’invite, désactivez l’invite de glissement et l’invite native (vous pouvez garder la cloche activée).
Étape 2 : Activer l’initialisation manuelle
Faites défiler jusqu’à Paramètres avancés et activez “Désactiver l’initialisation OneSignal”, puis Enregistrer.
Étape 3 : Ajouter du JavaScript personnalisé
Ajoutez ce code à votre site (après le délai de 3 secondes montré dans les exemples) :Invites spécifiques à une page
Méthode PHP côté serveur
Utilisez le filtreonesignal_initialize_sdk pour contrôler l’initialisation en fonction des propriétés de la page.
Méthode JavaScript côté client
Activez “Désactiver l’initialisation OneSignal” et ajoutez du JavaScript conditionnel pour initialiser OneSignal uniquement sur des pages spécifiques.Invites multilingues
Pour les sites monolingues, traduisez simplement le texte dans la configuration de l’invite. Pour les sites multilingues, utilisez la méthode d’initialisation manuelle ci-dessus et détectez la langue de la page pour afficher le texte approprié.Segmentation et ciblage des utilisateurs
Marquer les utilisateurs
Catégorisez les utilisateurs avec des tags de données pour envoyer des notifications ciblées :Cibler les segments
Créez des segments dans votre tableau de bord OneSignal en utilisant des filtres Tag utilisateur, puis ciblez-les avec le filtreonesignal_send_notification :
Images en vedette dans les notifications
Activer la prise en charge des images en vedette
Assurez-vous que votre thème prend en charge les images en vedette. Vérifiez le fichierfunctions.php de votre thème pour :
Configurer les paramètres d’image
Dans OneSignal Push → Paramètres de notification envoyée, activez les options d’image en vedette souhaitées :
Intégration de plugin tiers
Types d’articles standard
Activez Envoyer automatiquement une notification push lorsque je publie un article depuis des plugins tiers pour les types d’articles standard.
Types d’articles personnalisés
Ajoutez des types d’articles personnalisés (séparés par des virgules) au champ Types d’articles personnalisés supplémentaires :
https://votresite.com/wp-admin/post-new.php?post_type=votre_type_personnalise
Le paramètre post_type indique le nom à ajouter.
Intégration d’application mobile
Méthode 1 : Ouverture simple du navigateur web
Activez Envoyer des notifications supplémentairement aux plateformes iOS et Android dans les paramètres de votre plugin WordPress.
Méthode 2 : Liens profonds
Pour un comportement d’application mobile personnalisé, désactivez le paramètre ci-dessus et utilisez ce code PHP :Hooks et filtres du plugin WordPress
Emplacement du code
Placez le code PHP personnalisé dans
wp-content/mu-plugins/ pour éviter qu’il ne soit écrasé lors des mises à jour.wp-content/mu-plugins/onesignal-custom.php avec votre code personnalisé.
onesignal_send_notification
Modifiez les paramètres de notification avant l’envoi :onesignal_initialize_sdk
Contrôlez quand OneSignal s’initialise :onesignal_include_post
Forcez les notifications pour des types d’articles spécifiques :onesignal_meta_box_send_notification_checkbox_state
Contrôlez l’état par défaut de la case à cocher de notification :Sites mixtes WordPress/non-WordPress
Pour les sites avec des pages WordPress et non-WordPress :- Utilisez la configuration de code personnalisé dans le tableau de bord OneSignal
- Ajoutez ce code aux pages non-WordPress :
Dépannage
Problèmes courants
Erreur “No Recipients” (Aucun destinataire)
- Cause : Tentative d’envoi de plusieurs notifications pour le même article trop rapidement
- Solution : Attendez au moins une minute entre les notifications pour le même article
Les invites n’apparaissent pas
- Cause : Plugins de cache, paramètres du navigateur ou problèmes d’initialisation
- Solutions :
- Videz tous les plugins de cache
- Vérifiez les autorisations de notification du navigateur
- Vérifiez que HTTPS est activé
- Confirmez que la configuration du plugin est enregistrée
Avertissement “Couldn’t load wp.data”
- WordPress 5+ avec Gutenberg : Peut indiquer des problèmes de configuration - contactez le support
- WordPress 4.x : Peut être ignoré en toute sécurité - cet avertissement n’affecte pas la fonctionnalité
Les types d’articles personnalisés ne fonctionnent pas
- Cause : Métadonnées requises manquantes
- Solution : Utilisez le filtre
onesignal_include_postpour inclure explicitement votre type d’article
Les notifications ne se planifient pas
- Cause : Cron WordPress ou conflits de thème
- Solutions :
- Utilisez le tableau de bord OneSignal ou l’API pour la planification
- Implémentez une planification personnalisée avec le filtre
onesignal_send_notification - Utilisez l’intégration Zapier pour l’automatisation
Entrées de base de données
OneSignal crée ces entrées dans votre tablewp_postmeta :
| Entrée | Description |
|---|---|
onesignal_meta_box_present | Confirme que OneSignal était actif lors de la publication de l’article |
onesignal_send_notification | Suit l’envoi de notification |
status | Statut HTTP de la notification (200 = succès) |
response_body | Réponse API avec ID de notification et nombre de destinataires |
recipients | Nombre d’utilisateurs qui ont reçu la notification |
Obtenir de l’aide
- Problèmes de plugin : Consultez Dépannage du push web WordPress
- Support général : Contactez
support@onesignal.com - Source du plugin : Disponible sur GitHub
Prochaines étapes
Après avoir terminé cette configuration :- Surveiller les performances : Vérifiez régulièrement votre tableau de bord OneSignal pour la croissance des abonnés et les métriques d’engagement
- Optimiser les invites : Expérimentez avec différents timings et messages d’invite
- Segmenter les utilisateurs : Implémentez le marquage pour envoyer des notifications plus ciblées
- Tester minutieusement : Envoyez des notifications de test à différents appareils et navigateurs
- Planifier la stratégie de contenu : Développez une stratégie de notification qui ajoute de la valeur sans surcharger les utilisateurs