Wikizone - Benutzerbeiträge [de]

Zone30

2008-02-14T21:26:27Z

91.47.71.42: /* Presse- und Öffentlichkeitsarbeit */

== "Easy Going" Songs für den 1. September ==
Chasing Cars (Snow Patrol)

Wherever you will go (The Calling) - Tab: http://www.guitaretab.com/t/the-calling/22311.html

Reamonn - Tonight http://www.e-chords.com/guitartab.asp?idmusica=99301&keyb=true

** Everything - Bouble http://www.911tabs.com/link/?4326553

** Wenn jetzt Sommer wär (Pohlmann)

Baby Love (Mothers Finest)

Black Horse and the Cherry Tree (KT Tunstall)

Mother Mother (Tracy Bonham)

** Symphonie (Silbermond)

Nutbush City Limits (Ike&Tina Turner)

** Ich fühl wie Du (Peter Maffay)

** Kiss me (Sixpence non the richer)

Freedom (Georgy Michael)

** Vincent (Don McLean)

Das Beste (Silbermond)

** Your body is a wonderland (John Mayer)

Kiss (Prince)

** Beautyful Soul (Jessie McCartney)

Proud Mary (Ike&Tina Turner)

La camis negra (Juanes)

** We say goodbye (Sascha)

Das war´s was ich bisher gesammelt habe, weiter unten stehen noch Songs in der Vorschlags/Wunschliste, vielleicht ist da ja auch noch was dabei, was schnell realisierbar ist.

== Setlisten ==
gibts hier: [[Zone30 - Setlisten]]

== Was braucht Zone30: ==

'''Percussion''': Udu, Cowbell, Kabasa, Darbouka, Besen(Cajon), Ständer für Schellenring, Splash-Becken, Triangel, Boom-Wacker, Koffer/Kiste für Percussion-Sachen

'''Anlage''': Mikrofonierung für Percussion, Monitor, komplette Verkabelung für Anlage.

'''Dekoration''': Banner (wie gestalten?) Guckst Du: www.banner-channel.de

== Buchungen, Urlaub ==
Zone30 Gigs, Vorbuchungen etc.
<pre>

2008

Sa 15.3. - KO (VORGEBUCHT)
Sa 5.4. - Zone30 Böblingen Polarnacht (VORGEBUCHT)
Sa 24.5.- Zone30 Burkhölzle (VORGEBUCHT)
Sa 31.5. KO 30 Jähriges
Sa 26.7 - Zone30 Geburtstag (VORGEBUCHT)

Noch ohne Termine

<s>November Kulturverein DeSi (Degerschlacht-Sickenhausen)</s>
Benefiz Konzert Terre de Femmes (Nepomuk) - Anfrage von Akustika Jahreswechsel 07 / 08
Kohla Konzert allein, mit Gastsängern (Karaoke)?

Termine Jochen:
14.02. kein Ausweichtermin mögl.
21.02. kein Ausweichtermin mögl.
KW19 5 - 11.5. Sensor Messe Nbg.
KW41-43 6. - 25.10. China/Philipinen
KW46 10. - 16.11. Electronica München

</pre>

== Songideen / Wunschliste ==
Freedom - George Michael

Barenaked - Jennifer Love Hewitt

Promise you and me - Reamonn

Ironic - Alanis M.

Nobody´s wife - Anouk

Walk away - Kelly Klarkson

Stone Sour - Through glas

The Kooks - She moves in her own way

Hard to Handle - Black Crowes u.a.

Walk on the Wild Side - Lou Reed

Kiss me - Six Pence None The Richer

Killing in the Name of... - Rage Against the Machine

Black in Black - ACDC

Think - Aretha Franklin

Dancing on the ceiling - Lionel Richie

Im Ernst? dann lieber Brick House von Commodores (da war Herr Richie noch jung und fetzig)
OK, wie wär´s dann mit "I heard it through the grapevine"

Cowboys and Kisses - Anastacia

== Songs und Abläufe und aktuelles Set==
[[Zone30 - Set]]

== HILFE ==

'''Wie ändert man Texte?'''

Bearbeiten klicken (oben in der Seite oder am entsprechenden Abschnitt) und ändern...

'''Wie legt man neue Seiten an?'''

Irgendwo hier in der Seite den Text wie die Seite heißt reinschreiben(wie oben beschrieben) z.B. "mein neues Superlied", den Text dann markieren und den Button interner Link klicken. Wenn es die Seite noch nicht gibt, kann man die Seite neu anlegen wenn man das erste mal den Link klickt. Zum

'''Mehr Hilfe:'''
http://wiki.zone30.info/wikizone/index.php/Wikizone:Editierhilfe

== Presse- und Öffentlichkeitsarbeit ==
http://www.tagblatt.de/soundcheck/Terminkalender

swr veranstungstipps

radioton

rtf

radio achalm

Gea

Zone30

2008-02-14T21:25:54Z

91.47.71.42:

Zone30

2008-02-14T21:18:15Z

91.47.71.42: /* Buchungen, Urlaub */

Zone30

2008-02-14T21:08:10Z

91.47.71.42: /* Buchungen, Urlaub */

== "Easy Going" Songs für den 1. September ==
Chasing Cars (Snow Patrol)

Wherever you will go (The Calling) - Tab: http://www.guitaretab.com/t/the-calling/22311.html

Reamonn - Tonight http://www.e-chords.com/guitartab.asp?idmusica=99301&keyb=true

** Everything - Bouble http://www.911tabs.com/link/?4326553

** Wenn jetzt Sommer wär (Pohlmann)

Baby Love (Mothers Finest)

Black Horse and the Cherry Tree (KT Tunstall)

Mother Mother (Tracy Bonham)

** Symphonie (Silbermond)

Nutbush City Limits (Ike&Tina Turner)

** Ich fühl wie Du (Peter Maffay)

** Kiss me (Sixpence non the richer)

Freedom (Georgy Michael)

** Vincent (Don McLean)

Das Beste (Silbermond)

** Your body is a wonderland (John Mayer)

Kiss (Prince)

** Beautyful Soul (Jessie McCartney)

Proud Mary (Ike&Tina Turner)

La camis negra (Juanes)

** We say goodbye (Sascha)

Das war´s was ich bisher gesammelt habe, weiter unten stehen noch Songs in der Vorschlags/Wunschliste, vielleicht ist da ja auch noch was dabei, was schnell realisierbar ist.

== Setlisten ==
gibts hier: [[Zone30 - Setlisten]]

== Was braucht Zone30: ==

'''Percussion''': Udu, Cowbell, Kabasa, Darbouka, Besen(Cajon), Ständer für Schellenring, Splash-Becken, Triangel, Boom-Wacker, Koffer/Kiste für Percussion-Sachen

'''Anlage''': Mikrofonierung für Percussion, Monitor, komplette Verkabelung für Anlage.

'''Dekoration''': Banner (wie gestalten?) Guckst Du: www.banner-channel.de

== Buchungen, Urlaub ==
Zone30 Gigs, Vorbuchungen etc.
<pre>

2008

Sa 15.3. - KO (VORGEBUCHT)
Sa 5.4. - Zone30 Böblingen Polarnacht (VORGEBUCHT)
Sa 24.5.- Zone30 Burkhölzle (VORGEBUCHT)
Sa 31.5. KO 30 Jähriges
Sa 26.7 - Zone30 Geburtstag (VORGEBUCHT)

Noch ohne Termine

<s>November Kulturverein DeSi (Degerschlacht-Sickenhausen)</s>
Benefiz Konzert Terre de Femmes (Nepomuk) - Anfrage von Akustika Jahreswechsel 07 / 08
Kohla Konzert allein, mit Gastsängern (Karaoke)?

Termine Jochen:
14.02. kein Ausweichtermin mögl.
21.02. kein Ausweichtermin mögl.
KW19 Sensor Messe Nbg.
KW41-43 China/Philipinen
KW46 Electronica München

</pre>

== Songideen / Wunschliste ==
Freedom - George Michael

Barenaked - Jennifer Love Hewitt

Promise you and me - Reamonn

Ironic - Alanis M.

Nobody´s wife - Anouk

Walk away - Kelly Klarkson

Stone Sour - Through glas

The Kooks - She moves in her own way

Hard to Handle - Black Crowes u.a.

Walk on the Wild Side - Lou Reed

Kiss me - Six Pence None The Richer

Killing in the Name of... - Rage Against the Machine

Black in Black - ACDC

Think - Aretha Franklin

Dancing on the ceiling - Lionel Richie

Im Ernst? dann lieber Brick House von Commodores (da war Herr Richie noch jung und fetzig)
OK, wie wär´s dann mit "I heard it through the grapevine"

Cowboys and Kisses - Anastacia

== Songs und Abläufe und aktuelles Set==
[[Zone30 - Set]]

== HILFE ==

'''Wie ändert man Texte?'''

Bearbeiten klicken (oben in der Seite oder am entsprechenden Abschnitt) und ändern...

'''Wie legt man neue Seiten an?'''

Irgendwo hier in der Seite den Text wie die Seite heißt reinschreiben(wie oben beschrieben) z.B. "mein neues Superlied", den Text dann markieren und den Button interner Link klicken. Wenn es die Seite noch nicht gibt, kann man die Seite neu anlegen wenn man das erste mal den Link klickt. Zum

'''Mehr Hilfe:'''
http://wiki.zone30.info/wikizone/index.php/Wikizone:Editierhilfe

Typo3 Extensions - Backend Formulare und TCA Konfiguration

2008-02-14T13:03:45Z

91.47.71.42: /* Aussehen von Backend Formularen */

=== Aussehen von Backend Formularen ===

Definiert im '''TCA Array'''.

In Extensions wird es in den Dateien

'''ext_tables.php''' und '''tca.php'''

festgelegt. In tca.php wird z.B. mit
..."ctrl" => $TCA["tx_pupmanager_members"]["ctrl"],...
der Teil ctrl des TCA Arrays aus ext_tables übernommen. Man muß also nur in diesen beiden Dateien die Werte verändern um auf verschiedene Weise das Backend zu konfigurieren. Die Details findet man in:

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

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/
</pre>
===Möglichkeit 2: mit Paletten===
<pre>
</pre>
===Möglichkeit 3: ===
<pre>
</pre>
== Reihenfolge der Felder im Backend ==
<pre>

['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),
</pre>
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.

== 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-14T12:58:00Z

91.47.71.42: /* Aussehen von Backend Formularen */

=== Aussehen von Backend Formularen ===

Definiert im '''TCA Array'''.

In Extensions wird es in den Dateien

'''ext_tables.php''' und '''tca.php'''

festgelegt. In tca.php können die Werte aus ext_tables überschrieben werden.

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/
</pre>
===Möglichkeit 2: mit Paletten===
<pre>
</pre>
===Möglichkeit 3: ===
<pre>
</pre>
== Reihenfolge der Felder im Backend ==
<pre>

['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),
</pre>
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.

== 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-14T12:57:18Z

91.47.71.42: /* Aussehen von Backend Formularen */

=== 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/
</pre>
===Möglichkeit 2: mit Paletten===
<pre>
</pre>
===Möglichkeit 3: ===
<pre>
</pre>
== Reihenfolge der Felder im Backend ==
<pre>

['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),
</pre>
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.

== 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-14T12:29:20Z

91.47.71.42: /* Felder in Abhängigkeit von anderen anzeigen oder verstecken */

=== 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/
</pre>
===Möglichkeit 2: mit Paletten===
<pre>
</pre>
===Möglichkeit 3: ===
<pre>
</pre>
== Reihenfolge der Felder im Backend ==
<pre>

['types'][key]
Beispiel:
'types' => Array (
'0' => Array('showitem' => 'hidden;;1, type, title, test_template'),
</pre>
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.

== 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>