Typo3 - Spacer Page

2008-01-09T06:27:03Z

91.32.69.46: /* Der Seitentyp Spacer oder Abstand */

== Der Seitentyp Spacer oder Abstand (Trenner, Divider)==

aus http://www.mcuniverse.com/05/TYPO3.31.0.html

12.8.2006 14:00

'''Spacer Page Code'''

For my direct mail tutorial I was forced to use the Spacer Page Type to break up the leftside navigation into sections. It took a bit of searching on how to use it so I decided to add it to my Code Snippet Section.

To see how it is integrated in with the regular menu, check out the Left Vertical Menu Snippet.
What is a Spacer Page?

This is how the Spacer Page looks in the Directory Tree in Typo3
[[Bild:spacerpage1.gif]]

This is how the Spacer Page looks in the Navigation on the website
[[Bild:Spacerpage.gif]]
The Spacer page is a page that shows up in the navigation, but does not have a link associated with it.

Typo3 has to be told how to use the Spacer page. This is done in the Setup section of the Typo3 template.

First you have to decide at which level of the navigation tree the Spacer page has to show up. In my example it is on Level 3 of the left side navigation and does not show up as a link and does not link to anything. The look of the text is defined by a class in the style sheet.

'''Typo3 Template Spacer Code
'''
<pre>
# Spacer Code Level 2
temp.leftmenu.2.SPC = 1
temp.leftmenu.2.SPC < subparts.leftmenu
temp.leftmenu.2.SPC.doNotShowLink = 0
temp.leftmenu.2.SPC.doNotLinkIt = 1
temp.leftmenu.2.SPC.allWrap =
<DIV class="leftnavspc">«  |  »</DIV>
</pre>
Note:
The last to lines of code should all be on the same line. I had to split it into two to fit on the page.

Stylesheet Spacer Class
<pre>
/* Left Navigation SubMenu Spacer */
.leftnavspc {
font-family: Verdana, sans-serif;
font-size: 11px;
font-variant: small-caps;
font-weight: bolder;
color: #003366; /* dark blue */
text-decoration: none;
padding: 2px;
margin-left: 15px;
background-color: #FFFFFF; /* white */
border-bottom: thin dotted #9B193D; /* burgundy */
}
</pre>

Typo3 Extensions - Backend Formulare und TCA Konfiguration

2008-01-09T04:52:22Z

91.32.69.46:

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

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

Schauen wir uns den Code des Post Process Hooks in der Datei 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>

Es gibt 2 Möglichkeiten den Hook zu nutzen. callUserFunction und the getUserObj. Wobei zweitere die schickere (weil ansatzweise Objektorientiert) ist. Diese Methode stellt uns auch der obige Hook zur Verfügung. Auf die callUserFunction gehen wir zunächst hier nicht ein.

Methode 1 getUserObj:

1. Klasse definieren:
Wir schreiben eine Klasse in der wir die Funktion processDatamap_postProcessFieldArray überschreiben und hier unserer eigene Funktion bereitstellen.

2. Die Methoden Registrieren (ext_localconf.php

Im obigen Code-Schnipsel aus TCE-Main wird ein Array $hookObjectsArr übergeben und eine Methode processDatamap_postProcessFieldArray wird aufgerufen wenn dieses Existiert. Deshalb sollte unserer neue Klasse genauso eine Instanz des Objekts in genau diesem Array $hookObjectsArr sein.

The solution lies at the very beginning of the process_datamap function:

// 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);
}
}

in der Core Datei wird die Funktion im Globalen Array $TYPO3_CONF_VARS registriert. Genauso müssen wir das mit unserer neuen Funktion machen. Deshalb definieren wir in der Datei
ext_localconf.php
unserer Extension
<pre>
$GLOBALS ['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass'][] = 'tx_myextension_tcemainprocdm';
</pre>

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.

Inkludieren 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

Wikizone - Benutzerbeiträge [de]

Typo3 - Spacer Page

Typo3 Extensions - Backend Formulare und TCA Konfiguration