> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration du plugin OneSignal WordPress pour le push web

> Installez et configurez le plugin OneSignal WordPress v3+ pour les notifications push web, avec les étapes de configuration et la migration 2.x.

## Vue d'ensemble

Ce guide explique comment configurer le plugin OneSignal WordPress Web Push v3+.

> [!NOTE]
>
> Pour la documentation de l'ancienne version 2.x.x de WordPress, consultez le [plugin WordPress Legacy](./wordpress-legacy).

### Nouveautés de la version 3+

Cette version marque une mise à niveau importante en simplifiant le processus de configuration. Avec la version 3+, vous pouvez gérer tous les paramètres d'invite depuis un seul endroit : le tableau de bord OneSignal.

* 🚀 **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](https://documentation.onesignal.com/docs/fr/permission-requests.md) directement dans le tableau de bord OneSignal, sans code personnalisé
* ⏩ **Publication en un clic** : Cochez « Send notification when post is published » pour envoyer automatiquement des notifications push
* 🧑‍🤝‍🧑 **Ciblage d'audience** : Choisissez quels [segments](https://documentation.onesignal.com/docs/fr/segmentation.md) reçoivent les notifications pour chaque article
* 📲 **Intégration d'application mobile** : Envoyez aux abonnés d'applications mobiles avec [liens profonds](https://documentation.onesignal.com/docs/fr/deep-linking.md) optionnels

***

## Configuration

Avant de commencer, assurez-vous d'avoir :

* Un [compte OneSignal](https://dashboard.onesignal.com/signup) (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

Accédez à **Settings > Push & In-App > Web > WordPress Plugin or Website Builder**

![Configuration du canal web du tableau de bord OneSignal avec WordPress sélectionné](https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-integration-selection.png?fit=max\&auto=format\&n=sCO1i1UqrWQxmZ28\&q=85\&s=d48170c90c2d9e309769c430c1f8336d)

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](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy))
* **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, JPG ou GIF non animé carré de `256×256` pour les notifications et les invites. Consultez [Icônes de notification](https://documentation.onesignal.com/docs/fr/notification-icons.md#web-notification-icons).

![Champs Site URL et icône par défaut du canal web OneSignal](https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png?fit=max\&auto=format\&n=jFWn5xzleD8du3j6\&q=85\&s=535d1d4b6d579d0d296fbed60d5d669b)

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

> [!NOTE]
>
> Tests en local ? Consultez le [guide de test local](https://documentation.onesignal.com/docs/fr/web-sdk-setup.md#local-testing) pour le développement localhost

#### Invites de permission

Configurez vos [invites de permission](https://documentation.onesignal.com/docs/fr/permission-requests.md) pour Push, Email et/ou SMS. L'invite Push Slide est activée par défaut, mais vous pouvez la personnaliser ou ajouter des invites supplémentaires.

> [!NOTE]
>
> **Conseil de pro** : Commencez avec des invites simples et ajoutez progressivement de la complexité. Vous pouvez
> modifier tous les paramètres d'invite à tout moment via le tableau de bord OneSignal. Explorez
> toutes les options disponibles dans [Invites de permission web](https://documentation.onesignal.com/docs/fr/permission-requests.md).

> [tab] Configuration d'invite de base
>
> **1. Cliquez sur Push Slide Prompt pour personnaliser**
>
> ![Liste des invites de permission du tableau de bord avec Push Slide Prompt sélectionnée](https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png?fit=max\&auto=format\&n=_KaXe4GQkxsEfa17\&q=85\&s=fffa465720f34780e7c22b047a57ca4e)
>
> 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
>
> ![Éditeur d'invite slidedown affichant le délai de l'invite automatique et les champs de texte](https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png?fit=max\&auto=format\&n=_KaXe4GQkxsEfa17\&q=85\&s=33f5eb55da0cee00d1d8121bb3f66f89)
>
> 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.**

> [tab] Avancé : Segmentation par catégorie
>
> 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](https://documentation.onesignal.com/docs/fr/add-user-data-tags.md) interne pour la segmentation
>
> **3. Cliquez sur Done lorsque vous avez terminé de configurer l'invite.**
>
> ![Configuration d'invite par catégorie avec les labels News et Deals et les clés de tag](https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png?fit=max\&auto=format\&n=_KaXe4GQkxsEfa17\&q=85\&s=3d0d41386891b9b84ed2619da519206d)
>
> Exemple : La configuration des catégories Actualités et Offres crée les tags 'news: 1' et 'deals: 1' pour les utilisateurs qui cochent ces options
>
> **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

Configurez une notification immédiate envoyée après la première inscription des utilisateurs. Cela :

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

Configurez le texte et le timing de votre message de bienvenue, puis faites défiler vers le bas et cliquez sur **Save**.

> [!TIP]
>
> Ignorez la section **Advanced Push Settings** dans le tableau de bord OneSignal. Ces champs (y compris le chemin du service worker) sont destinés aux configurations [Typical Site ou Custom Code](https://documentation.onesignal.com/docs/fr/web-sdk-setup.md), pas à ce plugin. Cliquez sur **Save** pour continuer.

### 2. Configurer le plugin WordPress

Après avoir enregistré la configuration de votre tableau de bord, vous verrez votre **App ID** et votre **API Key** (la même clé REST API documentée dans [Keys & IDs](https://documentation.onesignal.com/docs/fr/keys-and-ids.md)). Copiez ces valeurs dans votre plugin WordPress :

![Page des clés OneSignal affichant l'App ID et la REST API Key pour WordPress](https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-app-id-and-api-key.png?fit=max\&auto=format\&n=sCO1i1UqrWQxmZ28\&q=85\&s=90643a5aafc920c3785b42a093ae1773)

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

> [!NOTE]
>
> **Vous ne voyez pas de clé API ?** Suivez notre [guide Keys & IDs](https://documentation.onesignal.com/docs/fr/keys-and-ids.md) pour
> en créer une.

**1. Dans votre admin WordPress, accédez aux paramètres du plugin OneSignal**

**2. Collez l'App ID et la REST API Key exactement comme indiqué dans votre tableau de bord**

![Paramètres du plugin WordPress OneSignal avec les champs App ID et REST API Key](https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png?fit=max\&auto=format\&n=9_Q1FZLh6C0BFLq-\&q=85\&s=ba2996eacb58d914c34edc5884e5abb1)

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

Configurez des options de plugin supplémentaires selon vos besoins :

![Paramètres avancés du plugin WordPress OneSignal et suivi des paramètres URL](https://mintcdn.com/onesignal/bqiNDj5j2mpssdoy/images/push/wordpress-advanced-settings.png?fit=max\&auto=format\&n=bqiNDj5j2mpssdoy\&q=85\&s=a6142c3df995140d2927cbc7c6058149)

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

**Suivi des paramètres URL**

Ajoutez des paramètres analytiques aux URL de notification pour le suivi. **Important** : Échappez les caractères spéciaux—la saisie est ajoutée telle quelle aux URL.

**Exemple pour Google Analytics :**

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

**Exemple avec caractères spéciaux :**

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

**Paramètres supplémentaires**

* **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

#### Service worker

Le plugin héberge et enregistre le service worker pour vous. Vous n'avez pas à téléverser `OneSignalSDKWorker.js` à la racine de votre site, ni à définir un chemin personnalisé dans le tableau de bord ou dans `OneSignal.init()`.

La version 3+ sert un fichier JavaScript simple depuis le répertoire `sdk_files` du plugin. Il importe le worker du CDN :

```javascript theme={null}
importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");
```

Les installations depuis WordPress.org utilisent cette URL (nom de dossier `onesignal-free-web-push-notifications`) :

`https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js`

Si vous avez installé le plugin depuis un fichier zip, le dossier du plugin peut différer (par exemple `OneSignal-WordPress-Plugin`). Vérifiez **Plugins** dans wp-admin ou regardez sous `wp-content/plugins/`, puis utilisez ce nom de dossier dans le chemin.

Ne suivez pas les étapes de téléversement à la racine ou de chemin personnalisé du [service worker OneSignal](https://documentation.onesignal.com/docs/fr/onesignal-service-worker.md) tant que le plugin est installé. Ces instructions concernent uniquement Typical Site et Custom Code.

Si vous avez besoin d'un emplacement de worker personnalisé ou d'un contrôle complet sur `init`, cela implique de passer à la [configuration Custom Code](https://documentation.onesignal.com/docs/fr/web-push-custom-code-setup.md) : désinstallez d'abord le plugin. Ce n'est pas un paramètre au sein de l'intégration WordPress.

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

> [!NOTE]
>
> **Les nouvelles installations peuvent ignorer cette étape. Si vous effectuez une mise à niveau depuis la v2+, suivez
> les instructions...**

> [!WARNING]
>
> **Urgent** : Complétez ces étapes dès que possible pour éviter que les utilisateurs ne manquent des
> notifications pendant la transition.

**1. Après avoir enregistré la configuration de votre tableau de bord OneSignal, retournez sur WordPress**

**2. Cliquez sur Migration Completed dans les paramètres du plugin**

**3. Cliquez sur Save Settings pour finaliser la mise à niveau**

![Case à cocher Migration Completed du plugin WordPress OneSignal et enregistrement des paramètres](https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png?fit=max\&auto=format\&n=ciRrThfP6xMpI7GY\&q=85\&s=2d55f565db10c116fed39ca3f5930cb4)

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

> [!TIP]
>
> Configuration terminée ! Cliquez sur **Save Settings** pour finaliser la configuration du plugin.

***

## Tester votre configuration

> [tab] Test initial
>
> 1. **Visitez votre site web** dans une fenêtre normale (non privée) pour le test le plus fiable. La navigation privée peut afficher les invites mais les abonnements ne persistent souvent pas—consultez le [dépannage WordPress](https://documentation.onesignal.com/docs/fr/troubleshooting-wordpress-web-push.md).
>
> 2. **Recherchez l'invite slidedown** que vous avez configurée.
>
>    ![Site web affichant l'invite d'abonnement slidedown OneSignal](https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png?fit=max\&auto=format\&n=jBdBk5XvQR5eKOks\&q=85\&s=d937481d712d3340ba8ef9b25a274901)
>
>    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.
>
>    ![Invite native de permission de notification du navigateur Autoriser Bloquer](https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png?fit=max\&auto=format\&n=KSCNwSpBCNSQ8xdF\&q=85\&s=60785d5a04fe7f2f5450fb05b414d5ee)
>
>    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).
>
>    ![Bureau affichant une notification push de bienvenue de OneSignal](https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png?fit=max\&auto=format\&n=tNi1OgLc_p9hiq7_\&q=85\&s=d9575a52cb6bfdb1ae770daf3bb82ed2)
>
>    La notification de bienvenue apparaît immédiatement après un abonnement réussi

> [tab] Vérifier l'abonnement
>
> 1. Dans votre tableau de bord OneSignal, accédez à **Audience > Subscriptions**.
> 2. Vous devriez voir votre [abonnement](https://documentation.onesignal.com/docs/fr/subscriptions.md) push web marqué comme **Subscribed**.
>
>    ![Tableau Audience Subscriptions de OneSignal avec une entrée push web abonnée](https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png?fit=max\&auto=format\&n=4HyuQPBpu-4xjmQC\&q=85\&s=b8152e5f84b8bcdda32888268bbede00)
>
>    Les abonnements réussis apparaissent dans l'audience de votre tableau de bord OneSignal

> [tab] Envoyer un message de test
>
> 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](https://documentation.onesignal.com/docs/fr/push.md) pour des instructions détaillées.

> [!TIP]
>
> **Succès !** Votre site WordPress est maintenant configuré pour les notifications push web.
> Les utilisateurs commenceront à apparaître dans vos Subscriptions lorsqu'ils s'abonnent.

**Prochaines étapes :**

* Consultez [Invites de permission web](https://documentation.onesignal.com/docs/fr/permission-requests.md) pour une personnalisation avancée
* Explorez [Configuration des canaux](https://documentation.onesignal.com/docs/fr/channel-setup.md) pour l'intégration email et SMS
* Configurez des [stratégies de segmentation](https://documentation.onesignal.com/docs/fr/segmentation.md) pour une messagerie ciblée

> [!NOTE]
>
> **Vous rencontrez des problèmes ?** Consultez notre [guide de dépannage
> WordPress](https://documentation.onesignal.com/docs/fr/troubleshooting-wordpress-web-push.md) pour des solutions courantes.

***

## Publier des notifications

Lorsque vous planifiez la publication d'un article, OneSignal planifie également l'envoi d'une notification push à vos abonnés à l'heure planifiée. Si vous replanifiez l'article, la notification push sera annulée et une nouvelle notification push sera planifiée pour la nouvelle heure.

Vous pouvez consulter vos notifications planifiées et annulées dans le tableau de bord OneSignal sous **Delivery > Scheduled Messages**. Consultez [Rapports de messages push](https://documentation.onesignal.com/docs/fr/push-notification-message-reports.md) pour plus de détails.

### Notifications d'articles de base

Lors de la création ou de la modification d'un article WordPress, localisez la metabox **OneSignal Push Notifications** (généralement en bas ou dans la barre latérale de l'éditeur d'article).

![Metabox OneSignal Push Notifications de l'éditeur d'article WordPress avec case à cocher d'envoi](https://mintcdn.com/onesignal/kAXbp86YqdTAbPtE/images/web-push/onesignal-push-notifications-metabox-wordpress.png?fit=max\&auto=format\&n=kAXbp86YqdTAbPtE\&q=85\&s=428a477e16f85fa50f9ff69678304340)

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

**Pour envoyer une notification :**

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

Par défaut, les notifications sont envoyées à tous les [abonnés](https://documentation.onesignal.com/docs/fr/subscriptions.md) push.

#### Envoyer à des segments spécifiques

Ciblez des audiences spécifiques en utilisant les [segments](https://documentation.onesignal.com/docs/fr/segmentation.md) que vous créez dans **OneSignal Dashboard > Audience > Segments**.

**Si vous avez configuré des invites par catégorie** dans le tableau de bord (voir **Avancé : Segmentation par catégorie** sous [Configuration](#setup)), créez les segments correspondants :

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`

![Éditeur de segment OneSignal avec des filtres de tag pour news et deals](https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png?fit=max\&auto=format\&n=Xl2NHJvxakrK4JbL\&q=85\&s=361fb5f307e412e28b1f3da26c4682d3)

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

![Menu déroulant de segments de la metabox WordPress OneSignal pour le ciblage d'audience](https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png?fit=max\&auto=format\&n=6tscVAtiSqz353kV\&q=85\&s=551c8c99851ad4fc431abf0e30084aa5)

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

> [!TIP]
>
> **Segmentation avancée** : Créez des segments basés sur le comportement des utilisateurs, la localisation,
> le type d'appareil, et plus encore. Les [Tags](https://documentation.onesignal.com/docs/fr/add-user-data-tags.md) offrent le plus de
> flexibilité pour les données utilisateur personnalisées et la personnalisation.

### Personnaliser le contenu des notifications

#### Comportement par défaut

* **Titre** : 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é

Cochez **« Customize notification content »** pour remplacer les valeurs par défaut :

![Champs de personnalisation du titre et du message de notification de la metabox WordPress OneSignal](https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png?fit=max\&auto=format\&n=_KaXe4GQkxsEfa17\&q=85\&s=8fef18d9723782c41604c358d69723ee)

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

**Exemple de résultat :**

![Exemple de notification push web personnalisée avec titre image et corps](https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png?fit=max\&auto=format\&n=RWtLFPeffHrC81wI\&q=85\&s=f1bbce88aeba84939032658beef5cf4d)

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é

Consultez la barre d'adresse de votre navigateur lors de la création d'un nouvel article. L'URL ressemblera à :

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

La valeur du paramètre `post_type` (par exemple, `your_custom_type`) est le nom exact que vous devrez ajouter dans les paramètres du plugin OneSignal.

#### 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

> [!NOTE]
>
> **Exemples courants :** `product` (WooCommerce), `tribe_events` (The Events Calendar), `portfolio`.

## Intégration d'application mobile

Si vous avez une application mobile utilisant le même App ID OneSignal :

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](https://documentation.onesignal.com/docs/fr/deep-linking.md)
3. Les utilisateurs mobiles seront dirigés vers votre application au lieu du navigateur web

> [!TIP]
>
> **Prêt à passer à l'échelle** : Explorez les [stratégies push avancées](https://documentation.onesignal.com/docs/fr/push.md) et les
> [parcours automatisés](https://documentation.onesignal.com/docs/fr/journeys-overview.md) pour des campagnes de notification
> sophistiquées.

> [!WARNING]
>
> **Les notifications n'apparaissent pas ?** Consultez notre [guide de dépannage
> push web](https://documentation.onesignal.com/docs/fr/notifications-not-shown-web-push.md) pour des solutions.

***

## FAQ

> [accordion] Dois-je téléverser un fichier service worker ?
>
> Non. Le plugin WordPress héberge `OneSignalSDKWorker.js` dans son répertoire `sdk_files` et configure le chemin pour vous. Ne téléversez pas le fichier à la racine de votre site et ne définissez pas `serviceWorkerPath` dans le code. Voir [Service worker](#service-worker).

> [accordion] 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**
>
> ![Éditeur d'invite du tableau de bord avec Auto Prompt décoché](https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png?fit=max\&auto=format\&n=0qspEXXeJ8zJbkJ-\&q=85\&s=bd44f572649f92e94a98dbe772f5973b)
>
> 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é](https://documentation.onesignal.com/docs/fr/web-sdk-reference.md#slidedown-prompts) 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](https://documentation.onesignal.com/docs/fr/permission-requests.md) pour les détails d'implémentation.

> [accordion] Puis-je envoyer des notifications aux abonnés d'applications mobiles ?
>
> Oui ! Si votre application mobile utilise le même App ID OneSignal :
>
> 1. Activez **« Send notification to Mobile app subscribers »** dans les paramètres du plugin WordPress
> 2. Lors de la publication d'articles, utilisez le champ **Mobile URL** dans la metabox OneSignal pour spécifier les liens profonds
> 3. Sans Mobile URL personnalisée, les utilisateurs seront dirigés vers votre site web
>
> Cette fonctionnalité permet la messagerie cross-plateforme depuis une seule interface WordPress.

> [accordion] Comment envoyer des emails ou des SMS depuis WordPress ?
>
> Le plugin WordPress ne prend actuellement en charge que les notifications push. Pour les emails et les SMS :
>
> 1. **Email** : Suivez notre [guide de configuration Email](https://documentation.onesignal.com/docs/fr/email-setup.md), puis utilisez les [outils de messagerie Email](https://documentation.onesignal.com/docs/fr/email-messaging.md)
> 2. **SMS** : Suivez notre [guide de configuration SMS](https://documentation.onesignal.com/docs/fr/sms-setup.md), puis utilisez les [outils de messagerie SMS](https://documentation.onesignal.com/docs/fr/sms-messaging.md)
>
> Les deux canaux peuvent être gérés depuis le même tableau de bord OneSignal aux côtés de vos notifications push.

> [accordion] 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 »**
>
> ![Onglet Network des Chrome DevTools avec Disable cache coché](https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png?fit=max\&auto=format\&n=_KaXe4GQkxsEfa17\&q=85\&s=9d7c9c09a6908cecf53578b1ba882342)
>
> 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

> [accordion] Que signifie l'erreur `A bad HTTP response code (404)` ?
>
> Cette erreur indique une migration incomplète :
>
> ![Console du navigateur affichant l'erreur bad HTTP response code 404 pour OneSignal](https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png?fit=max\&auto=format\&n=jFWn5xzleD8du3j6\&q=85\&s=5cb3f5dac155fe97a0a1b3051a138242)
>
> 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.**

> [accordion] Puis-je modifier les paramètres de notification avant l'envoi ?
>
> Oui, vous pouvez utiliser le filtre `onesignal_send_notification`.
>
> > [!NOTE]
> >
> > Placez le code PHP personnalisé dans `wp-content/mu-plugins/onesignal-custom.php`. Cela
> > garantit qu'il se charge correctement et évite qu'il soit écrasé par les mises à jour.
>
> ```php theme={null}
> <?php
>
> add_filter('onesignal_send_notification', function ($fields, $post_id) {
>
>   // Add fields supported by the Create notification API:
>   // https://documentation.onesignal.com/reference/create-notification
>
>   $fields['web_buttons'] = array(
>     array(
>       'id' => 'read-more',
>       'text' => 'Read More',
>       'url' => get_permalink($post_id),
>     ),
>   );
>
>   return $fields;
>
> }, 10, 2);
> ```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.