26. November 2009

TipAFriend mit powermail

in Extension, TypoScript

Im TER gibt es bereits ein paar ReferAFriend Erweiterungen, mit denen man einen Freund auf die aktuelle besuchte Internetseite aufmerksam machen kann. Auch mit powermail ist diese Funktionalität ohne Probleme nachbaubar. Die Idee kam mir eigentlich erst nach einem Tipp durch die TYPO3 Usergroup Leipzig.

Warum powermail?
Der Einsatz von powermail macht vor allem dann Sinn:

  1. powermail wird sowieso bereits auf dem System genutzt
  2. Man bestimmt selbst, wieviele und welche Felder gebraucht werden
  3. Verschiedenste Spam-Prevention Maßnahmen werden unterstützt
  4. Speicherung in Datenbank ist Standard
  5. Der Admin kann zur Kontrolle mitlesen
  6. Flexibilität kann genutzt werden (JS Validierung, Eingabenvalidierung über userFunc, TypoScript stdWrap für Felder, etc…)

Die Idee
Der Absender in einem powermail Formular bekommt in der Regel sowieso eine Mail. Jetzt muss nur noch der Empfänger im Frontend bestimmbar sein. Die gewünschte URL kann man in einem Hiddenfield über Typoscript vorfüllen.

Die Umsetzung
1. Formular erstellen
Eine neue Seite (z.B. im Menü verborgen) erstellen und ein powermail Formular einfügen. Beispielfelder können hier sein: Absender-Vorname, Absender-Nachname, Absender-E-Mail, Empfänger-Vorname, Empfänger-Nachname, Empfänger-E-Mail, Submit, Hiddenfield für die zu nutzende URL (Hier könnt ihr natürlich selbst entscheiden, welche Felder Pflichtfelder sein sollen).

In dem Beispiel oben gibt es noch ein weiteres Feld „Zeige URL (TS)“ mit dem man die URL nochmal im Formular anzeigt.

Hier ein paar Beispiele zu den anderen wichtigen Feldern in powermail:
TipAFriend mit der TYPO3 Extension powermail - Bild1
TipAFriend mit der TYPO3 Extension powermail - Bild2
TipAFriend mit der TYPO3 Extension powermail - Bild3

2. Die URL einbauen
Man kann nun das Hiddenfield über Typoscript vorfüllen:

# a) Get URL
lib.tipafriend = TEXT
lib.tipafriend.data = GPvar:rp
lib.tipafriend.htmlSpecialChars = 1
 
# b) Write label for form
lib.tipafriendlabel = COA
lib.tipafriendlabel {
	wrap = <div class="tx_powermail_pi1_fieldwrap_html tx_powermail_pi1_fieldwrap_html_text tx_powermail_pi1_fieldwrap_html_0">|</div>
 
	10 = TEXT
	10.value = URL:
	10.noTrimWrap = || |
 
	20 < lib.tipafriend
}
 
# c) Fill hidden field
plugin.tx_powermail_pi1.prefill.uid123 < lib.tipafriend

Bei a) wird das Objekt einfach nur mit dem Inhalt der GET Variable &rp=inhalt befüllt (Wichtig ist hier htmlSpecialChars, das XSS verhindern soll).
Bei b) wird ein anderes Objekt erstellt, das man im Formular wieder aufgreifen kann – es zeigt im Formular nochmal die zu versendende URL.
Bei c) wird das Feld uid123 (unser Hiddenfield) mit dem GET Parameter &rp=inhalt befüllt

3. Link auf Formular
Wie bei anderen TipAFriend Erweiterungen braucht man noch einen Link auf die Formularseite mit dem GET Parameter der aktuellen Seite.
Ein Mail-Icon mit einem entsprechendem Link kann z.B. so aussehen:

# Create TipAFriend link
lib.tipafriend_icon = IMAGE
lib.tipafriend_icon {
	file = fileadmin/mail.gif
	altText = Seite empfehlen
	titleText = Seite empfehlen
	imageLinkWrap = 1
	imageLinkWrap.enable = 1
	imageLinkWrap.typolink.parameter = 123
	imageLinkWrap.typolink.additionalParams.cObject = COA
	imageLinkWrap.typolink.additionalParams.cObject {
		10 = TEXT
		10.wrap = &rp=
		10.data = getIndpEnv:TYPO3_SITE_URL
 
		20 = TEXT
		20.typolink.parameter.data = TSFE:id
		20.typolink.returnLast = url
	}
}
 
# Output on a subpart in the html Template
page.10.subparts.TIPAFRIEND < lib.tipafriend_icon

Abschließendes Blabla

  • ACHTUNG – Generell gilt für TipAFriend Erweiterungen: Gerade wenn man dem User die Wahl der Empfängeradresse überlasst, sollte man ein achtsames Auge auf die Nutzung des Formulares werfen. Sonst habt ihr im Handumdrehen eine Spamschleuder geschaffen.
  • Das ist nur ein Hinweis, wie man es machen kann. Sicher gibt es noch ein paar coole Dinge, die man mit einbauen könnte (Geschlechtsspezifische Anrede, etc…)

Ein paar Links

Hoffentlich kann es jemand gebrauchen,

Cheers, Alex

9 Reaktionen zu “TipAFriend mit powermail”

Kommentare abonnieren (RSS) oder TrackBack URL

Danke für die Verlinkung und das sehr ausführliche Tutorial. Man könnte ja inzwischen ein Buch zu Powermail schreiben … Diese Extension ist einfach megacool 🙂

Cheers, Dierk
TUGLE – TYPO3 Usergruppe Leipzig
c/o and-advertising.de

Dierk Landmann am 26. November 2009 um 11:55

Wärs nicht gescheiter die URL eben nicht durch ein Hidden-Feld zu setzen sondern erst später zu füllen?

zumindest sollte vorm verschicken noch geprüft werden ob die URL auch zur eigenen Website gehört, eventuell t3lib_div::sanitizeLocalUrl()?

Georg Ringer am 26. November 2009 um 18:56

Die URL kann über
plugin.tx_powermail_pi1.validate {
uid999.expression = #^http://www.example.com/#
uid999.errormsg = Ungültige URL!
}
vor dem Versenden zumindest auf die Domain überprüft werden (uid999 ist die entsprechende uid).

Chris Müller am 14. Dezember 2009 um 14:13

Eine .t3d wäre zu der Idee noch recht schön. Powermail-Forms zu erstellen ist zwar komfortabel, aber auch eine menge geklicke, was ich mittlerweile recht unangenehm finde und ich mir ein paar t3ds zurechtgebastelt habe damit ich diesen Schritt nicht ständig wiederholen muss.. 🙂

Bernhard Berger am 14. Dezember 2009 um 18:02

Super sache – was eventuell erwähnt werden sollte ist das man die 2 lib. ins Template nehmen muss. Bzw Meta daten ergänzen:

und:

plugin.tx_powermail_pi1.clear.session = 1

sonst gibts Probleme mit dem Cache.

Franz am 01. April 2010 um 16:25

Also ich würde das versenden fremder URL’s einfach dadurch verhindern, dass ich nur die uid der Seite übergebe, und die Url selber dann erst in den einzelnen „Ansichten“ per TS zusammenbaue. (bestätigunsseite, sendermail, empfänger mail). Dann kann sollten die Links immer stimmen. So könnte ich dann auch noch weitere Informationen wie letztes Änderungsdatum oder der Gleichen über weitere marker in der Mail mitsenden. Dem sind da ja eigendlich keine Grenzen gesetzt. 🙂

Björn Biege am 27. September 2010 um 23:29

Ich hab die Lösungsvariante ausprobiert und es funktioniert alles soweit und so gut.
Nur ich würde gerne Artikel aus tt_news versenden, kriegs abre nicht auf die reihe, die den cHash zu übergeben

Karl Heller am 21. Oktober 2010 um 22:29

Die Links zu den Grafiken sind alle kaputt.

Und aufpassen!
Ab Typo3 V4.3 ist ‚GPvar‘ deprecated. Man soll ‚GP‘ benutzen. Ab Typo3 V4.7 geht nämich ‚GPvar‘ nicht mehr. – Böse Falle, in die ich gerade reingetappt bin!

bergischweb am 18. Juli 2012 um 18:33

############################################################
### GPvar = Deprecated ! Bitte GP verwenden ! 22.10.2012 ###
############################################################
lib.tipafriend = TEXT
lib.tipafriend.data = GP:rp
lib.tipafriend.htmlSpecialChars = 1

…

### c) Fill hidden field
### Veraltet …. 22.10.2012
#plugin.tx_powermail_pi1.prefill.uid57 < lib.tipafriend

### muss man im Feld bei "Erweitert" und "Variablenname" definieren, in diesem Fall "hiddenlink" – 22.10.2012
plugin.tx_powermail {
settings {
setup {
prefill {
#ihrenachricht = vordefinierte Nachricht
hiddenlink < lib.tipafriend
}
}
}
}

heiko am 23. Oktober 2012 um 00:05

Kategorien

Archiv