phpbb/webpushnotifications

一个官方的phpBB扩展,允许版主接收基于浏览器的推送通知。

1.0.0 2024-07-14 01:16 UTC

This package is auto-updated.

Last update: 2024-09-21 14:29:06 UTC


README

这是phpBB浏览器推送通知扩展的开发仓库。

Build Status

一个官方的phpBB扩展,允许版主接收基于浏览器的推送通知。

重要:只有经过phpBB扩展团队验证的官方版本才能安装到实时论坛上。从本仓库下载的预发布(beta,RC)版本仅供在离线/开发论坛上进行测试使用,并不提供官方支持。

贡献

请将该仓库Fork到您的GitHub账户,并提交一个Pull Request以贡献此扩展。

要在本地服务器上从仓库运行此扩展(而不是从预构建包中),请执行以下任务

  • Fork phpbb-extensions/webpushnotifications到您的GitHub账户,然后创建其本地副本
    git clone https://github.com/your_github_name/webpushnotifications.git
  • 安装此扩展的依赖项(从webpushnotifications仓库的根目录)
    cd webpushnotifications # navigate into the root of your webpushnotifications repo
    php composer.phar install # installs extension's 3rd-party dependencies 
  • 通过将本地仓库移动到正确的phpBB目录来将扩展安装到您的本地phpBB论坛
    cd ../ # back out one directory level
    mv webpushnotifications path_to_phpBB/ext/phpbb # move webpushnotifications to your phpBB/ext/phpbb directory
    cd path_to_phpBB # navigate to your phpBB forum's root directory
    php bin/phpbbcli.php extension:enable phpbb/webpushnotifications # install the extension

测试推送通知

测试推送通知需要用户之间的交互来准确观察通知行为。请按照以下步骤进行以有效地测试推送通知

  1. 用户账户设置

    • 为测试目的创建至少两个不同的用户账户。
    • 在用户账户1的通知偏好设置中,订阅接收推送通知(如果需要,分配网页推送通知类型)。
  2. 消息、引用或回复交互

    • 使用用户账户2通过执行以下操作之一来启动用户之间的交互
      • 私信:从用户账户2向用户账户1发送直接消息。
      • 引用:使用用户账户2引用用户账户1发表的帖子或消息。
      • 回复:使用用户账户2回复用户账户1发表的帖子或消息。
  3. 观察推送通知

    • 一旦从用户账户2与用户账户1进行交互,您应该立即看到用户账户1的通知。
  4. 本地测试的注意事项

    • 本地测试推送通知仅在localhost地址或本地服务器有安全SSL证书的情况下才能工作。
    • 我们已经在Windows上使用手动安装的PHP、Apache和MySQL上看到成功。然而,由于尚不清楚的原因,我们在Mac上使用MAMP时没有看到成功。

许可证

GNU通用公共许可证v2