=== Happy New Year Lantern（新年快乐灯笼）===
Contributors: dzw6
Tags: lantern, decoration, chinese new year, customize, customizer
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

可自定义的新年灯笼挂件，支持在“外观 → 自定义”中调整位置、大小、摆动与发光等。

== Description ==

本插件会在网站前台展示一组新年灯笼装饰，并尽量只在需要显示时才加载资源，减少对性能的影响。

演示视频：https://www.bilibili.com/video/BV1NDi5BGEZ7/?vd_source=daaf1562b90f676edcbbe03e9caf2183

Features:

* 在“外观 → 自定义 → Happy New Year Lantern”中配置：灯笼位置（左上/右上/两侧）、距离顶部、缩放比例、灯笼间距、摆动幅度、摆动速度、发光强度、灯笼文字（最多 6 个字）。
* 前台提供最小化/展开按钮，状态会在访客本地保存（不影响其他访客）。
* 支持仅首页显示 / 全站显示，并提供移动端显示开关。
* 遵循 `prefers-reduced-motion`：当访客启用减少动态效果时会自动禁用动画。

== Installation ==

1. 将插件文件夹上传到 `/wp-content/plugins/happy-new-year-lantern/`，或在后台“插件 → 安装插件 → 上传插件”上传 ZIP。
2. 在“插件”页面启用“Happy New Year Lantern（新年快乐灯笼）”。
3. 前往“外观 → 自定义 → Happy New Year Lantern”调整样式与显示参数。
4. 基础显示选项也可在“设置 → Happy New Year Lantern”中配置。

== Frequently Asked Questions ==

= 为什么前台看不到灯笼？ =

请检查：
* 插件是否已启用。
* 是否设置为“仅首页显示”，但你正在访问非首页页面。
* 在移动设备访问时，是否已开启“移动端显示”。
* 选择“两侧同时显示”时，灯笼文字必须为偶数个字（例如 4/6 个字）。

= 前台最小化按钮会影响所有访客吗？ =

不会。最小化/展开状态仅保存在当前访客浏览器的本地存储中（localStorage），只影响该访客自己。

== Screenshots ==

1. 前台灯笼展示效果。
2. 在“外观 → 自定义”中的样式设置。

== Changelog ==

= 2.0.1 =
* 文档：补充演示视频链接与说明。
* 发布：按 WordPress.org 要求使用 tags/2.0.1 作为稳定版。

= 2.0 =
* 安全：防止直接访问可执行插件文件。
* 文档：修正 WordPress.org 审核相关的 readme 元数据。

= 1.9 =
* 性能：仅在需要显示时加载 CSS/JS；通过 CSS 变量控制动画强度。
* 新增：自定义器设置、前台最小化/展开按钮、灯笼间距与顶部偏移选项。

== Upgrade Notice ==

= 2.0 =
安全修复与 WordPress.org 审核所需的 readme 元数据修正。

= 1.9 =
建议更新：获得更好的性能与更清晰的自定义选项。