columbusinteractive / typo3-easycaptcha
一个易于使用的扩展,可让您在TYPO3表单扩展中使用验证码。
3.0.0
2023-07-17 08:36 UTC
Requires
- php: ^7.2 || ^8.0
- ext-gd: *
- ext-json: *
- laminas/laminas-captcha: ^2.9
- laminas/laminas-session: ^2.9.0
- laminas/laminas-validator: ^2.13.0
- typo3/cms-core: ^12.4
- typo3/cms-form: ^12.4
Requires (Dev)
- roave/security-advisories: dev-master
README
一个易于使用的扩展,可让您在TYPO3表单扩展中使用验证码
通过Composer安装
composer require columbusinteractive/typo3-easycaptcha
工作原理
在底层,此扩展使用出色的laminas/laminas-captcha
库。此扩展使用独立的会话容器以简化操作。设置了一个名为captcha
的独立会话cookie,并且仅对当前浏览器会话有效。请记住这一点,以符合您的cookie同意或隐私设置!生成的验证码图像会定期自动回收,所以无需担心。
用法
安装扩展后,您将在TYPO3表单编辑器中看到一个名为“Easy captcha”的新字段。只需添加该字段即可。别忘了在您的模板中添加静态typoscript文件!
自定义
以下选项在TYPO3表单编辑器中可用
- 生成图像的宽度
- 生成图像的高度
- 点噪声级别
- 线噪声级别
- 字体大小
- 单词长度
- 启用或禁用TTS(文本到语音)。此功能使用
SpeechSynthesis API
(https://mdn.org.cn/en-US/docs/Web/API/SpeechSynthesis)
样式
如果需要,可以自定义验证码。然而,在大多数情况下,默认样式应该足够。以下类可用
- easycaptcha(容器)
- easycaptcha--initialized(已初始化的验证码)
- easycaptcha__challenge(图像和按钮的包装器)
- easycaptcha__image-wrapper(图像的包装器)
- easycaptcha__image(图像)
- easycaptcha__actions(按钮的包装器)
- easycaptcha__action-tts(TTS按钮)
- easycaptcha__action-reload(重载按钮)
- easycaptcha__input-wrapper(输入的包装器)
JS API
可以通过window.easycaptcha
访问JavaScript API。
可用函数
easycaptcha.init(id: string|HTMLElement): void; easycaptcha.initAll(): void; easycaptcha.reload(id: string|HTMLElement): void; easycaptcha.tts(id: string|HTMLElement): Promise; easycaptcha.get(id: string|HTMLElement): HTMLElement; easycaptcha.getAll(): HTMLCollection;
演示
我们在公司的联系表单上使用了验证码。
https://www.columbus-interactive.de/kontakt
许可证
此TYPO3扩展是开源软件,采用MIT许可证