随着目前typecho插件的不断发展,出了很多的美化插件,特别是登录页面的美化插件。
对于旧版的TypechoOAuthLogin插件,使用的是代码引用的方式,需要在主题的适当位置添加代码。
并且输出的格式一定,不能自定义。这就造成了对美化插件的冲突,导致整体的不协调。

针对以上问题,尝试构建新版的插件,提供多种输出和引用格式,用于适配各种主题。

v2版本使用说明

插件介绍

1.自动识别sdk。在前面的v1版本中,虽然支持自定义SDK,但是基本是写死的,比较难修改。对于v2版本,只需要按照标准修改SDK即可自动识别,包括logo;

2.sdk只需要添加服务器的OpenID Connect 发现文档URL,sdk就可以自行获取所需的URL,免去其他繁杂配置;

3.支持导入和导出插件配置;

4.自动插入登录按钮。目前针对AdminBeautify、GateLogin的登录页进行了适配,可以直接插入登录按钮。(如有其他需求,再另外适配)

5.代码引用方式扩展。通过不同代码引用三种登录样式。

插件下载:

下载地址:https://github.com/tianlingzi/TypechoOAuthLogin/releases

本站CDN下载:TypechoOAuthLogin.zip

使用方法

第三方登录配置

在插件设置中,添加“第三方登录配置”:平台类型、显示名称(仅按钮样式生效)、Client ID、Client Secret、是否启用等参数。

添加自定义的通用OAuth2.0/OIDC登录配置

  1. 进入SDK目录,其中的“TemplateSDK.class.php"文件复制一份,并重命名为:”{平台类型拼音}SDK.class.php"。如:AuthentikSDK.class.php;
  2. 修改AuthentikSDK.class.php文件中的displayName和OpenIDConfiguration对应的参数;
  3. 重新进入插件设置,即可自动识别出新的平台类型。
  4. 同一类型平台只能有一条配置起作用。对于有多个自定义的第三方平台,需要设置不同的SDK以及平台名称。

自动插入说明

  1. 由于插件是使用钩子自动插入,因此插件的加载顺序要在美化插件之前(即:先启用本插件,再启用美化插件)。

显示格式

  1. 默认为圆形图标样式。仅平台logo。
  2. 按钮样式。长方形按钮+文字(由于各美化主题的标签不同,会导致按钮的样式千奇百怪,慎用)
  3. 矩形图标样式。一般为平台logo+文字名称。
  4. 圆形图标和矩形图标可自行更换,只需要按照平台名称:XXX。图标名称:icon\_XXX.png、XXX.png,类似格式命名即可。

代码引用

各个显示样式的代码引用如下:

圆形图标样式

<?php TypechoOAuthLogin_Plugin::showImages(); ?>

矩形图标样式

<?php TypechoOAuthLogin_Plugin::showRectImages(); ?>

按钮样式

<?php TypechoOAuthLogin_Plugin::showButtons(); ?>

代码引用情况下,只会输出最简单的样式,只有图标、文本,没有其他元素。方便用户根据实际情况进行美化。

旧版v1插件详情:

最后修改:2026 年 09 月 29 日
如果觉得我的文章对你有用,请随意赞赏