Download the PHP package traw/powermailcaptcha without Composer
On this page you can find all versions of the php package traw/powermailcaptcha. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package powermailcaptcha
powermailcaptcha
Captcha Extension for TYPO3 powermail to prevent spam
Dependencies
- powermail >= 8.0
- TYPO3 11 or 12
Installation
Just install this extension via composer composer require traw/powermailcaptcha
Google Recaptcha
- Register your domain to www.google.com/recaptcha/
- Works with reCAPTCHA, Version 2
- Add sitekey and secretkey to TypoScript Constants (see example below)
- In TypoScript Constants, set the captcha method to
recaptcha
(This is the default)
Friendly Captcha
- Register your domain to friendlycaptcha.com
- Add sitekey and secretkey to TypoScript Constants (see example below)
- In TypoScript Constants, set the captcha method to
friendlycaptcha
hCaptcha
- Register your domain to hcaptcha.com
- Add sitekey and secretkey to TypoScript Constants (see example below)
- In TypoScript Constants, set the captcha method to
hcaptcha
Cloudflare
- Register your domain to cloudflare.com
- Add sitekey and secretkey to TypoScript Constants (see example below)
- In TypoScript Constants, set the captcha method to
cloudflare
Prosopo Procaptcha
- Register your domain to prosopo.io
- Add sitekey and secretkey to TypoScript Constants (see example below)
- In TypoScript Constants, set the captcha method to
procaptcha
General
- Ensure that spamshield is enabled (see below)
- Add a field of Type Powermailcaptcha to your powermail form
- Have fun
Example for TypoScript Constants:
Disable captcha
From versions >= 1.3.0
In case you wish to disable the captcha temporarily, just add the following line to your typoscript constants:
plugin.tx_powermailcaptcha.enable = 0
You can also find this option in the Constant Editor.
Captcha Language
From Versions >=1.1.0
The current language is added to the captcha via language parameter which is taken from your Site Configuration.
To disable this behavior, add the following to your Typoscript Constants:
Depending on your website language, not all languages are supported for every Captcha-Method. Read
for further information on supported language codes.
Common pitfalls and best practice
spamshield must be enabled in powermail (TypoScript setup):
Keep up to date if powermail recognize spam (TypoScript setup):
Remove the default captcha field by adding the following to your Page TSConfig:
TCEFORM.tx_powermail_domain_model_field.type.removeItems = captcha
Breaking change - Upgrade from <1.5.0 to >=1.5.0
The typoscript has previously been automatically loaded in a Preset TypoScript setup file.
However, this is no longer the case. In multisite environments where some websites dont use powermail the typoscript is not needed.
Also in some case it's hard to override settings which are made in a Preset TypoScript (for example: ext_typoscript_setup.typoscript).
Therefore, from version 1.5.0 and up the typoscript has to be manually added in your website's static template.
Upgrade from 1.0.x to >=1.1.x
If you override powermail's partial Partial/Form/Page.html
in your own extension, make sure to add the variable languageIso
to the f:render of the Fields.
e.g.
If you override powermail's FormController in your own extension, please see EXT:powermailcaptcha/Classes/Controller/FormController.php
on how this extension adds the language variable.
Credits
This extension is based on EXT:powermailrecaptcha by einpraegsam.
Changelog
Version | Date | Description |
---|---|---|
2.1.0 | 2024-09-25 | Feature: add Prosopo Procaptcha captcha method |
2.0.0 | 2024-07-31 | Dropped support for TYPO3 11 and older powermail version |
1.6.0 | 2024-04-24 | Feature: add Cloudflare Turnstile captcha method |
1.5.0 | 2024-04-24 | Feature: add typoscript as a static template |
1.3.0 | 2023-06-05 | Feature: add option to disable frontend output |
1.2.0 | 2023-06-02 | Code Maintenance: simplifiy controller code |
1.1.0 | 2023-05-11 | Add option to force website language onto the Captcha |
1.0.0 | 2022-10-18 | Initial release |