WordPress

​

Vue d’ensemble

​

Nouveautés de la version 3+

• 🚀 Mise à niveau du SDK : Met à jour le SDK Web OneSignal de la version 15 à 16
• 💬 Invites du tableau de bord : Configurez toutes les invites de permission directement dans le tableau de bord OneSignal, sans code personnalisé
• ⏩ Publication en un clic : Cochez « Envoyer une notification lorsque l’article est publié » pour envoyer automatiquement des notifications push
• 🧑‍🤝‍🧑 Ciblage d’audience : Choisissez quels segments reçoivent les notifications pour chaque article
• 📲 Intégration d’application mobile : Envoyez aux abonnés d’applications mobiles avec liens profonds optionnels

​

Configuration

• Un compte OneSignal (gratuit)
• Un accès administrateur WordPress pour installer et configurer les plugins
• Un site web avec HTTPS activé (requis pour les notifications push web)

​

1. Configurer WordPress dans le tableau de bord OneSignal

Sélectionnez WordPress parmi les options Website Builder dans votre tableau de bord OneSignal

​

Configuration du site

• Site Name : Le nom de votre site et le titre de notification par défaut.
• Site URL : Doit correspondre exactement à l’URL de votre site WordPress (suivez la politique de même origine)
• Auto Resubscribe : Activez cette option pour réabonner automatiquement les utilisateurs qui effacent leurs données de navigateur lorsqu’ils reviennent sur votre site (aucune nouvelle invite de permission requise)
• Default Icon URL : Fichier PNG ou JPG carré de 256x256px pour les notifications et les invites – MacOS Safari n’affichera pas d’invite de notification sans icône.

Entrez votre URL de site exacte. https://your-site.com est différent de https://www.your-site.com—utilisez un seul format de manière cohérente

​

Invites de permission

• Configuration d'invite de base
• Avancé : Segmentation par catégorie

1

Cliquez sur Push Slide Prompt pour personnaliser

Accédez et personnalisez les paramètres de votre invite push slide

2

Configurez le timing et le texte :

• Définissez Auto Prompt sur 1 page vue et 1 seconde pour les tests initiaux
  • Personnalisez le texte et l’apparence de l’invite
  • Ajustez le timing en fonction du comportement des utilisateurs après le lancement

Configurez le timing de l'invite automatique et personnalisez l'apparence de l'invite

3

Cliquez sur Done lorsque vous avez terminé de configurer l'invite.

​

Notification de bienvenue

• Remercie les utilisateurs de s’être abonnés
• Démontre comment les notifications apparaissent
• Augmente l’engagement et réduit les désabonnements

​

2. Configurer le plugin WordPress

Copiez votre App ID et votre API Key depuis le tableau de bord OneSignal

Assurez-vous que l'App ID et la REST API Key de votre plugin WordPress correspondent exactement à votre tableau de bord OneSignal

​

Paramètres avancés

Paramètres avancés pour des fonctionnalités améliorées et le suivi analytique

utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin

utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots

• Custom Post Types : Ajoutez des types de publication depuis des plugins pour activer les options de notification
• Automatically send notifications when a post is published : Coche automatiquement la case de notification lors de la publication d’articles afin que les notifications soient envoyées sans avoir à cocher la case manuellement
• Automatically send notifications when a post is updated : Coche automatiquement la case de notification lors de la mise à jour d’articles afin que les notifications soient envoyées sans avoir à cocher la case manuellement
• Automatically send notifications when a page is published : Coche automatiquement la case de notification lors de la publication de pages afin que les notifications soient envoyées sans avoir à cocher la case manuellement
• Automatically send notifications when a page is updated : Coche automatiquement la case de notification lors de la mise à jour de pages afin que les notifications soient envoyées sans avoir à cocher la case manuellement
• Automatically send a push notification when I publish a post from 3rd party plugins : Envoi automatique de notifications depuis des plugins de publication externes
• Mobile App Integration : Envoyez des notifications aux abonnés de votre application mobile en utilisant le même App ID OneSignal

​

3. Terminer la migration (utilisateurs en mise à niveau uniquement)

Cliquez sur Migration Completed pour finaliser la mise à niveau de votre plugin

​

Tester votre configuration

• Test initial
• Vérifier l'abonnement
• Envoyer un message de test

1. Visitez votre site web (évitez la navigation privée/incognito—les utilisateurs ne peuvent pas s’abonner dans ces modes) 2. Recherchez l’invite slidedown que vous avez configurée

Votre invite slidedown configurée devrait apparaître en fonction de vos paramètres de timing

3. Cliquez sur le bouton d’abonnement (étiqueté « Subscribe » dans cet exemple)
4. Acceptez la permission du navigateur lorsqu’elle est demandée

L'invite de permission du navigateur (l'apparence varie selon le navigateur) est requise pour les notifications push web

5. Vérifiez la notification de bienvenue (si configurée)

La notification de bienvenue apparaît immédiatement après un abonnement réussi

• Consultez Invites de permission web pour une personnalisation avancée
• Explorez Configuration des canaux pour l’intégration email et SMS
• Configurez des stratégies de segmentation pour une messagerie ciblée

​

Publier des notifications

​

Notifications d’articles de base

Metabox OneSignal Push Notifications—faites glisser pour repositionner si nécessaire

• Cochez « Send notification when post is published or updated »
• Décochez pour ignorer l’envoi d’une notification pour cet article

​

Ciblage d’audience

​

Envoyer à tous les abonnés (par défaut)

​

Envoyer à des segments spécifiques

1. Accédez à Audience > Segments dans votre tableau de bord OneSignal
2. Créez des segments en utilisant vos clés de tag, par exemple :
   • Segment Actualités : Tag news est 1
   • Segment Offres : Tag deals est 1

Les tags sont sensibles à la casse ! 'news' et 'News' sont des tags différents

3. Après avoir créé les segments, actualisez votre éditeur d’article WordPress
4. Sélectionnez votre segment cible dans le menu déroulant

Sélectionnez des segments spécifiques pour cibler des groupes d'utilisateurs pertinents

​

Personnaliser le contenu des notifications

​

Comportement par défaut

• Title : Utilise le titre de votre site WordPress (Settings > General)
• Message : Utilise le titre de l’article
• Image : Utilise l’image mise en avant de l’article (si définie)
• URL : Renvoie vers l’article publié

​

Contenu personnalisé

Personnalisez le titre, le contenu et d'autres éléments de notification

Notification push personnalisée telle qu'elle apparaît aux utilisateurs

​

Ajouter un type de publication personnalisé au plugin OneSignal WordPress

​

Trouver le nom de votre type de publication personnalisé

https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type

​

Ajouter aux paramètres OneSignal

1. Accédez à OneSignal > Settings dans l’admin WordPress
2. Dans Advanced Settings, ajoutez les noms de vos types de publication personnalisés au champ Custom Post Types
3. Enregistrez les paramètres

​

Intégration d’application mobile

1. Activez « Send notification to Mobile app subscribers » dans les paramètres du plugin
2. Dans la metabox de l’article, ajoutez une Mobile URL pour les liens profonds
3. Les utilisateurs mobiles seront dirigés vers votre application au lieu du navigateur web

​

FAQ

Comment désactiver les invites sur des pages spécifiques ?

Remarque : Cette méthode fonctionne uniquement avec les invites slidedown et de permission native, pas avec les invites cloche ou lien personnalisé.

1. Dans votre tableau de bord OneSignal, accédez à Settings > Push & In-App > Web Settings
2. Sélectionnez votre invite dans le tableau Permission Prompt Setup
3. Décochez Auto Prompt et cliquez sur Done

Désactivez Auto Prompt pour contrôler manuellement quand les invites apparaissent

4. Faites défiler vers le bas, cliquez sur Save, puis sur Finish
5. Ajoutez du code JavaScript personnalisé aux pages spécifiques où vous souhaitez que les invites apparaissent

Cela vous donne un contrôle total sur le timing et le placement des invites. Consultez Invites de permission web pour les détails d’implémentation.

Pourquoi mes invites ne fonctionnent-elles pas après la migration ?

Problèmes de cache : Le cache WordPress peut retarder les modifications de migration.Solution :Étape 1 : Faites un clic droit sur votre site web et sélectionnez InspectÉtape 2 : Accédez à l’onglet NetworkÉtape 3 : Cochez « Disable cache »

Désactivez le cache du navigateur pour forcer le chargement des fichiers mis à jour après la migration

Étape 4 : Actualisez votre site web pour voir la configuration actuelleÉtape 5 : Videz les paramètres de votre plugin de cache WordPress si applicable

Que signifie l'erreur `A bad HTTP response code (404)` ?

Cette erreur indique une migration incomplète :

L'erreur 404 dans la console du navigateur indique un processus de migration incomplet

Solution :

1. Assurez-vous d’avoir enregistré la configuration de votre tableau de bord OneSignal
2. Dans WordPress, cliquez sur « Migration Completed » dans les paramètres du plugin
3. Cliquez sur Save Settings pour finaliser la mise à niveau

Cette erreur n’affecte que les utilisateurs effectuant une mise à niveau depuis la version 2.x.x.

<?php

add_filter('onesignal_send_notification', function($fields, $post_id) {

  // Include any properties mentioned in the Create Notification API Reference:
  // https://documentation.onesignal.com/reference/push-notification eg:

  // Add action buttons
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Read More",
      "url" => get_permalink($post->ID)
    )

  // Return the modified fields array
  return $fields;

}, 10, 2);