// ==============================================
    // ✅ 文章订阅插件短代码：插入在文章正文正下方
    // ==============================================
    echo '<div style="margin: 30px 0; padding: 10px 0; border-top: 1px solid #f0f0f0;">';
    echo do_shortcode('[z把这位文字删除掉ibll_article_subscribe]');
    echo '</div>';
    // ==============================================
    // 文章订阅模块结束
    // ==============================================

# 🎀 功能介绍

这是一款专为 Zibll 主题设计的文章订阅推送插件，具有以下特性：

– **少女心精美设计**：粉色渐变风格，适配浅色/深色模式

– **双重通知方式**：支持站内消息 + 邮件通知

– **可视化后台配置**：基于 CSF 框架，所有设置实时生效

– **灵活调用方式**：支持短代码手动插入

– **订阅管理**：用户可查看和管理已订阅的文章

– **实时统计**：后台显示文章订阅人数

—

## 🔧 安装方法

### 方法一：后台上传安装

1. 进入 WordPress 后台 → **插件** → **安装插件** → **上传插件**

2. 选择插件 zip 文件，点击**立即安装**

3. 安装完成后点击**启用插件**

### 方法二：FTP 上传安装

1. 解压插件文件

2. 将文件夹上传到 `/wp-content/plugins/` 目录

3. 进入 WordPress 后台 → **插件** → 启用插件

### 前置要求

– WordPress 5.0+

– Zibll 主题（子比主题）

– CSF 框架（子比主题已内置）

—

## 📝 短代码使用

### 短代码一：文章订阅框

**短代码：**

“`

“`

**功能说明：**

– 显示一个精美的订阅卡片

– 用户可订阅/取消订阅当前文章

– 仅在文章详情页生效

– 仅登录用户可订阅

**使用场景：**

在文章内容中手动插入订阅框，让用户订阅该文章的更新通知。

**插入位置建议：**

– 文章开头（引导订阅）

– 文章中间（内容相关处）

– 文章结尾（阅读后订阅）

**示例效果：**

“`

┌─────────────────────────────────────┐

│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │ ← 渐变装饰条

│     ✦                        ✧     │ ← 装饰星星

│         💌  💖  🔔                  │ ← 图标组

│                                      │

│     订阅文章更新通知                  │ ← 标题

│                                      │

│  订阅后，本文有新更新时会通过          │ ← 说明文字

│  站内消息和邮件通知你哦 ✧            │

│                                      │

│     [✨ 订阅本文更新 ✧]              │ ← 订阅按钮

│                                      │

└─────────────────────────────────────┘

“`

**古腾堡编辑器使用：**

1. 添加「短代码」区块

2. 输入 `

`

3. 保存文章

**经典编辑器使用：**

直接在文章内容中输入 `

`

—

### 短代码二：我的订阅列表

**短代码：**

“`

“`

**功能说明：**

– 显示当前用户已订阅的所有文章列表

– 支持快速取消订阅

– 横排卡片布局，适配侧边栏

– 仅登录用户可查看

**使用场景：**

– 侧边栏小工具

– 用户中心页面

– 个人主页

**示例效果：**

“`

┌─────────────────────────────────┐

│  💕 我的订阅文章                 │

├─────────────────────────────────┤

│  ┌──────────┐ ┌──────────┐     │

│  │ 文章标题1 │ │ 文章标题2 │     │

│  │ 2025-01-15 已发布          │

│  │ [取消]    │ │ [取消]    │     │

│  └──────────┘ └──────────┘     │

│  ┌──────────┐ ┌──────────┐     │

│  │ 文章标题3 │ │ 文章标题4 │     │

│  │ 2025-01-10 已发布          │

│  │ [取消]    │ │ [取消]    │     │

│  └──────────┘ └──────────┘     │

└─────────────────────────────────┘

“`

**在侧边栏使用：**

1. 进入 **外观** → **小工具**

2. 添加「短代码」小工具到侧边栏

3. 输入 `

`

**在页面模板中使用：**

“`php

<?php echo do_shortcode(‘

‘); ?>

“`

—

## ⚙️ 后台配置

### 进入配置页面

**路径：** WordPress 后台 → **子比主题设置** → **文章订阅设置**

### 配置项说明

#### 📌 基础配置

| 配置项 | 说明 | 默认值 |

|——–|——|——–|

| 订阅卡片内边距 | 调整卡片内容的间距 | 30px |

| 开启邮件通知 | 文章更新时发送邮件 | 开启 |

| 开启站内消息通知 | 文章更新时发送站内消息 | 开启 |

#### 🎨 样式配置

| 配置项 | 说明 | 默认值 |

|——–|——|——–|

| 主题主色调 | 订阅模块的主色调 | #ff6ba7（少女粉）|

| 主题浅色调 | 渐变效果的浅色 | #ff9eb5 |

| 按钮圆角 | 订阅按钮的圆角大小 | 30px |

| 卡片圆角 | 订阅卡片的圆角大小 | 8px |

#### 📝 文字配置

| 配置项 | 说明 | 默认值 |

|——–|——|——–|

| 订阅框标题 | 订阅卡片的标题 | 订阅文章更新通知 |

| 订阅按钮文字 | 未订阅时的按钮文字 | 订阅本文更新 ✧ |

| 取消订阅按钮文字 | 已订阅时的按钮文字 | 已订阅 ✧ 取消订阅 |

| 说明文字 | 订阅卡片的说明 | 订阅后，本文有新更新时会… |

| 我的订阅页面标题 | 订阅列表标题 | 我的订阅文章 |

| 我的订阅空提示 | 无订阅时的提示 | 你还没有订阅任何文章哦 |

| 我的订阅空引导 | 无订阅时的引导 | 快去发现喜欢的文章订阅吧 ✧ |

| 订阅成功提示 | 订阅成功的提示 | 订阅成功啦 ✧ 有更新会第一时间通知你 |

| 取消订阅提示 | 取消订阅的提示 | 已取消订阅 ~ 有点小失落呢 |

| 网络错误提示 | 网络错误时的提示 | 网络有点小问题呢，请重试 ~ |

| 邮件通知标题 | 邮件标题模板 | 【✧】你订阅的文章《%post_title%》已%action_type% |

| 邮件按钮文字 | 邮件中的按钮文字 | 点击查看更新内容 |

| 邮件Logo图片 | 邮件顶部Logo | 无 |

### 邮件标题变量说明

邮件标题支持以下变量替换：

| 变量 | 说明 | 示例 |

|——|——|——|

| `%post_title%` | 文章标题 | 《WordPress入门教程》 |

| `%action_type%` | 操作类型 | 发布 / 更新 |

| `%author%` | 作者名称 | 小明 |

**示例：**

“`

原始标题：【✧】你订阅的文章《%post_title%》已%action_type%

实际发送：【✧】你订阅的文章《WordPress入门教程》已更新

“`

—

## 💡 高级用法

### 在 PHP 模板中调用

“`php

<?php

// 显示文章订阅框

echo do_shortcode(‘

‘);

// 显示我的订阅列表

echo do_shortcode(‘

‘);

?>

“`

### 在 Elementor 中使用

1. 添加「短代码」元件

2. 输入对应的短代码

3. 调整元件样式

### 检查用户是否订阅某文章

“`php

<?php

if (function_exists(‘zibll_check_subscribe_status’)) {

    $is_subscribed = zibll_check_subscribe_status($user_id, $post_id);

    if ($is_subscribed) {

        echo ‘用户已订阅此文章’;

    }

}

?>

“`

—

## ❓ 常见问题

### Q1: 短代码不显示？

**可能原因：**

– 不在文章详情页（订阅框仅在文章页生效）

– 未安装/启用 CSF 框架

– 主题不支持

**解决方法：**

– 确保在 `single.php` 对应的文章页面使用

– 检查 Zibll 主题是否正常启用

### Q2: 邮件发送失败？

**可能原因：**

– 服务器未配置邮件发送

– 邮件被拦截到垃圾箱

**解决方法：**

– 安装 SMTP 插件（如 WP Mail SMTP）

– 检查垃圾邮件箱

### Q3: 站内消息不显示？

**可能原因：**

– Zibll 主题版本过低

– 未开启站内消息功能

**解决方法：**

– 更新 Zibll 主题到最新版本

– 检查主题设置中的消息功能

### Q4: 样式显示异常？

**解决方法：**

– 清除浏览器缓存

– 检查主题是否启用了深色模式

– 在后台重新保存一次插件设置

### Q5: 如何批量发送通知？

在文章编辑页面侧边栏，有「手动发送更新通知」按钮，点击即可向所有订阅用户发送通知。

—

## 📊 数据库表结构

插件会创建以下数据表：

“`sql

wp_zibll_article_subscribe

├── id (mediumint) – 主键ID

├── user_id (mediumint) – 用户ID

├── post_id (mediumint) – 文章ID

├── user_email (varchar) – 用户邮箱

└── subscribe_time (datetime) – 订阅时间

“`

—

## 🔄 更新日志

### v2.1.0

– ✨ 新增 CSF 后台可视化配置

– ✨ 所有设置修改后前台实时生效

– ✨ 新增深色模式适配

– 🐛 修复样式兼容性问题