janvince/smallmessages-plugin

此包的最新版本(v1.2.7)没有可用的许可证信息。

安装: 1

依赖项: 0

建议者: 0

安全: 0

星星: 2

关注者: 2

分支: 4

开放问题: 1

类型:october-plugin

v1.2.7 2023-12-19 11:47 UTC

This package is not auto-updated.

Last update: 2024-09-27 00:43:36 UTC


README

简单插件,用于管理前端和后端消息

安装

GitHub 克隆到 /plugins 目录

git clone https://github.com/jan-vince/smallmessages

OctoberCMS 后端

只需在

设置 > 更新 & 插件 > 安装插件

权限

设置 > 管理员

您可以设置权限以限制对 设置 > 小插件 > 小消息 和消息列表的访问。

快速入门指南

  • 安装插件。

  • 进入 October 的后端设置并选择小消息。

    • 选择您喜欢的 UI 风格,并可选地添加关闭按钮的文本。
  • 进入 October 的后端并从主菜单选择消息。

    • 创建新消息并将其设置为活动状态(您还可以设置日期范围并选择通过 cookie 控制消息窗口)。
  • 进入 October 的 CMS 部分。

    • 添加新布局、页面或部分。
    • 添加组件小消息 > 消息(在您的 body 标签内)。

别忘了在布局页面中在关闭 body 标签之前添加 {% scripts %} 标签!更多信息请参阅 October 文档

  • 打开您的网站 - 消息应该可见。

组件

消息

应在您的布局、页面或部分中使用。

可见性

如果您想控制消息框何时在您的网站上显示,可以设置日期范围。

限制

您可以添加列表或(相对)URL,消息框应该显示在这些位置。

Cookie

您可以为 Cookie 控制添加一个(自定义过期时间的)Cookie,当用户点击隐藏按钮时,消息框将不会再次出现(直到 Cookie 过期)。

您还可以添加消息框将在其中显示的 URL(例如,对于 /contact 页面很有用)。

手动禁用消息框

如果您需要在特定的部分、页面或布局中隐藏消息框,您可以通过以下方式在页面中使用 View Bag

[viewBag]
hideMessagesBox = 1

如何使用

获取消息列表

通过附加组件,您可以通过 {{ messages.items }} 获取消息列表。

您的自定义消息框设计

如果您想自定义消息框设计,只需在 /themes/[your-theme-name]/partials/messages/default.htm 中创建一个名为 messages 的文件夹和文件,并放入您的代码。

如果您已更改消息组件的默认别名(它是 messages),您也必须更改文件夹名称!

对于默认代码,您可以在 /plugins/janvince/smallmessages/components/messages 中查看。

我要感谢
OctoberCMS 团队成员和支持者,感谢他们这个伟大的系统。
Possessed Photography 提供横幅照片。
Font Awesome 提供漂亮的图标。

由来自捷克共和国的自由职业网页设计师 Jan Vince 创建。