README

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

General

Ensure that spamshield is enabled (see below)
Add a field of Type Powermailcaptcha to your powermail form
Have fun

Example for TypoScript Constants:

plugin.tx_powermailcaptcha.captchaMethod = recaptcha
plugin.tx_powermailcaptcha.captchaMethod = friendlycaptcha
plugin.tx_powermailcaptcha.captchaMethod = hcaptcha
plugin.tx_powermailcaptcha.captchaMethod = cloudflare
plugin.tx_powermailcaptcha.sitekey = 6LdsBBUTAAAAAKMhI67inzeAvzBh5JdRRxlCwbTz
plugin.tx_powermailcaptcha.secretkey = 6LdsBBUTAAAAAKMhaaaainzeAvzBh5JdRRxlCwbyy

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:

plugin.tx_powermailcaptcha.useSiteLanguage = 0

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):

plugin.tx_powermail.settings.setup.spamshield._enable = 1

Keep up to date if powermail recognize spam (TypoScript setup):

# Get an email if spam was recognized
plugin.tx_powermail.settings.setup.spamshield.email = spamreceiver@yourdomain.de

# Write to a logfile when spam was recognized
plugin.tx_powermail.settings.setup.spamshield.logfileLocation = typo3temp/logs/powermailSpam.log

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.

<f:render partial="Form/Field/{vh:String.Upper(string:field.type)}" arguments="{field:field, languageIso:languageIso}"/>

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
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

traw / powermailcaptcha

Maintainers

Details