QidaoConnect - 栖岛账号登录插件

这是一款为Typecho/WordPress系统开发的插件，支持使用栖岛账号进行登录和注册。后续会支持更多系统的插件

功能特点

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

安装方法

1. 下载插件并解压
   QidaoConnect_Typecho.zip

QidaoConnect_WordPress.zip

1. 将插件目录重命名为QidaoConnect并上传到Typecho的插件目录（/usr/plugins/）
2. 登录Typecho后台，在"控制台"->"插件"中找到"QidaoConnect"，点击"启用"
3. 点击"设置"，填写栖岛OAuth应用的Client ID和Client Secret

配置说明

• 应用ID(Client ID): 在栖岛开放平台申请的应用ID
• 应用密钥(Client Secret): 在栖岛开放平台申请的应用密钥
• 回调地址: 登录成功后的回调地址，需要将此地址设置到栖岛开放平台的回调域中
• 授权域(Scope): 请求的权限范围，多个权限用空格分隔
• 是否需要完善资料: 用户使用栖岛账号登录后，是否需要完善昵称、邮箱等信息
• 默认用户组: 栖岛用户登录后默认的用户组权限，不同用户组拥有不同的操作权限
• 特权邮箱列表: 这些邮箱的栖岛用户将获得管理员权限，一行一个邮箱

使用方法

后台登录页面

插件启用后，会自动在Typecho后台登录页面底部添加栖岛登录按钮，无需额外设置。

前台登录页面

在需要显示登录按钮的地方，添加以下代码：

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

如果需要显示文本链接而不是图标按钮：

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

在模板中使用

在主题模板文件中添加栖岛登录按钮（例如在comments.php或sidebar.php中）：

<?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

常见问题

Q: 为什么登录后跳转到首页而不是原来的页面？
A: 请确保您的Typecho网站配置正确，特别是"站点地址"和"站点根目录"设置。

Q: 登录时提示"获取栖岛用户信息失败"？
A: 请检查您填写的Client ID和Client Secret是否正确，以及授权域（Scope）是否设置正确，申请的时候如果不包含这些权限但是又填写了不存在的权限就会出现问题。

Q: 首次注册成功，但退出后再次登录提示"注册失败"？
A: 这可能是由于邮箱冲突导致的。请确保您的栖岛账号邮箱与Typecho中已有账号的邮箱不冲突，或者尝试先使用该邮箱在Typecho中注册账号，然后再使用栖岛账号登录并绑定。

Q: 如何修改登录按钮的样式？
A: 您可以通过CSS自定义栖岛登录按钮的样式，按钮的HTML结构为一个带有图片的链接。

版权和许可

本插件版权归艺当然所有。您可以自由使用和分发本插件，但不得修改插件代码，且必须保留原始版权信息和作者署名。未经授权，不得将本插件进行二开。

关于开发者

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