tacraft-social-guild / flarum-login-screen

1.0.0 2026-10-30 01:38 UTC

Requires

• flarum/core: ^2.0

Requires (Dev)

• flarum/testing: ^2.0

MIT

• TCS Dev HUB

• flarum

Published on Packagist.org on 2026-10-30 01:43 UTC

README

面向 Flarum 2 的登录界面美化扩展：只重绘原生登录弹窗的外观与第三方登录按钮的排列方式，不新增登录方式，也不修改任何登录逻辑与表单字段。

安装

环境要求：

Flarum 2.0 +
PHP 8.5 +

1 . 在 Flarum 的 composer.json 中添加仓库源（若已添加则跳过）：

{
  "repositories": [
    {
      "type": "vcs", 
      "url": "https://github.com/TaCraft-Social-Guild/flarum-login-screen"
    }
  ]
}

2 . 在require中添加获取的分支属性：

{
  "require": {
    "tacraft-social-guild/flarum-login-screen": "dev-main"
  }
}

3 . 执行安装命令：

composer require tacraft-social-guild/flarum-login-screen

4 . 清理PHP缓存：

php flarum cache:clear

安装完成后进入「管理后台 → 扩展 → Login Screen」进行配置。

更新

composer update tacraft-social-guild/flarum-login-screen
php flarum cache:clear

设置项

设置键均以 tacraft-social-guild-login-screen. 为前缀。

设置	设置键后缀	可选值	默认值
每行登录按钮数量	login_buttons_per_row	1 / 2 / 3 / 4	4
登录按钮尺寸	login_button_size	40 / 48 / 56 / 64 / 72 / 80 px	56
按钮提示延迟	login_button_tooltip_delay	0 / 250 / 500 / 750 / 1000 / 1500 / 2000 ms	500

按钮尺寸与提示延迟由 LESS 变量参与编译，修改后需执行 php flarum cache:clear 让资源重新编译。

兼容性

• Flarum 2.0 +（已在 Flarum 2.0.2 + PHP 8.5 上完成测试）

• 提示依赖 Popover API（Chrome 114+ / Safari 17+ / Firefox 125+）；不支持时退化为普通固定定位元素，功能不受影响

链接

• GitHub

许可

本项目基于 MIT license 发布。