Wikizone - Benutzerbeiträge [de]

Typo3 - Benutzer Registrierung (sr feuser register)

2010-04-21T19:18:14Z

91.47.238.180: /* Wichtige TS Constanten */

Diese Extension kann die wichtigsten Dinge für Frontend Benutzer ab:
* Registrieren
* An- / Abmeldung
* Zuordnung zu verschiedenen Benutzergruppen
* etc.

== Links ==
[http://wiki.typo3.org/index.php/De:Front_End_User_Registration Typo3 Wiki]

[http://blog.marit.ag/2010/02/12/fe-user-gesalzenen/ User Registrierung mit gesalzenen Passwörtern]

== Quickstart ==
benötigt:
* static_info_tables
* div2007 (für Flexforms)
* kb_md5fepw (wenn md5 Passwords verwendet werden sollen)

=== Wichtige Ordner und Seiten ===
* O: Benutzer (oder Abos) enthält notwendige Benutzergruppen und die User
* S: Login (oder Newsletter) enthält normales Login und sr_feuser_register (default, startingpoint ist der feuser - Ordner)
*S: Registrierung (sr_feuser_register, mode create, startingpoint wie oben)

=== Benutzergruppen anlegen ===
* Gruppe für nicht bestätigte Registrierungen
* Gruppe für bestätigte Registrierungen

=== TypoScript ===
'''Statisches Template'''
* FE User Registration

'''Constants'''
<pre>
// Ordner mit Benutzern für Loginform
styles.content.loginform.pid = 87
// bei alter newloginbox...
# plugin.tx_newloginbox_pi1.storagePid = 87

plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 87
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2
// Seite mit Login Form
loginPID = 88
// Seite mit Registierung
registerPID = 89
// Seite zum editieren der Benutzerdaten
editPID = 90
// Seite mit Bestätigung der Registrierung
confirmPID = 91
// Wieviel Bilder dürfen hochgeladen werden
maxImages = 1
dateFormat = d.m.Y
dateSplit = .
salutation = informal
siteName = KO rockt!
formFields = password,first_name, last_name, email,module_sys_dmail_html, module_sys_dmail_category,disable
requiredFields = first_name,last_name,email
email = steff@ko-rockband.de
// nur mit RealURL ?
useShortUrls = 1
// Kategorien von Direct Mail
module_sys_dmail_category_PIDLIST = 86
//
dmailCheckedUponRegistration = 1
}
</pre>

'''Setup'''
<pre>
// Sprachlabel anpassen
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de{
v_really_wish_to_delete_informal = Willst Du Dein Konto wirklich löschen?
v_your_account_was_created_informal = Dein Konto <strong>%2$s</strong> wurde erstellt. Wir senden eine E-Mail an die Adresse <strong>%4$s</strong>, damit Du die Anmeldung bestätigen kannst.
}
// Titel der Benutzerseite überschreiben (wird in E-Mails benutzt)
plugin.tx_srfeuserregister_pi1.pidTitleOverride = KO rockt! News

</pre>

== Beispiel: sr_feuser_register für Newsletter einsetzen ==

In diesem Beispiel geht es darum die Benutzer Registrierung für Direct Mail (direct_mail) einzubauen und zu konfigurieren.

Typo3 - Benutzer Registrierung (sr feuser register)

2010-04-21T18:44:36Z

91.47.238.180: /* Benutzergruppen anlegen */

Diese Extension kann die wichtigsten Dinge für Frontend Benutzer ab:
* Registrieren
* An- / Abmeldung
* Zuordnung zu verschiedenen Benutzergruppen
* etc.

== Links ==
[http://wiki.typo3.org/index.php/De:Front_End_User_Registration Typo3 Wiki]

[http://blog.marit.ag/2010/02/12/fe-user-gesalzenen/ User Registrierung mit gesalzenen Passwörtern]

== Quickstart ==
benötigt:
* static_info_tables
* div2007 (für Flexforms)
* kb_md5fepw (wenn md5 Passwords verwendet werden sollen)

=== Wichtige Ordner und Seiten ===
* O: Benutzer (oder Abos) enthält notwendige Benutzergruppen und die User
* S: Login (oder Newsletter) enthält normales Login und sr_feuser_register (default, startingpoint ist der feuser - Ordner)
*S: Registrierung (sr_feuser_register, mode create, startingpoint wie oben)

=== Benutzergruppen anlegen ===
* Gruppe für nicht bestätigte Registrierungen
* Gruppe für bestätigte Registrierungen

=== TypoScript ===
'''Statisches Template'''
* FE User Registration

'''Constants'''
<pre>
// Ordner mit Benutzern für Loginform
styles.content.loginform.pid = 87
// bei alter newloginbox...
# plugin.tx_newloginbox_pi1.storagePid = 87

plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 87
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2
// Seite mit Login Form
loginPID = 88
// Seite mit Registierung
registerPID = 89
// Seite zum editieren der Benutzerdaten
editPID = 90
// Seite mit Bestätigung der Registrierung
confirmPID = 91
// Wieviel Bilder dürfen hochgeladen werden
maxImages = 1
dateFormat = d.m.Y
dateSplit = .
salutation = informal
siteName = KO rockt!
formFields = password,first_name, last_name, email,module_sys_dmail_html, module_sys_dmail_category,disable
requiredFields = first_name,last_name,email
email = steff@ko-rockband.de
// nur mit RealURL ?
useShortUrls = 1
// Kategorien von Direct Mail
module_sys_dmail_category_PIDLIST = 86
//
dmailCheckedUponRegistration = 1
}
</pre>

'''Setup'''
<pre>
// Sprachlabel anpassen
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de{
v_really_wish_to_delete_informal = Willst Du Dein Konto wirklich löschen?
v_your_account_was_created_informal = Dein Konto <strong>%2$s</strong> wurde erstellt. Wir senden eine E-Mail an die Adresse <strong>%4$s</strong>, damit Du die Anmeldung bestätigen kannst.
}
// Titel der Benutzerseite überschreiben (wird in E-Mails benutzt)
plugin.tx_srfeuserregister_pi1.pidTitleOverride = KO rockt! News

</pre>

=== Wichtige TS Constanten ===
<pre>
plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 0
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2

}
</pre>

== Beispiel: sr_feuser_register für Newsletter einsetzen ==

In diesem Beispiel geht es darum die Benutzer Registrierung für Direct Mail (direct_mail) einzubauen und zu konfigurieren.

AJAX in TYPO3 Extensions

2010-04-21T10:28:13Z

91.47.238.180: /* eID Datei */

== Übersicht ==
=== Links ===
http://prototypejs.org/learn/introduction-to-ajax

=== Typo3 Skripte ohne Rendering ===
Ein Ajax Request wird in den meisten Fällen über ein JavaScript abgesetzt von einem Serverskript (PHP) verarbeitet und die Antwort als xml oder JSON Objekt zurückgegeben.

Um das PHP-Skript zu nutzen und zugleich die ganzen '''Rendering und Caching-Mechanismen von Typo3 zu vermeiden''' könnte man irgend ein php Skript nutzen. Andererseits wollen wir die Typo3 Funktionalitäten wie dbal Datenbankabfrage etc. nutzen. Deshalb stellt Typo3 den '''eid Mechanismus''' zur Verfügung (siehe unten). Mit diesem wird das '''Seitenrendering frühzeitig abgebrochen''' und der Request direkt an ein Skript weitergegeben.

Eine weitere Möglichkeit außer dem eid Mechanismus findest du unter [[Typo3 - alternatives Rendering]]

=== Schnelle Antwort ===
Dieses Skript kann sich nun ausschließlich um die Anfrage kümmern und das Ergebnis direkt zurückgeben, welches wiederum die Daten in die Seite einhängt.

== Der eid Mechanismus und AJAX ==
Quellen: http://www.typo3-tutorials.org/tutorials/extensions/eid-mechanismus.html (10.3.2010 Artikel von 2007)

http://www.blogix.net/2009/02/08/typo3-eid-oder-daten-mit-ajax-anfordern/

eID steht für Extension ID
Der eID Mechanismus ist der seit der Version 4.x dabei und kann als '''alternative Rendering Engine''' betrachtet werden.

Angesprochen wird er über einen GET oder POST Parameter. Sobald '''eID als Parameter in der URL''' vorhanden ist (zB. ''www.domain.de/?eID=schuesselwort'') wird der normaler Rendering Prozess sehr früh abgebrochen und auf ein Script weitergeleitet was wir selber programmieren müssen. Da der normale Rendering Prozess so früh abgebrochen wird kommt es auch noch zu keiner Ausgabe. Es wird nichts gecachet und kein HeaderCode ect generiert. Der eID Mechanismus kann also super im Zusammenhang mit AJAX verwendet werden.

Wollen wir uns einmal die index_ts.php (typo3/sysext/cms/tslib/) Zeile 127 bis 136 ansehen.

<pre>
<?php
// *********************
// Look for extension ID which will launch alternative output engine
// *********************
if ($temp_extId = t3lib_div::_GP('eID')) {
if ($classPath = t3lib_div::getFileAbsFileName($TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId])) {
require_once(PATH_tslib.'class.tslib_eidtools.php');
require($classPath);
}
exit;
}
?>
</pre>

Hier wird überprüft ob der Schlüssel eID als Get/Post Variable vorhanden ist und falls ja, wird der normale Renderingprozess abgebrochen und auf unser Script verwiesen. Doch woher weiss TYPO3 jetzt wo unser Script liegt ?

Das sagen wir Ihm über $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId].
Wir müssten entweder in die localconf.php oder in eine ext_localconf.php einer Extension folgendes Eintragen
<pre>
<?php
// Zugriff nur von Typo3 aus:
if (!defined ('TYPO3_MODE')) {
die ('Access denied.');
}
// Registrierung der eid Scripts
$TYPO3_CONF_VARS['FE']['eID_include']['schluesselwort'] = 'EXT:myExtKey/eid/meinScript.php'; ?>
?>
</pre>
Steht jetzt also in der Adresse ''www.domain.de/?eID=schluesselwort'' geht er in die erste if Abfrage und sieht das ''$TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId]'' vorhanden ist und '''speichert''' 'EXT:myExtKey/meinScript.php' in die Variable ''$classPat''h. '''Danach includiert er die Klasse eidtools und unsere eigene'''.

Da unser Script noch leer ist bekommen wir eine weisse Seite angezeigt in der auch der komplette Quelltext leer ist.

Um in unserem Script nun ein FEUSER Objekt zu haben und eine aktive DB Verbindung schreiben wir
<pre>
<?php
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
// ...
?>
</pre>
Die erste Zeile '''initialisert den FrontentUser''' und gibt uns diesen als Objekt zurück.

Die zweite Zeile stellt eine '''Verbindung zur Datenbank''' her.

Im Weiteren können wir ganz normal auch TYPO3 Funktionalitäten benutzen und unseren eigenen Renderingablauf schreiben.

Um auch '''zB auf alle piBase Funktionen zurückzugreifen''' können wir uns ganz einfach eine Klasse erstellen die von dieser Erbt

<pre>
<?php
require_once(PATH_tslib.'class.tslib_pibase.php');

class unsereKlasse extends tslib_pibase {
function main(){
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
echo("hallo welt");
}
}

$output = t3lib_div::makeInstance('unsereKlasse');
$output->main();
?>
</php>
</pre>
Das war es soweit, wenn Ihr noch fragen dazu habt stellt Sie einfach über die Kommentarfunktion.

== eid ajax Beispiel ==
Bei diesem Beispiel gehen wir von einem normalen Frontend Plugin aus das z.B. mit dem Kickstarter erzeugt wird. Wir legen eine PHP-Klasse für die Bearbeitung der AJAX Anfrage an und eine JavaScript Datei mit den passenden Funktionen. Die PHP Datei wird in localconf registriert. Das Handling des AJAX Request überlassen wir der Prototype JavaScript Lib die in Typo3 schon dabei ist.

Diese Dateien bearbeiten wir:
<pre>
typo3conf/ext/myExtKey/
- ext_localconf.php
typo3conf/ext/myExtKey/eid/
- ajax.js
- class.myExtKey_eid.php
typo3conf/ext/myExtKey/pi1/
- class.myExtKey_pi1.php
</pre>

=== eID Datei ===
'''class.myExtkey_eid.php'''
<pre>
<?php
if (!defined ('PATH_typo3conf')) die ('Access denied: eID only.');
require_once(PATH_tslib . 'class.tslib_pibase.php');

class tx_myExtKey_eid extends tslib_pibase {
var $prefixId = 'tx_myExtKey_eid';// Same as class name
var $scriptRelPath = 'eid/class.tx_myExtKey_eid.php'; // Path to this script relative to the extension dir.
var $extKey = 'myExtKey';// The extension key.

function eid_main() {
$GLOBALS['TSFE']->fe_user = tslib_eidtools::initFeUser();
tslib_eidtools::connectDB();

// Hier beginnt unser Code
$res = 'Hallo Welt';
// Hier endet unser Code

// Wir geben der Anfrage ein XML Objekt zurück
$ajax_return_data = t3lib_div::array2xml(array('data'=>$res));
header('Expires: Mon, 26 Jul 2000 03:00:00 GMT');
header('Last-Modified: ' . gmdate( "D, d M Y H:i:s" ) . 'GMT');
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: text/xml');
echo $ajax_return_data;
exit;
}
}

$extensionkey = t3lib_div::makeInstance('tx_myExtKey_eid');
$extensionkey->eid_main();

?>
</pre>

Möchte man in diesem Skript nun auf '''Funktionen (z.B. Datenbank) aus dem TYPO3-Framework''' zurückgreifen, so muss man für die Instantiierung selbst sorge tragen. In der Datei ''typo3_src/typo3/sysext/cms/tslib/class.tslib_eidtools.php'' findet man vorgefertigte Methoden um auf die Daten eines FE-Users oder die Datenbank zugreifen zu können (Verwendung siehe im Code oben).

=== ext_localconf.php ===
Die '''Datei muß noch dem System bekannt gemacht werden'''. Dies tun wir in der '''ext_localconf.php''' indem wir folgende Zeile hinzufügen:

$TYPO3_CONF_VARS['FE']['eID_include']['myExtKeyeid'] = 'EXT:myExtKey/eid/class.myExtKey_eid.php';

Hiermit sagen wir dem System das wir gerne die Datei myExtKey_eid.php ausführen würden wenn der Parameter eID=myExtKeyeid übergeben wird.

=== Das Frontend Plugin ===
In unserem Frontent Plugin erzeugen wir einen div container mit der id ac (ajaxcontainer) diesen wollen wir später mit der Ausgabe des Ajax Scriptes füllen. Außerdem noch einen Knopf mit dem wir die Anfrage starten können.

'''class.myExtKey_pi1.php'''
<pre>
...
$content .= '
<div id="ac">ajaxcontainer</div>
<input onclick="getData()" id="myButton" type="button" value="AJAX" />
';
...
</pre>

Anmerkung: Statt dem onclick im Button, kann man auch Prototypes observe Funktion nehmen, dan kann man den Code komplett in der .js Datei verwalten.

=== JavaScript ===
Jetzt benötigen wir noch etwas JavaScript um die '''Anfrage vom FrontendPlugi'''n auszuführen:

'''JavaScript (ajax.js)'''
<pre>

function anfrage()
{
var myAjax = new Ajax.Request(
'index.php', // the Request goes to index.php
{
method: 'get', //get or post
parameters: 'eID=gbeventseid',
onComplete: show // after loading use the anzeige function
});
}

function show(orgRequest)
//
{
var xmldoc = orgRequest.responseXML; //use XML Object as answer
var result = xmldoc.getElementsByTagName("data")[0].firstChild.data;//datapart
$('ac').innerHTML = result;//drop the stuff in the div with id "ac"
}
</pre>

=== Eine Prise TypoScript ===
Wir benutzen wie gesagt das Prototype Lib. Unsere '''JavaScript Dateien''' müssen wir natürlich auch in das Frontend Plugin '''einbinden'''. Das machen wir z.B. ganz einfach über TypoScript

'''TypoScript'''
<pre>
page.includeJS.proto = typo3/contrib/prototype/prototype.js
page.includeJS.gbevents3 = EXT:gb_events/eid/ajax.js
</pre>

=== andere Frameworks ===
Todo

== Probleme mit cc_debug und JASON Objekten ==

von Tim Lochmüller im Adventskalender 2008

In letzter Zeit habe ich sehr oft mit AJAX und JSON gearbeitet. Leider gibt es dabei immer ein Problem mit cc_debug, weil sich dieser immer hinter die Ausgabe des JSON Codes klemmt und damit ein kaputtes JSON erzeugt. Nachdem ich heute mit meinem Kollegen Michael zusammen gesessen habe um dieses Problem zu lösen, sind wir auf eine sehr einfache Lösung gestoßen:

$GLOBALS['errorList']->clear();
die(json_encode($result));

Die Zeile 1 direkt vor der Ausgabe des JSON Codes eingebaut, verhindert, dass cc_debug noch seinen JavaScript-Code hinter her ausgibt. Und wer jetzt sagt: naje, ein die() oder exit() sollte es auch tun, der irrt sich. Versucht es gerne selber mal</pre>

AJAX in TYPO3 Extensions

2010-04-21T10:22:11Z

91.47.238.180: /* Der eid Mechanismus und AJAX */

== Übersicht ==
=== Links ===
http://prototypejs.org/learn/introduction-to-ajax

=== Typo3 Skripte ohne Rendering ===
Ein Ajax Request wird in den meisten Fällen über ein JavaScript abgesetzt von einem Serverskript (PHP) verarbeitet und die Antwort als xml oder JSON Objekt zurückgegeben.

Um das PHP-Skript zu nutzen und zugleich die ganzen '''Rendering und Caching-Mechanismen von Typo3 zu vermeiden''' könnte man irgend ein php Skript nutzen. Andererseits wollen wir die Typo3 Funktionalitäten wie dbal Datenbankabfrage etc. nutzen. Deshalb stellt Typo3 den '''eid Mechanismus''' zur Verfügung (siehe unten). Mit diesem wird das '''Seitenrendering frühzeitig abgebrochen''' und der Request direkt an ein Skript weitergegeben.

Eine weitere Möglichkeit außer dem eid Mechanismus findest du unter [[Typo3 - alternatives Rendering]]

=== Schnelle Antwort ===
Dieses Skript kann sich nun ausschließlich um die Anfrage kümmern und das Ergebnis direkt zurückgeben, welches wiederum die Daten in die Seite einhängt.

== Der eid Mechanismus und AJAX ==
Quellen: http://www.typo3-tutorials.org/tutorials/extensions/eid-mechanismus.html (10.3.2010 Artikel von 2007)

http://www.blogix.net/2009/02/08/typo3-eid-oder-daten-mit-ajax-anfordern/

eID steht für Extension ID
Der eID Mechanismus ist der seit der Version 4.x dabei und kann als '''alternative Rendering Engine''' betrachtet werden.

Angesprochen wird er über einen GET oder POST Parameter. Sobald '''eID als Parameter in der URL''' vorhanden ist (zB. ''www.domain.de/?eID=schuesselwort'') wird der normaler Rendering Prozess sehr früh abgebrochen und auf ein Script weitergeleitet was wir selber programmieren müssen. Da der normale Rendering Prozess so früh abgebrochen wird kommt es auch noch zu keiner Ausgabe. Es wird nichts gecachet und kein HeaderCode ect generiert. Der eID Mechanismus kann also super im Zusammenhang mit AJAX verwendet werden.

Wollen wir uns einmal die index_ts.php (typo3/sysext/cms/tslib/) Zeile 127 bis 136 ansehen.

<pre>
<?php
// *********************
// Look for extension ID which will launch alternative output engine
// *********************
if ($temp_extId = t3lib_div::_GP('eID')) {
if ($classPath = t3lib_div::getFileAbsFileName($TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId])) {
require_once(PATH_tslib.'class.tslib_eidtools.php');
require($classPath);
}
exit;
}
?>
</pre>

Hier wird überprüft ob der Schlüssel eID als Get/Post Variable vorhanden ist und falls ja, wird der normale Renderingprozess abgebrochen und auf unser Script verwiesen. Doch woher weiss TYPO3 jetzt wo unser Script liegt ?

Das sagen wir Ihm über $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId].
Wir müssten entweder in die localconf.php oder in eine ext_localconf.php einer Extension folgendes Eintragen
<pre>
<?php
// Zugriff nur von Typo3 aus:
if (!defined ('TYPO3_MODE')) {
die ('Access denied.');
}
// Registrierung der eid Scripts
$TYPO3_CONF_VARS['FE']['eID_include']['schluesselwort'] = 'EXT:myExtKey/eid/meinScript.php'; ?>
?>
</pre>
Steht jetzt also in der Adresse ''www.domain.de/?eID=schluesselwort'' geht er in die erste if Abfrage und sieht das ''$TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId]'' vorhanden ist und '''speichert''' 'EXT:myExtKey/meinScript.php' in die Variable ''$classPat''h. '''Danach includiert er die Klasse eidtools und unsere eigene'''.

Da unser Script noch leer ist bekommen wir eine weisse Seite angezeigt in der auch der komplette Quelltext leer ist.

Um in unserem Script nun ein FEUSER Objekt zu haben und eine aktive DB Verbindung schreiben wir
<pre>
<?php
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
// ...
?>
</pre>
Die erste Zeile '''initialisert den FrontentUser''' und gibt uns diesen als Objekt zurück.

Die zweite Zeile stellt eine '''Verbindung zur Datenbank''' her.

Im Weiteren können wir ganz normal auch TYPO3 Funktionalitäten benutzen und unseren eigenen Renderingablauf schreiben.

Um auch '''zB auf alle piBase Funktionen zurückzugreifen''' können wir uns ganz einfach eine Klasse erstellen die von dieser Erbt

<pre>
<?php
require_once(PATH_tslib.'class.tslib_pibase.php');

class unsereKlasse extends tslib_pibase {
function main(){
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
echo("hallo welt");
}
}

$output = t3lib_div::makeInstance('unsereKlasse');
$output->main();
?>
</php>
</pre>
Das war es soweit, wenn Ihr noch fragen dazu habt stellt Sie einfach über die Kommentarfunktion.

== eid ajax Beispiel ==
Bei diesem Beispiel gehen wir von einem normalen Frontend Plugin aus das z.B. mit dem Kickstarter erzeugt wird. Wir legen eine PHP-Klasse für die Bearbeitung der AJAX Anfrage an und eine JavaScript Datei mit den passenden Funktionen. Die PHP Datei wird in localconf registriert. Das Handling des AJAX Request überlassen wir der Prototype JavaScript Lib die in Typo3 schon dabei ist.

Diese Dateien bearbeiten wir:
<pre>
typo3conf/ext/myExtKey/
- ext_localconf.php
typo3conf/ext/myExtKey/eid/
- ajax.js
- class.myExtKey_eid.php
typo3conf/ext/myExtKey/pi1/
- class.myExtKey_pi1.php
</pre>

=== eID Datei ===
'''class.myExtkey_eid.php'''
<pre>
<?php
if (!defined ('PATH_typo3conf')) die ('Access denied: eID only.');
require_once(PATH_tslib . 'class.tslib_pibase.php');

class tx_myExtKey_eid extends tslib_pibase {
var $prefixId = 'tx_myExtKey_eid';// Same as class name
var $scriptRelPath = 'eid/class.tx_myExtKey_eid.php'; // Path to this script relative to the extension dir.
var $extKey = 'myExtKey';// The extension key.

function eid_main() {
$GLOBALS['TSFE']->fe_user = tslib_eidtools::initFeUser();
tslib_eidtools::connectDB();

// Hier beginnt unser Code
$res = 'Hallo Welt';
// Hier endet unser Code

// Wir geben der Anfrage ein XML Objekt zurück
$ajax_return_data = t3lib_div::array2xml(array('data'=>$res));
header('Expires: Mon, 26 Jul 2000 03:00:00 GMT');
header('Last-Modified: ' . gmdate( "D, d M Y H:i:s" ) . 'GMT');
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: text/xml');
echo $ajax_return_data;
exit;
}
}

$extensionkey = t3lib_div::makeInstance('tx_myExtKey_eid');
$extensionkey->eid_main();

?>
</pre>

Möchte man in diesem Skript nun auf '''Funktionen (z.B. Datenbank) aus dem TYPO3-Framework''' zurückgreifen, so muss man für die Instantiierung selbst sorge tragen. In der Datei ''typo3_src/typo3/sysext/cms/tslib/class.tslib_eidtools.php'' findet man vorgefertigte Methoden um auf die Daten eines FE-Users oder die Datenbank zugreifen zu können (Verwendung siehe im Code oben).

Die '''Datei muß noch dem System bekannt gemacht werden'''. Dies tun wir in der '''ext_localconf.php''' indem wir folgende Zeile hinzufügen:

$TYPO3_CONF_VARS['FE']['eID_include']['myExtKeyeid'] = 'EXT:myExtKey/eid/myExtKey_eid.php';

Hiermit sagen wir dem System das wir gerne die Datei myExtKey_eid.php ausführen würden wenn der Parameter eID=myExtKeyeid übergeben wird.

=== Das Frontend Plugin ===
In unserem Frontent Plugin erzeugen wir einen div container mit der id ac (ajaxcontainer) diesen wollen wir später mit der Ausgabe des Ajax Scriptes füllen. Außerdem noch einen Knopf mit dem wir die Anfrage starten können.

'''class.myExtKey_pi1.php'''
<pre>
...
$content .= '
<div id="ac">ajaxcontainer</div>
<input onclick="getData()" id="myButton" type="button" value="AJAX" />
';
...
</pre>

Anmerkung: Statt dem onclick im Button, kann man auch Prototypes observe Funktion nehmen, dan kann man den Code komplett in der .js Datei verwalten.

=== JavaScript ===
Jetzt benötigen wir noch etwas JavaScript um die '''Anfrage vom FrontendPlugi'''n auszuführen:

'''JavaScript (ajax.js)'''
<pre>

function anfrage()
{
var myAjax = new Ajax.Request(
'index.php', // the Request goes to index.php
{
method: 'get', //get or post
parameters: 'eID=gbeventseid',
onComplete: show // after loading use the anzeige function
});
}

function show(orgRequest)
//
{
var xmldoc = orgRequest.responseXML; //use XML Object as answer
var result = xmldoc.getElementsByTagName("data")[0].firstChild.data;//datapart
$('ac').innerHTML = result;//drop the stuff in the div with id "ac"
}
</pre>

=== Eine Prise TypoScript ===
Wir benutzen wie gesagt das Prototype Lib. Unsere '''JavaScript Dateien''' müssen wir natürlich auch in das Frontend Plugin '''einbinden'''. Das machen wir z.B. ganz einfach über TypoScript

'''TypoScript'''
<pre>
page.includeJS.proto = typo3/contrib/prototype/prototype.js
page.includeJS.gbevents3 = EXT:gb_events/eid/ajax.js
</pre>

=== andere Frameworks ===
Todo

== Probleme mit cc_debug und JASON Objekten ==

von Tim Lochmüller im Adventskalender 2008

In letzter Zeit habe ich sehr oft mit AJAX und JSON gearbeitet. Leider gibt es dabei immer ein Problem mit cc_debug, weil sich dieser immer hinter die Ausgabe des JSON Codes klemmt und damit ein kaputtes JSON erzeugt. Nachdem ich heute mit meinem Kollegen Michael zusammen gesessen habe um dieses Problem zu lösen, sind wir auf eine sehr einfache Lösung gestoßen:

$GLOBALS['errorList']->clear();
die(json_encode($result));

Die Zeile 1 direkt vor der Ausgabe des JSON Codes eingebaut, verhindert, dass cc_debug noch seinen JavaScript-Code hinter her ausgibt. Und wer jetzt sagt: naje, ein die() oder exit() sollte es auch tun, der irrt sich. Versucht es gerne selber mal</pre>

Typo3 - alternatives Rendering

2010-04-21T10:18:35Z

91.47.238.180:

== Einleitung ==

Für verschiedene Anwendungsfälle (eigene template engine, ajax requests etc.) ist es manchmal notwendig, das Standard Seitenrendering von Typo3 zu umgehen. Dafür gibt es verschiedene Möglichkeiten.

== eid mechanismus ==
siehe unter Ajax und Typo3

== ajax parameter ==
Bemerkung: Nicht getestet

Wenn in der URL der Parameter
ajax=1
mitgegeben wird, dann erzeugt Typo3 ebenfalls eine Ausgabe ohne HTML-Tags und Metadaten. Die komplette Page-Konfiguration wird gelöscht und nur die Ausgabe der Extension “tx_myExt_pi1″ findet statt wenn man diese mit untenstehendem TS vorbereitet.

Denkbar wäre auch eine andere Type Nummer zu definieren.

TypoScript
<pre>
[globalVar = GP:ajax > 0]
config.disableAllHeaderCode = 1
page >
page = PAGE
page {
typeNum = 0
10 < plugin.tx_myExt_pi1
}
[global]
</pre>

== Alternativer DokType ==
Eine andere Möglichkeit, eine komplett leere Basisseite zu bekommen versteckt sich noch irgendwo in der Extension “tt_news”. Dort kann man per DokType steuern ob eine Liste oder ein RSS-Feed ausgegeben wird. Der RSS-Feed befindet sich auch auf einer ganz leeren Seite.

Typo3 - alternatives Rendering

2010-04-21T10:18:22Z

91.47.238.180: /* ajax parameter */

Typo3 - alternatives Rendering

2010-04-21T10:17:58Z

91.47.238.180: /* ajax parameter */

== Einleitung ==

Für verschiedene Anwendungsfälle (eigene template engine, ajax requests etc.) ist es manchmal notwendig, das Standard Seitenrendering von Typo3 zu umgehen. Dafür gibt es verschiedene Möglichkeiten.

== eid mechanismus ==
siehe unter Ajax und Typo3

== ajax parameter ==
Bemerkung: Nicht getestet

Wenn in der URL der Parameter
ajax=1
mitgegeben wird, dann erzeugt Typo3 ebenfalls eine Ausgabe ohne HTML-Tags und Metadaten. Die komplette Page-Konfiguration wird gelöscht und nur die Ausgabe der Extension “tx_myExt_pi1″ findet statt wenn man diese mit untenstehendem TS vorbereitet.

Denkbar wäre auch eine andere Type Nummer zu definieren.

TypoScript
<pre>
[globalVar = GP:ajax > 0]
config.disableAllHeaderCode = 1
page >
page = PAGE
page {
typeNum = 0
10 < plugin.tx_myExt_pi1
}
[global]
</pre>
== Alternativer DokType ==
Eine andere Möglichkeit, eine komplett leere Basisseite zu bekommen versteckt sich noch irgendwo in der Extension “tt_news”. Dort kann man per DokType steuern ob eine Liste oder ein RSS-Feed ausgegeben wird. Der RSS-Feed befindet sich auch auf einer ganz leeren Seite.</pre>

Typo3 - alternatives Rendering

2010-04-21T10:17:40Z

91.47.238.180:

== Einleitung ==

Für verschiedene Anwendungsfälle (eigene template engine, ajax requests etc.) ist es manchmal notwendig, das Standard Seitenrendering von Typo3 zu umgehen. Dafür gibt es verschiedene Möglichkeiten.

== eid mechanismus ==
siehe unter Ajax und Typo3

== ajax parameter ==
Bemerkung: Nicht getestet

Wenn in der URL der Parameter
ajax=1
mitgegeben wird, dann erzeugt Typo3 ebenfalls eine Ausgabe ohne HTML-Tags und Metadaten. Die komplette Page-Konfiguration wird gelöscht und nur die Ausgabe der Extension “tx_myExt_pi1″ findet statt wenn man diese mit untenstehendem TS vorbereitet.

Denkbar wäre auch eine andere Type Nummer zu definieren.

TypoScript
<pre>
[globalVar = GP:ajax > 0]
config.disableAllHeaderCode = 1
page >
page = PAGE
page {
typeNum = 0
10 < plugin.tx_myExt_pi1
}
[global]

== Alternativer DokType ==
Eine andere Möglichkeit, eine komplett leere Basisseite zu bekommen versteckt sich noch irgendwo in der Extension “tt_news”. Dort kann man per DokType steuern ob eine Liste oder ein RSS-Feed ausgegeben wird. Der RSS-Feed befindet sich auch auf einer ganz leeren Seite.</pre>

AJAX in TYPO3 Extensions

2010-04-21T10:11:31Z

91.47.238.180: /* Typo3 Skripte ohne Rendering */

== Übersicht ==
=== Links ===
http://prototypejs.org/learn/introduction-to-ajax

=== Typo3 Skripte ohne Rendering ===
Ein Ajax Request wird in den meisten Fällen über ein JavaScript abgesetzt von einem Serverskript (PHP) verarbeitet und die Antwort als xml oder JSON Objekt zurückgegeben.

Um das PHP-Skript zu nutzen und zugleich die ganzen '''Rendering und Caching-Mechanismen von Typo3 zu vermeiden''' könnte man irgend ein php Skript nutzen. Andererseits wollen wir die Typo3 Funktionalitäten wie dbal Datenbankabfrage etc. nutzen. Deshalb stellt Typo3 den '''eid Mechanismus''' zur Verfügung (siehe unten). Mit diesem wird das '''Seitenrendering frühzeitig abgebrochen''' und der Request direkt an ein Skript weitergegeben.

Eine weitere Möglichkeit außer dem eid Mechanismus findest du unter [[Typo3 - alternatives Rendering]]

=== Schnelle Antwort ===
Dieses Skript kann sich nun ausschließlich um die Anfrage kümmern und das Ergebnis direkt zurückgeben, welches wiederum die Daten in die Seite einhängt.

== Der eid Mechanismus und AJAX ==
Quellen: http://www.typo3-tutorials.org/tutorials/extensions/eid-mechanismus.html (10.3.2010 Artikel von 2007)

http://www.blogix.net/2009/02/08/typo3-eid-oder-daten-mit-ajax-anfordern/

eID steht für Extension ID
Der eID Mechanismus ist der seit der Version 4.x dabei und kann als a'''lternative Rendering Engine''' betrachtet werden.

Angesprochen wird er über einen GET oder POST Parameter. Sobald '''eID als Parameter in der URL''' vorhanden ist (zB. ''www.domain.de/?eID=schuesselwort'') wird der normaler Rendering Prozess sehr früh abgebrochen und auf ein Script weitergeleitet was wir selber programmieren müssen. Da der normale Rendering Prozess so früh abgebrochen wird kommt es auch noch zu keiner Ausgabe. Es wird nichts gecachet und kein HeaderCode ect generiert. Der eID Mechanismus kann also super im Zusammenhang mit AJAX verwendet werden.

Wollen wir uns einmal die index_ts.php (typo3/sysext/cms/tslib/) Zeile 127 bis 136 ansehen.

<pre>
<?php
// *********************
// Look for extension ID which will launch alternative output engine
// *********************
if ($temp_extId = t3lib_div::_GP('eID')) {
if ($classPath = t3lib_div::getFileAbsFileName($TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId])) {
require_once(PATH_tslib.'class.tslib_eidtools.php');
require($classPath);
}
exit;
}
?>
</pre>

Hier wird überprüft ob der Schlüssel eID als Get/Post Variable vorhanden ist und falls ja, wird der normale Renderingprozess abgebrochen und auf unser Script verwiesen. Doch woher weiss TYPO3 jetzt wo unser Script liegt ?

Das sagen wir Ihm über $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId].
Wir müssten entweder in die localconf.php oder in eine ext_localconf.php einer Extension folgendes Eintragen

<?php $TYPO3_CONF_VARS['FE']['eID_include']['schluesselwort'] = 'EXT:myExtKey/eid/meinScript.php'; ?>

Steht jetzt also in der Adresse ''www.domain.de/?eID=schluesselwort'' geht er in die erste if Abfrage und sieht das ''$TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId]'' vorhanden ist und '''speichert''' 'EXT:myExtKey/meinScript.php' in die Variable ''$classPat''h. '''Danach includiert er die Klasse eidtools und unsere eigene'''.

Da unser Script noch leer ist bekommen wir eine weisse Seite angezeigt in der auch der komplette Quelltext leer ist.

Um in unserem Script nun ein FEUSER Objekt zu haben und eine aktive DB Verbindung schreiben wir
<pre>
<?php
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
// ...
?>
</pre>
Die erste Zeile '''initialisert den FrontentUser''' und gibt uns diesen als Objekt zurück.

Die zweite Zeile stellt eine '''Verbindung zur Datenbank''' her.

Im Weiteren können wir ganz normal auch TYPO3 Funktionalitäten benutzen und unseren eigenen Renderingablauf schreiben.

Um auch '''zB auf alle piBase Funktionen zurückzugreifen''' können wir uns ganz einfach eine Klasse erstellen die von dieser Erbt

<pre>
<?php
require_once(PATH_tslib.'class.tslib_pibase.php');

class unsereKlasse extends tslib_pibase {
function main(){
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
echo("hallo welt");
}
}

$output = t3lib_div::makeInstance('unsereKlasse');
$output->main();
?>
</php>
</pre>
Das war es soweit, wenn Ihr noch fragen dazu habt stellt Sie einfach über die Kommentarfunktion.

== eid ajax Beispiel ==
Bei diesem Beispiel gehen wir von einem normalen Frontend Plugin aus das z.B. mit dem Kickstarter erzeugt wird. Wir legen eine PHP-Klasse für die Bearbeitung der AJAX Anfrage an und eine JavaScript Datei mit den passenden Funktionen. Die PHP Datei wird in localconf registriert. Das Handling des AJAX Request überlassen wir der Prototype JavaScript Lib die in Typo3 schon dabei ist.

Diese Dateien bearbeiten wir:
<pre>
typo3conf/ext/myExtKey/
- ext_localconf.php
typo3conf/ext/myExtKey/eid/
- ajax.js
- class.myExtKey_eid.php
typo3conf/ext/myExtKey/pi1/
- class.myExtKey_pi1.php
</pre>

=== eID Datei ===
'''class.myExtkey_eid.php'''
<pre>
<?php
if (!defined ('PATH_typo3conf')) die ('Access denied: eID only.');
require_once(PATH_tslib . 'class.tslib_pibase.php');

class tx_myExtKey_eid extends tslib_pibase {
var $prefixId = 'tx_myExtKey_eid';// Same as class name
var $scriptRelPath = 'eid/class.tx_myExtKey_eid.php'; // Path to this script relative to the extension dir.
var $extKey = 'myExtKey';// The extension key.

function eid_main() {
$GLOBALS['TSFE']->fe_user = tslib_eidtools::initFeUser();
tslib_eidtools::connectDB();

// Hier beginnt unser Code
$res = 'Hallo Welt';
// Hier endet unser Code

// Wir geben der Anfrage ein XML Objekt zurück
$ajax_return_data = t3lib_div::array2xml(array('data'=>$res));
header('Expires: Mon, 26 Jul 2000 03:00:00 GMT');
header('Last-Modified: ' . gmdate( "D, d M Y H:i:s" ) . 'GMT');
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: text/xml');
echo $ajax_return_data;
exit;
}
}

$extensionkey = t3lib_div::makeInstance('tx_myExtKey_eid');
$extensionkey->eid_main();

?>
</pre>

Möchte man in diesem Skript nun auf '''Funktionen (z.B. Datenbank) aus dem TYPO3-Framework''' zurückgreifen, so muss man für die Instantiierung selbst sorge tragen. In der Datei ''typo3_src/typo3/sysext/cms/tslib/class.tslib_eidtools.php'' findet man vorgefertigte Methoden um auf die Daten eines FE-Users oder die Datenbank zugreifen zu können (Verwendung siehe im Code oben).

Die '''Datei muß noch dem System bekannt gemacht werden'''. Dies tun wir in der '''ext_localconf.php''' indem wir folgende Zeile hinzufügen:

$TYPO3_CONF_VARS['FE']['eID_include']['myExtKeyeid'] = 'EXT:myExtKey/eid/myExtKey_eid.php';

Hiermit sagen wir dem System das wir gerne die Datei myExtKey_eid.php ausführen würden wenn der Parameter eID=myExtKeyeid übergeben wird.

=== Das Frontend Plugin ===
In unserem Frontent Plugin erzeugen wir einen div container mit der id ac (ajaxcontainer) diesen wollen wir später mit der Ausgabe des Ajax Scriptes füllen. Außerdem noch einen Knopf mit dem wir die Anfrage starten können.

'''class.myExtKey_pi1.php'''
<pre>
...
$content .= '
<div id="ac">ajaxcontainer</div>
<input onclick="getData()" id="myButton" type="button" value="AJAX" />
';
...
</pre>

Anmerkung: Statt dem onclick im Button, kann man auch Prototypes observe Funktion nehmen, dan kann man den Code komplett in der .js Datei verwalten.

=== JavaScript ===
Jetzt benötigen wir noch etwas JavaScript um die '''Anfrage vom FrontendPlugi'''n auszuführen:

'''JavaScript (ajax.js)'''
<pre>

function anfrage()
{
var myAjax = new Ajax.Request(
'index.php', // the Request goes to index.php
{
method: 'get', //get or post
parameters: 'eID=gbeventseid',
onComplete: show // after loading use the anzeige function
});
}

function show(orgRequest)
//
{
var xmldoc = orgRequest.responseXML; //use XML Object as answer
var result = xmldoc.getElementsByTagName("data")[0].firstChild.data;//datapart
$('ac').innerHTML = result;//drop the stuff in the div with id "ac"
}
</pre>

=== Eine Prise TypoScript ===
Wir benutzen wie gesagt das Prototype Lib. Unsere '''JavaScript Dateien''' müssen wir natürlich auch in das Frontend Plugin '''einbinden'''. Das machen wir z.B. ganz einfach über TypoScript

'''TypoScript'''
<pre>
page.includeJS.proto = typo3/contrib/prototype/prototype.js
page.includeJS.gbevents3 = EXT:gb_events/eid/ajax.js
</pre>

=== andere Frameworks ===
Todo

== Probleme mit cc_debug und JASON Objekten ==

von Tim Lochmüller im Adventskalender 2008

In letzter Zeit habe ich sehr oft mit AJAX und JSON gearbeitet. Leider gibt es dabei immer ein Problem mit cc_debug, weil sich dieser immer hinter die Ausgabe des JSON Codes klemmt und damit ein kaputtes JSON erzeugt. Nachdem ich heute mit meinem Kollegen Michael zusammen gesessen habe um dieses Problem zu lösen, sind wir auf eine sehr einfache Lösung gestoßen:

$GLOBALS['errorList']->clear();
die(json_encode($result));

Die Zeile 1 direkt vor der Ausgabe des JSON Codes eingebaut, verhindert, dass cc_debug noch seinen JavaScript-Code hinter her ausgibt. Und wer jetzt sagt: naje, ein die() oder exit() sollte es auch tun, der irrt sich. Versucht es gerne selber mal</pre>

AJAX in TYPO3 Extensions

2010-04-21T10:06:00Z

91.47.238.180:

== Übersicht ==
=== Links ===
http://prototypejs.org/learn/introduction-to-ajax

=== Typo3 Skripte ohne Rendering ===
Ein Ajax Request wird in den meisten Fällen über ein JavaScript abgesetzt von einem Serverskript (PHP) verarbeitet und die Antwort als xml oder JSON Objekt zurückgegeben.

Um das PHP-Skript zu nutzen und zugleich die ganzen '''Rendering und Caching-Mechanismen von Typo3 zu vermeiden''' könnte man irgend ein php Skript nutzen. Andererseits wollen wir die Typo3 Funktionalitäten wie dbal Datenbankabfrage etc. nutzen. Deshalb stellt Typo3 den '''eid Mechanismus''' zur Verfügung (siehe unten). Mit diesem wird das '''Seitenrendering frühzeitig abgebrochen''' und der Request direkt an ein Skript weitergegeben.

=== Schnelle Antwort ===
Dieses Skript kann sich nun ausschließlich um die Anfrage kümmern und das Ergebnis direkt zurückgeben, welches wiederum die Daten in die Seite einhängt.

== Der eid Mechanismus und AJAX ==
Quellen: http://www.typo3-tutorials.org/tutorials/extensions/eid-mechanismus.html (10.3.2010 Artikel von 2007)

http://www.blogix.net/2009/02/08/typo3-eid-oder-daten-mit-ajax-anfordern/

eID steht für Extension ID
Der eID Mechanismus ist der seit der Version 4.x dabei und kann als a'''lternative Rendering Engine''' betrachtet werden.

Angesprochen wird er über einen GET oder POST Parameter. Sobald '''eID als Parameter in der URL''' vorhanden ist (zB. ''www.domain.de/?eID=schuesselwort'') wird der normaler Rendering Prozess sehr früh abgebrochen und auf ein Script weitergeleitet was wir selber programmieren müssen. Da der normale Rendering Prozess so früh abgebrochen wird kommt es auch noch zu keiner Ausgabe. Es wird nichts gecachet und kein HeaderCode ect generiert. Der eID Mechanismus kann also super im Zusammenhang mit AJAX verwendet werden.

Wollen wir uns einmal die index_ts.php (typo3/sysext/cms/tslib/) Zeile 127 bis 136 ansehen.

<pre>
<?php
// *********************
// Look for extension ID which will launch alternative output engine
// *********************
if ($temp_extId = t3lib_div::_GP('eID')) {
if ($classPath = t3lib_div::getFileAbsFileName($TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId])) {
require_once(PATH_tslib.'class.tslib_eidtools.php');
require($classPath);
}
exit;
}
?>
</pre>

Hier wird überprüft ob der Schlüssel eID als Get/Post Variable vorhanden ist und falls ja, wird der normale Renderingprozess abgebrochen und auf unser Script verwiesen. Doch woher weiss TYPO3 jetzt wo unser Script liegt ?

Das sagen wir Ihm über $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId].
Wir müssten entweder in die localconf.php oder in eine ext_localconf.php einer Extension folgendes Eintragen

<?php $TYPO3_CONF_VARS['FE']['eID_include']['schluesselwort'] = 'EXT:myExtKey/eid/meinScript.php'; ?>

Steht jetzt also in der Adresse ''www.domain.de/?eID=schluesselwort'' geht er in die erste if Abfrage und sieht das ''$TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId]'' vorhanden ist und '''speichert''' 'EXT:myExtKey/meinScript.php' in die Variable ''$classPat''h. '''Danach includiert er die Klasse eidtools und unsere eigene'''.

Da unser Script noch leer ist bekommen wir eine weisse Seite angezeigt in der auch der komplette Quelltext leer ist.

Um in unserem Script nun ein FEUSER Objekt zu haben und eine aktive DB Verbindung schreiben wir
<pre>
<?php
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
// ...
?>
</pre>
Die erste Zeile '''initialisert den FrontentUser''' und gibt uns diesen als Objekt zurück.

Die zweite Zeile stellt eine '''Verbindung zur Datenbank''' her.

Im Weiteren können wir ganz normal auch TYPO3 Funktionalitäten benutzen und unseren eigenen Renderingablauf schreiben.

Um auch '''zB auf alle piBase Funktionen zurückzugreifen''' können wir uns ganz einfach eine Klasse erstellen die von dieser Erbt

<pre>
<?php
require_once(PATH_tslib.'class.tslib_pibase.php');

class unsereKlasse extends tslib_pibase {
function main(){
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
echo("hallo welt");
}
}

$output = t3lib_div::makeInstance('unsereKlasse');
$output->main();
?>
</php>
</pre>
Das war es soweit, wenn Ihr noch fragen dazu habt stellt Sie einfach über die Kommentarfunktion.

== eid ajax Beispiel ==
Bei diesem Beispiel gehen wir von einem normalen Frontend Plugin aus das z.B. mit dem Kickstarter erzeugt wird. Wir legen eine PHP-Klasse für die Bearbeitung der AJAX Anfrage an und eine JavaScript Datei mit den passenden Funktionen. Die PHP Datei wird in localconf registriert. Das Handling des AJAX Request überlassen wir der Prototype JavaScript Lib die in Typo3 schon dabei ist.

Diese Dateien bearbeiten wir:
<pre>
typo3conf/ext/myExtKey/
- ext_localconf.php
typo3conf/ext/myExtKey/eid/
- ajax.js
- class.myExtKey_eid.php
typo3conf/ext/myExtKey/pi1/
- class.myExtKey_pi1.php
</pre>

=== eID Datei ===
'''class.myExtkey_eid.php'''
<pre>
<?php
if (!defined ('PATH_typo3conf')) die ('Access denied: eID only.');
require_once(PATH_tslib . 'class.tslib_pibase.php');

class tx_myExtKey_eid extends tslib_pibase {
var $prefixId = 'tx_myExtKey_eid';// Same as class name
var $scriptRelPath = 'eid/class.tx_myExtKey_eid.php'; // Path to this script relative to the extension dir.
var $extKey = 'myExtKey';// The extension key.

function eid_main() {
$GLOBALS['TSFE']->fe_user = tslib_eidtools::initFeUser();
tslib_eidtools::connectDB();

// Hier beginnt unser Code
$res = 'Hallo Welt';
// Hier endet unser Code

// Wir geben der Anfrage ein XML Objekt zurück
$ajax_return_data = t3lib_div::array2xml(array('data'=>$res));
header('Expires: Mon, 26 Jul 2000 03:00:00 GMT');
header('Last-Modified: ' . gmdate( "D, d M Y H:i:s" ) . 'GMT');
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: text/xml');
echo $ajax_return_data;
exit;
}
}

$extensionkey = t3lib_div::makeInstance('tx_myExtKey_eid');
$extensionkey->eid_main();

?>
</pre>

Möchte man in diesem Skript nun auf '''Funktionen (z.B. Datenbank) aus dem TYPO3-Framework''' zurückgreifen, so muss man für die Instantiierung selbst sorge tragen. In der Datei ''typo3_src/typo3/sysext/cms/tslib/class.tslib_eidtools.php'' findet man vorgefertigte Methoden um auf die Daten eines FE-Users oder die Datenbank zugreifen zu können (Verwendung siehe im Code oben).

Die '''Datei muß noch dem System bekannt gemacht werden'''. Dies tun wir in der '''ext_localconf.php''' indem wir folgende Zeile hinzufügen:

$TYPO3_CONF_VARS['FE']['eID_include']['myExtKeyeid'] = 'EXT:myExtKey/eid/myExtKey_eid.php';

Hiermit sagen wir dem System das wir gerne die Datei myExtKey_eid.php ausführen würden wenn der Parameter eID=myExtKeyeid übergeben wird.

=== Das Frontend Plugin ===
In unserem Frontent Plugin erzeugen wir einen div container mit der id ac (ajaxcontainer) diesen wollen wir später mit der Ausgabe des Ajax Scriptes füllen. Außerdem noch einen Knopf mit dem wir die Anfrage starten können.

'''class.myExtKey_pi1.php'''
<pre>
...
$content .= '
<div id="ac">ajaxcontainer</div>
<input onclick="getData()" id="myButton" type="button" value="AJAX" />
';
...
</pre>

Anmerkung: Statt dem onclick im Button, kann man auch Prototypes observe Funktion nehmen, dan kann man den Code komplett in der .js Datei verwalten.

=== JavaScript ===
Jetzt benötigen wir noch etwas JavaScript um die '''Anfrage vom FrontendPlugi'''n auszuführen:

'''JavaScript (ajax.js)'''
<pre>

function anfrage()
{
var myAjax = new Ajax.Request(
'index.php', // the Request goes to index.php
{
method: 'get', //get or post
parameters: 'eID=gbeventseid',
onComplete: show // after loading use the anzeige function
});
}

function show(orgRequest)
//
{
var xmldoc = orgRequest.responseXML; //use XML Object as answer
var result = xmldoc.getElementsByTagName("data")[0].firstChild.data;//datapart
$('ac').innerHTML = result;//drop the stuff in the div with id "ac"
}
</pre>

=== Eine Prise TypoScript ===
Wir benutzen wie gesagt das Prototype Lib. Unsere '''JavaScript Dateien''' müssen wir natürlich auch in das Frontend Plugin '''einbinden'''. Das machen wir z.B. ganz einfach über TypoScript

'''TypoScript'''
<pre>
page.includeJS.proto = typo3/contrib/prototype/prototype.js
page.includeJS.gbevents3 = EXT:gb_events/eid/ajax.js
</pre>

=== andere Frameworks ===
Todo

== Probleme mit cc_debug und JASON Objekten ==

von Tim Lochmüller im Adventskalender 2008

In letzter Zeit habe ich sehr oft mit AJAX und JSON gearbeitet. Leider gibt es dabei immer ein Problem mit cc_debug, weil sich dieser immer hinter die Ausgabe des JSON Codes klemmt und damit ein kaputtes JSON erzeugt. Nachdem ich heute mit meinem Kollegen Michael zusammen gesessen habe um dieses Problem zu lösen, sind wir auf eine sehr einfache Lösung gestoßen:

$GLOBALS['errorList']->clear();
die(json_encode($result));

Die Zeile 1 direkt vor der Ausgabe des JSON Codes eingebaut, verhindert, dass cc_debug noch seinen JavaScript-Code hinter her ausgibt. Und wer jetzt sagt: naje, ein die() oder exit() sollte es auch tun, der irrt sich. Versucht es gerne selber mal</pre>

AJAX in TYPO3 Extensions

2010-04-21T09:54:39Z

91.47.238.180: /* eid ajax Beispiel */

== Übersicht ==
=== Links ===
http://prototypejs.org/learn/introduction-to-ajax

=== Typo3 Skripte ohne Rendering ===
Ein Ajax Request wird in den meisten Fällen über ein JavaScript abgesetzt von einem Serverskript (PHP) verarbeitet und die Antwort als xml oder JSON Objekt zurückgegeben.

Um das PHP-Skript zu nutzen und zugleich die ganzen Rendering und Caching-Mechanismen von Typo3 zu vermeiden könnte man irgend ein php Skript nutzen. Andererseits wollen wir die Typo3 Funktionalitäten wie dbal Datenbankabfrage etc. nutzen. Deshalb stellt Typo3 den eid Mechanismus zur Verfügung (siehe unten). Mit diesem wird das Seitenrendering frühzeitig abgebrochen und der Request direkt an ein Skript weitergegeben.

=== Schnelle Antwort ===
Dieses Skript kann sich nun ausschließlich um die Anfrage kümmern und das Ergebnis direkt zurückgeben, welches wiederum die Daten in die Seite einhängt.

== Der eid Mechanismus und AJAX ==
Quellen: http://www.typo3-tutorials.org/tutorials/extensions/eid-mechanismus.html (10.3.2010 Artikel von 2007)

http://www.blogix.net/2009/02/08/typo3-eid-oder-daten-mit-ajax-anfordern/

eID steht für Extension ID
Der eID Mechanismus ist der seit der Version 4.x dabei und kann als alternative Rendering Engine betrachtet werden.

Angesprochen wird er über einen GET oder POST Parameter. Sobald eID als Parameter in der URL vorhanden ist (zB. www.domain.de/?eID=schuesselwort) wird der normaler Rendering Prozess sehr früh abgebrochen und auf ein Script weitergeleitet was wir selber programmieren müssen. Da der normale Rendering Prozess so früh abgebrochen wird kommt es auch noch zu keiner Ausgabe. Es wird nichts gecachet und kein HeaderCode ect generiert. Der eID Mechanismus kann also super im Zusammenhang mit AJAX verwendet werden.

Wollen wir uns einmal die index_ts.php (typo3/sysext/cms/tslib/) Zeile 127 bis 136 ansehen.

<pre>
<?php
// *********************
// Look for extension ID which will launch alternative output engine
// *********************
if ($temp_extId = t3lib_div::_GP('eID')) {
if ($classPath = t3lib_div::getFileAbsFileName($TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId])) {
require_once(PATH_tslib.'class.tslib_eidtools.php');
require($classPath);
}
exit;
}
?>
</pre>

Hier wird überprüft ob der Schlüssel eID als Get/Post Variable vorhanden ist und falls ja, wird der normale Renderingprozess abgebrochen und auf unser Script verwiesen. Doch woher weiss TYPO3 jetzt wo unser Script liegt ?

Das sagen wir Ihm über $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId].
Wir müssten entweder in die localconf.php oder in eine ext_localconf.php einer Extension folgendes Eintragen

<?php $TYPO3_CONF_VARS['FE']['eID_include']['schluesselwort'] = 'EXT:myExtKey/eid/meinScript.php'; ?>

Steht jetzt also in der Adresse www.domain.de/?eID=schluesselwort geht er in die erste if Abfrage und sieht das $TYPO3_CONF_VARS['FE']['eID_include'][$temp_extId] vorhanden ist und speichert 'EXT:myExtKey/meinScript.php' in die Variable $classPath. Danach includiert er die Klasse eidtools und unsere eigene.

Da unser Script noch leer ist bekommen wir eine weisse Seite angezeigt in der auch der komplette Quelltext leer ist.

Um in unserem Script nun ein FEUSER Objekt zu haben und eine aktive DB Verbindung schreiben wir
<pre>
<?php
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
// ...
?>
</pre>
Die erste Zeile initialisert den FrontentUser und gibt uns diesen als Objekt zurück.

Die zweite Zeile stellt eine Verbindung zur Datenbank her.

Im Weiteren können wir ganz normal auch TYPO3 Funktionalitäten benutzen und unseren eigenen Renderingablauf schreiben.

Um auch zB auf alle piBase Funktionen zurückzugreufen können wir uns ganz einfach eine Klasse erstellen die von dieser Erbt

<pre>
<?php
require_once(PATH_tslib.'class.tslib_pibase.php');

class unsereKlasse extends tslib_pibase {
function main(){
$feUserObj = tslib_eidtools::initFeUser(); // Initialize FE user object
tslib_eidtools::connectDB(); //Connect to database
echo("hallo welt");
}
}

$output = t3lib_div::makeInstance('unsereKlasse');
$output->main();
?>
</php>
</pre>
Das war es soweit, wenn Ihr noch fragen dazu habt stellt Sie einfach über die Kommentarfunktion.

== eid ajax Beispiel ==
Bei diesem Beispiel gehen wir von einem normalen Frontend Plugin aus das z.B. mit dem Kickstarter erzeugt wird. Wir legen eine PHP-Klasse für die Bearbeitung der AJAX Anfrage an und eine JavaScript Datei mit den passenden Funktionen. Die PHP Datei wird in localconf registriert. Das Handling des AJAX Request überlassen wir der Prototype JavaScript Lib die in Typo3 schon dabei ist.

Diese Dateien bearbeiten wir:
<pre>
typo3conf/ext/myExtKey/
- ext_localconf.php
typo3conf/ext/myExtKey/eid/
- ajax.js
- class.myExtKey_eid.php
typo3conf/ext/myExtKey/pi1/
- class.myExtKey_pi1.php
</pre>

=== eID Datei ===
'''class.myExtkey_eid.php'''
<pre>
<?php
if (!defined ('PATH_typo3conf')) die ('Access denied: eID only.');
require_once(PATH_tslib . 'class.tslib_pibase.php');

class tx_myExtKey_eid extends tslib_pibase {
var $prefixId = 'tx_myExtKey_eid';// Same as class name
var $scriptRelPath = 'eid/class.tx_myExtKey_eid.php'; // Path to this script relative to the extension dir.
var $extKey = 'myExtKey';// The extension key.

function eid_main() {
$GLOBALS['TSFE']->fe_user = tslib_eidtools::initFeUser();
tslib_eidtools::connectDB();

// Hier beginnt unser Code
$res = 'Hallo Welt';
// Hier endet unser Code

// Wir geben der Anfrage ein XML Objekt zurück
$ajax_return_data = t3lib_div::array2xml(array('data'=>$res));
header('Expires: Mon, 26 Jul 2000 03:00:00 GMT');
header('Last-Modified: ' . gmdate( "D, d M Y H:i:s" ) . 'GMT');
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: text/xml');
echo $ajax_return_data;
exit;
}
}

$extensionkey = t3lib_div::makeInstance('tx_myExtKey_eid');
$extensionkey->eid_main();

?>
</pre>

Möchte man in diesem Skript nun auf '''Funktionen (z.B. Datenbank) aus dem TYPO3-Framework''' zurückgreifen, so muss man für die Instantiierung selbst sorge tragen. In der Datei ''typo3_src/typo3/sysext/cms/tslib/class.tslib_eidtools.php'' findet man vorgefertigte Methoden um auf die Daten eines FE-Users oder die Datenbank zugreifen zu können (Verwendung siehe im Code oben).

Die '''Datei muß noch dem System bekannt gemacht werden'''. Dies tun wir in der '''ext_localconf.php''' indem wir folgende Zeile hinzufügen:

$TYPO3_CONF_VARS['FE']['eID_include']['myExtKeyeid'] = 'EXT:myExtKey/eid/myExtKey_eid.php';

Hiermit sagen wir dem System das wir gerne die Datei myExtKey_eid.php ausführen würden wenn der Parameter eID=myExtKeyeid übergeben wird.

=== Das Frontend Plugin ===
In unserem Frontent Plugin erzeugen wir einen div container mit der id ac (ajaxcontainer) diesen wollen wir später mit der Ausgabe des Ajax Scriptes füllen. Außerdem noch einen Knopf mit dem wir die Anfrage starten können.

'''class.myExtKey_pi1.php'''
<pre>
...
$content .= '
<div id="ac">ajaxcontainer</div>
<input onclick="getData()" id="myButton" type="button" value="AJAX" />
';
...
</pre>

Anmerkung: Statt dem onclick im Button, kann man auch Prototypes observe Funktion nehmen, dan kann man den Code komplett in der .js Datei verwalten.

=== JavaScript ===
Jetzt benötigen wir noch etwas JavaScript um die '''Anfrage vom FrontendPlugi'''n auszuführen:

'''JavaScript (ajax.js)'''
<pre>

function anfrage()
{
var myAjax = new Ajax.Request(
'index.php', // the Request goes to index.php
{
method: 'get', //get or post
parameters: 'eID=gbeventseid',
onComplete: show // after loading use the anzeige function
});
}

function show(orgRequest)
//
{
var xmldoc = orgRequest.responseXML; //use XML Object as answer
var result = xmldoc.getElementsByTagName("data")[0].firstChild.data;//datapart
$('ac').innerHTML = result;//drop the stuff in the div with id "ac"
}
</pre>

=== Eine Prise TypoScript ===
Wir benutzen wie gesagt das Prototype Lib. Unsere '''JavaScript Dateien''' müssen wir natürlich auch in das Frontend Plugin '''einbinden'''. Das machen wir z.B. ganz einfach über TypoScript

'''TypoScript'''
<pre>
page.includeJS.proto = typo3/contrib/prototype/prototype.js
page.includeJS.gbevents3 = EXT:gb_events/eid/ajax.js
</pre>

=== andere Frameworks ===
Todo

== Probleme mit cc_debug und JASON Objekten ==

von Tim Lochmüller im Adventskalender 2008

In letzter Zeit habe ich sehr oft mit AJAX und JSON gearbeitet. Leider gibt es dabei immer ein Problem mit cc_debug, weil sich dieser immer hinter die Ausgabe des JSON Codes klemmt und damit ein kaputtes JSON erzeugt. Nachdem ich heute mit meinem Kollegen Michael zusammen gesessen habe um dieses Problem zu lösen, sind wir auf eine sehr einfache Lösung gestoßen:

$GLOBALS['errorList']->clear();
die(json_encode($result));

Die Zeile 1 direkt vor der Ausgabe des JSON Codes eingebaut, verhindert, dass cc_debug noch seinen JavaScript-Code hinter her ausgibt. Und wer jetzt sagt: naje, ein die() oder exit() sollte es auch tun, der irrt sich. Versucht es gerne selber mal</pre>

Newsletter mit Direct Mail

2010-04-21T07:40:43Z

91.47.238.180: /* Muster */

== Quickstart ==
=== Extensions ===
* tt_address
* direct_mail (Newsletterversand)
* sr_feuser_register oder direct_mail_subscriptionoder oder sr_email_subscribe o.ä. (Frontend User Anmeldung)
* für sr_feuser_register werden weitere extensions benötigt (siehe [[Typo3 - Benutzer Registrierung (sr_feuser_register)]])
=== Ordner ===
Für sr_feuser_subscribe kann bei neueren Versionen das meiste im default mode gemacht werden, einige Seiten bieten sich denoch an, weil man auch schöne Infotexte mit reinbauen kann.
* Newsletter/ (sr_feuser_register_pi in default mode, Login)
** Registrierung/ (sr_feuser_register in register Mode), hide at login, hide in menu
** Registrierung bestätigt/ (sr_feuser_register in default oder setfixed mode) hide in menu
** Benutzerdaten bearbeiten/ (sr_feuser_register in edit oder default mode) hide in Menu, access alle oder bestimmte Benutzer.

Für direct_mail

* Newsletter/
Seiteneigenschaften enthält '''Plugin direct_mail''', '''Neues Root-Template''' auf Newsletter (alles clearen) '''includes''': content(default), plugin.alt.plaintext(99) und css_styled_content. (Update es gibt auch direct mail plaintext und direct mail news plaintext)
** Abonnements/ (enthält die Benutzer)

=== User Registrierung ===
direct_mail kann seine Adressen aus verschiedenen Datenquellen beziehen. Oft nimmt man dazu die fe_user oder tt_address
=== Bei Verwendung von direct_mail_subscription ===
* Konstanten anpassen (Constants Editor) für direct_mail_subscription (Admin Email, Name und Record PID auf Abonnement Ordner setzen)
* Anmelde Template nach fileadmin und anpassen
todo

=== bei sr_feuser_register ===
Ist meiner Ansicht nach das bessere Tool um Benutzer (wofür auch immer) über das Frontend zu registrieren.

Beachten:
* Kategorie für dmail muß gesetzt sein sonst wird später nichts versandt. (Geht evtl auch als verstecktes Feld?
* Todo: Testen ob nicht Abo nutzer auch Mails kriegen.

Weitere Infos dazu:

[[Typo3 - Benutzer Registrierung (sr_feuser_register)]]

=== bei sr_email_subscribe ===
Todo

=== direct_mail ===
* Versendet Direktmails, oder Seiten (extern intern)
* Kategorien werden auf Content Elemente gelegt
* Template für PlainText (Type 99) nicht vergessen.
-

== Muster ==
Seitenbaum für Registrierung (sr_feuser_register)
<pre>
- Newsletter
|
|- Registrierung
|- Benutzerdaten bearbeiten
|- Registrierung bestätigt
|- Freunde einladen

Seitenbaum für Newsletter (direct_mail)
- Newsletter (Kategorien)
|- Abonnenten
|- Newsletter Seiten...
</pre>

TypoScript Registrierung (sr_feuser_register)

Constants
<pre>
// Ordner mit Benutzern für Loginform
styles.content.loginform.pid = 87
// bei alter newloginbox...
# plugin.tx_newloginbox_pi1.storagePid = 87

plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 87
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2
// Seite mit Login Form
loginPID = 88
// Seite mit Registierung
registerPID = 89
// Seite zum editieren der Benutzerdaten
editPID = 90
// Seite mit Bestätigung der Registrierung
confirmPID = 91
// Wieviel Bilder dürfen hochgeladen werden
maxImages = 1
dateFormat = d.m.Y
dateSplit = .
salutation = informal
siteName = KO rockt!
formFields = password,first_name, last_name, email,module_sys_dmail_html, module_sys_dmail_category,disable
requiredFields = first_name,last_name,email
email = steff@ko-rockband.de
// nur mit RealURL ?
useShortUrls = 1
// Kategorien von Direct Mail
module_sys_dmail_category_PIDLIST = 86
//
dmailCheckedUponRegistration = 1
}
</pre>

Setup
<pre>
// Sprachlabel anpassen
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de{
v_really_wish_to_delete_informal = Willst Du Dein Konto wirklich löschen?
v_your_account_was_created_informal = Dein Konto <strong>%2$s</strong> wurde erstellt. Wir senden eine E-Mail an die Adresse <strong>%4$s</strong>, damit Du die Anmeldung bestätigen kannst.
}
// Titel der Benutzerseite überschreiben (wird in E-Mails benutzt)
plugin.tx_srfeuserregister_pi1.pidTitleOverride = KO rockt! Newsletter
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de.username = E-Mail Adresse
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de.v_your_account_was_created = Hallo %3$s, du hast eben unseren kostenlosen Newsletter bestellt. Um den Missbrauch Ihrer Adresse durch Dritte zu vermeiden, bitten wir Dich daher, das Newsletter-Abonnement zu bestätigen. Dazu haben wir dir eine E-Mail an die Adresse %2$s geschickt. In dieser Mail befindet sich ein Link zum Bestätigen der Anmeldung. <br />
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de.v_follow_instructions1 =
#plugin.tx_directmail_pi1.10.template.file = fileademin/templates/ext/newsletter-textversion.tmpl
/*
plugin.tx_directmail_pi1.10 {
marks.RCONTENT < styles.content.getRight
marks.RCONTENT.renderObj = < plugin.tx_directmail_pi1
}

lib.alt_plaintext.renderObj.siteUrl = http://www.ko-rockband.de/
tx_directmail_pi1.10.marks.RCONTENT < tx_directmail_pi1.10.marks.CONTENT
tx_directmail_pi1.10.marks.RCONTENT.select.where = colPos=2
*/

#plugin.tx_srfeuserregister_pi1.salutation = informal
</pre>
TypoScript Newsletter (direct_mail)

== weiteres Tutorial ==
Basiert auf:

Tutorials und Artikel / Typo3 / Einrichtung eines Newsletters mit Direct Mail
Einrichtung eines Newsletters mit Direct Mail

Um einen Newsletter mit Direct mail unter Typo3 4.0 einzurichten, bedarf es nur wenige Schritte. In diesem Tutorial möchte ich die Vorgehensweise beschreiben, auf Sonderfälle gehe ich nicht ein, es sollte jedem möglich sein, anhand der Beschreibung einen solchen Newsletter auf den eigenen Seiten einzubinden.
Benötigte Extensions

Diese Extensions werden benötigt und sollten, wenn noch nicht vorhanden, über den Extension-manager installiert werden.

* Address list (tt_address)
* Direct Mail (direct_mail)
* Direct Mail Subscription (direct_mail_subscription)

'''Vorbereitungen'''

Als erstes legen wir '''2 Systemordner''' an, die sich auf der rootline befinden. Dadurch greift das Template der root-Seite nicht und wir sind unabhängig von dem Rest der Seite. In meinem Fall hat der Sysordner Newsletter die PID 147 und der Sysordner Abonnoments die PID 148. Wir bearbeiten die Seinteneigenschaften des Sysordners Newsletter und geben unter "Enthält Erweiterung" direct mail an.

Man kann die Ordner auch woanders hinlegen und das root-Template einfach mit einem neuen root Template überschreiben bzw dessen eigenschaften mit den clear Häkchen löschen.

Newsletter/
Abonnements/

Wir benötigen noch eine Seite, auf der die User sich für den Newsletter anmelden können. Hierzu erstellen wir in unserem Seitenbaum eine Seite und fügen auf ihr das Inhaltselement "Plugin / Direct Mail Anmeldung" ein. Als Ausgangspunkt wählen wir unseren Sysordner Abonnements, in dem die Anmeldungen gesammelt werden sollen.
Template Anpassungen

Nun wollen wir unser root-Template vervollständigen. Hierzu legen wir auf unserem SysOrdner Newsletter ein neues Template an "Create template for a new site". Wir benennen es und binden folgende Module ein:

Das Modul content(default) und plugin.alt.plaintext(99) wird benötigt, um den Inhalt für die Plain Text-Emails zu generieren, für die HTML-Ausgabe nehmen wir wie gewohnt die css_styled_content.

Unserem root-Template müssen wir auch noch einige Angaben hinzufügen. Vorerst kopieren wir das Template für die Newsletteranmeldung (typo3conf/ext/direct_mail_subscription/pi/fe_admin_dmailsubscrip.tmpl) nach fileadmin/templates/newsletter_subscription.html, so das wir es später bearbeiten können.

Wir gehen auf unser root-Template und wählen im Constants-Editor die Seite PLUGIN.FEADMIN.DMAILSUBSCRIPTION und wählen die Einträge
Administration email, Administration name und Record PID.
Wir ergänzen die email-Angaben und unter Record PID geben wir unseren SysOrdner Abonnoments an (in meinem Fall 148) - hierdurch werden die Anmeldungen auch in diesem SysOrdner gespeichert.

Anschliessend öffnen wir Constants unter Info/Modify und ergänzen die Angabe unseres Templatefiles:
plugin.feadmin.dmailsubscription.file.templateFile = fileadmin/templates/newsletter_subscription.html

In diesem Zuge können wir auch das Template in einem Editor bearbeiten und entsprechend anpassen.

Wir sind nun mit den Vorbereitungen fertig und melden uns probeweiser beim Newsletter an. Es müsste ein neuer Datensatz im SysOrdner Abonnoments gelandet sein, der versteckt ist - wenn wir unsere Email erhalten haben und auf den Aktivierungslink geklickt haben, so wird der Datensatz sichtbar.
Newsletter einrichten

Nun wollen wir unseren ersten Newsletter einrichten. Die Newsletter sind ganz normale Typo3-Seiten, die in unserem SysOrdner Newsletter landen. Hier brauchen wir noch ein paar ergänzende Angaben in unserem Template des SysOrdners Newsletter, damit auch die Inhalte angezeigt werden.

In diesem Fall nehmen wir ein einfaches Typoscript-Template, hier kann jeder natürlich die Ausgabe so stylen, wie er gerne möchte. In diesem Beispiel sieht das Template so aus:
TypoScript
<pre>
page = PAGE

page.headerData.10=TEXT
page.headerData.10.value (
style type=text/css
* {margin:0;padding:0;}
body {background: #eee;}
div#main {padding:12px;}
/style
)
page.bodyTag=body
page.10 styles.content.get - ERROR: Line 12: Object Name String, "page.10" was not preceded by any operator, =<>({
page.10.wrap = divimg src=fileadmin/images/newsletterheader.gif/divdiv id=main|/div
</pre>
Nachdem wir das Template gespeichert haben, klicken wir unter Web auf den Direct Mail-Link. Wir sehen unseren SysOrdner Newsletter, den wir anklicken. Dann klicken wir auf den Link "Klicken Sie hier, um eine neue Typo3-Seite, die Sie später als Newsletter verschicken können, anzulegen. ". Wir benennen die Seite und speichern sie. Nun legen wir noch ein bischen Inhalt auf der Seite an und lassen sie anzeigen, um unser Template zu überprüfen. Wenn alles glatt gelaufen ist, sehen wir unseren ersten Newsletter.

Nun können wir unseren Newsletter versenden. Wir wählen wieder Web>Direct Mail. Unter Modulkonfiguration ändern wir noch die Einstellungen wie gewünscht. Wir erstellen unter Empfängerliste eine neue Versandgruppe. Unter Tabellen klicken wir Adresse an, da wir ja tt_address für unsere Adressen benutzen. Wir sehen, das es da noch weitere Optionen gibt.

Nun erstellen wir unseren Newsletter anhand unserer Seite. Wir haben nun viele Optionen zum versenden, wir können ihn zuerst als Testmail an uns selbst verschicken, um alles zu überprüfen. Wir sollten uns mit den einzelnen Menüpunkten von DirectMail vertraut machen, es ist alles gut erklärt und somit verständlich.

Unserem Newsletter steht nun nichts mehr im Weg, viel Spass!
Bugfix

Bei einigen Konfigurationen ergibt sich ein Problem mit den Plain Text - Mails. Hier wird als Content nur eine 1 erzeugt, und der Plain-Letter wird erst richtig erzeugt, wenn man den FE-Cache löscht.
Sollte dieses Problem auftauchen, so kann man den Code von direct mail modifizieren, um das Verhalten zu ändern. Folgende Zeile muss in der Datei direct_mail/mod/class.web_mod_dmail.php auskommentiert werden (Zeile 3916):
PHP

// $this-tmpl-forceTemplateParsing = 1;

Quelle: sk-typo3 · Steffen Kamper · 2006 last Update:Wednesday, 22.07.2009

Newsletter mit Direct Mail

2010-04-21T06:47:03Z

91.47.238.180:

== Quickstart ==
=== Extensions ===
* tt_address
* direct_mail (Newsletterversand)
* sr_feuser_register oder direct_mail_subscriptionoder oder sr_email_subscribe o.ä. (Frontend User Anmeldung)
* für sr_feuser_register werden weitere extensions benötigt (siehe [[Typo3 - Benutzer Registrierung (sr_feuser_register)]])
=== Ordner ===
Für sr_feuser_subscribe kann bei neueren Versionen das meiste im default mode gemacht werden, einige Seiten bieten sich denoch an, weil man auch schöne Infotexte mit reinbauen kann.
* Newsletter/ (sr_feuser_register_pi in default mode, Login)
** Registrierung/ (sr_feuser_register in register Mode), hide at login, hide in menu
** Registrierung bestätigt/ (sr_feuser_register in default oder setfixed mode) hide in menu
** Benutzerdaten bearbeiten/ (sr_feuser_register in edit oder default mode) hide in Menu, access alle oder bestimmte Benutzer.

Für direct_mail

* Newsletter/
Seiteneigenschaften enthält '''Plugin direct_mail''', '''Neues Root-Template''' auf Newsletter (alles clearen) '''includes''': content(default), plugin.alt.plaintext(99) und css_styled_content. (Update es gibt auch direct mail plaintext und direct mail news plaintext)
** Abonnements/ (enthält die Benutzer)

=== User Registrierung ===
direct_mail kann seine Adressen aus verschiedenen Datenquellen beziehen. Oft nimmt man dazu die fe_user oder tt_address
=== Bei Verwendung von direct_mail_subscription ===
* Konstanten anpassen (Constants Editor) für direct_mail_subscription (Admin Email, Name und Record PID auf Abonnement Ordner setzen)
* Anmelde Template nach fileadmin und anpassen
todo

=== bei sr_feuser_register ===
Ist meiner Ansicht nach das bessere Tool um Benutzer (wofür auch immer) über das Frontend zu registrieren.

Beachten:
* Kategorie für dmail muß gesetzt sein sonst wird später nichts versandt. (Geht evtl auch als verstecktes Feld?
* Todo: Testen ob nicht Abo nutzer auch Mails kriegen.

Weitere Infos dazu:

[[Typo3 - Benutzer Registrierung (sr_feuser_register)]]

=== bei sr_email_subscribe ===
Todo

=== direct_mail ===
* Versendet Direktmails, oder Seiten (extern intern)
* Kategorien werden auf Content Elemente gelegt
* Template für PlainText (Type 99) nicht vergessen.
-

== Muster ==
Seitenbaum für Registrierung (sr_feuser_register)

Seitenbaum für Newsletter (direct_mail)

TypoScript Registrierung (sr_feuser_register)

TypoScript Newsletter (direct_mail)

== weiteres Tutorial ==
Basiert auf:

Tutorials und Artikel / Typo3 / Einrichtung eines Newsletters mit Direct Mail
Einrichtung eines Newsletters mit Direct Mail

Um einen Newsletter mit Direct mail unter Typo3 4.0 einzurichten, bedarf es nur wenige Schritte. In diesem Tutorial möchte ich die Vorgehensweise beschreiben, auf Sonderfälle gehe ich nicht ein, es sollte jedem möglich sein, anhand der Beschreibung einen solchen Newsletter auf den eigenen Seiten einzubinden.
Benötigte Extensions

Diese Extensions werden benötigt und sollten, wenn noch nicht vorhanden, über den Extension-manager installiert werden.

* Address list (tt_address)
* Direct Mail (direct_mail)
* Direct Mail Subscription (direct_mail_subscription)

'''Vorbereitungen'''

Als erstes legen wir '''2 Systemordner''' an, die sich auf der rootline befinden. Dadurch greift das Template der root-Seite nicht und wir sind unabhängig von dem Rest der Seite. In meinem Fall hat der Sysordner Newsletter die PID 147 und der Sysordner Abonnoments die PID 148. Wir bearbeiten die Seinteneigenschaften des Sysordners Newsletter und geben unter "Enthält Erweiterung" direct mail an.

Man kann die Ordner auch woanders hinlegen und das root-Template einfach mit einem neuen root Template überschreiben bzw dessen eigenschaften mit den clear Häkchen löschen.

Newsletter/
Abonnements/

Wir benötigen noch eine Seite, auf der die User sich für den Newsletter anmelden können. Hierzu erstellen wir in unserem Seitenbaum eine Seite und fügen auf ihr das Inhaltselement "Plugin / Direct Mail Anmeldung" ein. Als Ausgangspunkt wählen wir unseren Sysordner Abonnements, in dem die Anmeldungen gesammelt werden sollen.
Template Anpassungen

Nun wollen wir unser root-Template vervollständigen. Hierzu legen wir auf unserem SysOrdner Newsletter ein neues Template an "Create template for a new site". Wir benennen es und binden folgende Module ein:

Das Modul content(default) und plugin.alt.plaintext(99) wird benötigt, um den Inhalt für die Plain Text-Emails zu generieren, für die HTML-Ausgabe nehmen wir wie gewohnt die css_styled_content.

Unserem root-Template müssen wir auch noch einige Angaben hinzufügen. Vorerst kopieren wir das Template für die Newsletteranmeldung (typo3conf/ext/direct_mail_subscription/pi/fe_admin_dmailsubscrip.tmpl) nach fileadmin/templates/newsletter_subscription.html, so das wir es später bearbeiten können.

Wir gehen auf unser root-Template und wählen im Constants-Editor die Seite PLUGIN.FEADMIN.DMAILSUBSCRIPTION und wählen die Einträge
Administration email, Administration name und Record PID.
Wir ergänzen die email-Angaben und unter Record PID geben wir unseren SysOrdner Abonnoments an (in meinem Fall 148) - hierdurch werden die Anmeldungen auch in diesem SysOrdner gespeichert.

Anschliessend öffnen wir Constants unter Info/Modify und ergänzen die Angabe unseres Templatefiles:
plugin.feadmin.dmailsubscription.file.templateFile = fileadmin/templates/newsletter_subscription.html

In diesem Zuge können wir auch das Template in einem Editor bearbeiten und entsprechend anpassen.

Wir sind nun mit den Vorbereitungen fertig und melden uns probeweiser beim Newsletter an. Es müsste ein neuer Datensatz im SysOrdner Abonnoments gelandet sein, der versteckt ist - wenn wir unsere Email erhalten haben und auf den Aktivierungslink geklickt haben, so wird der Datensatz sichtbar.
Newsletter einrichten

Nun wollen wir unseren ersten Newsletter einrichten. Die Newsletter sind ganz normale Typo3-Seiten, die in unserem SysOrdner Newsletter landen. Hier brauchen wir noch ein paar ergänzende Angaben in unserem Template des SysOrdners Newsletter, damit auch die Inhalte angezeigt werden.

In diesem Fall nehmen wir ein einfaches Typoscript-Template, hier kann jeder natürlich die Ausgabe so stylen, wie er gerne möchte. In diesem Beispiel sieht das Template so aus:
TypoScript
<pre>
page = PAGE

page.headerData.10=TEXT
page.headerData.10.value (
style type=text/css
* {margin:0;padding:0;}
body {background: #eee;}
div#main {padding:12px;}
/style
)
page.bodyTag=body
page.10 styles.content.get - ERROR: Line 12: Object Name String, "page.10" was not preceded by any operator, =<>({
page.10.wrap = divimg src=fileadmin/images/newsletterheader.gif/divdiv id=main|/div
</pre>
Nachdem wir das Template gespeichert haben, klicken wir unter Web auf den Direct Mail-Link. Wir sehen unseren SysOrdner Newsletter, den wir anklicken. Dann klicken wir auf den Link "Klicken Sie hier, um eine neue Typo3-Seite, die Sie später als Newsletter verschicken können, anzulegen. ". Wir benennen die Seite und speichern sie. Nun legen wir noch ein bischen Inhalt auf der Seite an und lassen sie anzeigen, um unser Template zu überprüfen. Wenn alles glatt gelaufen ist, sehen wir unseren ersten Newsletter.

Nun können wir unseren Newsletter versenden. Wir wählen wieder Web>Direct Mail. Unter Modulkonfiguration ändern wir noch die Einstellungen wie gewünscht. Wir erstellen unter Empfängerliste eine neue Versandgruppe. Unter Tabellen klicken wir Adresse an, da wir ja tt_address für unsere Adressen benutzen. Wir sehen, das es da noch weitere Optionen gibt.

Nun erstellen wir unseren Newsletter anhand unserer Seite. Wir haben nun viele Optionen zum versenden, wir können ihn zuerst als Testmail an uns selbst verschicken, um alles zu überprüfen. Wir sollten uns mit den einzelnen Menüpunkten von DirectMail vertraut machen, es ist alles gut erklärt und somit verständlich.

Unserem Newsletter steht nun nichts mehr im Weg, viel Spass!
Bugfix

Bei einigen Konfigurationen ergibt sich ein Problem mit den Plain Text - Mails. Hier wird als Content nur eine 1 erzeugt, und der Plain-Letter wird erst richtig erzeugt, wenn man den FE-Cache löscht.
Sollte dieses Problem auftauchen, so kann man den Code von direct mail modifizieren, um das Verhalten zu ändern. Folgende Zeile muss in der Datei direct_mail/mod/class.web_mod_dmail.php auskommentiert werden (Zeile 3916):
PHP

// $this-tmpl-forceTemplateParsing = 1;

Quelle: sk-typo3 · Steffen Kamper · 2006 last Update:Wednesday, 22.07.2009