myaghobi / f3-captcha
A better captcha for Fat-Free Framework.
Requires
- bcosca/fatfree-core: ^3.6
This package is auto-updated.
Last update: 2024-10-20 12:15:05 UTC
README
A better captcha for Fat-Free Framework.
Config
This plugin is configurable via config file:
[captcha] LENGTH=5 CASE_SENSITIVE=TRUE WIDTH=150 HEIGHT=70 FONT=monofont.ttf FONT_SCALE=0.65 WAVES=TRUE LETTERS=123456789abcdefghijklmnopkrstuvwxyz KEY=captcha_code
The above config is the default, you can ignore/remove each one you don't need to change.
Usage
1. Install
If you use composer, run the below code:
composer require myaghobi/f3-captcha
For manual installation:
- Copy the content of
lib/
folder into yourlib/
folder. - Copy content of
ui/
into yourui/
folder.
2. Routing
To show the captcha, you need to add a new route:
$f3->route('GET /captcha', 'Captcha->makeCaptchaImage');
3. Serve
Within your controller you need to serve the captcha:
$f3->set('captcha', \Captcha::instance()->serve());
And in your HTML template:
{{@captcha|raw}}
4. Verification
Finally you need to verify entered security code:
if (\Captcha::verify()) { ...
Customization
- Style
The default captcha template can be changed by the developer, check out ui/captcha/captcha.html
.
- Font
The default font is monofont.ttf
, you can add your font in ui/fonts/
and set the font name in config file.
License
You are allowed to use this plugin under the terms of the GNU General Public License version 3 or later.
Copyright (C) 2021 Mohammad Yaghobi