设置网站公告及展示对象

先选择公告类型

使用有设置管理权限的账号进入 WordPress 后台，选择目标前端，再打开“瓜奇 → 公告”。这里有顶部公告、弹窗公告和系统通知三类。

类型	用途与生效方式
顶部公告	在页面顶部展示通知，只读取列表第一条。不会轮播后面的公告，也不会因为第一条不符合条件就自动改用下一条。
弹窗公告	用弹窗展示通知，同样只读取列表第一条。
系统通知	写入符合条件的已登录用户的消息中心，可以同时配置多条。每条分别控制是否发送、接收对象和期限。

用户范围、设备范围和有效期要同时满足。顶部和弹窗公告没有填写有效的到期时间时，当前前端不会展示。

“通知 key”由系统自动生成，字段只读。修改标题或正文不会自动换一个 key，也不会自动清除用户此前的关闭记录。

顶部公告正文支持以下占位符，写在哪里就显示在哪里。占位符名称不要翻译，也不要放进 HTML 标签属性或链接地址中。

占位符或字段	作用
`{countdown}`	显示距离公告到期的剩余天、时、分、秒，每秒更新。到期后整条顶部公告隐藏，已经打开的页面也会隐藏。
复制内容	填写优惠码等需要复制的文字，各语言共用同一个值。
`{copy_text}`	在正文中显示“复制内容”。
`{copy_button}`	显示复制按钮，只复制“复制内容”，不会跳转公告链接。
复制按钮文字	支持多语言，例如“复制优惠码”。当前语言留空时使用该语言默认的“复制”文字。

例如正文可以填写：优惠码：{copy_text}，剩余 {countdown}，{copy_button}。只有“复制内容”非空时，相关文字和按钮才会显示。复制功能需要 HTTPS，localhost 除外，并需要浏览器允许写入剪贴板。

顶部公告到期时间按 WordPress“设置 → 常规”中的站点时区填写。不使用倒计时占位符时，到期隐藏规则仍然有效。

顶部公告的 HTML 会经过处理，脚本和内联事件等内容不会执行。需要调整外观时使用支持的 HTML 和容器 CSS，不要把正文当作脚本运行入口。

顶部公告链接可按语言填写。站内链接使用实际页面路径，外链填写完整地址；正文中单独添加的 HTML 链接使用自己的地址，复制按钮只执行复制。

弹窗虽然有“弹窗公告链接”字段，但当前弹窗组件没有把它用于整窗跳转，也没有据此生成按钮。需要用户点击跳转时，可在支持 HTML 的弹窗正文中加入链接，并实际测试。

两类公告的再次显示时间都按小时填写，例如 24 表示关闭后间隔 24 小时。正数间隔过后，应重新访问页面验证，不要把它理解为一定会在当前页面自动重新弹出。

当前两类公告对 0 的处理不同：顶部公告填 0 后，在该浏览器保留关闭记录期间，同一 key 不再显示。弹窗的字段说明也写着“关闭后不再显示”，但当前组件没有按这一规则处理 0；重新进入页面并触发显示检查时，可能再次弹出。不要用弹窗的 0 来保证只展示一次。

顶部公告使用浏览器 Cookie 记录关闭状态，弹窗使用浏览器本地存储。清除站点数据、换浏览器或换设备后，不能指望原来的关闭记录继续有效。

系统通知在前台读取已登录用户信息时检查并补发，不是保存设置时立即给所有账号群发。游客不会收到消息中心通知。

系统会按用户和通知 key 去重。已经收到同一 key 的用户不会因为修改正文而重新收到；关闭发送或到期会停止后续发送，不会自动撤回此前已写入消息中心的记录。

公告不出现时，依次检查第一条记录、用户身份、设备选择、有效期、关闭记录和页面是否加载公告组件。后台值正确而前台仍是旧配置时，使用“刷新前端”重新同步。