独家-zibll初晨订阅 – 订阅按钮使用说明【满血优化的】

# zibll初晨订阅 - 订阅按钮使用说明

## 插件简介

zibll初晨订阅是一款专为zibll主题设计的文章订阅推送插件。用户订阅后，网站发布新文章时会自动通过邮件通知订阅用户，提升用户活跃度和转化率。

## 订阅按钮功能

- ✅ **全局订阅**：用户订阅后，网站发布任何新文章都会收到邮件通知
- ✅ **自动推送**：文章发布后自动发送邮件通知给所有订阅用户
- ✅ **登录保护**：订阅按钮只对已登录用户显示
- ✅ **邮箱绑定**：未绑定邮箱的用户订阅时会自动引导绑定邮箱

## 使用方法

### 方式一：在WordPress小工具中使用（推荐）

这是最简单、最推荐的使用方式，适合在侧边栏、页脚等位置显示订阅按钮。

#### 使用步骤：

1. 进入 WordPress 后台
2. 点击 **外观** → **小工具**
3. 找到 **自定义HTML** 小工具
4. 将小工具拖拽到任意侧边栏位置
5. 在小工具的 **内容** 框中输入以下短代码：

```
[zibll_subscribe_button]
```

6. 点击 **保存**

#### 注意事项：

- WordPress 小工具的自定义HTML不支持PHP代码，必须使用短代码
- 短代码格式：`[zibll_subscribe_button]`（注意中括号是英文的）
- 订阅按钮会自动适配zibll主题的样式（深色/浅色模式）

### 方式二：在文章或页面内容中使用

如果需要在文章内容或页面内容中显示订阅按钮，可以直接在编辑器中输入短代码。

#### 使用步骤：

1. 编辑文章或页面
2. 在需要显示订阅按钮的位置输入：

```
[zibll_subscribe_button]
```

3. 发布或更新文章/页面

### 方式三：在主题模板文件中使用

如果需要在主题模板文件（如 `header.php`、`footer.php`、`sidebar.php` 等）中显示订阅按钮，可以使用PHP代码。

#### 使用步骤：

1. 打开主题模板文件（建议使用子主题，避免主题更新时丢失修改）
2. 在需要显示订阅按钮的位置添加以下代码：

```php
<?php 
if (function_exists('zibll_category_subscribe_global_button')) {
    echo zibll_category_subscribe_global_button();
}
?>
```

3. 保存文件

#### 注意事项：

- 此方法需要修改主题文件，建议使用子主题
- PHP代码不能在WordPress小工具中使用，小工具必须使用短代码

## 订阅按钮显示效果

订阅按钮会显示为：

- **未订阅状态**：
  - 一个居中的卡片样式
  - 顶部有铃铛图标
  - 标题："订阅新文章通知"
  - 描述文字："订阅后，网站发布新文章时会第一时间通过邮件通知您"
  - 蓝色"立即订阅"按钮

- **已订阅状态**：
  - 绿色"已订阅"按钮
  - 其他样式保持不变

## 功能说明

### 订阅流程

1. **已登录用户**：
   - 点击"立即订阅"按钮
   - 如果已绑定邮箱，直接订阅成功
   - 如果未绑定邮箱，会弹出邮箱绑定窗口，输入邮箱和验证码后完成订阅

2. **未登录用户**：
   - 订阅按钮不显示
   - 需要先登录才能看到订阅按钮

### 邮件通知

- 订阅成功后，网站发布新文章时会自动发送邮件通知
- 邮件内容包含文章标题、链接等信息
- 确保WordPress的邮件功能已正确配置（SMTP设置）

## 注意事项

1. **登录检查**：订阅按钮只对已登录用户显示，未登录用户看不到
2. **插件启用**：确保插件已启用且订阅功能已开启（后台 → zibll初晨订阅 → 基础设置）
3. **样式适配**：按钮样式会自动适配zibll主题的样式变量（深色/浅色模式）
4. **JavaScript依赖**：确保页面已加载jQuery和插件的JavaScript文件
5. **邮箱配置**：确保WordPress的邮件发送功能已正确配置

## 常见问题

### Q: 订阅按钮不显示？

**A:** 检查以下几点：
1. 用户是否已登录（订阅按钮只对已登录用户显示）
2. 插件是否已启用
3. 后台"zibll初晨订阅" → "基础设置"中是否已开启"启用分类订阅"
4. 短代码格式是否正确：`[zibll_subscribe_button]`（注意中括号是英文的）

### Q: 点击订阅后没有反应？

**A:** 检查以下几点：
1. 浏览器控制台是否有JavaScript错误
2. 确保jQuery已正确加载
3. 检查网络连接是否正常
4. 查看浏览器控制台的AJAX请求是否成功

### Q: 订阅后没有收到邮件？

**A:** 检查以下几点：
1. WordPress的邮件功能是否已正确配置（SMTP设置）
2. 检查垃圾邮件文件夹
3. 确认邮箱地址是否正确
4. 查看WordPress错误日志（如果启用了WP_DEBUG）

### Q: 短代码显示为文本而不是按钮？

**A:** 这通常发生在WordPress小工具中，解决方法：
1. 确保使用的是"自定义HTML"小工具，而不是"文本"小工具
2. 插件已自动添加过滤器支持小工具中的短代码执行
3. 如果仍然不显示，尝试清除浏览器缓存和WordPress缓存

### Q: 如何在多个位置显示订阅按钮？

**A:** 可以在多个位置使用短代码 `[zibll_subscribe_button]`：
- 侧边栏小工具
- 文章内容
- 页面内容
- 主题模板文件

每个位置都会显示相同的订阅按钮，用户状态是统一的。

## 技术支持

如有问题或建议，请访问：[www.ccyuanma.com](https://www.ccyuanma.com)

---

**版权@[初晨之家](https://www.ccyuanma.com)所有**

文章上展示

首页全宽底部

文章页面展示-侧边栏

后台展示