README

Google recaptcha for TYPO3 powermail to prevent spam

Dependencies

• powermail 8.x, 9.x, 10.x, 11.x, 12.x
• TYPO3 Version 10, 11 & 12
• Google recaptcha V2 (https://developers.google.com/recaptcha/docs/v2)

Installation

• Just install this extension via composer composer require in2code/powermailrecaptcha
• Register your domain to www.google.com/recaptcha/ (registration direct link: https://g.co/recaptcha/v3 - reCAPTCHA, Version 2)
• Add sitekey and secretkey to TypoScript Constants (see example below)
• Ensure that spamshield is enabled (see below)
• Add a field of Type Google Recaptcha to your powermail form
• Have fun

Example for TypoScript Constants:

plugin.tx_powermailrecaptcha.sitekey = 6LdsBBUTAAAAAKMhI67inzeAvzBh5JdRRxlCwbTz
plugin.tx_powermailrecaptcha.secretkey = 6LdsBBUTAAAAAKMhaaaainzeAvzBh5JdRRxlCwbyy

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

Early Access Programm for TYPO3 13 support

ℹ️ TYPO3 13 compatibility

See EAP page (DE) or EAP page (EN) for more information how to get access to a TYPO3 13 version

Changelog

Development

Environment is included. Set it up via:

• DDEV start
• Composer install
• ddev import-db .project/db.sql.gz

Made for TYPO3 12 / powermail 12