开启智能数字体验
Djacore CMS 驱动未来

节日遮罩层插件 - 为您的网站增添节日氛围

这是一个功能强大的Django节日遮罩层插件，可自动在特定节日为用户展示精美的节日主题遮罩层，增强用户体验和节日氛围。

🎯 核心功能

• 多节日类型支持：支持阳历固定日期、农历日期、第N个星期X、日期范围四种节日类型
• 农历日期计算：内置农历日期支持，准确计算中国传统节日
• 灵活的背景配置：支持渐变背景、图片背景、纯色背景和自定义CSS四种背景类型
• 响应式设计：自动适配横竖屏，可分别为横屏和竖屏设置不同的背景图片
• 智能显示逻辑：支持优先级设置、会话控制、过期时间、显示延迟等智能显示策略
• 丰富的动画效果：提供淡入、滑动、缩放三种动画效果，可自定义动画时长
• 完整的管理后台：友好的Django Admin界面，支持节日数据的增删改查
• 一键数据导入：支持通过JSON文件批量导入节日数据

📋 节日类型详解

• 阳历固定日期：如元旦（1月1日）、国庆节（10月1日）
• 农历日期：如春节（正月初一）、中秋节（八月十五）
• 第N个星期X：如母亲节（5月第二个星期日）、感恩节（11月第四个星期四）
• 日期范围：如劳动节假期（5月1日-5月3日）、圣诞节（12月24日-12月26日）

🎨 背景配置特性

• 渐变背景：可设置起始颜色、结束颜色和渐变角度
• 图片背景：支持上传横屏和竖屏两种图片，自动适配设备方向
• 纯色背景：简单的单色背景配置
• 自定义CSS：为高级用户提供完全自定义的CSS样式
• 默认值：内置美观的渐变效果作为默认背景

⚙️ 显示行为控制

• 优先级系统：同一天可设置多个节日，只显示优先级最高的
• 会话控制：可选择每次会话只显示一次，避免用户重复看到
• 过期时间：用户关闭后可在指定时间内不再显示
• 显示延迟：页面加载后延迟显示，避免影响用户体验
• 自动关闭：可设置自动关闭时间，无需用户操作
• 生效年份：可指定节日只在特定年份生效

🔧 技术特性

• 插件化设计：独立完整的Django App，易于集成到现有项目
• 模板标签：提供简单的模板标签，一行代码即可集成遮罩层
• 前端优化：使用原生JavaScript，无jQuery依赖，性能优异
• 响应式CSS：适配各种屏幕尺寸和设备方向
• 本地存储：使用localStorage和sessionStorage记录用户关闭状态
• 管理命令：提供导入/导出节日数据的管理命令
• 完整的测试数据：包含常见节日的示例数据，开箱即用

🚀 快速开始

1. 安装插件：将插件目录放到项目的plugins目录下
2. 运行迁移：在插件管理操作界面执行数据库迁移，或者在终端执行python manage.py migrate创建数据库表
3. 导入数据：执行python manage.py import_festivals导入节日数据
4. 集成到模板：在模板中添加{% load festival_tags %}和{% festival_overlay %}

📊 数据管理

• JSON数据格式：使用标准JSON格式管理节日数据，便于版本控制和批量操作
• 管理后台：通过Django Admin界面管理所有节日配置
• 批量操作：支持批量启用/禁用节日、设置优先级等操作

🔄 集成方式

• 模板标签：{% festival_overlay %} - 自动插入所有必要的HTML、CSS和JavaScript
• 分离式集成：可分别插入样式、容器和脚本，实现更精细的控制
• API接口：提供获取今日节日的API接口，供前端动态调用

🎭 自定义扩展

• 自定义HTML：可在遮罩层中添加自定义的HTML内容，如祝福语、活动链接等
• 倒计时功能：日期范围类型的节日可显示倒计时
• 动画效果：可自定义动画类型和动画时长
• 关闭按钮样式：可自定义关闭按钮的颜色、大小和位置

🔒 兼容性

• 浏览器兼容：支持Chrome、Firefox、Safari、Edge等现代浏览器
• 设备兼容：完美支持桌面、平板和手机设备
• Django版本：兼容Django 3.2+，推荐使用Django 4.2+

📈 应用场景

• 电商网站：节日促销活动提醒和氛围营造
• 企业官网：节日祝福和品牌形象展示
• 内容网站：节日专题内容推荐
• 社交应用：节日主题界面和互动元素
• 游戏平台：节日活动通知和奖励展示

该插件已包含完整的实现代码、示例数据、管理界面和详细文档，可快速部署到任何Django项目中，为您的网站增添节日氛围。

——V1.0.0 2026年2月17日 02:10