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

​

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.

​

Invites de permission

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

1

Cliquez sur Push Slide Prompt pour personnaliser

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

3

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

Pour une messagerie ciblée basée sur les intérêts des utilisateurs, configurez des catégories :

1

Sélectionnez Categories dans les paramètres de votre invite

2

Configurez chaque catégorie avec :

• Label : Ce que les utilisateurs voient dans l’invite
• Tag Key : Clé de tag interne pour la segmentation

3

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

Logique de tag : Les catégories cochées définissent la valeur du tag à 1, non cochées à 0. Ces tags permettent la messagerie ciblée vers des intérêts d’utilisateurs spécifiques.

​

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

​

Paramètres avancés

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)

​

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

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

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

1. Dans votre tableau de bord OneSignal, accédez à Audience > Subscriptions 2. Vous devriez voir votre abonnement push web marqué comme « Subscribed »

1. Accédez à Messages > Push dans votre tableau de bord OneSignal 2. Créez un New Message 3. Envoyez-vous une notification de test 4. Vérifiez que la notification s’affiche correctement Consultez notre guide de messagerie Push pour des instructions détaillées.

• 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

• 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

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

​

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é

​

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

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 »

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

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);