README

此插件用于配置和显示桌面通知给用户。这些通知的外观和特定功能提供了一种异步向用户提供信息的方式。

要求

Zealpush 通知插件的功能需求包括

1. Craft CMS 版本 3.1 或更高
2. PHP 版本 7.2.5 或更高

安装

您可以从 插件商店 或使用 Composer 安装此插件。

• 从插件商店（不使用 Composer）

  转到您项目控制面板中的插件商店，搜索 “Zealpush Notification”，然后在弹出的窗口中点击“安装”按钮。

• 使用 Composer

# go to the project directory
cd /path/to/my-project

# Command the composer to load the plugin
composer require zealousweb/zealpush-notification

# Command the craft to install the plugin
./craft install/plugin zealpush-notification

插件的主要功能

• 创建或编辑通知。
• 选项发送带有图标和图片的通知。
• 存储通知以供将来使用。
• 选项重新发送现有通知。
• 删除不必要的或旧的通知。
• 使用非活动状态添加通知以供将来使用。

常规设置

如何创建 Firebase 账户

• 创建 Firebase 账户
• 转到 Firebase 控制台 并添加一个新的项目或使用现有的项目。
• 一旦您的项目创建完成，请向项目中添加一个 Web 应用。通过添加应用名称来注册您的 Web 应用，然后点击继续进入控制台。
• 通过点击左侧上角“项目概览”旁边的设置图标进入项目设置。
• 在“常规”选项卡中，您将找到一个新添加的 Web 应用配置面板。找到“Firebase SDK 片段”并选择“配置”单选按钮以获取配置密钥。
• 选择“配置”单选按钮后，您将获得一个包含 apiKey、authDomain、projectId、storageBucket、messagingSenderId 和 appId 的 JSON 对象作为配置脚本。
• 现在，您需要复制如下所示配置脚本中的确切部分，并将其粘贴到插件设置页面中的“配置 JSON 数据”文本区域。

	{
		apiKey: "***********",
		authDomain: "***********",
		projectId: "***********",
		storageBucket: "***********",
		messagingSenderId: "***********",
		appId: "***********"
	}

• 或者
• 您还可以在“配置”面板中的输入框中填写个别值。
• 在 Firebase 项目中，在项目设置页面中，转到“云消息”选项卡，从“项目凭证”面板中复制“服务器密钥”，并将其粘贴到设置页面中的“服务器密钥”字段。

使用方法

在设置页面上添加所需信息后，下载 js 文件并将其放置在服务器基本根目录中。

在您的首页上放置以下一行代码。

{% hook 'get-webnotification-token' %}

在访问您的网站时，用户将获得一个弹出窗口以启用获取未来通知的选项。

通知

添加/编辑通知

• 可根据需求在标题、文本、URL、图标、图片和状态中添加通知。
• 您可以从您的资产或本地选择一张图片。
• 如果选择活动状态，则通知将发送给您的用户。非活动状态的通知存储在您的系统中。稍后，您可以编辑任何通知。

通知列表

• 在列表页面上，您可以按特定字段排序和筛选数据。

删除通知

• 在列表页面上，您可以选中一个或多个通知并删除它们。

重新发送通知

• 您可以从列表页面一次性重发一个或多个通知。