refbw / uniform-simple-captcha
为 'mzur/kirby-uniform' 及 Kirby v3 提供简单验证码保护
2.1.1
2022-05-16 08:49 UTC
Requires
- getkirby/composer-installer: ^1.1
- mzur/kirby-uniform: ^5.0
- s1syphos/php-simple-captcha: ^2.1
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
克隆或下载
使用方法
模板
有两个辅助函数
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'