refbw/uniform-simple-captcha

为 'mzur/kirby-uniform' 及 Kirby v3 提供简单验证码保护

安装: 29

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 0

开放问题: 0

类型:kirby-plugin

2.1.1 2022-05-16 08:49 UTC

This package is not auto-updated.

Last update: 2024-09-14 05:19:04 UTC


README

此插件实现了 Martin Zurowietz 的 kirby-uniform 插件为 Kirby v3 的简单验证码保护 - 无依赖项且符合 GDPR,由 php-simple-captcha 提供支持,它是 Gregwar/Captcha 的分支。

注意:生成的图像使用数据 URI 作为其 src 属性,其他所有操作都由 Kirby 的 会话对象 处理。

入门指南

使用以下方法之一安装和使用 refbw/uniform-simple-captcha

Git 子模块

如果您熟悉 Git,您可以将其作为 子模块 下载此插件

git submodule add https://codeberg.org/refbw/uniform-simple-captcha.git site/plugins/uniform-simple-captcha

Composer

composer require s1syphos/refbw/uniform-simple-captcha

克隆或下载

  1. 克隆下载 此存储库。
  2. 解压缩 / 将文件夹移动到 site/plugins

使用方法

模板

有两个辅助函数

  • simpleCaptcha() 用于验证码 img 标签
  • simpleCaptchaField() 用于其 input 字段

您可以在模板中使用它们,如下所示

# Captcha image
# Vanilla
<?= simpleCaptcha() ?>

# Custom attributes
<?= simpleCaptcha(['class' => 'some-class', 'title' => 'solve me!' ]) ?>

# Input field
<?= simpleCaptchaField() ?>

# Custom `id` (eg for use with a label)
<label for="my-captcha">Not so fast!</label>
<?= simpleCaptchaField('my-captcha', ['class' => 'some-class']) ?>

控制器

之后,您需要在 $form 对象上调用 simplecaptchaGuard() 以启用保护。

有关更多信息,请参阅 kirby-uniform 文档中的 魔法方法

$form = new Form();

if ($kirby->request()->is('POST')) {
    # Call security
    $form->simplecaptchaGuard();

    # .. more code
}

配置

您可以从全局的 config.php 中更改某些选项(《simple-captcha.optionName》

注意

  • RGB = RGB 值数组,例如 [0, 255, 0]
  • HEX = 十六进制表示,例如 '#fafafa'

许可证

此插件受 MIT 许可证 的许可,但 在生产中使用 Kirby 需要您 购买许可证