TYPO3weblog.de

Die Zeit verfliegt, der heilige Abend rückt immer näher und der Streß-Faktor was die Geschenke angeht steigt. Dennoch gibt es heute wieder einmal etwas TypoScript bzw. eine Erklärung zu TypoScript.

Erst vor wenigen Tagen habe ich einem Kollegen erklärt, worin eigentlich der Unterschied zwischen Objekten besteht, die mit temp. und lib. beginnen.

Dazu mal ein Beispiel TypoScript:

temp.meinObject = TEXT
temp.meinObject.value = Text1

lib.meinObject = TEXT
lib.meinObject.value = Text2

Bis hierhin gibt es keinen großen Unterschied, wir haben zwei Objekte, welche einen Text enthalten. Was passiert jedoch, wenn wir diese beiden Objekte nun als Referenz an einer anderen Stelle verwenden wollen:

page = PAGE
page.10 < = temp.meinObject
page.20 <= lib.meinObject

Hier zeigt sich, dass lediglich page.20 mit dem Text befüllt wird. Aber warum ist das so? Das ist sehr schnell und einfach erklärt. Objekte die mit temp. eingeleitet werden, werden nicht gecached. Wie der Prefix es selbst schon aussagt, es sind temporäre Objekte. Alles was hingeben mit lib. beginnt kann auch bei einer Referenz verwendet werden.

Arbeitet man nicht mit dem Referenz-Operator (<=) sondern mit dem Kopier-Operator (<), spielt es keine Rolle ob man temp. oder lib. verwenden.

Gestern hat Euch Tim Tobias im Türchen 10 erklärt, wie man eine TYPO3 Installation auf utf-8 umstellt, ein sehr schönes Tutorial wie ich finde.

Immer wieder erlebe ich es, dass der Kunde Texte selber ändern möchte, klar dafür hat er ja auch von uns TYPO3 bekommen. Leider Zum Glück, möchte der Kunde aber manchmal alles pflegen, also auch Texte die aus LocalLang-Dateien oder Templates kommen.

Eine sehr einfache aber durchaus effektive Lösung dafür ist mal wieder ein wenig TypoScript:

plugin.tx_myplugin_pi1.searchError = RECORDS
plugin.tx_myplugin_pi1.searchError {
  tables = tt_content
  source = 123
}

Jetzt noch das ContentElement mit der UID 123 im Seitenbaum anlegen und folgenden PHP Code in der Extension verwenden:

$marker['###ERR_SEARCH###'] = $this->cObj->cObjGetSingle(
  $this->conf['searchError'], 
  $this->conf['searchError.']
);

Das war es schon, jetzt enthält der Marker ###ERR_SEARCH### den Content, den der Kunde selbst eingepflegt hat. Natürlich muss man kein RECORD nehmen, sondern kann auch alle anderen TS-Objekte wie TEXT oder IMAGE.

Die Extension die Tim gestern im Türchen 4 vorgestellt hat, kannte ich auch noch nicht. Für Euch habe ich heute wieder etwas TypoScript. Das Thema Semantic Web wird inzwischen immer interessanter, darum kam ich auf die Idee – fast allein mit TypoScript – das bekannte hCard-Microformat in TYPO3 zu integrieren.

Was wir dafür brauchen ist eine eigene kleine Extension, diese benötigen wir lediglich für eine einzige Zeile Code, welche in die Datei ext_tables.php kommt:

t3lib_extMgm::addToInsertRecords('fe_users');

Dazu jetzt noch das TypoScript:

temp.hcard = COA
temp.hcard {
	wrap = 
|
	10 = IMAGE
	10.file {
		import = uploads/pics/
		import.field = image
		width = 40
		params = class="photo"
	}
	20 = TEXT
	20.field = name
	20.typolink.parameter.field = url
	20.typolink.ATagParams = class="url fn"
	30 = TEXT
	30.field = company
	30.wrap = 
|
	40 = TEXT
	40.field = email
	40.typolink.parameter.field = email
	40.typolink.ATagParams = class="email"
	50 = COA
	50 {
		wrap = 
|
		10 = TEXT
		10.field = address
		10.wrap = 
|
		20 = TEXT
		20.field = city
		20.wrap = |
		30 = TEXT
		30.field = zip
		30.wrap = |
		40 = TEXT
		40.field = country
		40.wrap = |
	}
	60 = TEXT
	60.field = telephone
	60.wrap = 
|
}

// fe_users dem type shortcut hinzufügen
tt_content.shortcut.20.0.tables = fe_users
// für Tabelle fe_users sagen wir jetzt noch wie es gerendert werden soll.
tt_content.shortcut.20.0.conf.fe_users < temp.hcard

Und was hat uns das jetzt gebracht? Ganz einfach:

1. Wir haben das Content Element "Insert Record" um die Tabelle fe_users erweitert.
2. Wir haben mit dem TypoScript aus dem Object "temp.hcard" eine komplette hCard definiert, welche jetzt mit meinem fe_user Datensatz befüllt werden kann.
3. Durch die CSS-Klassen kann man die Visitenkarte nun auch noch schön aussehen lassen.

Sind alle Daten vorhanden, könnte der erzeugte HTML-Code dann so aussehen:

	
	Frank Nägler
	
TYPO3Weblog.de
	frank.naegler@e-netconsulting.rl
	

		
Sievekingsallee 150b
		Hamburg
		22111
		Deutschland
	
	
+49 (0)7000 623 45 37

Cool oder?

Die komplette Extension fn_hcard als T3X Export habe ich hier für Euch zum Download.

Heute startet der TYPO3-Adventskalender 2008. Im ersten Türchen habe ich ein TypoScript für Euch. Ich stelle Euch eine recht neue und noch eher unbekannte Funktion des stdWrap vor. Aber schauen wir uns erstmal das TypoScript an, danach erkläre ich, was es damit auf sich hat.

temp.tcafield = TEXT
temp.tcafield {
	value = 1
	stdWrap.TCAselectItem.table = fe_users
	stdWrap.TCAselectItem.field = status
}

Die Ausgabe von temp.tcafield ist jetzt “Student”, denn das Feld “Status” beim FE-User hat mit dem Value 1 den Begriff “Student” verknüpft. Wir können also auf diese Art sehr einfach an den Text eines TCA Feldes kommen.

Ein Manko gibt es jedoch noch. Man kann diese Funktion nur auf Felder vom Typ “select” anwenden, und auch nur dann, wenn es keine Datenbank-Relation ist. Ich habe diese Funktion erst kürzlich eingesetzt und mir damit eine Menge Arbeit erspart.

Morgen geht es dann weiter mit Türchen 2 bei Tim.

Auch wenn ich kein Mac-User bin, möchte ich Euch jedoch die neue Version 1.1.12 von ts4c vorstellen, dem TypoScript Plugin für Coda.

Folgende Neuerungen wurden implementiert:

• Verbesserte Unterstützung für coda 1.5
• Verbessertes Syntaxhighlighting
• _ conditions (globalVar, browser)
• _ coa_int, cobj_array
• _ constants {$constant}
• _ plugins
• diverse Verbesserungen und Bugfixes

Über ein paar Kommentare von denen von Euch, die das Plugin einsetzen würde ich mich sehr freuen. Auch wenn ich verAPPLE.me ins Leben gerufen habe, interessieren mich schon Eurer Erfahrungen mit dem Plugin.