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

# WordPress

> Guide complet de configuration et de migration pour le plugin OneSignal WordPress Web Push v3+. Configurez les notifications push, les invites et la segmentation via le tableau de bord OneSignal avec un processus de configuration simplifié.

## Vue d'ensemble

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

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

### 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](./permission-requests) 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](./segmentation) reçoivent les notifications pour chaque article
* 📲 **Intégration d'application mobile** : Envoyez aux abonnés d'applications mobiles avec [liens profonds](./links#deep-linking) optionnels

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

***

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

<Frame caption="Sélectionnez WordPress parmi les options Website Builder dans votre tableau de bord OneSignal">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-integration-selection.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=d48170c90c2d9e309769c430c1f8336d" width="1916" height="590" data-path="images/dashboard/wordpress-integration-selection.png" />
</Frame>

#### 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 ou JPG carré de `256x256px` pour les notifications et les invites – MacOS Safari n'affichera pas d'invite de notification sans icône.

<Frame caption="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">
  <img src="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" width="2046" height="1036" data-path="images/docs/5a29a00c2808e8128e2cd822d743d14b472637f65fbde2aa64d9f16a8658d4a6-Screenshot_2025-02-13_at_3.06.28_PM.png" />
</Frame>

<Info>
  Tests en local ? Consultez le [guide de test local](./web-sdk-setup#local-testing)
  pour le développement localhost
</Info>

#### Invites de permission

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

<Info>
  **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](./permission-requests).
</Info>

<Tabs>
  <Tab title="Configuration d'invite de base">
    <Steps>
      <Step title="Cliquez sur Push Slide Prompt pour personnaliser">
        <Frame caption="Accédez et personnalisez les paramètres de votre invite push slide">
          <img src="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" width="2534" height="452" data-path="images/docs/32d2f36e12becd930037774ab376b1c65080fbb801e99f37f00964603371614e-Screenshot_2025-02-13_at_3.39.15_PM.png" />
        </Frame>
      </Step>

      <Step title="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

        <Frame caption="Configurez le timing de l'invite automatique et personnalisez l'apparence de l'invite">
          <img src="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" width="1922" height="1594" data-path="images/docs/3f3638ec5fa60f55fb8aa922ba0f7197aee508f11b242e0377a0a8e255a2b38d-Screenshot_2025-02-13_at_3.42.09_PM.png" />
        </Frame>
      </Step>

      <Step title="Cliquez sur Done lorsque vous avez terminé de configurer l'invite." />
    </Steps>
  </Tab>

  <Tab title="Avancé : Segmentation par catégorie">
    Pour une messagerie ciblée basée sur les intérêts des utilisateurs, configurez des catégories :

    <Steps>
      <Step title="Sélectionnez Categories dans les paramètres de votre invite" />

      <Step title="Configurez chaque catégorie avec :">
        * **Label** : Ce que les utilisateurs voient dans l'invite
        * **Tag Key** : [Clé de tag](./add-user-data-tags) interne pour la segmentation
      </Step>

      <Step title="Cliquez sur Done lorsque vous avez terminé de configurer l'invite." />
    </Steps>

    <Frame caption="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">
      <img src="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" width="1910" height="1604" data-path="images/docs/39ebfb19de43d53d6f07956c6e96bb101dca53dca81a58f6fc55a021f73ccdc9-Screenshot_2025-02-18_at_3.36.56_PM.png" />
    </Frame>

    **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.
  </Tab>
</Tabs>

<Info>
  **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](./permission-requests).
</Info>

#### 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 **Enregistrer**.

<Tip>
  Ignorez la section **Paramètres Push avancés** dans le tableau de bord OneSignal pour l'instant — ces paramètres sont pour la [configuration personnalisée du SDK Web](./web-sdk-setup). Cliquez sur **Enregistrer** pour continuer.
</Tip>

### 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**. Copiez ces valeurs dans votre plugin WordPress :

<Frame caption="Copiez votre App ID et votre API Key depuis le tableau de bord OneSignal">
  <img src="https://mintcdn.com/onesignal/sCO1i1UqrWQxmZ28/images/dashboard/wordpress-app-id-and-api-key.png?fit=max&auto=format&n=sCO1i1UqrWQxmZ28&q=85&s=90643a5aafc920c3785b42a093ae1773" width="1648" height="826" data-path="images/dashboard/wordpress-app-id-and-api-key.png" />
</Frame>

<Info>
  **Vous ne voyez pas de clé API ?** Suivez notre [guide Keys & IDs](./keys-and-ids) pour
  en créer une.
</Info>

<Steps>
  <Step title="Dans votre admin WordPress, accédez aux paramètres du plugin OneSignal" />

  <Step title="Collez l'App ID et la REST API Key exactement comme indiqué dans votre tableau de bord" />
</Steps>

<Frame caption="Assurez-vous que l'App ID et la REST API Key de votre plugin WordPress correspondent exactement à votre tableau de bord OneSignal">
  <img src="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" width="1828" height="1064" data-path="images/docs/c92c0ca5a7e910104a2c3e5d0fa87e63c2a9adb61aa20de072b41b49006a70c0-Screenshot_2025-02-13_at_3.49.16_PM.png" />
</Frame>

#### Paramètres avancés

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

<Frame caption="Paramètres avancés pour des fonctionnalités améliorées et le suivi analytique">
  <img src="https://mintcdn.com/onesignal/bqiNDj5j2mpssdoy/images/push/wordpress-advanced-settings.png?fit=max&auto=format&n=bqiNDj5j2mpssdoy&q=85&s=a6142c3df995140d2927cbc7c6058149" width="1946" height="1410" data-path="images/push/wordpress-advanced-settings.png" />
</Frame>

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

### 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...**
</Note>

<Warning>
  **Urgent** : Complétez ces étapes dès que possible pour éviter que les utilisateurs ne manquent des
  notifications pendant la transition.
</Warning>

<Steps>
  <Step title="Après avoir enregistré la configuration de votre tableau de bord OneSignal, retournez sur WordPress" />

  <Step title="Cliquez sur Migration Completed dans les paramètres du plugin" />

  <Step title="Cliquez sur Save Settings pour finaliser la mise à niveau" />
</Steps>

<Frame caption="Cliquez sur Migration Completed pour finaliser la mise à niveau de votre plugin">
  <img src="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" width="1059" height="312" data-path="images/docs/01ba2d812c5757d50ee60885c45f229e2bba4ff2da42ba3fb0098ac5b5621eba-Screenshot_2024-12-19_at_2.33.31_PM.png" />
</Frame>

<Check>
  Configuration terminée ! Cliquez sur **Save Settings** pour finaliser la configuration du plugin.
</Check>

***

## Tester votre configuration

<Tabs>
  <Tab title="Test initial">
    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

    <Frame caption="Votre invite slidedown configurée devrait apparaître en fonction de vos paramètres de timing">
      <img src="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" width="1600" height="700" data-path="images/docs/7aca650375517543ad8c80bedc0c75a224a51dd63e84c67798ab4b1812b01498-Screenshot_2025-02-24_at_9.58.05_AM.png" />
    </Frame>

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

    <Frame caption="L'invite de permission du navigateur (l'apparence varie selon le navigateur) est requise pour les notifications push web">
      <img src="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" width="1612" height="490" data-path="images/docs/fac77534f9a5182d0a2351713a23f10f26f779ff5182c0c2c8a1289372dea9a9-Screenshot_2025-02-13_at_4.44.29_PM.png" />
    </Frame>

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

    <Frame caption="La notification de bienvenue apparaît immédiatement après un abonnement réussi">
      <img src="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" width="740" height="198" data-path="images/docs/1752c5e7341bbb505d93af428bba12e4042257cb518e281ccb887b1a415dbaee-Screenshot_2025-02-13_at_4.44.40_PM.png" />
    </Frame>
  </Tab>

  <Tab title="Vérifier l'abonnement">
    1. Dans votre tableau de bord OneSignal, accédez à **Audience > Subscriptions** 2. Vous
       devriez voir votre [abonnement](./subscriptions) push web marqué comme
       « Subscribed »

    <Frame caption="Les abonnements réussis apparaissent dans l'audience de votre tableau de bord OneSignal">
      <img src="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" width="3006" height="788" data-path="images/docs/cf9b6a27fb8a32c5228e9123646e6ad5ca5b3ceb4d74fd8cf42e016e36f67c5a-Screenshot_2025-02-13_at_4.52.19_PM.png" />
    </Frame>
  </Tab>

  <Tab title="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](./push)
       pour des instructions détaillées.
  </Tab>
</Tabs>

<Check>
  **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.
</Check>

**Prochaines étapes :**

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

<Info>
  **Vous rencontrez des problèmes ?** Consultez notre [guide de dépannage
  WordPress](./troubleshooting-wordpress-web-push) pour des solutions courantes.
</Info>

***

## 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](./push-notification-message-reports) 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).

<Frame caption="Metabox OneSignal Push Notifications—faites glisser pour repositionner si nécessaire">
  <img src="https://mintcdn.com/onesignal/kAXbp86YqdTAbPtE/images/web-push/onesignal-push-notifications-metabox-wordpress.png?fit=max&auto=format&n=kAXbp86YqdTAbPtE&q=85&s=428a477e16f85fa50f9ff69678304340" width="3252" height="1674" data-path="images/web-push/onesignal-push-notifications-metabox-wordpress.png" />
</Frame>

**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](./subscriptions) push.

#### Envoyer à des segments spécifiques

Ciblez des audiences spécifiques en utilisant les [segments](./segmentation) que vous créez dans **OneSignal Dashboard > Audience > Segments**.

**Si vous avez configuré des catégories à l'étape 3**, 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`

<Frame caption="Les tags sont sensibles à la casse ! 'news' et 'News' sont des tags différents">
  <img src="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" width="1446" height="926" data-path="images/docs/e7c2b21714e2de8653ac569fc65eb929988f5ccede8429168a40cae0067d893d-Screenshot_2025-02-18_at_4.45.19_PM.png" />
</Frame>

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

<Frame caption="Sélectionnez des segments spécifiques pour cibler des groupes d'utilisateurs pertinents">
  <img src="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" width="2030" height="796" data-path="images/docs/9cb2736bc8b318d1de60b5b40887db8adda8f7797289bb0ad00d8e98e9e9c902-Screenshot_2025-02-19_at_10.36.16_AM.png" />
</Frame>

<Check>
  **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](./add-user-data-tags) offrent le plus de
  flexibilité pour les données utilisateur personnalisées et la personnalisation.
</Check>

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

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

<Frame caption="Personnalisez le titre, le contenu et d'autres éléments de notification">
  <img src="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" width="2064" height="1114" data-path="images/docs/40837af4e6fefa7d4303f5a3d49992396eb152cec5fd2420d7064aecef32c1af-Screenshot_2025-02-19_at_10.48.18_AM.png" />
</Frame>

**Exemple de résultat :**

<Frame caption="Notification push personnalisée telle qu'elle apparaît aux utilisateurs">
  <img src="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" width="740" height="198" data-path="images/docs/a5011ec82798e7b6b31a9c5e2a26d2fb98a2c17dbc3fb0cb9895453f74d3240a-Screenshot_2025-02-19_at_10.49.26_AM.png" />
</Frame>

### 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` (Events
  Calendar), `portfolio`{" "}
</Note>

## 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](./deep-linking)
3. Les utilisateurs mobiles seront dirigés vers votre application au lieu du navigateur web

<Check>
  **Prêt à passer à l'échelle** : Explorez les [stratégies push avancées](./push) et les
  [parcours automatisés](./journeys-overview) pour des campagnes de notification sophistiquées.
</Check>

<Warning>
  **Les notifications n'apparaissent pas ?** Consultez notre [guide de dépannage
  push web](./notifications-not-shown-web-push) pour des solutions.
</Warning>

***

## FAQ

<Accordion title="Comment désactiver les invites sur des pages spécifiques ?" icon="circle-chevron-down">
  **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**

  <Frame caption="Désactivez Auto Prompt pour contrôler manuellement quand les invites apparaissent">
    <img src="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" width="712" height="840" data-path="images/docs/814f50f2de90ad37c5213f963cd9dca9214b5dcc708650269d139254d55a9985-Screenshot_2025-02-13_at_5.06.27_PM.png" />
  </Frame>

  4. Faites défiler vers le bas, cliquez sur **Save**, puis sur **Finish**
  5. Ajoutez du [code JavaScript personnalisé](./web-sdk-reference#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](./permission-requests) pour les détails d'implémentation.
</Accordion>

<Accordion title="Puis-je envoyer des notifications aux abonnés d'applications mobiles ?" icon="circle-chevron-down">
  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>

<Accordion title="Comment envoyer des emails ou des SMS depuis WordPress ?" icon="circle-chevron-down">
  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](./email-setup), puis utilisez les [outils de messagerie Email](./email-messaging)
  2. **SMS** : Suivez notre [guide de configuration SMS](./sms-setup), puis utilisez les [outils de messagerie SMS](./sms-messaging)

  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>

<Accordion title="Pourquoi mes invites ne fonctionnent-elles pas après la migration ?" icon="circle-chevron-down">
  **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 »**

  <Frame caption="Désactivez le cache du navigateur pour forcer le chargement des fichiers mis à jour après la migration">
    <img src="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" width="777" height="156" data-path="images/docs/34b7e61edec0e1fec8954fec630ca0dc60459ad15d9472b5622b5e461b791256-Screenshot_2024-12-20_at_3.02.43_PM_1.png" />
  </Frame>

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

<Accordion title="Que signifie l'erreur `A bad HTTP response code (404)` ?" icon="circle-chevron-down">
  Cette erreur indique une migration incomplète :

  <Frame caption="L'erreur 404 dans la console du navigateur indique un processus de migration incomplet">
    <img src="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" width="1136" height="252" data-path="images/docs/5cf024c8bd09be6d420f85f846feef7242302c2052046f283ddeed09f73562d1-Screenshot_2024-12-20_at_3.11.58_PM_1.png" />
  </Frame>

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

<Accordion title="Puis-je modifier les paramètres de notification avant l'envoi ?" icon="circle-chevron-down">
  Oui, vous pouvez utiliser le filtre `onesignal_send_notification`.

  <Info>
    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.
  </Info>

  ```php theme={null}
  <?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);
  ```
</Accordion>

***