一、工具核心特性解析

• 独立模块化架构：通过自定义路径加载，与主题核心文件解耦，避免升级冲突；
• 可视化元素自定义：支持顶部产品图 / 会员图标挂载（需自行调整 CSS 适配尺寸）；
• 响应式倒计时：适配移动端与 PC 端显示，倒计时结束自动隐藏或切换状态。

二、部署步骤：从文件创建到功能激活

1. 登录服务器，定位至主题目录：/wp-content/themes/zibll/
2. 若不存在func.php文件，手动创建并添加 PHP 文件头（示例如下）：

<?php
// 子比主题自定义功能加载文件
// 注意：必须保留<?php开头，避免解析错误

$widgets_files = array(
    'heimao_sale.php', // 黑猫促销倒计时工具核心文件
);

foreach ($widgets_files as $file) {
    require get_template_directory() . '/heimao/widgets/' . $file;
}

• 数组$widgets_files用于声明需加载的工具文件，可按此格式扩展多个工具；
• require语句通过主题目录动态加载工具文件，确保路径/heimao/widgets/与实际存储一致。

第二步：上传工具核心文件
将附件解压后，确保文件结构如下：

zibll/
└─ heimao/
   └─ widgets/
      └─ heimao_sale.php  // 核心功能文件

• 若需添加产品图，可在heimao_sale.php中找到图片路径配置段，替换为自定义图片 URL；
• CSS 样式调整示例（以圆角图标为例）：

.heimao-sale-icon {
    border-radius: 50%; /* 圆形图标 */
    width: 60px; height: 60px; /* 调整尺寸 */
    margin-bottom: 10px; /* 图标与倒计时间距 */
}

1. 进入 WordPress 后台 → 外观 → 小工具；
2. 在侧边栏区域（如 “首页侧边栏”）添加名为 “黑猫促销倒计时” 的组件；
3. 配置项说明：
   • 促销标题：支持 HTML 标签（例：<strong>限时折扣</strong>）；
   • 结束时间：格式为Y-m-d H:i:s（例：2025-07-10 23:59:59）；
   • 跳转链接：倒计时结束后点击跳转的目标页面。

三、常见问题与进阶优化

• 更新主题后工具失效？
  由于采用独立文件夹存储，只要不手动删除heimao/目录，工具将永久保留。
• 如何适配深色主题？
  在主题自定义 CSS 中添加：

.heimao-sale-countdown {
    color: #fff; /* 白色数字适配深色背景 */
    background: rgba(0,0,0,0.7); /* 半透明深色背景 */
}

• 多产品倒计时如何部署？
  可复制heimao_sale.php并重命名（如heimao_sale_product2.php），修改文件内组件 ID 后，在func.php中添加新文件名即可。

四、资源获取与技术支持

• func.php是否缺少<?php开头；
• 文件夹路径是否包含中文或特殊符号。

附件下载链接：