Wikizone - Benutzerbeiträge [de]

Typo3 - Extensions

2008-02-06T10:46:47Z

91.47.80.48: /* weitere nützliche Extensions */

== Ideen für neue Extensions und Erweiterungen bestehender Extensions ==
Extension zur automatischen Erzeugung zweispaltiger Inhalte mit Line Count (auch Umbrüche), Hurenkinder und Schusterjungen regelung etc.

Erweiterung der rg_googlemaps mit Listenansicht nach PLZ
Händlersuche mit Umkreissuche oder Auflistung nach PLZ bereichen (Erweiterung bestehender)

== Extensions programmieren ==
Infos hierzu gibt es im Abschnitt Extension Kickstarter und unter

[[Typo3 - Extensions programmieren]]

[[TypoScript Einstellungen in Extensions auslagern]]

== Nützliche Extensions ==

=== die wichtigsten Extensions ===

automakeTemplates

[[Metatags extended (metatags)]]

[[News (tt_news)]]

CleanDB nf_cleandb

[[Database Integration (wfqbe)]]
Schweizer Taschenmesser zur Integration von Daten (Bugs beachten)

=== weitere nützliche Extensions ===
mk_wastebasket - Datensätze entgültig löschen

Foreign access for MM Tables mmforeign 0.2.0 Experimental

Page Template Selector rlmp_tmplselector 1.2.2

TER Update Check ter_update_check

Exo Feeds exofeeds 0.0.2 Alpha

freeCap CAPTCHA sr_freecap

Front End User Registration sr_feuser_register Stable

Indexed Search Engine indexed_search 2.9.2 System Stable

Language Selection sr_language_menu

Photo Book goof_fotoboek 1.7.11 Stable

Local Stable

TIMTAB Tag-Cloud timtab_tagcloud 1.2.1

Make Print Link make_printlink 1.5.2 Stable

Static Info Tables static_info_tables

sb_accessiblecontent

Content/DAM reference usage dam_ttcontent (Experimental)

phpmyadmin

DAM inkl Erweiterungen

Media (DAM) dam Local Stable

Media>Categories dam_catedit 1.0.3 Local Alpha

Media>Indexing dam_index 1.0.3 Local Stable

Media>Info dam_info

[[PDF Generator 2 (pdf_generator2)]]

[[Typo3 - Bildergallerie]] (lz_gallery)

[[Modern Guestbook (ve_guestbook)]]

[[Mailformplus (tx_mailformplus)]]

[[Send-a-Card (sr_sendcard)]]

[[Front End User Registration (fe_users)]]

[[FreeCap (sr_freecap)]]

[[Date2Calendar (date2cal)]] JavaScript Datumsauswahl für Datumsfelder

[[Dynamic Flexforms (dynaflex)]] Flexforms während der Laufzeit verändern

[[Google Earth links (itxg_gelinks)]] Allows to create and view Google Earth .kml files. The building of a link is being done with GPS coordinates in D-M-S notation.

[[Google Sitemap for Pages and Contents (mc_googlesitemap)]] All options available

== Der Typo3 Extension Kickstarter ==
(Deutsch: Erweiterungs Manager)
Der Erweiterungsmanager ist selbst eine Erweiterung die zuerst installiert werden muß.

Fehler in Extension Kickstarter

Wenn der Kickstarter local installiert ist, dann kann meine eine bereits erstelle Extension nicht im Kickstarter überarbeiten. (Bis Version ?)

Der Kickstarter muß global installiert sein, damit man bereits erstellte Extension mit dem Kickstarter überarbeiten kann.

=== Kurzanleitung ===
'''Wo?'''

Backend-Modul Ext Manager; hier im Dropdown Menü "Make new Extension"

'''General Info'''

Allgemeine Infos zum PlugIn (hat nichts mit der Funktion zu tun)

'''Extension Key'''

- Typo3 entfernt Unterstriche (meine_extension wird zu meineextension)

- tx_ wird automatisch vorangestellt

- ein vorangestelltes user_ bedeutet dass es sich um eine eigene Entwicklung handelt, die nicht in das Repository gestellt werden kann.

'''New Database Tables'''
Hier kann man automatisch die benötigten Tabellen und deren Felder erzeugen.
Üblich ist ein Tabellenname mit dem Suffix _main z.B. user_meineErweiterung_main.
Hier werden auch einige von Typo unterstützte Funktionen die im Backend als Felder sichtbar sind vorbereitet (z.B. Start, Stop, Hide...). Sinnvoll in diesem Zusammenhang:

''Delete*'' - damit die Tabelle ein Delete Flag bekommt

''Hide*'' - damit Datensätze versteckt werden können

''Allowed on Pages'' - Damit Frontend Plugins auch als Inhaltselement im Backend ausgewählt werden können.

''Save and new'' - damit können später schnell mehrere Datensätze angelegt werden.

*Damit das bei der Anzeige Funktioniert muß die Funktionalität in der Datenbankabfrage mit eingebaut werden (d.h. das Flag muß abgefragt werden).

'''Datenfelder der Tabelle'''

Hier werden die Spalten der Tabelle angelegt.

Field name - Der Name der Spalte in der DB (in Kleinbuchstaben, z.B. vorname)

Field title - wird im Backend beim Eingabefeld angezeigt (z.B. Vorname)

Field type - welche Art von Eingabefeld

'''Frontend Plugins'''

Integration ins Frontend

''Enter a title for the plugin'' - taucht in der Auswahlliste für die Plugins aus (Backend)

''USER cObjects are cached'' - Auswählen ob gecached wird (für Entwicklung bietet sich das deaktivieren des Caches an.

''...Typo Script Code...'' - den Beispielcode braucht man i.d.R. nicht, ein einfacher Code wird denoch generiert.

weiter unten kann noch angegeben werden wo das Plugin zugänglich ist.

'''View Result'''

Hier kann man sehen was erzeugt wird...

'''Write'''
... und hier wird es tatsächlich erzeugt.

== Bilder in eigener Extension rendern ==

In diesem Beispiel benutzte Variablen:
$BildAdresse
$ParameterFuerImgTag
$Alttext

In PHP-Datei der Extension:

$this->conf["imageBeispiel."]["file"]="uploads/pics/".$BildAdresse;
$this->conf["imageBeispiel."]["params"]=$ParameterFuerImgTag;
$this->conf["imageBeispiel."]["altText"]=$Alttext;
$Bild=$this->cObj->IMAGE($this->conf["imageBeispiel."]);
$Content.=$Bild;

In Typoscript Setup

plugin.tx_hoTest_pi1 { //hier Plugin-Name
imageArtikel{
file.maxW = {$ho_Test.BildWidthNews}
imageLinkWrap = 1
imageLinkWrap {
enable = 1
bodyTag = <BODY bgColor=white>
wrap = |
width = 400m
height = 400
JSwindow = 1
JSwindow.newWindow = 1
JSwindow.expand = 17,20
}
}
}

Der Wert {$ho_Test.BildWidthNews} kann aus Constants übernommen werden.

Siehe dazu auch
Konstanten von Constants im Setup verwenden
und
Konstanten für Constant-Editor bereitstellen

(aus www.easy-office4you.de/ 10.1.2006)

== Spalten der Seiten umbenennen ==

Um die Spalten der Seite im Backend beliebig umzubenennen und/oder zusätzliche eigene Spalten zu verwenden, muß die Extension zed_more_columns installiert werden und dann in der Datei ext_tables.php die Spalten-Namen eingeben werden.

Beispiel:

$TCA["tt_content"]["columns"]["colPos"]["config"]["items"] = array (
"0" => array ("Mitte||Mitte||||||||","0"),
"1" => array ("Links||Links||||||||","1"),
"2" => array ("Rechts||Rechts||||||||","2"),
"3" => array ("Teaser||Teaser||||||||","3"),
"4" => array ("Fusszeile||Fusszeile||||||||","4")
);

== Bei Extension dafür sorgen, daß im Backend kein Sortierungs-Button entsteht ==

In der Datei ext_tables.php der Extension folgende Zeile ändern

"sortby" => "name",

ändern in

"default_sortby" => "ORDER BY name",

Anstatt "name" kann natürlich auch ein anderes Suchkriterium verwendet werden.

== Eigene Extensions ==
[[Typo3 Extension: pupmanager]]

Webbretter

Personalabfrage

In Planung:

Real Last Change

Easy Rootline

Typo3 Extensions - Backend Formulare und TCA Konfiguration

2008-02-06T09:39:46Z

91.47.80.48: /* Eine Klasse für eigene Validierung einbauen */

=== Aussehen von Backend Formularen ===

Definiert im TCA Array. In Extensions wird es in den Dateien '''ext_tables.php''' und '''tca.php''' festgelegt.
Die Ebenen des Arrays sind wie folgt angelegt.

=== Verschiedenes ===
Bereich '''ctrl''' wird immer gleich geladen die anderen BEreiche erst dynamisch. Wenn sie benutzt werden mit

t3lib_loadTCA('your_table_name');

nachladen

=== Level 1 ===
Die '''Schlüssel entsprechen den DB-Tabellen'''

Grundsätzliche Einstellungen in ''ext_tables.php''

=== Level 2 und 3 ===

Diese beziehen sich auf die '''Struktur eines Tabelleneintrags''' (so sieht also ein Datensatz im Backend aus) und werden meist in ''tca.php'' festgelegt.

== Validierung von Backend Formularen ==
Für Backendfelder steht der Bereich eval zur Verfügung. Dort gibt es vorgefertigte Evaluierungsmöglichkeiten. Es können auch mittels einer Extension eigene JavaScripte zur Evaluierung gebastelt werden. Eine Beispielextension steht auch zur Verfügung.

http://typo3.org/documentation/api/

['columns'][fieldname]['config'] / TYPE: "input"
eval=>...

=== Eine Klasse für eigene Validierung einbauen ===
Folgende Schritte sind notwendig:
# Eine '''Klasse zur Evaluierung''' in der Extension anlegen in der Art: class.tx_meineextension_extraeval1

## Diese Klasse enthält '''zwei Funktionen'''. Eine für die Evaluierung per '''JavaScript''' bei der Eingabe und eine '''php''' Evaluierung nachdem der Datensatz gespeichert wurde. Unten steht die Beispielklasse aus der typo3.org API Dokumentation aus; sie fügt den eingegebenen Werten die unten gezeigten Strings hinzu.

## Die Funktion ''returnFieldJS()'' gibt den '''JavaScript Code''' zurück. Im JavaScript steht die Variable ''value'' zur Verfügung die den Wert des Feldes enthält.

## Die Funktion ''evaluateFieldValue ($value, $is_in, &$set)'' hat folgende Übergabewerte: ''$value'' ist der Feldinhalt, ''$is_in'' enthält die Werte aus der Typo3 Eval Funktion is_in (Filtert Zeichen aus), ''&$set'' ist Boolean und legt fest ob der Wert in die Datenbank geschrieben wird oder nicht. Wird per Referenz übergeben.

# In ext_localconf.php muß die Klasse registriert werden damit sie zur Verfügung steht

# In tca.php kann nun den Backendeingabefeldern die Evaluierung zugewiesen werden.

'''class.tx_exampleextraevaluations_extraeval1'''
<pre>

<?php

class tx_exampleextraevaluations_extraeval1 {
function returnFieldJS() {
return '
return value + " [added by JS]";
';
}
function evaluateFieldValue($value, $is_in, &$set) {
return $value.' [added by PHP]';
}
}
?>

</pre>

'''ext_localconf.php'''
<pre>
...
# Register new evaluation method in the $TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals'] array.
$TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals']['tx_exampleextraevaluations_extraeval1'] = 'EXT:example_extraevaluations/class.tx_pupmanager_extraeval1.php';
</pre>

''' Beispiel zum Aufruf in tca.php '''
<pre>
...
'eval' => 'trim,tx_exampleextraevaluations_extraeval1',
...
</pre>

== Felder in Abhängigkeit von anderen anzeigen oder verstecken ==
===Möglichkeit 1: in der Felddefinition===
Für jedes Feld das eventuell versteckt werden soll, wird eine Bedingung angegeben
Im TCA (tca.php) unter
['columns'][fieldname]
displayCond

'''Beispiele:'''
<pre>
This example will require the field named "tx_templavoila_ds" to be true, otherwise the field for which this rule is set will not be displayed:

'displayCond' => 'FIELD:tx_templavoila_ds:REQ:true',

This example requires the extension "static_info_tables" to be loaded, otherwise the field is not displayed. (This is useful if the field makes a look-up on a table coming from another extension!)

'displayCond' => 'EXT:static_info_tables:LOADED:true',

Wie man sieht ist der String mit : in verschiedene Bereiche aufgeteilt.
Teil 1 ist der Regeltyp. FIELD bezieht sich z.B. auf ein Feld im selben Datensatz. Je nachdem was im ersten Teil steht kann man weitere Teile angeben.

http://typo3.org/documentation/document-library/core-documentation/doc_core_api/4.1.0/view/4/2/

===Möglichkeit 2: mit Paletten===

===Möglichkeit 3: ===

== Reihenfolge der Felder im Backend ==
['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),

The key "showitem" lists the order in which to define the fields: "hidden, type, title, test_template"

(nicht mit showRecordFieldList verwechseln - das legt nur Fest was überhaupt angezeigt wird.
</pre>

== Default Werte in Backend-Feldern ==
useColumnsForDefaultValues

== Tabs in Backend Formularen ==
dividers2tabs(in types)

== Funktionen vor oder nach der Backendeingabe ausführen ==
'''Verwendete Dateien:'''
<pre>
ext_localconf.php (register hook here)
class.tx_myExtension_post-or whatever.php (functionality)
</pre>
Dies kann mit Hooks realisiert werden.

http://typo3.org/development/articles/how-to-use-existing-hooks/page/2/

Daten die vom Backend übermittelt werden werden in der Klasse t3lib_tcemain bearbeitet. Das wäre der geeignete Ort um einzugreifen.
Diese liegt in '''t3lib/class.t3lib_tcemain.php'''. Jetzt wäre es natürlich blöde in den Core Dateien herumzufuhrwerken. Aber es gibt ja das Hook Konzept, mit dem ein Programmierer Schnittstellen bereitstellen kann um die Funktionalität zu erweitern. Netterweise hat ein lieber Core Programmierer schon zwei Hooks vorgesehen die vor bzw. nachdem speichern der Daten im Backend genutzt werden können.

Es gibt 2 Möglichkeiten den Hook zu nutzen. '''callUserFunction''' und the '''getUserObj'''. Wobei zweitere die schickere (weil ansatzweise Objektorientiert) ist. Auf die callUserFunction gehen wir zunächst hier nicht ein.

Die '''getUserObj Methode''' stellt uns auch der folgende Hook zur Verfügung.

Schauen wir uns den Code des Post Process Hooks in der Datei class.t3li_tcemain.php an:
<pre>
// Hook: processDatamap_postProcessFieldArray
reset($hookObjectsArr);
while (list(,$hookObj) = each($hookObjectsArr)) {
if (method_exists ($hookObj, 'processDatamap_postProcessFieldArray')) {
$hookObj->processDatamap_postProcessFieldArray ($status, $table, $id, $fieldArray, $this);
}
}
</pre>

Im obigen Code-Schnipsel aus TCE-Main wird ein Array $hookObjectsArr übergeben und eine Methode processDatamap_postProcessFieldArray wird aufgerufen wenn dieses Existiert.

=== 1. Klasse schreiben ===

'''Wir schreiben einfach eine Klasse''' in der wir die Funktion processDatamap_postProcessFieldArray überschreiben und hier unserer eigene Funktion bereitstellen.

2.1 Funktion Registrieren
in der Core Datei wird die '''Funktion im Globalen Array $TYPO3_CONF_VARS registriert'''. Genauso müssen wir das mit unserer neuen Funktion machen. Die neuen Methoden Registrieren wir in ''ext_localconf.php''

Typo 3 hat seine Klasse so registriert:

process_datamap function des Typo3 Core (obige Datei):
<pre>
// First prepare user defined objects (if any) for hooks which extend this function:
$hookObjectsArr = array();
if (is_array ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'])) {
foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'] as $classRef) {
$hookObjectsArr[] = &t3lib_div::getUserObj ($classRef);
}
}
</pre>

Unserer neue Klasse soll genauso eine Instanz des Objekts in genau diesem Array $hookObjectsArr sein.

Deshalb registrieren wir in der Datei '''ext_localconf.php'''unserer Extension unsere Datei indem wir die Funktion genau wie oben im Array aufnehmen:
<pre>
$GLOBALS ['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'tx_myextension_tcemainprocdm';
</pre>

=== 2.2. Klassendatei laden ===
Jezt müssen wir noch aufpassen das die Klassendatei auch geladen wird wenn sie benötigt wird. Dazu können wir ein require_once statement in ext_tables.php unserer Extension hinzufügen oder besser folgendes machen.

=== 2.3. Laden und Registrieren der Klasse gleichzeitig ===

Die getUserObj Methode erlaubt uns die beiden Schritte gleichzeitig auszuführen. Das können wir dann beides in '''ext_localconf.php''' machen. Dann sieht die Zeile von vorhin '''etwas anders''' aus:

<pre>
$GLOBALS ['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'EXT:myextension/class.myextension_tcemainprocdm.php:tx_myextension_tcemainprocdm';
</pre>

Das hat zudem den Vorteil, das die Klasse nur dann aufgerufen wird wenn sie auch benötigt wird.

Another great advantage of this method is that your file will only be included if it's really used!
postProcessFieldArray" in der Rubrik "processDatamap

=== Wie Programmiert man ? ===
Für die Programmierung steht die Typo3 Core Engine zur Verfügung (TCE)

'''Das Konzept:'''

When you are using TCE from your backend applications you need to prepare two arrays of information which contain the instructions to TCEmain of what actions to perform. They fall into two categories: Data and Commands.

"Data" is when you want to write information to a database table or create a new record.

"Commands" is when you want to move, copy or delete a record in the system.

The data and commands are created as multidimensional arrays and to understand the API of TCEmain you simply need to understand the hierarchy of these two arrays.

Commands Array ($cmd):

'''Syntax:'''

$cmd[ tablename ][ uid ][ command ] = value

Unsere Funktion:
Wird aufgerufen wenn Datensatz gespeichert wird
Parameter:
<pre>
$status->update oder new,
$table -> die im Moment bearbeitete Tabelle,
$id-> bei status new ein Zufallscode Newxxxxx sonst die uid des Datensatzen,
&$fieldArray -> hier kann man einen Wert aus dem gerade zu speichernden Datensatz überschreiben
$reference -> das komplette cObj
</pre>

<pre>
class tx_myextension_tcemainprocdm {

function processDatamap_postProcessFieldArray ($status, $table, $id, &$fieldArray, &$this) {

// here comes the code

}

}
</pre>

Typo3 Extensions - Backend Formulare und TCA Konfiguration

2008-02-06T09:38:44Z

91.47.80.48: /* Eine Klasse für eigene Validierung einbauen */

=== Aussehen von Backend Formularen ===

Definiert im TCA Array. In Extensions wird es in den Dateien '''ext_tables.php''' und '''tca.php''' festgelegt.
Die Ebenen des Arrays sind wie folgt angelegt.

=== Verschiedenes ===
Bereich '''ctrl''' wird immer gleich geladen die anderen BEreiche erst dynamisch. Wenn sie benutzt werden mit

t3lib_loadTCA('your_table_name');

nachladen

=== Level 1 ===
Die '''Schlüssel entsprechen den DB-Tabellen'''

Grundsätzliche Einstellungen in ''ext_tables.php''

=== Level 2 und 3 ===

Diese beziehen sich auf die '''Struktur eines Tabelleneintrags''' (so sieht also ein Datensatz im Backend aus) und werden meist in ''tca.php'' festgelegt.

== Validierung von Backend Formularen ==
Für Backendfelder steht der Bereich eval zur Verfügung. Dort gibt es vorgefertigte Evaluierungsmöglichkeiten. Es können auch mittels einer Extension eigene JavaScripte zur Evaluierung gebastelt werden. Eine Beispielextension steht auch zur Verfügung.

http://typo3.org/documentation/api/

['columns'][fieldname]['config'] / TYPE: "input"
eval=>...

=== Eine Klasse für eigene Validierung einbauen ===
Folgende Schritte sind notwendig:
# Eine '''Klasse zur Evaluierung''' in der Extension anlegen in der Art: class.tx_meineextension_extraeval1

## Diese Klasse enthält '''zwei Funktionen'''. Eine für die Evaluierung per '''JavaScript''' bei der Eingabe und eine '''php''' Evaluierung nachdem der Datensatz gespeichert wurde. Unten steht die Beispielklasse aus der typo3.org API Dokumentation aus; sie fügt den eingegebenen Werten die unten gezeigten Strings hinzu.

## Die Funktion returnFieldJS() gibt den JavaScript Code zurück. Im JavaScript steht die Variable value zur Verfügung die den Wert des Feldes enthält.

## Die Funktion evaluateFieldValue ($value, $is_in, &$set) hat folgende Übergabewerte: $value ist der Feldinhalt, $is_in enthält die Werte aus der Typo3 Eval Funktion is_in (Filtert Zeichen aus), &$set ist Boolean und legt fest ob der Wert in die Datenbank geschrieben wird oder nicht. Wird per Referenz übergeben.

# In ext_localconf.php muß die Klasse registriert werden damit sie zur Verfügung steht

# In tca.php kann nun den Backendeingabefeldern die Evaluierung zugewiesen werden.

'''class.tx_exampleextraevaluations_extraeval1'''
<pre>

<?php

class tx_exampleextraevaluations_extraeval1 {
function returnFieldJS() {
return '
return value + " [added by JS]";
';
}
function evaluateFieldValue($value, $is_in, &$set) {
return $value.' [added by PHP]';
}
}
?>

</pre>

'''ext_localconf.php'''
<pre>
...
# Register new evaluation method in the $TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals'] array.
$TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals']['tx_exampleextraevaluations_extraeval1'] = 'EXT:example_extraevaluations/class.tx_pupmanager_extraeval1.php';
</pre>

''' Beispiel zum Aufruf in tca.php '''
<pre>
...
'eval' => 'trim,tx_exampleextraevaluations_extraeval1',
...
</pre>

== Felder in Abhängigkeit von anderen anzeigen oder verstecken ==
===Möglichkeit 1: in der Felddefinition===
Für jedes Feld das eventuell versteckt werden soll, wird eine Bedingung angegeben
Im TCA (tca.php) unter
['columns'][fieldname]
displayCond

'''Beispiele:'''
<pre>
This example will require the field named "tx_templavoila_ds" to be true, otherwise the field for which this rule is set will not be displayed:

'displayCond' => 'FIELD:tx_templavoila_ds:REQ:true',

This example requires the extension "static_info_tables" to be loaded, otherwise the field is not displayed. (This is useful if the field makes a look-up on a table coming from another extension!)

'displayCond' => 'EXT:static_info_tables:LOADED:true',

Wie man sieht ist der String mit : in verschiedene Bereiche aufgeteilt.
Teil 1 ist der Regeltyp. FIELD bezieht sich z.B. auf ein Feld im selben Datensatz. Je nachdem was im ersten Teil steht kann man weitere Teile angeben.

http://typo3.org/documentation/document-library/core-documentation/doc_core_api/4.1.0/view/4/2/

===Möglichkeit 2: mit Paletten===

===Möglichkeit 3: ===

== Reihenfolge der Felder im Backend ==
['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),

The key "showitem" lists the order in which to define the fields: "hidden, type, title, test_template"

(nicht mit showRecordFieldList verwechseln - das legt nur Fest was überhaupt angezeigt wird.
</pre>

== Default Werte in Backend-Feldern ==
useColumnsForDefaultValues

== Tabs in Backend Formularen ==
dividers2tabs(in types)

== Funktionen vor oder nach der Backendeingabe ausführen ==
'''Verwendete Dateien:'''
<pre>
ext_localconf.php (register hook here)
class.tx_myExtension_post-or whatever.php (functionality)
</pre>
Dies kann mit Hooks realisiert werden.

http://typo3.org/development/articles/how-to-use-existing-hooks/page/2/

Daten die vom Backend übermittelt werden werden in der Klasse t3lib_tcemain bearbeitet. Das wäre der geeignete Ort um einzugreifen.
Diese liegt in '''t3lib/class.t3lib_tcemain.php'''. Jetzt wäre es natürlich blöde in den Core Dateien herumzufuhrwerken. Aber es gibt ja das Hook Konzept, mit dem ein Programmierer Schnittstellen bereitstellen kann um die Funktionalität zu erweitern. Netterweise hat ein lieber Core Programmierer schon zwei Hooks vorgesehen die vor bzw. nachdem speichern der Daten im Backend genutzt werden können.

Es gibt 2 Möglichkeiten den Hook zu nutzen. '''callUserFunction''' und the '''getUserObj'''. Wobei zweitere die schickere (weil ansatzweise Objektorientiert) ist. Auf die callUserFunction gehen wir zunächst hier nicht ein.

Die '''getUserObj Methode''' stellt uns auch der folgende Hook zur Verfügung.

Schauen wir uns den Code des Post Process Hooks in der Datei class.t3li_tcemain.php an:
<pre>
// Hook: processDatamap_postProcessFieldArray
reset($hookObjectsArr);
while (list(,$hookObj) = each($hookObjectsArr)) {
if (method_exists ($hookObj, 'processDatamap_postProcessFieldArray')) {
$hookObj->processDatamap_postProcessFieldArray ($status, $table, $id, $fieldArray, $this);
}
}
</pre>

Im obigen Code-Schnipsel aus TCE-Main wird ein Array $hookObjectsArr übergeben und eine Methode processDatamap_postProcessFieldArray wird aufgerufen wenn dieses Existiert.

=== 1. Klasse schreiben ===

'''Wir schreiben einfach eine Klasse''' in der wir die Funktion processDatamap_postProcessFieldArray überschreiben und hier unserer eigene Funktion bereitstellen.

2.1 Funktion Registrieren
in der Core Datei wird die '''Funktion im Globalen Array $TYPO3_CONF_VARS registriert'''. Genauso müssen wir das mit unserer neuen Funktion machen. Die neuen Methoden Registrieren wir in ''ext_localconf.php''

Typo 3 hat seine Klasse so registriert:

process_datamap function des Typo3 Core (obige Datei):
<pre>
// First prepare user defined objects (if any) for hooks which extend this function:
$hookObjectsArr = array();
if (is_array ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'])) {
foreach ($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'] as $classRef) {
$hookObjectsArr[] = &t3lib_div::getUserObj ($classRef);
}
}
</pre>

Unserer neue Klasse soll genauso eine Instanz des Objekts in genau diesem Array $hookObjectsArr sein.

Deshalb registrieren wir in der Datei '''ext_localconf.php'''unserer Extension unsere Datei indem wir die Funktion genau wie oben im Array aufnehmen:
<pre>
$GLOBALS ['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'tx_myextension_tcemainprocdm';
</pre>

=== 2.2. Klassendatei laden ===
Jezt müssen wir noch aufpassen das die Klassendatei auch geladen wird wenn sie benötigt wird. Dazu können wir ein require_once statement in ext_tables.php unserer Extension hinzufügen oder besser folgendes machen.

=== 2.3. Laden und Registrieren der Klasse gleichzeitig ===

Die getUserObj Methode erlaubt uns die beiden Schritte gleichzeitig auszuführen. Das können wir dann beides in '''ext_localconf.php''' machen. Dann sieht die Zeile von vorhin '''etwas anders''' aus:

<pre>
$GLOBALS ['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'EXT:myextension/class.myextension_tcemainprocdm.php:tx_myextension_tcemainprocdm';
</pre>

Das hat zudem den Vorteil, das die Klasse nur dann aufgerufen wird wenn sie auch benötigt wird.

Another great advantage of this method is that your file will only be included if it's really used!
postProcessFieldArray" in der Rubrik "processDatamap

=== Wie Programmiert man ? ===
Für die Programmierung steht die Typo3 Core Engine zur Verfügung (TCE)

'''Das Konzept:'''

When you are using TCE from your backend applications you need to prepare two arrays of information which contain the instructions to TCEmain of what actions to perform. They fall into two categories: Data and Commands.

"Data" is when you want to write information to a database table or create a new record.

"Commands" is when you want to move, copy or delete a record in the system.

The data and commands are created as multidimensional arrays and to understand the API of TCEmain you simply need to understand the hierarchy of these two arrays.

Commands Array ($cmd):

'''Syntax:'''

$cmd[ tablename ][ uid ][ command ] = value

Unsere Funktion:
Wird aufgerufen wenn Datensatz gespeichert wird
Parameter:
<pre>
$status->update oder new,
$table -> die im Moment bearbeitete Tabelle,
$id-> bei status new ein Zufallscode Newxxxxx sonst die uid des Datensatzen,
&$fieldArray -> hier kann man einen Wert aus dem gerade zu speichernden Datensatz überschreiben
$reference -> das komplette cObj
</pre>

<pre>
class tx_myextension_tcemainprocdm {

function processDatamap_postProcessFieldArray ($status, $table, $id, &$fieldArray, &$this) {

// here comes the code

}

}
</pre>