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

> OneSignal WordPress Web Push 插件 v3+ 的完整设置和迁移指南。通过 OneSignal 仪表板配置推送通知、提示和分段,实现流畅的设置过程。

## 概述

本指南介绍如何设置和配置 OneSignal WordPress Web Push 插件 v3+。

<Info>
  有关旧版本 2.x.x WordPress 文档,请参阅 [WordPress 旧版插件](./wordpress-legacy)。
</Info>

### 版本 3+ 的新功能

此版本通过简化设置和配置过程进行了重大升级。使用版本 3+,您可以在一个地方处理所有提示设置——OneSignal 仪表板。

* 🚀 **SDK 升级**: 将 OneSignal Web SDK 从版本 15 升级到版本 16
* 💬 **仪表板提示**: 直接在 OneSignal 仪表板中配置所有[权限提示](./permission-requests)——无需自定义代码
* ⏩ **一键发布**: 勾选"发布文章时发送通知"即可自动发送推送通知
* 🧑‍🤝‍🧑 **受众定位**: 为每篇文章选择接收通知的[分段](./segmentation)
* 📲 **移动应用集成**: 通过可选的[深度链接](./links#deep-linking)向移动应用订阅者发送通知

<Info>
  有关旧版本 2.x.x WordPress 文档,请参阅 [WordPress 旧版插件](./wordpress-legacy)。
</Info>

***

## 设置

在开始之前,请确保您具备:

* [OneSignal 账户](https://dashboard.onesignal.com/signup)(免费创建)
* WordPress 管理员访问权限以安装和配置插件
* 启用了 HTTPS 的网站(网页推送通知所必需)

### 1. 在 OneSignal 仪表板中配置 WordPress

导航到 **设置 > 推送和应用内 > Web > WordPress 插件或网站构建器**

<Frame caption="从 OneSignal 仪表板的网站构建器选项中选择 WordPress">
  <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>

#### 网站设置

* **网站名称**: 您的网站名称和默认通知标题。
* **网站 URL**: 必须与您的 WordPress 网站的确切 URL 匹配(遵循[同源策略](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy))
* **自动重新订阅**: 启用此选项可在清除浏览器数据的用户返回您的网站时自动重新订阅他们(无需新的权限提示)
* **默认图标 URL**: 用于通知和提示的正方形 `256x256px` PNG 或 JPG 文件 – MacOS Safari 在没有图标的情况下不会显示通知提示。

<Frame caption="输入您的确切网站 URL。https://your-site.com 与 https://www.your-site.com 不同——始终仅使用一种格式">
  <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>
  在本地测试?请参阅[本地测试指南](./web-sdk-setup#local-testing)了解本地开发信息
</Info>

#### 权限提示

为推送、电子邮件和短信设置您的[权限提示](./permission-requests)。推送滑动提示默认启用,但您可以自定义或添加其他提示。

<Info>
  **专业提示**: 从简单的提示开始,逐步增加复杂性。您可以随时通过 OneSignal 仪表板修改所有提示设置。在[网页权限提示](./permission-requests)中探索所有可用选项。
</Info>

<Tabs>
  <Tab title="基本提示设置">
    <Steps>
      <Step title="点击推送滑动提示进行自定义">
        <Frame caption="访问并自定义您的推送滑动提示设置">
          <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="配置时间和文本:">
        * 将 **自动提示** 设置为 `1` 次页面浏览和 `1` 秒用于初始测试
          * 自定义提示文本和外观
          * 根据启动后的用户行为调整时间

        <Frame caption="配置自动提示时间并自定义提示外观">
          <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="配置完提示后点击完成。" />
    </Steps>
  </Tab>

  <Tab title="高级:基于类别的分段">
    要根据用户兴趣进行有针对性的消息传递,请设置类别:

    <Steps>
      <Step title="在您的提示设置中选择类别" />

      <Step title="为每个类别配置:">
        * **标签**: 用户在提示中看到的内容
        * **标签键**: 用于分段的内部[标签键](./add-user-data-tags)
      </Step>

      <Step title="配置完提示后点击完成。" />
    </Steps>

    <Frame caption="示例:设置新闻和优惠类别会为勾选这些选项的用户创建标签 'news: 1' 和 'deals: 1'">
      <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>

    **标签逻辑**: 勾选的类别将标签值设置为 `1`,未勾选的设置为 `0`。这些标签可实现针对特定用户兴趣的定向消息传递。
  </Tab>
</Tabs>

<Info>
  **专业提示**: 从简单的提示开始,逐步增加复杂性。您可以随时通过 OneSignal 仪表板修改所有提示设置。在[网页权限提示](./permission-requests)中探索所有可用选项。
</Info>

#### 欢迎通知

设置用户首次订阅后立即发送的通知。这可以:

* 感谢用户订阅
* 演示通知的显示方式
* 提高参与度并减少取消订阅

配置您的欢迎消息文本和时间,然后向下滚动并点击 **保存**。

<Info>
  暂时跳过 **高级推送设置** 部分——这些是用于自定义 [Web SDK 设置](./web-sdk-setup)的。点击 **保存** 继续。
</Info>

### 2. 配置 WordPress 插件

保存仪表板配置后,您将看到您的 **App ID** 和 **API Key**。将这些值复制到您的 WordPress 插件:

<Frame caption="从 OneSignal 仪表板复制您的 App ID 和 API Key">
  <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>
  **看不到 API Key?** 按照我们的 [Keys & IDs 指南](./keys-and-ids)创建一个。
</Info>

<Steps>
  <Step title="在您的 WordPress 管理后台,导航到 OneSignal 插件设置" />

  <Step title="准确粘贴仪表板中显示的 App ID 和 REST API Key" />
</Steps>

<Frame caption="确保您的 WordPress 插件 App ID 和 REST API Key 与 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>

#### 高级设置

根据您的需求配置其他插件选项:

<Frame caption="用于增强功能和分析跟踪的高级设置">
  <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>

**URL 参数跟踪**

向通知 URL 添加分析参数以进行跟踪。**重要**: 转义特殊字符——输入内容会原样添加到 URL 中。

**Google Analytics 示例:**

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

**其他设置**

* **自定义文章类型**: 添加插件中的文章类型以启用通知选项
* **文章发布时自动发送通知**: 发布文章时自动勾选通知框,这样无需手动勾选即可发送通知
* **文章更新时自动发送通知**: 更新文章时自动勾选通知框,这样无需手动勾选即可发送通知
* **页面发布时自动发送通知**: 发布页面时自动勾选通知框,这样无需手动勾选即可发送通知
* **页面更新时自动发送通知**: 更新页面时自动勾选通知框,这样无需手动勾选即可发送通知
* **从第三方插件发布文章时自动发送推送通知**: 从外部发布插件自动发送通知
* **移动应用集成**: 使用相同的 OneSignal App ID 向您的移动应用订阅者发送通知

### 3. 完成迁移(仅限升级用户)

<Note>
  **新安装可以跳过此步骤。如果您从 v2+ 升级,请继续...**
</Note>

<Warning>
  **时间敏感**: 尽快完成这些步骤以避免用户在过渡期间错过通知。
</Warning>

<Steps>
  <Step title="保存 OneSignal 仪表板配置后,返回 WordPress" />

  <Step title="在插件设置中点击迁移已完成" />

  <Step title="点击保存设置以完成升级" />
</Steps>

<Frame caption="点击迁移已完成以完成您的插件升级">
  <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>
  设置完成!点击 **保存设置** 完成插件配置。
</Check>

***

## 测试您的设置

<Tabs>
  <Tab title="初始测试">
    1. **访问您的网站**(避免使用无痕/隐私浏览——用户无法在这些模式下订阅) 2. **查找您配置的滑动提示**

    <Frame caption="您配置的滑动提示应根据您的时间设置显示">
      <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. **点击订阅按钮**(在此示例中标记为"订阅") 4. **接受浏览器权限**(出现提示时)

    <Frame caption="网页推送通知需要浏览器权限提示(外观因浏览器而异)">
      <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. **检查欢迎通知**(如果已配置)

    <Frame caption="成功订阅后立即显示欢迎通知">
      <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="验证订阅">
    1. 在您的 OneSignal 仪表板中,转到 **受众 > 订阅** 2. 您应该看到标记为"已订阅"的网页推送[订阅](./subscriptions)

    <Frame caption="成功的订阅显示在您的 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="发送测试消息">
    1. 在您的 OneSignal 仪表板中导航到 **消息 > 推送** 2. 创建 **新消息** 3. 向自己发送测试通知 4. 验证通知是否正确显示 有关详细说明,请参阅我们的[推送消息指南](./push)。
  </Tab>
</Tabs>

<Check>
  **成功!** 您的 WordPress 网站现已配置为网页推送通知。用户在订阅时会开始出现在您的订阅中。
</Check>

**下一步:**

* 查看[网页权限提示](./permission-requests)了解高级自定义
* 探索[渠道设置](./channel-setup)以实现电子邮件和短信集成
* 设置[分段策略](./segmentation)以进行定向消息传递

<Info>
  **遇到问题?** 查看我们的 [WordPress 故障排除指南](./troubleshooting-wordpress-web-push)以获取常见解决方案。
</Info>

***

## 发布通知

当您安排文章发布时,OneSignal 也会安排在计划时间向您的订阅者发送推送通知。如果您重新安排文章,推送通知将被取消,并为新时间安排新的推送。

您可以在 OneSignal 仪表板的 **投递 > 计划消息** 下查看您的计划和已取消的通知。有关更多详细信息,请参阅[推送消息报告](./push-notification-message-reports)。

### 基本文章通知

创建或编辑 WordPress 文章时,找到 **OneSignal 推送通知** 元框(通常在文章编辑器的底部或侧边栏)。

<Frame caption="OneSignal 推送通知元框——如需要可拖动重新定位">
  <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>

**发送通知:**

* 勾选 **"文章发布或更新时发送通知"**
* 取消勾选可跳过为该文章发送通知

### 受众定位

#### 发送给所有订阅者(默认)

默认情况下,通知会发送给所有推送[订阅者](./subscriptions)。

#### 发送给特定分段

使用您在 **OneSignal 仪表板 > 受众 > 分段** 中创建的[分段](./segmentation)来定位特定受众。

**如果您在步骤 3 中设置了类别**,请创建相应的分段:

1. 在您的 OneSignal 仪表板中转到 **受众 > 分段**
2. 使用您的标签键创建分段,例如:
   * **新闻分段**: 标签 `news` 为 `1`
   * **优惠分段**: 标签 `deals` 为 `1`

<Frame caption="标签区分大小写!'news' 和 'News' 是不同的标签">
  <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. 创建分段后,刷新您的 WordPress 文章编辑器
4. 从下拉菜单中选择您的目标分段

<Frame caption="选择特定分段以定位相关用户组">
  <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>
  **高级分段**: 根据用户行为、位置、设备类型等创建分段。[标签](./add-user-data-tags)为自定义用户数据和个性化提供了最大的灵活性。
</Check>

### 自定义通知内容

#### 默认行为

* **标题**: 使用您的 WordPress 网站标题(设置 > 常规)
* **消息**: 使用文章标题
* **图片**: 使用文章的特色图片(如果已设置)
* **URL**: 链接到已发布的文章

#### 自定义内容

勾选 **"自定义通知内容"** 以覆盖默认设置:

<Frame caption="自定义通知标题、内容和其他元素">
  <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>

**示例结果:**

<Frame caption="自定义推送通知向用户显示的效果">
  <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>

### 将自定义文章类型添加到 OneSignal WordPress 插件

#### 查找您的自定义文章类型名称

创建新文章时查看浏览器的地址栏。URL 看起来像:

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

`post_type` 参数的值(例如 `your_custom_type`)就是您需要在 OneSignal 插件设置中添加的确切名称。

#### 添加到 OneSignal 设置

1. 在 WordPress 管理后台转到 **OneSignal > 设置**
2. 在 **高级设置** 中,将您的自定义文章类型名称添加到 **自定义文章类型** 字段
3. 保存设置

<Note>
  **常见示例:** `product` (WooCommerce)、`tribe_events` (Events Calendar)、`portfolio`{" "}
</Note>

## 移动应用集成

如果您有一个使用相同 OneSignal App ID 的移动应用:

1. 在插件设置中启用 **"向移动应用订阅者发送通知"**
2. 在文章元框中,添加用于[深度链接](./deep-linking)的 **移动 URL**
3. 移动用户将被引导到您的应用而不是网页浏览器

<Check>
  **准备扩展**: 探索[高级推送策略](./push)和[自动化旅程](./journeys-overview)以实现复杂的通知活动。
</Check>

<Warning>
  **通知未显示?** 查看我们的[网页推送故障排除指南](./notifications-not-shown-web-push)以获取解决方案。
</Warning>

***

## 常见问题

<Accordion title="如何在特定页面上禁用提示?" icon="circle-chevron-down">
  **注意**: 此方法仅适用于滑动提示和原生权限提示,不适用于铃铛或自定义链接提示。

  1. 在您的 OneSignal 仪表板中,转到 **设置 > 推送和应用内 > Web 设置**
  2. 从 **权限提示设置** 表中选择您的提示
  3. 取消勾选 **自动提示** 并点击 **完成**

  <Frame caption="禁用自动提示以手动控制提示何时出现">
    <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. 向下滚动,点击 **保存**,然后点击 **完成**
  5. 在您希望提示出现的特定页面上添加[自定义 JavaScript 代码](./web-sdk-reference#slidedown-prompts)

  这使您可以完全控制提示的时间和位置。有关实现详细信息,请参阅[网页权限提示](./permission-requests)。
</Accordion>

<Accordion title="我可以向移动应用订阅者发送通知吗?" icon="circle-chevron-down">
  可以!如果您的移动应用使用相同的 OneSignal App ID:

  1. 在 WordPress 插件设置中启用 **"向移动应用订阅者发送通知"**
  2. 发布文章时,使用 OneSignal 元框中的 **移动 URL** 字段指定深度链接
  3. 如果没有自定义移动 URL,用户将被引导到您的网站

  此功能可从单个 WordPress 界面实现跨平台消息传递。
</Accordion>

<Accordion title="如何从 WordPress 发送电子邮件或短信?" icon="circle-chevron-down">
  WordPress 插件目前仅支持推送通知。对于电子邮件和短信:

  1. **电子邮件**: 按照我们的[电子邮件设置指南](./email-setup),然后使用[电子邮件消息工具](./email-messaging)
  2. **短信**: 按照我们的[短信设置指南](./sms-setup),然后使用[短信消息工具](./sms-messaging)

  这两个渠道都可以从与推送通知相同的 OneSignal 仪表板进行管理。
</Accordion>

<Accordion title="为什么迁移后我的提示不起作用?" icon="circle-chevron-down">
  **缓存问题**: WordPress 缓存可能会延迟迁移更改。

  **解决方案:**

  **步骤 1:** 右键点击您的网站并选择 **检查**

  **步骤 2:** 转到 **网络** 选项卡

  **步骤 3:** 勾选 **"禁用缓存"**

  <Frame caption="禁用浏览器缓存以强制在迁移后加载更新的文件">
    <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>

  **步骤 4:** 刷新您的网站以查看当前配置

  **步骤 5:** 如果适用,清除您的 WordPress 缓存插件设置
</Accordion>

<Accordion title="`A bad HTTP response code (404)` 错误是什么意思?" icon="circle-chevron-down">
  此错误表示迁移不完整:

  <Frame caption="浏览器控制台中的 404 错误表示迁移过程不完整">
    <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>

  **解决方案:**

  1. 确保您已保存 OneSignal 仪表板配置
  2. 在 WordPress 中,在插件设置中点击 **"迁移已完成"**
  3. 点击 **保存设置** 以完成升级

  **此错误仅影响从版本 2.x.x 升级的用户。**
</Accordion>

<Accordion title="我可以在发送前修改通知参数吗?" icon="circle-chevron-down">
  可以,您可以使用 `onesignal_send_notification` 过滤器。

  <Info>
    将自定义 PHP 代码放在 `wp-content/mu-plugins/onesignal-custom.php` 中。这确保其正确加载并防止被更新覆盖。
  </Info>

  ```php theme={null}
  <?php

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

    // 包括创建通知 API 参考中提到的任何属性:
    // https://documentation.onesignal.com/reference/push-notification 例如:

    // 添加操作按钮
    $fields['web_buttons'] = array(
      array(
        "id" => "read-more",
        "text" => "Read More",
        "url" => get_permalink($post->ID)
      )

    // 返回修改后的字段数组
    return $fields;

  }, 10, 2);
  ```
</Accordion>

***