Skip to content

「十八桥」社区入站测试系统。A simple entrance exam system for Bridge Eighteen.

License

Notifications You must be signed in to change notification settings

favocas/b18-exam

Repository files navigation

十八桥社区

入站测试系统

十八桥社区使用的入站测试系统,基于 Bootstrap 和 PHP。

反馈 Bug · 请求新功能

贡献者总数 Forks 总数 Stars 总数 Issues 总数 Composer 版本 许可证

目录
  1. 关于本项目
  2. 开始
  3. 主要功能
  4. 贡献
  5. 许可证
  6. 联系我们

关于本项目

这是十八桥社区的入站测试系统,用于让用户完成入站测试并根据成绩获得邀请码以注册。

(回到顶部)

构建工具

(回到顶部)

开始

要获取本地副本并且配置运行,你可以按照下面的示例步骤操作。

依赖

正常安装(生产环境推荐)

  1. Cloudflare 仪表板中获取 Turnstile 的密钥(测试用途不需要),然后去 Flarum 的个人主页获取 API 密钥。同时,你需要在 Flarum 中利用 OAuth Center 插件的管理面板创建一个新的应用,先复制(或记下)插件自动生成的 ID 和私钥,然后依需要填写其余内容。回调地址填 https://你的部署网站/admin/oauth.php
  2. 通过 Composer 创建新项目。这里的 my-new-project 可以根据实际需要更换。
    composer create-project bridgeeighteen/exam my-new-project
  3. config-example.php 中根据注释提示完成配置。如果只是用于测试,须保留模板中给定的 Turnstile 密钥。
  4. 使用 phpMyAdmin 等导入 table.sql 中定义的数据表及结构。
  5. questions 表中手工录入试题。在后续版本中,可以通过管理面板导入 Word 试题,由系统自动识别并录入。

使用 Git 克隆安装

  1. Cloudflare 仪表板中获取 Turnstile 的密钥(测试用途不需要),然后去 Flarum 的个人主页获取 API 密钥。同时,你需要在 Flarum 中利用 OAuth Center 插件的管理面板创建一个新的应用,先复制(或记下)插件自动生成的 ID 和私钥,然后依需要填写其余内容。回调地址填 https://你的部署网站/admin/oauth.php
  2. 克隆本仓库。
    git clone https://github.com/favocas/b18-exam.git
  3. 安装 Composer 依赖包。
    composer install
  4. config-example.php 中根据注释提示完成配置。如果只是用于测试,须保留模板中给定的 Turnstile 密钥。
  5. 使用 phpMyAdmin 等导入 table.sql 中定义的数据表及结构。
  6. questions 表中手工录入试题。在后续版本中,可以通过管理面板导入 Word 试题,由系统自动识别并录入。

(回到顶部)

主要功能

  • 支持单选/多选试题
  • 时间作弊检测
  • 自定义通过分数阈值、每题全对分数和多选题漏选分数
  • 完美支持 Flarum API 接口
  • 识别 Word 并自动录入试题

你也可以到 Open Issues 页查看所有请求的功能(以及已知的问题)。

(回到顶部)

贡献

贡献让开源社区成为了一个非常适合学习、互相激励和创新的地方。你所做出的任何贡献都是受人尊敬的。

如果你有好的建议,请复刻(Fork)本仓库并且创建一个拉取请求(Pull Request)。你也可以简单地创建一个议题(Issue),并且添加标签「enhancement」。不要忘记给项目点一个 Star!再次感谢!

  1. 复刻(Fork)本项目
  2. 创建你的 Feature 分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的变更 (git commit -m 'Add some AmazingFeature')
  4. 推送到该分支 (git push origin feature/AmazingFeature)
  5. 创建一个拉取请求(Pull Request)

(回到顶部)

许可证

根据 LGPL-3.0+ 许可证分发。GPL-3.0 和 LGPL-3.0 的完整副本请见 LICENSE

(回到顶部)

联系我们

管理团队邮箱:[email protected]

IRC 频道:#bridgeeighteen at Libera.Chat

(回到顶部)

About

「十八桥」社区入站测试系统。A simple entrance exam system for Bridge Eighteen.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published