栖岛开放平台

<div align="center">

<h1>QidaoConnect - 栖岛账号登录插件</h1>
<p>支持 Typecho / WordPress 系统使用栖岛账号登录与注册</p>
</div>

✨ 功能特点

• ✅ 支持栖岛账号一键登录
• 🔗 支持将栖岛账号与已有 Typecho / WordPress 账号绑定
• 🆕 支持使用栖岛账号注册新用户
• ⚙️ 可配置是否需要完善用户资料
• 🔐 支持自定义授权域（Scope）
• 👥 支持设置默认用户组和特权邮箱

📦 安装方法

✅ Typecho 插件安装

1. 下载插件并解压：
   👉 QidaoConnect_Typecho.zip
2. 重命名文件夹为 QidaoConnect，上传到 Typecho 的插件目录：
   /usr/plugins/QidaoConnect
3. 登录 Typecho 后台 → 控制台 → 插件 → 启用 “QidaoConnect”
4. 点击“设置”，填写栖岛开放平台提供的 Client ID 和 Client Secret

✅ WordPress 插件安装

1. 下载插件并解压：
   👉 QidaoConnect_WordPress.zip
2. 将解压后的文件夹命名为 qidao-connect，上传到 WordPress 插件目录：
   /wp-content/plugins/qidao-connect
3. 登录 WordPress 后台 → 插件 → 启用 “QidaoConnect”
4. 进入“设置” → “QidaoConnect”，填写 OAuth2 配置参数（Client ID、Client Secret、Scope 等）

⚙️ 配置说明

🛠 使用方法

✅ 后台登录页面

插件启用后会自动在后台登录页底部添加“栖岛账号登录”按钮，无需额外操作。

✅ 前台登录页面（Typecho）

添加以下代码显示按钮：

<?php QidaoConnect_Plugin::loginBtn(); ?>

显示为文本链接：

<?php QidaoConnect_Plugin::loginBtn(true); ?>

✅ 模板中调用（Typecho）

在主题模板文件中添加：

<?php 
if (class_exists('QidaoConnect_Plugin')) {
    echo '<div class="qidao-login-container">';
    echo '<span>使用栖岛账号登录：</span>';
    echo QidaoConnect_Plugin::loginBtn();
    echo '</div>';
}
?>

🌐 栖岛开放平台配置指南

1. 打开：栖岛开放平台 并注册账号
2. 登录后创建一个 OAuth2 应用
3. 设置应用回调地址为插件中提供的回调地址
4. 复制生成的 Client ID 和 Client Secret 并填写到插件配置

5. 设置授权域 Scope，推荐至少包含：

   email screen_name avatar url

❓ 常见问题 FAQ

Q: 登录后跳转到首页而不是原页面？
A: 请检查 Typecho 或 WordPress 的站点地址设置，确保配置正确。

Q: 登录提示“获取栖岛用户信息失败”？
A: 请确认 Client ID / Secret 填写正确，Scope 中的权限必须在栖岛平台申请时包含。

Q: 首次注册成功，但再次登录提示“注册失败”？
A: 可能是邮箱已被其他账号注册。建议提前使用该邮箱注册账号后再绑定。

Q: 如何自定义登录按钮样式？
A: 可通过 CSS 自定义按钮外观，HTML 为图片链接形式，可完全自定义。

📜 版权与许可

本插件由 艺当然 原创开发，版权归属艺当然所有。

• ✅ 允许自由使用和分发
• ❌ 不允许修改源代码进行二次发布
• ✅ 必须保留原始版权信息与作者署名

👨‍💻 关于开发者

• 作者： 艺当然
• 栖岛平台： https://web.tvcloud.top/
• 插件版本： 1.0.0
• 版权年份： © 2023-2024 艺当然，保留所有权利