Description
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 custom CSS
- jQuery Compatibility: Optional downgrade to jQuery 2.1.4 for legacy themes
- Smart Display: Cookie-based frequency control (once per day)
- Lightweight: No external dependencies, minimal footprint
- Translation Ready: Full i18n support with .pot file
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
- Activate the plugin
- Go to Settings 弹窗公告 (Homepage Popup Notice)
- Choose your popup style and customize content
- Save and view your site!
Screenshots
Installation
- Upload the plugin folder to
/wp-content/plugins/directory, or install via WordPress plugin installer. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Go to Settings 弹窗公告 (Homepage Popup Notice) to configure.
FAQ
-
The popup is not showing. What should I do?
-
Please check:
1. The plugin is activated and you’ve saved popup content in settings.
2. Enable “修复2” (Cookie fix) in the plugin settings.
3. Check browser console for JavaScript errors. -
My site’s JavaScript broke after installing this plugin.
-
WordPress ships with a modern version of jQuery. This plugin uses the built-in jQuery. If you encounter issues, try updating your theme.
-
Does the popup show every page load?
-
No. Style 1 and Style 2 use cookies to remember when a user closes the popup, so it only shows once per day per user.
-
Can I customize the popup appearance?
-
Yes! Each style has its own content editor and color options in the plugin settings.
-
Does this plugin work with caching plugins?
-
Yes. The popup is rendered via wp_footer action and works with most caching plugins.
-
弹窗不显示怎么办？
-
请检查：
1. 确保插件已激活，且在设置中已保存弹窗内容。
2. 在设置中勾选「修复2」（Cookie 支持）。
3. 检查浏览器控制台是否有 JS 错误。 -
安装插件后网站前台 JS 失效了？
-
WordPress 自带最新版 jQuery，本插件使用默认 jQuery。如遇兼容问题，请更新您的主题。
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Homepage Popup Notice” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Homepage Popup Notice” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Renamed js.cookie.js to cookie.js for broader filesystem compatibility
1.0.1
- Removed custom CSS/JS input fields (WP.org guideline compliance)
- Replaced inline style/script tags with wp_add_inline_style / wp_add_inline_script
- Fixed nonce sanitization (wp_unslash + sanitize_text_field)
- Removed bundled jQuery (use WordPress built-in)
- Updated js-cookie to v3.0.8
- Removed load_plugin_textdomain() (automatic in WP 4.6+)
- Tested with WordPress 7.0
1.0.0
- Complete rewrite: WordPress Settings API replaces Redux Framework
- All obfuscated/encrypted code removed
- External update checker removed
- Phone-home tracking on activation removed
- Bundled Redux Framework removed
- New admin page: Settings 弹窗公告
- Full i18n support (.pot file included)
- All functions prefixed with hppn_
- All output properly escaped (esc_*, wp_kses_post)
- Complete sanitize callback for all options
- Visual style selector with preview images
- Color picker and media upload support
- Tested with WordPress 6.9