README

What does it do?

This is a simple replacement for the direct_mail_subscription extension. It's buit on extbase, so translations and templating is much easier. You have the choice to use Google reCAPTCHA V3, V2 (invisible or checkbox) or Friendly Captcha (https://friendlycaptcha.com/).

It allows FE-users to

• Subscript to the newsletter (user receives a mail to confirm his email-address)
• Cancel newsletter subscription (user receives a mail to confirm his email-address)

Supported tt_address fields are

• gender
• firstName
• lastName
• name (will be set to 'firstName lastName' by default)
• moduleSysDmailHtml (by default set to 1 by a hidden field in the registration form)

By default, on subscription all existing records with identical email-adresses will be removed. This option can be disabled by TS-constant.

Configuration Reference

Include the static template of the extension in your site template

Typoscript Constants:

keepEmailAddressUnique (default: true)
Remove tt_address records with the same email-address on subscription.

includeJQuery (default: true)
Include jQuery library: disable if jQuery is already available.

removeAddress (default: true)
Remove email-address on cancel subscription: remove tt_address records on cancle subscription. disable to just hide them.

fromEmail
Email sender address for address-verification-emails. If not set, no mails will be sent!

fromName
Email sender name for address-verification-emails

useCaptcha CAPTCHA implementation to use (none / Google reCAPTCHA V2 checkbox / Google reCAPTCHA V2 invisible / Google reCAPTCHA V3, Friendly Captcha).
https://www.google.com/recaptcha/about/ https://friendlycaptcha.com/

invokeGrcV3JsGlobally If set to 1 and Google reCAPTCHA V3 is activated (useCaptcha), the reCAPTCHA javascript-library will be included globally in the head-section. This allows the algorithm to serve better guesses if the user is human or not. If set to 0, the script will be included in the plugin form (default: 0)

nameFieldsMaxChars Maximum allowed characters in the fields firstName / lastName (default: 25)

nameFieldsAllowedCharsRegEx Regular expression to validate allowed characters for fields firstName / lastName (default: /[^.:\/\@]+/).

captchaSiteKey Key that identifies your site / application. This key is provided by the CAPTCHA-service (application key or site key).

captchaSecret Secret key provided by your CAPTCHA-service (API key or secret key).

grc3ScoreTreshold Treshold for the score returned by Google CAPTCHA V3 in %. 50 is equivalent to a score treshold of 0.5 (default).

grc3ActionName Action name passed to the Google V3 engine (default: 'directmail_subscription')

scriptPath
Path to Scripts (default: typo3conf/ext/mmc_directmail_subscription/Resources/Public/Scripts/)

Storage for tt_address

• 'Default storage PID' of the extension
• 'Record Storage Page' of the FE-Plugin

ChangeLog

4.0.2

Update this ChangeLog :-)

4.0.1

remove obsolete $this->address; change private function getCurrentLanguageIsoCode to protected

4.0.0

TYPO3 12 ready

3.0.3

remove obsolete $this->address; make private function protected

3.0.2

Fixed dependencies

3.0.1

Fix indentation in PHP files

3.0.0

TYPO3 11 compatibility

2.2.2

Bugfix in README

2.2.1

Removed honeypot, added Google CAPTCHA and Friendly Captcha implementations and name fields restrictions.

2.1.3

Fix composer.json

2.1.2

• Move JS to footer
• change file ending .ts to .typoscript

2.1.1

Bugfixes (thanks to Loek Hilgersom):

• SubscribeController->getStandaloneView overrides original controller-context in TYPO3 10
• TypoScript condition in old style

2.1.0

update dependencies to enable direct_mail 7.0.0^

2.0.3

update this changelog :-)

2.0.2

fix extension dependencies

2.0.1

upgraded jquery core to 3.5.1
include js via typoscript-setup, use includeJSLibs for jQuery inclusion

2.0.0

TYPO3 9/10 compatibility; drop TYPO3 8 support

1.3.1

Trigger packagist

1.3.0

• Add composer support
• Move documentation to this file
• Change filenames constants.txt / setup.txt to *.ts
• Drop TYPO3 6/7 support

1.2.0

• TYPO3 8 compatibility
• language labels it: "Grazie Mille" instead of "Molte Grazie"

1.1.3

updated changelog :-)

1.1.2

multiple view-paths (for TYPO3 7) in typoscript-setup

1.1.1

Fixed minimal version for direct_mail to 4.1.0

1.1.0

Compatibility to TYPO3 7.6

1.0.0

• Modified es.locallang.xlf
• Changed state form "beta" to "stable"

0.9.9

es.locallang.xlf formating

0.9.8

• [FEATURE] Contribution by Benjamin Einert [b.einert(at)abija.de]: Option to hide address on unsubscript
• [BUGFIX] Error when record is already deleted when following email confirmation link
• Updated Documentation

0.9.7

Contributions by Loek Hilgersom [loek(at)netcoop.nl]: - [BUGFIX] Set actions register and cancel as non-cacheable actions to make them work in production context - Generate cleaner back links directly to current page without parameters because register is default action - [SECURITY] Set no-cache headers as soon as any personal data is passed to the view to avoid caching of personal data

0.9.6

• added FE-language labels for Dutch (nl). Thanks to Stefan Rosbak (srosbak@zigwebsoftware.nl)
• simplified honeypot implementation If you copied and customized the template, you have to consider change for the hidden honeypot fields!

0.9.5

email repeat check in forms