Homepage Popup Notice

Homepage Popup Notice (弹窗公告) is a simple yet powerful popup plugin for WordPress. Display announcements, promotions, or important notices on your site’s homepage with three distinct styles. No complex configuration needed — just activate, customize, and go.

Features

• 3 Popup Styles: Centered card popup, modal overlay, and toast notification
• Customizable Content: Logo image, button text, links, and color options
• Visual Style Selector: Click preview cards to switch styles instantly
• Smart Display: Cookie-based frequency control (once per day per user)
• Lightweight: No external dependencies, minimal footprint
• Beautiful Admin UI: Flat, colorful, block-based settings page
• Help Center: Built-in help tab with FAQ and contact info

Style Preview

• Style 1 — Centered Card Popup: A centered card with logo avatar, close button, and action link. Perfect for brand announcements.
• Style 2 — Modal Overlay: Full-screen semi-transparent overlay with centered modal. Ideal for important notices.
• Style 3 — Toast Notification: Growl/Toast-style notification that auto-dismisses. Great for subtle alerts.

Usage

1. Activate the plugin
2. Go to Settings → Homepage Popup Notice
3. Choose your popup style and customize content
4. Save and view your site!

中文介绍

Homepage Popup Notice（弹窗公告）是一款简单强大的 WordPress 弹窗插件。无需复杂的配置，激活后进入设置页选择样式、填写内容即可使用。支持在首页展示公告、促销信息、重要通知或活动推广。

功能特性

• 三种弹窗样式：居中卡片弹窗、模态遮罩弹窗、侧边通知条
• 可视化样式选择：后台点击预览卡片即可切换样式，所见即所得
• 内容完全可自定义：Logo 图片、按钮文字、跳转链接、颜色选择
• 智能弹窗控制：基于 Cookie 记忆，每个用户每天仅弹窗一次
• 轻量无依赖：不依赖任何外部库，对网站性能零负担
• 全新扁平化设置界面：多彩分块设计，设置项一目了然
• 使用帮助中心：内置帮助文档、联系作者和插件介绍

样式预览

• 样式一 · 居中卡片弹窗：带 Logo 头像的居中卡片，支持关闭按钮和跳转链接，适合品牌公告。
• 样式二 · 模态遮罩弹窗：全屏半透明遮罩层，标题醒目，适合重要通知和系统公告。
• 样式三 · 侧边通知条：Growl/Toast 风格通知条，自动消失，适合轻量提示。

使用方法

1. 安装并激活插件
2. 进入「设置 → 弹窗公告」
3. 在「基本」页选择弹窗样式
4. 在对应的样式页填写内容并保存
5. 访问网站前台查看效果

安装方法

1. 将插件文件夹上传到 /wp-content/plugins/ 目录，或通过 WordPress 插件安装程序直接安装。
2. 在 WordPress 后台「插件」页面激活插件。
3. 进入「设置 → 弹窗公告」进行配置。

常见问题

弹窗不显示怎么办？

请检查： 1. 确保插件已激活，且在设置中已保存弹窗内容。 2. 在设置中勾选「修复2」（Cookie 支持）。 3. 检查浏览器控制台是否有 JS 错误。

安装插件后网站前台 JS 失效了？

WordPress 自带最新版 jQuery，本插件使用默认 jQuery。如遇兼容问题，请更新您的主题。

弹窗每次页面刷新都显示吗？

不是的。样式一和样式二使用 Cookie 记录用户的关闭操作，每个用户每天仅弹窗一次。

弹窗外观可以自定义吗？

可以！每种样式都有独立的编辑器、颜色选择和宽度设置。

这个插件兼容缓存插件吗？

兼容。弹窗通过 wp_footer 钩子渲染，与大多数缓存插件兼容。

更新日志

1.0.3

• 新增：扁平化多彩设置界面
• 新增：「使用帮助」页签（帮助文档、联系作者、插件介绍）
• 新增：样式三显示位置下拉箭头和说明
• 更新：高清样式预览图
• 修复：样式三通知条脚本加载问题

1.0.2

• 将 js.cookie.js 重命名为 cookie.js，提升文件系统兼容性

1.0.1

• 移除自定义 CSS/JS 输入框（WP.org 合规要求）
• 内联 style/script 标签改为 wp_add_inline_style / wp_add_inline_script
• 修复 nonce 的 sanitize 处理
• 移除捆绑的 jQuery（使用 WordPress 自带版本）
• 更新 js-cookie 到 v3.0.8
• 移除 load_plugin_textdomain() 调用
• 兼容 WordPress 7.0

1.0.0

• 完全重写：WordPress Settings API 替代 Redux Framework
• 移除所有混淆/加密代码
• 移除外部更新检查器
• 移除激活时的回传跟踪
• 移除捆绑的 Redux Framework
• 新增设置页面：设置 → 弹窗公告
• 完整的国际化支持（包含 .pot 文件）
• 所有函数以 hppn_ 前缀命名
• 所有输出均已正确转义
• 所有选项均有完整的 sanitize 回调
• 可视化样式选择器，带预览图
• 颜色选择器和媒体上传支持
• 兼容 WordPress 6.9