in2code/email2powermail

Convert Email-Addresses in TYPO3 Frontend to links to a powermail form. The form will be send to this email.

Installs: 7

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 1

Open Issues: 0

Type:typo3-cms-extension

2.0.0 2017-10-29 11:38 UTC

This package is auto-updated.

Last update: 2021-10-25 01:11:51 UTC


README

Introduction

Convert Email-Addresses in TYPO3 Frontend to links to a powermail form. The form will be send to this email. This will help you to hide email-addresses in frontend from spiders.

Screens

First of all define some email-addresses and add some names to it: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353837382f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d6957525a4b58597a44643970533567682f73637265656e2e706e67

Editors can add email addresses anywhere in the frontend: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353836372f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d4c316645354c5659704a4659596d44672f73637265656e2e706e67

But emails will not be shown in frontend: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353836382f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d4742427661315173336e30734a56736d2f73637265656e2e706e67

Instead they will parsed into links to a powermail form: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353836392f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d35764a31756c536e664a75354d7833572f73637265656e2e706e67

After clicking a link, a powermail form will be shown: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353837302f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d424b597464654c784d733654776b68712f73637265656e2e706e67

Example if form was sent: 68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353837312f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d4e6c775933524a476e6e42553458445a2f73637265656e2e706e67

Installation

  • Install powermail 4.0.0 or newer first
  • Install this extension
  • Take care that static templates (powermail and email2powermail are included) - Important: powermail must be included before email2powermail!
  • Add a powermail form to a page and remember the PID (e.g. 123)
  • Add this pid to constants: plugin.tx_email2powermail.settings.pid=123
  • Add some email-records to a sysfolder (all this emails will be encoded in frontend)
  • Have fun!

Dependencies

  • Powermail 4.0.0 or newer
  • TYPO3 7.6 or newer
  • PHP 5.5 or newer

Changelog

Version Date Description
2.0.0 2017-10-29 Update for powermail 4.x
1.1.1 2017-05-20 TCA update for TYPO3 8.7
1.1.0 2017-03-17 Add simple mode to convert all email addresses
1.0.1 2016-10-05 Prevent function if extension is turned off
1.0.0 2016-10-03 Complete refactored version of email2powermail

Best practice

1) Add a label field to the form

If you want to add a label field in the form, you can add a new field of type TypoScript and add the path lib.email2powermail.decode.introductionText With this a field will be shown at first if powermail will be called from a link.

68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353838302f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d68684132677764793336314d4a386f672f73637265656e2e706e67

Of course you can also use this TypoScript in your setup if you need this.

2) Use a marker after the form is submitted to show where the mail goes

You can use markers like {email2powermail_name} or {email2powermail_email} in the RTE of powermail:

68747470733a2f2f626f782e6576657268656c7065722e6d652f6174746163686d656e742f3539353838312f38343732356662372d306233652d346334302d623532652d3239643736323037373762622f3236323430372d69485746667741496e4e6348696342382f73637265656e2e706e67

3) Use another table for encoding (e.g. fe_users or be_users)

See TypoScript file EXT:email2powermail/Configuration/TypoScript/setup.txt - there is a mapping configuration. Per default tx_email2powermail_domain_model_email will be used, but you can also use another table - see following example. Use fe_users which are located in pages 1 or 237. Use field email for email and use field first_name for name:

config.tx_extbase {
	persistence {
		classes {
			In2code\Email2powermail\Domain\Model\Email {
				# Example how to use fe_users instead of tx_email2powermail_domain_model_email
				mapping {
					tableName = fe_users
					columns {
						uid.mapOnProperty = identifier
						email.mapOnProperty = email
						first_name.mapOnProperty = name
					}
					in {
						pid = 1,237
					}
				}
			}
		}
	}
}