Wikizone - Benutzerbeiträge [de]

Typo3 - Update

2009-03-12T16:23:11Z

91.47.50.37: /* Mass Update Script */

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:

== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==

Yesterday some updates came out for TYPO3. These updates fixed certain issues and we needed to update all of our excellent shared hosting environments.

We already have a script (which is more elaborate now) that checks all our TYPO3 installations and sends the sysadmins a nice report about its findings. We use part of that report (list of paths to Document Roots) to feed the updater script.

The TYPO3 update requires you to do the followi

* update encryption key
* clear configuration cache
* clear page cache

We do not want to go into 200+ TYPO3 backends and do those tasks manually. We are lazy and we will write a script to automagically do the boring tasks for us.

This script is not perfect but it works well on Debian systems. You can modify it to fit your needs. It was just a quick hack to ease the upgrade pain. Take care to switch the symlink part for upgrade runs of different versions of TYPO3.

I am not responsible for any damage to your system that may occur to misuse of this script. Make sure you understand it before you run it. Run it with a single URI before attempting a whole ist of URI's.

Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

Typo3 - Update

2009-03-12T16:22:24Z

91.47.50.37: /* Mass Update Script */

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:

== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==
Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

TYPO3 mass update script

1.
#!/bin/sh
2.
binDir=/usr/bin/
3.
sleep=2
4.

5.
pageCacheTables=(
6.
cache_pages
7.
cache_pagesection
8.
)
9.

10.
sites=(
11.
/var/www/sites/live/www.somedomain.tld
12.
/var/www/sites/live/www.someotherdomain.tld
13.
/var/www/sites/live/www.yetsomeotherdomain.tld
14.
)
15.

16.
len=${#sites[*]}
17.
pageCacheTablesLength=${#pageCacheTables[*]}
18.
i=0
19.
while [ $i -lt $len ]; do
20.
echo updating: ${sites[$i]}
21.
cd ${sites[$i]}
22.
rm typo3_src
23.
ln -s ../../sources/typo3_src-4.2.5 typo3_src
24.

25.
echo generating new key
26.
k=0
27.
key=''
28.
while [ $k -lt 96 ]; do
29.
key=$key$(head -100 /dev/urandom | md5sum | cut -c1)
30.
let k++
31.
done
32.
echo key: $key
33.
sed -i "s/$\$TYPO3_CONF_VARS\['SYS']\['encryptionKey'] = $.*/\1'$key';/g" typo3conf/localconf.php
34.

35.
echo removing configuration cache
36.
rm -f typo3conf/temp_CACHED*
37.

38.
echo clearing page cache
39.
# For some insane reason some values are enclosed in double qotes
40.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db =')
41.
if [ -z "$database" ] ; then
42.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
43.
else
44.
database=$(grep "typo_db " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
45.
fi
46.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_username =')
47.
if [ -z "$username" ] ; then
48.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
49.
else
50.
username=$(grep "typo_db_username " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
51.
fi
52.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/" | grep '$typo_db_password =')
53.
if [ -z "$password" ] ; then
54.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^']*'$[^']*$'.*/\1/")
55.
else
56.
password=$(grep "typo_db_password " typo3conf/localconf.php | tail -1 | sed "s/^[^\"]*\"$[^\"]*$\".*/\1/")
57.
fi
58.
j=0
59.
while [ $j -lt $pageCacheTablesLength ];
60.
do
61.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "TRUNCATE ${pageCacheTables[$j]}"
62.
nice -n 19 ${binDir}mysql --batch -u$username -p"$password" -D$database -e "ALTER TABLE ${pageCacheTables[$j]} auto_increment=1"
63.
let j++
64.
done
65.

66.
echo "done! Sleeping $sleep seconds . . ."
67.
sleep $sleep
68.

69.
echo
70.
let i++
71.
done

Typo3 - Update

2009-03-12T16:21:28Z

91.47.50.37:

== Update alter Typo3 Installationen (<V.3.8)==
Aus der Mailing Liste Östereich:
- der Core ist relativ easy (fast) immer zu upgraden (muesst' eigentlich von
v3.3 auch gehen ;-) )
- Achte immer auf installierte Extensions
* wenn etwas nicht geht, mal soweit wie moeglich alle Extensions wegschalten (nicht loeschen!).
* dann zuschalten; wenns dann hakt, dann sieht man gleich welche ext "boese" ist.
* dann diese ext updaten, wenns keine updates gibt, mal danach googlen.
* wenns dann net geht, debuggen..

Weitere Probleme:

Alte TS Templates arbeiten noch mit CSet und Content als default Template. Nach umstellen auf css-styled-content muß evt. einiges angepasst werden:

== Update auf 4.1 ==
Unbedingt im Install Tool Compare ausführen und Tabellen aktualisieren. Sonst kann es Probleme mit verschiedenen Extensions geben (z.B. Login..)

== Release Notes Version 4.1 ==
Die wichtigsten Neuerungen
* IRRE (Inline Relational Record Editing)
* AJAX Page and File Tree
* Clean-up functions (command line scripts)(Über Extension lowlevel)
* Improved Extension Manager (less memory, stored extension list)
* UTF-8 for filenames
* Backend "Who is online"
* Frontend "Stay logged in" (Konfiguration mit new login box)
* MySQL InnoDB (Wird automatisch bei Neuinstallation zur Verfügung gestellt, wenn es in mySQL aktiviert ist)
* Speed up Backend with .htaccess http://typo3.org/development/articles/release-notes-41/page/4/)

=== Manuelles ändern der Tabellen auf InnoDB ===
<pre>
alter table cache_hash ENGINE = INNODB;
alter table cache_imagesizes ENGINE = INNODB;
alter table cache_md5params ENGINE = INNODB;
alter table cache_pages ENGINE = INNODB;
alter table cache_pagesection ENGINE = INNODB;
alter table cache_typo3temp_log ENGINE = INNODB;
alter table fe_sessions ENGINE = INNODB;
alter table fe_session_data ENGINE = INNODB;
alter table index_fulltext ENGINE = INNODB;
alter table index_grlist ENGINE = INNODB;
alter table index_phash ENGINE = INNODB;
alter table index_rel ENGINE = INNODB;
alter table index_section ENGINE = INNODB;
alter table index_stat_search ENGINE = INNODB;
alter table index_stat_word ENGINE = INNODB;
alter table index_words ENGINE = INNODB;
alter table sys_log ENGINE = INNODB;
</pre>

== Generelle Informationen zum Update unter Linux ==
Quelle: typo3.net Mai 2006

Typo3 ist normalerweise sehr einfach upzudaten - allerdings müssen ein paar Dinge beachtet werden, um updatefähig zu bleiben:

* Es dürfen keine Änderungen an dem Typo3-Sourcecode gemacht worden sein. Falls dieses doch gemacht wurde, müssen natürlich diese Änderungen erst in die neue Version eingearbeitet werden.
* Installierte Extensions sollten möglichst immer LOCAL installiert worden sein. So bleiben diese nach dem Tausch des Typo3-Sourcecodes unberührt und funktionieren nach dem Update (meist) wie gewohnt. Es gibt nur selten den Fall, daß eine Typo3-Version eine Funktion nicht mehr verwendet, die es in der alten Version noch gab.
* Wenn sie HTML-Templates von GLOBAL installierten Erweiterungen direkt im Extensionordner modifiziert haben sollten, müssen diese erst z.B. in den fileadmin kopiert werden. Dann können Sie den Pfad zu dieser Datei im TypoScript anpassen.

Den Pfad finden Sie überigens mithilfe des TypoScript-Object-Browsers schnell. Meist ist er an der Stelle plugin.extensionname.templateFile zu finden.

[[Bild:T3_wichtigeVerzeichnisse.gif]]

Einige der wichtigsten Verzeichnisse

'''Das Update für mittwaldmedien Kunden'''
Für unsere Kunden ist es nun besonders einfach, die vorhandene Installation auf die aktuelle Version zu bringen. Sie müssen sich nur auf der Webseite http://www.typo3server.com einloggen. Nach dem Login finden Sie ein Menü mit einem Link zu dem Typo3-Versionsmanager. Dort können Sie mit einem Klick Ihren Account auf die neue Version updaten.

'''ToDo Versionsmanager für Geo-bit'''

'''Manuelles Update'''

Für diejenigen, die dieses Update manuell machen wollen oder müssen, sind die folgenden Schrittenötig. Die Beispiele - vor allem die Pfade - müssen natürlich angepasst werden. Die Beispiele gehen davon aus, daß Sie eine Verzeichnisstruktur angelegt haben, die dem obigen Bild entspricht.

1. Machen Sie zuerst eine Datensicherung von dem Typo3-Sourcen und Ihrem html-Ordner! Die Datenbank können Sie nun über diesen Befehl sichern:

mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql

Notfalls könnte auch ein Dump mit phpMyAdmin erstellt werden.

2. Verbinden Sie sich mit Ihrem Server über SSH.

3. Wechseln Sie das Verzeichnis auf einer Ebene über dem Rootverzeichnis Ihres Webservers.
z.B.: cd /home/www/p1234/

4. Laden Sie sich die neuen Typo3-Sourcen auf ihren Linuxrechner. Die aktuellen Sourcen finden Sie unter: http://typo3.org/download/packages/.

Die benötigte Datei hat das Format typo3_src-3.x.x.tar.gz

'''Beispiel:'''

wget belnet.dl.sourceforge.net/sourceforge/typo3/typo3_src-3.7.0.tar.gz

5. Entpacken Sie die Datei mit dem Kommando:

'''Beispiel:'''

tar -xzvf typo3_src-3.x.x.tar.gz

6. Ändern Sie nun die Rechte so, wie der bisherige Typo3-Sourcecode-Ordner sie hatte.

'''Beispiel:'''

chown p1234.ftponly typo3_src-3.7.0 -R

7. Entfernen Sie den alten symbolischen Link mit:

rm typo3_src

8. Legen Sie nun einen neuen Link an mit:

ln -s typo3_src-3.x.x typo3_src

(Die Versionsnummer müssen Sie natürlich noch anpassen.)

9. Nun muss die Datenbank noch aktualisiert werden:

Gehen Sie hierzu in das Typo3-Installtool und klicken Sie auf den 2. Menüpunkt Database Analyser. Mit einem Klick auf Compare werden die zu ändernden oder zu ergänzenden Datenbankfelder angezeigt. Mit einem Klick auf "Write to database" wird die Datenbank an die neue Typo3-Version angepasst.

10. Loggen Sie sich nun als Admin im Backend an und löschen Sie alle Caches.

== Neu in Version 4 ==
* Conditions mit AND und OR (|| &&)

== Neu in 4.2 ==
Viele Usability Verbesserungen im Backend
== Update auf 4.2 ==
=== Extensions Updaten ===
* dam 1.0.11 ist nicht kompatibel Update auf min. 1.0.13
* date2cal auf >= 7.1.0
* Kickstarter 0.3.8 ist nicht kompatibel
* Developer tools gehen nicht mehr (wg. Frame oben)

=== Ablauf ===
* Backend Benutzer sperren (only Admins)
* Sicherung der Datenbank
* neue Source + Symlink
* Update Wizard
* Compare

=== Probleme ===
'''DAM Upload geht für Benutzer''' nicht mehr (Fehler Meta Daten können nicht geschrieben werden)
Beim neu indizieren geht dem dam der Media Ordner verloren. Er legt dann einen neuen an, in den er scheiben möchte. Die Benutzer sind abe noch auf den alten eingestellt. D.h. die Benutzergruppen m´üssen auf den neuen eingestellt werden.

Im Dam stehen im IE7 die Benutzerwerkzeuge nicht zur verfügung (löschen etc.) nur der Stift ist noch da.

Lösung: Das Problem ist das CSS für das Fenster. Es verdeckt die restlichen Symbole
Forum: 24.7.

Ich hatte das gleiche Problem bis vor 5 Minuten auch,
gelöst habe ich es so:
- Datei: class.tx_dam_listbase.php im Ordner DAM\lib\
Unter der Zeile 256 ('itemTD' => ' class="typo3-dblist-item"',)
ist in 3 Werten als Breite 1% angegeben. Das auskommentieren

- Datei: stylesheet.cdd in typo3_src\typo3\
table.typo3-dblist width: 98%; durch width: auto; ersetzen und in
table.typo3-dblist tr td {width: auto;} einsetzen,

damit hats bei mir im IE 7, Firefox, safari für Win und Opera alles richtig angezeigt :-)

Ich hoffe, geholrfen zu haben,
Schmoozer

Bug in Mount Points

== Datenbank über Root Shell sichern (mysql backup) ==

mysqldump -opt ...

Beispiele

Die häufigste Anwendung von mysqldump ist wahrscheinlich die '''Erstellung eines Backups einer vollständigen Datenbank''':

shell> mysqldump --opt db_name > backup-file.sql

oder mit User und Passwortangabe:
mysqldump -u meinDBUser -pGEHEIM db_name > backup.sql

--opt ist in neueren MySQL Versionen Standardmäßig an deshalb lassen wir es mal weg.

Die Speicherauszugsdatei können Sie wie folgt '''wieder einspielen'''.

shell> mysql db_name < backup-file.sql

Oder aber so:

shell> mysql -e "source /path-to-backup/backup-file.sql" db_name

mysqldump ist ferner sehr nützlich zum Ausfüllen von Datenbanken durch Kopieren von Daten von einem MySQL Server auf einen anderen:

shell> mysqldump --opt db_name | mysql --host=remote_host -C db_name

Sie können mit einem einzigen Befehl einen Speicherauszug mehrerer Datenbanken erstellen:

shell> mysqldump --databases db_name1 [db_name2 ...] > my_databases.sql

Um einen Speicherauszug aller Datenbanken zu erstellen, verwenden Sie die Option --all-databases:

shell> mysqldump --all-databases > all_databases.sql

Bei InnoDB-Tabellen bietet mysqldump die Möglichkeit, eine Online-Sicherung zu erstellen:

shell> mysqldump --all-databases --single-transaction > all_databases.sql

Diese Datensicherung muss vor Beginn des Speicherauszugsvorgangs lediglich (mit FLUSH TABLES WITH READ LOCK) eine globale Lesesperre für alle Tabellen erwirken. Sobald diese Sperre aktiv ist, werden die Koordinaten des Binärlogs ausgelesen, und die Sperre wird aufgehoben. Wenn beim Absetzen der FLUSH-Anweisung gerade eine umfangreiche Änderungsanweisung ausgeführt wird, dann – und nur dann! – kann der MySQL Server stehen bleiben, bis diese lange Anweisung ausgeführt ist; danach ist der Server sperrfrei. Wenn die vom MySQL Server empfangenen Änderungsanweisungen (in Bezug auf ihre Ausführungsdauer) kurz sind, sollte die anfängliche Sperrperiode auch bei vielen Änderungen nicht spürbar sein.

Bei der Point-in-Time-Wiederherstellung (die auch als „Roll-Forward“ bezeichnet wird, wenn Sie ein altes Backup wiederherstellen und die seitdem durchgeführten Änderungen neu aufspielen müssen) ist es häufig nützlich, das Binärlog zu rotieren (siehe Abschnitt 5.12.3, „Die binäre Update-Logdatei“) oder zumindest die Binärlogkoordinaten zu kennen, denen der Speicherauszug entspricht:

shell> mysqldump --all-databases --master-data=2 > all_databases.sql

Oder:

shell> mysqldump --all-databases --flush-logs --master-data=2
> all_databases.sql

== Mass Update Script ==
Ein Massen Update Script von:

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/
Zugriff am 12.3.2009

http://typofree.org/article/archive/2009/january/title/typo3-mass-upgrade-script/

Typo3 - Alles über Hooks

2009-03-12T16:10:57Z

91.47.50.37:

Link zum Original Artikel:

http://typo3blogger.de/alles-uber-hooks/ (Datum der Kopie: 12.3.2009)

Ich versuche hier einen Einblick in die Mysterien von Hooks innerhalb von TYPO3 zu geben. Folgende Fragen will ich alle aufgreifen:

* 1. Was ist ein Hook?
* 2. Was kann ich damit machen?
* 3. Hook vs. XCLASS - was ist besser?
* 4. Welche Hooks werden schon jetzt auf meinem System verwendet?
* 5. Wie finde ich Hooks?
* 6. Wie kann ich einen Hook anwenden?
* 7. Wie kann ich einen Hook in meine Extension einbauen?
* 8. Gibt es weitere Dokumentationen zu Hooks?

Los gehts:

1. Was ist ein Hook?
In der Programmierung bezeichnet der Begriff Hook eine Schnittstelle, mit der fremder Programmcode in eine bestehende Anwendung integriert werden kann, um diese zu erweitern, deren Ablauf zu modifizieren oder um bestimmte Ereignisse abzufangen (soviel mal wieder von Wikipedia).
In vereinfachter und speziell auf TYPO3 ausgelegter Formulierung würde ich sagen, dass man einen Hook (im T3 Source oder in einer Extension) dazu verwenden kann, um eine vorhande Funktion abzuändern oder um eine weitere Funktion bei einer Aktion auszulösen; und das alles ohne den Code der Ausgangsfunktion zu ändern.

2. Was kann ich damit machen?
2.1. Was ich mit Hooks mache
Am häufigsten verwende ich Hooks, wenn ich eine Extension erweitern will. Eine gute und umfangreiche T3 Erweiterung bringt von Haus auf ein paar Hooks mit, damit man in einen Ablauf eingreifen kann (falls eine Extension eurer Meinung nach unbedingt noch einen neuen Hook braucht, wird der Autor sicher nicht nicht nein sagen, wenn ihr diesen mit ein wenig Code unterstützt und die Implementation gut begründet). Natürlich bietet auch der T3 Core eine Menge Hooks, die z.B. die FE Ausgabe beeinflussen können.

2.2. Konkrete Beispiele

1. Ich will tt_news in der Singleansicht um einen neuen Marker erweitern, der mir irgendeinen Wert zur aktuellen News ausgibt (Beispiel).
2. Ich will die Empfänger eines Powermail Formulares kurz vor dem Versand manipulieren (siehe wt_dynamictarget).
3. Ich will den gerenderten HTML Quelltext von TYPO3 kurz vor der Ausgabe manipulieren (siehe spamshield).
4. Ich will bei einer Bestellung in commerce einen weiteren Prozess anstoßen (Hooks in commerce).

3. Hook vs. XCLASS - was ist besser?
3.1. XCLASS
Vielleicht habt ihr euch schon mal gefragt, warum der Kickstarter am Ende jeder relevanten Datei so eine Zeile einfügt:
<pre>
if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/wt_directory/pi1/class.tx_wtdirectory_pi1.php']) {
include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/wt_directory/pi1/class.tx_wtdirectory_pi1.php']);
}
</pre>
Nahezu jede Extension- und auch viele Core- Dateien bieten die Möglichkeit über XCLASS nicht die eigentlichen Skripte auszuführen sondern alternative Skripte (Beispiel) - somit kann eine komplett andere Datei als die eigentlich vorbestimmte verwendet werden.

3.2. Hook
Während man also über die XCLASS ganze Dateien ersetzen kann, ist ein Hook “nur” dazu gedacht, einen definierten Bereich zu manipulieren - Beispiel:
<pre>
$content = 'ergebnis';
if (is_array($GLOBALS['TYPO3_CONF_VARS']['EXTCONF'][$this->extKey]['hook'])) {
foreach ($GLOBALS['TYPO3_CONF_VARS']['EXTCONF'][$this->extKey]['hook'] as $_classRef) {
$_procObj = &t3lib_div::getUserObj($_classRef);
$_procObj->functionName($content);
}
}
return $content;
</pre>
3.3. Was ist besser und warum?
Es liegt auf der Hand, warum die Verwendung eines Hooks zu bevorzugen ist:
Bei Updates der Ausgangsextension ist die Ablaufänderung weiterhin möglich (sofern der Autor nicht den Hook entfernt oder abändert) und Änderung können einfließen, während bei der Benutzung der XCLASS ein Update an der Ausgangsdatei keine Wirkung zeigt (die Datei wird ja nicht mehr verwendet). Desweiteren kann man einen Hook öfters und parallel nutzen (wenn richtig eingerichtet), während die XCLASS nur max. einmal verwendet werden kann.

4. Welche Hooks werden schon jetzt auf meinem System verwendet?
Vermutlich werden bereits jetzt schon einige Hooks auf deinem System verwendet. Hier hilft ein Blick in die Konfiguration (linkes Menü: Punkt “Konfiguration”, dann $TYPO3_CONF_VARS, dann z.B. Baum EXTCONF aufklappen):

5. Wie finde ich Hooks?
Einige Erweiterungen dokumentieren die verwendeten Hooks im Manual oder bringen eine eigene XLS Datei mit. Bei einigen bringt wohl auch nur der Blick in den Code wirklich etwas. Ähnlich verhält es sich derzeit mit den Hooks im T3 Sourcecode.
Eine ganz neuer Ansatz wie man Hooks auf die Spur kommt, beschreibt Tim in seinem Beitrag vom Juli 2007.

6. Wie kann ich einen Hook anwenden?
6.1. Info
Wenn du also einen Hook gefunden hast, den du in einer Erweiterung selbst aufgreifen willst, dann geht der Weg meist über die ext_localconf.php. Dort machst du die Zuweisung zu einer eigenen Klasse oder Funktion (Beispiel unten)

6.2. Beispiel - Vorgegebener Hook
6.2.1. Code
<pre>
$content = 10;
if (is_array($GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extensionkey']['hook'])) {
foreach ($GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extensionkey']['hook'] as $_classRef) {
$_procObj = &t3lib_div::getUserObj($_classRef);
$_procObj->main($content, $this);
}
}
return $content;
</pre>
Erklärung: Ausgeschrieben würden diese Zeilen wohl folgendes tun: Falls der Hook $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extensionkey']['hook'] gesetzt ist, wird eine Schleife geöffnet, die jeden Hook (kann ja schließlich mehrfach verwendet werden) durchgeht. Zuerst wird eine Referenz zu dem von dir gesetzten Objekt erstellt, danach wird die Funktion “main” mit 2 Parametern aufgerufen.
Falls unberührt vom Hook würde einfach nur die Variable $content (mit Inhalt “10″) aus- bzw. zurückgegeben werden.

6.2.2. ext_localconf.php
Ein Aufruf in der ext_localconf.php kann so aussehen:
<pre>
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extensionkey']['hook'][] = 'EXT:extension/class.ext_hook.php:ext_hook';
</pre>
Erklärung: Hier wird die Zieldatei und Klasse gesetzt (in unserem Beispiel also - Datei: class.ext_hook.php, Klasse: ext_hook)

6.2.3. Datei class.ext_hook.php
Beispielinhalt:
<pre>
class ext_hook {
function main(&$content, $obj) {
$content += 1; // erhöhe $content um 1
}
}
</pre>
Da die Funktion mit Namen main in unserem Beispiel vorgegeben ist, wird diese aufgerufen und dieser werden 2 Paramter übergeben. In unserem Beispiel erhöhen wir $content um den wert 1.
Durch die Verwendung der Referenz &$content beim Funktionsaufruf wird somit auch $content in der ursprünglichen Datei um 1 erhöht.

7. Wie kann ich einen Hook in meine Extension einbauen?
7.1. Alternatives Beispiel
Vermutlich dient Punkt 6 schon dem Verständnis, wie man einen Hook integrieren kann.
Als alternatives Beispiel kann man einen Hook auch so integrieren, ohne dass der Funktionsname fest vorgegeben wird:
<pre>
if ($GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extName']['hook']) {
foreach($GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extName']['hook'] as $_funcRef) {
if ($_funcRef) {
t3lib_div::callUserFunction($_funcRef, $content, $this);
}
}
}
</pre>
Beispielintegration in eurer ext_localconf.php:

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extName']['hook'][] = 'EXT:extension/class.tx_ext.php:tx_ext->start';

Beispieldatei:
<pre>
class tx_ext {
function start(&$content, $obj) {
$content = 'neuer Wert';
}
}
</pre>
7.2. By the way
- Übergabe von $this: In meinen Beispielen wird beim Methodenaufruf in den Hooks immer $this übergeben. Der Sinn darin besteht, dass man nahezu jedes zuvor definierte Objekt oder Methode mit $this->bla aufrufen und ändern kann. Also beim Extension Entwickeln lieber $this->content statt $content verwenden (wenn möglich und sinnvoll)
- Hooks sollten immer so angelegt werden, dass diese öfters verwendet werden können (siehe Beispiele oben). Man weiß nie wieviele Erweiterungen gleichzeitig einen Hook nutzen
- Macht euch Gedanken wo in eurer Extension ein Hook Sinn macht. Was könnte also jemand anderes beeinflussen wollen? Macht ein Hook überhaupt Sinn?

8. Gibt es weitere Dokumentationen zu Hooks?

* Hook Dokumentation von typo3.org
* Wiki für T3 Hooks

Puh, hoffentlich habe ich nicht zu viel (Mist) geschrieben - ist ja auch ein trockenes Thema. Habe ich etwas wichtiges vergessen? Freue mich auf Feedback!

Grüße, Alex

Typo3 - Extensions programmieren

2009-03-12T16:07:58Z

91.47.50.37: /* Erweitern von Funktionalitäten mit Hooks */

Weiterführende Links:

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

http://wiki.typo3.org/De:Create_your_own_extension

http://wiki.typo3.org/Extension_Developers_Guide

http://typo3.org/documentation/document-library/core-documentation/doc_core_api/4.2.0/view/3/2/#id4144512

(High Priority Functions)

== Templates ==
[[Typo3 Extension Developer Templates]]
== Wie fange ich an ? ==
Was möchtest du tun?
'''Ein vorhandenes Inhaltselement verändern, z.B. Felder hinzufügen oder ein neues Erstellen.'''

[[Typo3 Extensions - Inhaltstypen anlegen und bearbeiten]]

Ein Beispiel dafür ist die Extension metatags die den Inhaltselementen Text mit Bild und Bild zusätzliche Felder für Alt und Title Tag hinzufügt.

== Extensions Programmieren in der Praxis ==
=== Typo3 und AJAX ===
[[AJAX in TYPO3 Extensions]]

=== TypoScript in Extensions ===
[[TypoScript Einstellungen in Extensions auslagern]]

=== Frontend Plugin ===
[[Typo3 Extensions - ein Frontend Plugin Programmieren]]
=== IRRE ===
[[Typo3 Extensions mit IRRE]]

Das IRRE Konzept hilft beim erstellen von Extensions mit "echten" relationalen Datenbankabfragen
=== FlexForms ===
[[Typo3 Extensions mit FlexForms]]

=== Backendformulare ===
[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]
=== Erweitern von Funktionalitäten mit Hooks ===

Ein Beispiel findet sich hier unter Funktionen vor oder nach der Backendeingabe ausführen:

[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]

Eine schöne Einführung von Typo3 Blogger:
[[Typo3 - Alles über Hooks]]

=== Arbeiten mit Templates ===
[[Typo3 Extensions - Arbeiten mit Templates]]

=== Typo3 Extensions programmieren - Snippets ===
[[Typo3 Extensions programmieren - Snippets]]

=== Typo3 Extensions programmieren - Rich Text Editor (RTE) ===
[[Typo3 Extensions programmieren - RTE]]

=== Typo3 Extensions programmieren - Session Verwaltung ===
Siehe auch Sessions in Typo3

Standardmäßig gibt es Sessions für eingeloggte Frontend User Session und Browser Sessions

Browser Session Variable setzen
$GLOBALS["TSFE"]->fe_user->setKey("ses","zaehler", $wert);
und auslesen:
$GLOBALS["TSFE"]->fe_user->getKey("ses","zaehler");

Bei der User Session wird statt 'ses' 'user' als 1. Parameter verwendet
Beispiele User Session:
<pre>
$this->lastSelection['filters']['sem'] = 0;
//User SEssion Data lesen
$this->lastSelection = $GLOBALS["TSFE"]->fe_user->getKey("user","lastSelection");
// User Session Data schreiben
GLOBALS["TSFE"]->fe_user->setKey("user","lastSelection",$this->lastSelection);
</pre>

'''Ein weiterer netter Artikel von Tim Lochmüller aus typo3weblog.de'''

Diesmal geht es um die Benutzung der Session in TYPO3. In der Regel genügt nur eine Zeile Code um einen Wert in die Session zu schreiben oder wieder heraus zu holen. Schauen wir uns erstmal an, wie man etwas in die Session schreibt:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);

Die Funktion setKey() erwartet drei Parameter:

# Type: Dieser kann "ses" oder "user" sein.
# Key: Eindeutiger Ident für eine Session Variable
# Data: Die Daten die gespeichert werden sollen.

Die beiden Typen "ses" und "user" unterscheiden sich wesentlich. Während der Typ "ses" nur temporär die Daten speichert, also genau so lange, wie die Session besteht (Session-Cookie), ist es mit dem Key "user" möglich, die Daten auch über mehrere Sessions hinweg zu speichern, wobei diese an den FE-User gekoppelt werden.

Der Key sollte so gewählt werden, dass man nicht in Konflikt mit anderen Extensions kommt. Am besten benutzt man seinen Extension-Key dafür.

Die Daten die man speichern will kann jede beliebige PHP Variable sein, sogar komplette Objekte kann man ablegen.

So, nun wollen wir uns den Wert mal wieder raus holen, auch dies geht sehr schnell und einfach:

$data = $GLOBALS["TSFE"]->fe_user->getKey("ses", "tx_myext");

Die Methode getKey erwartet nur zwei Parameter, die Bedeutung ist die gleiche wie bei setKey().

Das Leben kann so einfach sein, wenn es nicht ab und an diese kleinen fiesen Sonderfälle gibt ;)

Nehmen wir mal an, man erzeugt ein PDF oder eine AJAX-Antwort, dann gibt man das PDF aus und steigt mit einem exit() oder die() aus. In diesen Fällen, reicht ein einfacher Aufruf von setKey() nicht aus. Denn TYPO3 kann dann die Daten nicht automatisch speichern. Aber hier schafft der folgende Code Abhilfe:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);
$GLOBALS["TSFE"]->fe_user->storeSessionData();

Mit storeSessionData() sorgen wir dafür, dass TYPO3 umgehend die Werte speichert. Sehr häufig wird gerade auf die letzte Zeile verzichtet, was in der Regel auch funktioniert, jedoch nur so lange, wie kein Fehler auftritt oder das Script vorzeitig beendet wird.

Fröhliches Session-Handling Euch allen :)

=== Typo3 Extensions programmieren - Nützliche Funktionen ===
Aus Adventskalender 2008 typo3blog

Interessante Funktionen aus der Klasse t3lib_div vor.

1. t3lib_div::array2json($data)
Mit dieser Funktion kann man sehr einfach seine Daten in ein JSON Objekt konvertieren. Die Funktion erwartet ein Array mit den Daten, dieses kann beliebig verschachtelt sein. Natürlich gibt es auch noch die PHP native Funktion json_encode, jedoch muss dies von der installierten PHP Installation unterstüzt werden.

2. t3lib_div::convUmlauts($str)
Eine sehr nützliche Funktion ist convUmlauts, welche die deutschen Umlaute konvertiert, dabei wird aus einem Ä eine Ae oder aus einem ü ein ue. Groß und Klein-Schreibung wird also berücksichtigt.

3. t3lib_div::rmFromList($element, $list)
Auch diese Funktion ist sehr nützlich. Möchte man aus einer kommaseparierten Liste ein Element entfernen, ist dies mit einem Funktionsaufruf getan. Gerade bei TYPO3 ist diese Funktion sehr hilfreich, wenn man z.B. eine Benutzergruppe eines FE-Users entfernen möchte.

== Wichtige Variablen ==
$_EXTKEY
bzw. im Array...
Enthält den Extension Key. Immer die Variable benutzen, dann kann man den Code leichte wieder verwenden.
$TYPO3_CONF_VARS

== Wie arbeitet eine Extension ==
'''Laden:''' Extension Manager (EM) ruft ''ext_emconf.php'' (enthält nur das Array: $EM_CONF[$_EXTKEY]) bei allen Extensions auf die in der localconf.php aufgeführt sind.

'''Aufruf von Backend oder Frontend:''' ''ext_localconf.php'' wird ausgeführt (oder eine gecachete Kopie) In dieser wird die /typo3conf/localconf.php erweitert.
Funktion: weitere Klassen includieren (require_once())

=== Wichtige Dateien einer Extension ===

====ext_emconf.php====
'''Metadaten''' wie Name, Kategorie, Status einer Extension - muß vorhanden sein sonst wird die Extension nicht geladen. Die Informationen landen in $EM_CONF[$_EXTKEY] = ARRAY

==== ext_localconf.php ====
'''TCA Konfiguration für das Backend'''. (Werte für das Array $TYPO3_CONF_VARS). Z.B. Namen der zu ladenden Klassen, statische TSFiles etc.

Wird immer geladen wenn ein Aufruf in Frontend oder Backend erfolgt. Kann deshalb dazu benutzt werden wichtige Klassendaten zu laden oder Skripte zu inkludieren.

Optional - wird genutzt wenn Sie gefunden wird.

==== ext_tables.php ====
Erweiterungen für $'''TCA'''(Table Configuration Array). Beschreibungen von Tabellen und Formularen.

Wird außerdem genutzt um den '''Code von Frontend-Plugins, Modulen oder statischem TypoScript zu laden'''

Optional - wird genutzt wenn Sie gefunden wird.

==== Weitere häufige Dateien ====
ext_tables.sql - SQL Statements für die '''Datenbank-Tabellen''' beim Installieren der Extension.

ext_tables_static+adt.sql - SQL Insert Statements für '''statische Werte in Tabellen''' (z.B. PLZ Liste).

ext_conf_template.txt

tca.php - Anpassungen für '''$TCA,''' Informationen für die Behandlung von Datenbanktabellen

locallang[...].xml und locallang[...].php - '''Sprachdateien''' (Begriffe).

====Typische Unterordner (optional)====
pi1, pi2 - Enthalten Frontend Plugins

mod1, mod2 - Backend Module

sv1, sv2 - Services

=== Wichtige Globale Variablen ===
$_EXTKEY - der Extension Key

=== Formulare im Backend ===
Das '''$TCA''' (Table Configuration Array) bestimmt welche Formularfelder verwendet werden.
Das Array ist in ext_tables.php(Bereiche: ctrl und feinterface s.u.) und tca.php gespeichert

* Jeder Eintrag im $TCA ist an eine Datenbanktabelle geknüpft
* Der erste Index ist der Tabellenname.
* Im zweiten Index gibt es 6 Bereiche:
<pre>
ctrl -> Informationen zur Tabelle
interface -> Konfiguration für die Auflistung und Darstellung im Backend
feInterface -> Eigenschaften für das Frontend Editing
columns -> Informationen zu den Feldtypen der Tabelle und der Verarbeitung der Daten (zweiter Index ist hier der Spaltenname)
types -> legt fest welche der in columns definierten Spalten dargestellt werden und in welcher Reihenfolge,
außerdem Zusatzinfo wie alternative Feldbezeichnung, Palettennummer, style codes...
palettes -> Zum Zusammenfassen von mehreren Eingabefeldern, Zusammenstellungen wiederverwenden, Hilfsfelder definieren
</pre>

=== Daten bearbeiten mit TCE und TCEforms ===
Die im $TCA definierten Daten müssen in irgend einer Form bearbeitet werden. Ein umfangreiches Modul dazu befindet sich in der Extension CMS (typo3/sysext/cms/layout/db_layout.php. DDas Modul greift auf die '''Typo3 Core Engine (TCE)''' zurück, die zum Verarbeiten und Speichern von Daten dient. Die '''Formulare werden mit der Klasse TCEforms''' erzeugt. Bearbeitet wird hierbei im Backend.

Immer dann, wenn man die '''im $TCA eingetragenen Tabellen über Eingabemasken manipulieren''' will ist des sinnvoll die TCE zu nutzen.

t3lib_TCEmain -> t3lib/class.t3lib_tce-main.php
t3lib_TCEforms -> TCEforms

==== Einsatz in Extensions ====
Instanz von t3lib_TCEmain erzeugen:
require_once(PATH_t3lib."class.t3lib_tcemain.php");
$tce=t3lib_div::makeInstance('t3lib_TCEmain');
Arrays für Daten und Kommandos erzeugen:
$data[tabelle][uid][feld] = wert
um neue Daten zu schreiben bevor man eine uid hat belegt man uid mit NEW und einem Zufallsstring z.B. NEWo1amh
$cmd[tabelle][uid][befehl] = wert
dabei stehen verschiedene Befehle zur Verfügung:
copy, move, delete, localize, version, new
Die beiden Arrays werden dann mittels
$tce->start($data,$cmd)
an die TCE übergeben und von
$tce->process_cmdmap()
abgearbeitet.

== Wie kann ich eine eigene Extension debuggen? ==
=== Hilfreiche Extensions zur Entwicklung von Extensions ===
'''devlog''' -> schreibt log Einträge in eine Datenbanktabelle. Dazu ruft man an in seiner Extension die Funktion TODO auf und übergibt die Werte die man loggen will.

''' Extension Development Evaluator (extdeveval) ''' -> Referenzen aufrufen, Autmatisch Funktionsinfos schreiben u.v.m.

=== permalink ===
Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

Beispiel:

PHP-Code:
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
t3lib_div::debug($data);
</pre>

Ergebnis:

je nach devIPMask Einstellungen ist auch nur

PHP-Code:

debug();

nützlich, vor allem wenn ein Kundenprojekt Online ist einfach im Installtool und devIpMask deine IP eingeben und dann mit debug(); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist... Beispiel Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...

da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

Beispiel:
PHP-Code:
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22);
t3lib_div::debug(,'Array vorher');

$data['Name'] = 'T.uX';
$data['Alter'] = 32;

t3lib_div::debug(,'Array nachher');

Auch bei der Verwendung der integrierten DB-Abstraktionsschicht können eine Reihe von Fehlern auftreten, die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu erzwingen sollte man folgende Zeile in seine Extension integrieren*:

PHP-Code:
$GLOBALS['TYPO3_DB']->debugOutput = true;
So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.

== Datenbankabfrage in Extensions ==
[[TYPO3 - Datenbankabfragen in Extensions]]

== Struktur einer Extension ==
===ext_emconf.php===

Informationen und Metadaten zur Extension. Etwa die Infos die im Kickstarter unter General Info stehen.

* Root-Verzeichnis
**'''ext_localconf.php''' Enthält '''Konfigurationsdaten''' ($TYPO3_CONF_VARS) für das Backend und Frontend. Hier kann über die Extension API auch '''TypoScript''' eingebunden werden. Hier können auch Klassendateien aufgerufen werden (require_once() ) die bei jedem Aufruf zur Verfügung stehen sollen.
**'''ext_tables.php''' Konfiguration von '''Datenbanktabellen'''. Plugins und Module über die Extension API einbinden. (Alles über Kickstarter)
**'''ext_tables.sql''' '''SQL-Daten''' für die Tabellendefinition. Die Auswertung erfolgt über den Extension Manager und das Install-Tool.
**'''ext_tables_static+adt.sql''' '''SQL-Tabellendefinition''' inkl. Daten. Z.B. für statische Daten (Länderinfos etc.)Die Tabellen müssen zusätzlich in ext_tables.sql definiert sein.
**'''ext_typoscript_*.txt''' '''Globaler TypoScript-Code'''. Steht nicht üver Template-Datensätze zur Auswahl (siehe /static)
**'''ext_conf_template.txt''' Hier werden '''Optionen zur Konfiguration''' angelegt, die der Benutzer im Extensionmanager einstellen kann.
**'''*icon*.gif''' '''Symbol-Dateien''' für Extension,DB-Tabellen,Plugins, Module...
**'''locallang*.php''' Texte für die '''Lokalisierung''' in verschiedenen Sprachen
**'''class.ext_update.php''' Funktionen für ein '''Update der Extension''' (Beispiel siehe newloginbox).

*'''pi1/''' Verzeichnis für '''Skripte und Daten''' des Plugin
**'''class*.php''' '''PHP-Klassen''' z.B. für Plugins oder Submodule

*'''cm1/''' Verzeichnis für Dateien die das '''Kontext-Menü''' betreffen

*'''mod1/''' Verzeichnis für ein Modul.
**'''conf.php''' Konfigurationsdatei für ein '''Modul''' zum einbinden ins Backend.
**'''index.php''' '''Hauptscript eines Moduls'''.

*'''modfunc1/''' Skripte und Daten für '''Submodul-Funktionen'''

*'''static/''' '''TypoScript-Template'''-Dateien. Diese werden über die Extension-API eingebunden und stehen dann in Template-Datensätzen, ähnlich den Standard Templates zur Auswahl.

*'''sv1/''' Verzeichnis für '''Services'''

*'''res/''' Verzeichnis für beliebige 'recourcen'.

*'''doc/''' Verzeichnis der '''Dokumentation'''.

== Wo werden Extensions installiert ? ==
===typo3/sysext/ (System)===
System Extensions wie cms und lang. Hier können keine Extensions mit dem Extension Manager installiert werden.
===typo3/ext/ - globale Extensions (Global) ===
Z.B. diese die von Typo3 mitgeliefert werden. Mit der Option allowGlobalInstall kann man die Installation in dieses Verzeichnis erlauben. Das ist dann nicht sinnvoll wenn sich mehrere Typo3 WEbsites eine Installation teilen, weil es hier zu Versionskonflikten kommen kann.
===typo3conf/ext - lokale Extensions (Local)===
Hier werden normalerweise alle Extensions installiert. Die Lokale Installation hat immer Vorang vor einer globalen.

== Typolinks richtig in Extensions einsetzen ==

In diesem kurzem Tutorial möchte ich zeigen, wie man Typolinks in eigenen Erweiterungen erstellt, die das
Feature 'Simulate Static Documents' unterstützen und eine Ausgabe erstellen, die von Typo3 gecached wird
und so auch mit der Indexed search verwendet werden können. Diese Informationen wurden aus anderen
Erweiterungen zusammengetragen, speziell aus der Erweiterung tt_board.
Typoscript
Zuerst erstelle in der Datei 'ext_typoscript_setup.txt' eine Eigenschaft, die deiner Erweiterung mitteilt, ob
caching genutzt werden soll oder nicht:

<pre>
plugin.tx_myextension_pi1 {
allowCaching = 1
}
</pre>

Wenn das später auf 0 gesetzt wird, werden diese Seiten nicht mehr gecached.

'''Vorbereitung'''

Bereite in der main() Funktion den Typolink vor und konfiguriere das caching:

<pre>
class tx_myextension_pi1 extends tslib_pibase {
...
var $allowCaching = "";
function main($content,$conf) {
$this->conf=$conf;
...
// Preconfigure the typolink
$this->local_cObj = t3lib_div::makeInstance("tslib_cObj");
$this->local_cObj->setCurrentVal($GLOBALS["TSFE"]->id);
$this->typolink_conf = $this->conf["typolink."];
$this->typolink_conf["parameter."]["current"] = 1;
$this->typolink_conf["additionalParams"] =
$this->cObj->stdWrap($this->typolink_conf["additionalParams"],
$this->typolink_conf["additionalParams."]);
unset($this->typolink_conf["additionalParams."]);
// Configure caching
$this->allowCaching = $this->conf["allowCaching"]?1:0;
if (!$this->allowCaching) {
$GLOBALS["TSFE"]->set_no_cache();
}
...
}
}
Links erstellen
Um nun Links in der Erweiterung zu erstellen, benutze das folgende Code Fragment:
$temp_conf = $this->typolink_conf;
$temp_conf["additionalParams"] .= "&tx_myextension_pi1[key]=value";
$temp_conf["useCacheHash"] = $this->allowCaching;
$temp_conf["no_cache"] = !$this->allowCaching;
$the_link = $this->local_cObj->typolink("Linktext", $temp_conf);
</pre>

Danach kann man '$the_link' zu der Ausgabe hinzufügen. Das '$temp_conf' Array kann man mit allen
Eigenschaften des typolink Objektes erweitern.

Tutorial by typo3.hachmeister.org
Von:fruit-lab.de

== Datei Uploads in Backend Extensions ==
Feld im Kickstarter anlegen. in der tca.php kannst du den uploadfolder festlegen.

Komplizierter wirds in folgendem Fall (aus typo3.net 12-2007)

stimmt schon, dass man da den ordner ändern kann, aber was wenn ich nicht alle dateien in einen ordner speichern will?
ich brauche 2 ordner. einen für normale downloads und in den anderen würden die dateien reinkommen, die kostenpflichtig downzuloaden sind. diesen ordner muss ich also per htaccess schützen. darum wärs nötig, dass der upload-ordner für den späteren redakteur frei wählbar, oder zumindest 2 ordner auswählbar sind.

irgendwelche ideen?

alles kein Problem.

Man kann in der ext_emconf.php unter createDirs die benötigten Verzeichnisse angeben.
Für Fileupload gibts auch einige Typofunktionen die man nutzen kann, so helfen einem folgende Klassen weiter:
t3lib_basicFileFunctions
t3lib_extFileFunctions

== Debug Methode ==
Typo3 | Debug Methode :: Hilfe bei der Programmierung

Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu
behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data);
</pre>

Ergebnis:

[[Bild:TS_debug01.gif]]

je nach devIPMask Einstellungen ist auch nur
debug($sonstwas);
nützlich, vor allem wenn ein Kundenprojekt Online isteinfach im Installtool und devIpMask deine IP eingeben und dann mit debug($sonstwas); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist...

'''Beispiel'''

Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...
da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data,'Array vorher');
$data['Name'] = 'T.uX';
$data['Alter'] = 32;
echo t3lib_div::debug($data,'Array nachher');
</pre>

Ergebnis:

[[Bild:TS_debug02.gif]]

Hinweis:
läst du dir eine Variable im debug ausgeben erscheint [b]|debug|[/b]. das funzt nur mit Arrays ;-)
Auch bei der Verwendung der integrierten DB-Abstrktionsschicht können eine Reihe von Fehlern auftreten,
die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu
erzwingen sollte man folgende Zeile in seine Extension integrieren*:
$GLOBALS['TYPO3_DB']->debugOutput = true;

So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.
Tutorial by typo3.kj187.de

== PHP-Skripte einbinden ==

=== mit PHP_SCRIPT ===

Im Typo Script:
<pre>
##############################
### temporäres Test Script ###
##############################

temp.phpScript = PHP_SCRIPT
temp.phpScript {
file = demo/test.inc.php
myVerySpecialOwnParameter = Hallo Welt
myParamArray {
a = 2
b = 5
}
}
</pre>
Im Skript text.inc.php
<pre>
<?php
// Use the debug-function to view the config
// array $conf given by TypoScript:
debug( $conf );

$contentArr[] = "Test";
$contentArr[] = $conf['file'];
$contentArr[] = $conf['myVerySpecialOwnParameter'];
$contentArr[] = implode( $conf['myParamArray.'], ', ' );

// Put all your output to $content,
// that TYPO3 will display for you:
$content = implode( $contentArr, '< br />' );
?>
</pre>

=== mit PHP_SCRIPT_EXT ===
Typo3 | Externe PHP Scripte einbinden

Haben Sie ihr Projekt auf Typo3 umgestellt und wollen dennoch ihre eigenen PHP-Scripte verwenden? Dann machen Sie folgendes.

Schreiben Sie in das SETUP Feld des Templates:

<pre>
tt_content.script = CASE
tt_content.script {
key.field = select_key
test = PHP_SCRIPT_EXT
test.file = fileadmin/dein_script.php
}
</pre>

Um das Script jetzt als Contentelement in die Seite einzubinden, legen Sie einen neuen Seiteninhalt an. Wechseln Sie von Typ = Text auf Typ = Skript. In das CODE Feld müssen Sie jetzt nur noch test eintragen und sie sind fertig.

Dies ist die einfachste Methode. Die Ausgabe des Scripts wird aber nicht in den Cache aufgenommen! Diese Funktion wird leider nicht unterstützt.

Tutorial by typo3.kj187.de

Anmerkung Steff: Für die Cache Funktion kann man z.B. eine Einfache Extension basteln.

== Beispiele ==
===Einträge aus Bildausrichtungen im Backend entfernen===
aus cron_cssstyledimgtext
<pre>
<?php
if (!defined ('TYPO3_MODE')) die ('Access denied.');

t3lib_extMgm::addPItoST43($_EXTKEY,'pi1/class.tx_croncssstyledimgtext_pi1.php','_pi1','',1);

$_EXTCONF = unserialize($_EXTCONF);
if ($_EXTCONF['addPageTS']) {
t3lib_extMgm::addPageTSConfig('
TCEFORM.tt_content.imageorient.types.image.removeItems = 8,9,10,17,18,25,26
');
}

$TYPO3_CONF_VARS['FE']['XCLASS']['tslib/class.tslib_content.php']=t3lib_extMgm::extPath($_EXTKEY).'class.ux_tslib_content.php';
?>

</pre>

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

== Ausgaben im HTML-Header in Extensions programmieren ==
Manchmal möchte man bestimmte Angaben in den Header schreiben, um zum Beispiel ein JavaScript einzubinden o.ä.

Man könnte im statischen TypoScript für das Objekt page etwas hernehmen. Das funktioniert aber nur wenn das PAGE Objekt auch wirklich page heißt.

Also besser mit einer Typo3 Eigenen Funktion.

'''Beispiel - JavaScript einbinden'''
<pre>
function includeJavaScript() {
$js .= '<script src="'.t3lib_extMgm::siteRelPath($this->extKey).dirname($this->scriptRelPath).'/JS-Verzeichnis/js-file.js" type="text/javascript"></script>';
$GLOBALS['TSFE']->additionalHeaderData[$this->extKey] = $js;
}

//Aufruf der Funktion:
$content=$this->includeJavaScript();
</pre>

Die Variable $this->extKey wird normalerweise immer in der Klassendefinition der Extensiongesetzt und enthält den Namen der Extension (z.B. meineextension)

Für $this->scriptRelPath gilt das gleiche. Hier steht der Pfad ab dem Extension Ordner (z.B. pi1/class.tx_meineExtension_pi1.php)

== Mehrsprachige Extensions ==
Seit der Version 4 hat sich die Vorgehensweise bei der Lokalisierung geändert. Um zu verstehen wie die Lokalisierung von Backend, Frontend etc. funktioniert gibt es hier eine kleine Übersicht:
[[Sprachverwaltung und Lokalisierung in Typo3]]

Typo3 - Baukasten

2009-03-12T16:02:14Z

91.47.50.37: /* GMenu mit Bildern aus den Seiteneigenschaften (Media-Feld) */

weitere Infos unter [[Typo3 - Tipps und Tricks]]

== Auf Daten zugreifen ==
Beispiele gibt es hier:

[[TypoScript - Daten auslesen]]

[[Typo3 - stdWrap]]

Die stdWrap Eigenschaft steht vielen Objekten zur Verfügung. Wenn Sie vorhanden ist ist Sie der Problemlöser für fast alle Probleme :-).

[[Typo3 - TSFE]]

[[Typo3 - Das Media Feld]]

== Standardeinstellungen ==
[[Typo3 - Standardeinstellungen]]

== Quellcode aufräumen - Sourcecode verbessern - valides XHTML ==
Der Core produziert seit 4.0 valides XHTML

weitere Hilfen wenn Extensions nicht valide arbeiten bieten:

Installation von Tidy auf dem SErver (aktivieren im Install-Tool)

HTML Cleaner http://typo3.org/extensions/repository/view/qcom_htmlcleaner/2.4.0/

Das Bordeigene HTML-Cleaning: config.xhtml_cleaning = all

Vorsicht bei den Cleanern wenn JavaScript im Spiel ist weil dieser z.T. zerstört werden kann.

=== Beispiel aus dem Forum zum Quelltext aufräumen ===
<pre>
#Einstellen des DocType auf XHTML Transitional
config.doctype = xhtml_trans
#XHTML Cleaning aktivieren
config.xhtml_cleaning = all
#Default Javascripts in externes File auslagern
config.removeDefaultJS = 1
config.removeDefaultJS = external
#<?xml... ?> Prolog deaktivieren
config.xmlprologue = none
#CSS Datei in externes File auslagern
config.inlineStyle2TempFile = 1
config.disablePrefixComment = 1

#RTE Tuning
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.P.class >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.remapTag >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.DIV.class >
#Angabe von Tags, die nicht mit einem zusätzlichen wrap umgeben werden dürfen
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.encapsTagList = cite, div, p, pre, h1, h2, h3, h4, h5, h6

#Entfernt die zusätzlichen CSS-Klassen
lib.stdheader.3 = LOAD_REGISTER
lib.stdheader.3.headerClass =
lib.stdheader.3.headerClass.noTrimWrap = |
lib.stdheader.stdWrap.dataWrap = |

#Standard-Headings aufräumen
lib.stdheader.stdWrap.dataWrap =
lib.stdheader.10.1.fontTag = <h1>|</h1>
lib.stdheader.10.2.fontTag = <h2>|</h2>
lib.stdheader.10.3.fontTag = <h3>|</h3>
lib.stdheader.10.4.fontTag = <h4>|</h4>
lib.stdheader.10.5.fontTag = <h5>|</h5>

#Content Elemente aufräumen und Kommentare entfernen
tt_content.stdWrap.dataWrap >
tt_content.stdWrap.prefixComment >
tt_content.header.20.dataWrap >
tt_content.header.20.prefixComment >
tt_content.default.prefixComment >
tt_content.text.stdWrap.prefixComment >
tt_content.text.20.prefixComment >
tt_content.textpic.20.stdWrap.prefixComment >
tt_content.table.20.stdWrap.prefixComment >
tt_content.mailform.20.stdWrap.wrap >
tt_content.menu.20.stdWrap.prefixComment >
tt_content.image.20.stdWrap.prefixComment >
tt_content.list.20.stdWrap.prefixComment >
</pre>

== Navigation ==
=== GMenu mit Bildern aus den Seiteneigenschaften (Media-Feld) ===
Ein Schnipsel vom 12.3.2009 typo3 blogger
Nicht sehr oft benötigt, aber unter Umständen dennoch hilfreich: ein kleines Copy&Paste Tutorial zur Erstellung eines GMENUs mit Bildern aus dem “media”-Feld der Seiteneigenschaften. Zu beachten gibt es: der GIFBUILDER greift bei diesem Snippet das Bild nicht an, sodass es unverändert im Frontend ausgegeben wird. Dies hatte bei mir den Grund, dass die Website nur aus Bildern besteht und Photoshop nunmal bessere Ergebnisse als ImageMagick bzw. GraphicsMagick liefert - deshalb wollte ich auch nicht, dass er irgendwas an den Bildern verändert oder neu berechnet.
<pre>
temp.menu = HMENU
temp.menu {
1 = GMENU
1 {
wrap = <ul>|</ul>

noBlur = 0
NO = 1
NO {
wrap = <li>|</li>

altImgResource.import = uploads/media/
altImgResource.import.field = media
altImgResource.import.listNum = 0

ATagTitle.field = subtitle // title
}

RO = 1
RO < .NO
RO {
altImgResource.import.listNum = 1
}

ACT < .RO
}
}

lib.menu < temp.menu
</pre>
Welches Bild (falls mehrere vorhanden sind) TYPO3 nun für das Erzeugen des Menüs nimmt bestimmt folgende Zeile:

altImgResource.import.listNum = 0

Zu beachten gibt es dabei: wie in der Datentechnik üblich fängt man bei 0 zu zählen an, 0 ist dabei das erste Bild, 1 das zweite, 2 das dritte, usw.

=== GMENU und wrapItemAndSub Workaround mit TMENU===
Ebenfalls von Typo3Blogger

Freunde von semantisch korrektem HTML die auf ein grafisches, mehrstufiges Menü angewiesen sind, werden wissen wovon ich spreche. Man hat ein tolles GMENU gebastelt, welches wunderbare Grafiken liefert und fragt sich “warum ist mein HTML kaputt?”. Nach ein paar Sekunden googlen findet man die Antwort: GMENU fehlt die Eigenschaft “wrapItemAndSub”, mit welchem sich einfach verschachtelte Menüs realisieren lassen. Es gibt viele Ansätze dies zu umgehen, manche arbeiten mit IFSUB, manche verlassen sich auf Tidy. Vor Kurzem stand ich (wieder einmal) vor dem Problem und wollte es einmal anders lösen.

Dabei bin ich auf folgende Lösung gestoßen:
<pre>
temp.mainMenu = HMENU
temp.mainMenu {
1 = TMENU
1 {
wrap = <ul>|</ul>
NO = 1
NO {
wrapItemAndSub = <li>|</li>
doNotShowLink = 1

RO = 1
ATagTitle.field = title

beforeImg = GIFBUILDER
beforeImg {
XY=[20.w]+15,42
backColor = #1092AD

10 = TEXT
10 {
text {
field = title
align = center
}

fontFile = fileadmin/font.ttf
fontSize = 16
fontColor = #FFFFFF

offset = 0,34
}
}

beforeROImg < .beforeImg
beforeROImg.20.fontColor = #FFD20F
beforeImgLink = 1
}

ACT < .NO
ACT {
RO = 0
beforeImg.20.fontColor = #FF0000
wrapItemAndSub = <li class="act">|</li>
}
}

2 < .1
}

lib.mainMenu < temp.mainMenu
</pre>
Das tolle an dieser Lösung ist nicht nur, dass man wrapItemAndSub verwenden kann, nein auch alle anderen Eigenschaften und Zustände des TMENU stehen einem zur Verfügung!

Ich frage mich, warum wrapItemAndSub bis heute noch nicht in TYPO3 implementiert wurde. Vielleicht wäre es mit der aktuellen Veröffentlichung der TYPO3 4.3 Alpha 2 und der Aufforderung die Feature-Wunschliste zu füllen einmal Zeit diesem Punkt etwas Nachdruck zu verleihen. Falls ihr noch andere Lösungsansätze auf Lager oder bessere Ideen habt, bitte informiert uns in den Comments!

=== Klassisches List Menu ===
Dieses Menü kann als Grundbaustein für alle möglichen Menüs verwendet werden. Man kopiert sich das Menü in ein neues Objekt und modifiziert dort die Eigenschaften wie man sie braucht. Als Alternative gibt es noch das [[Menue als CSS formatierte Liste]] in dem ein fixer Startpunkt vorgegeben ist:

==== Accessible ====
benötigt cronaccessiblemenues

<pre>
temp.listMenu = HMENU

# Falls das Menü nicht bei der obersten Ebene anfangen soll
temp.listMenu.entryLevel = 1

# Bei Bedarf einzelne Seiten aus dem Menü ausschließen
#temp.listMenu.excludeUidList = 1,2,3

temp.listMenu.1 = TMENU
temp.listMenu.1 {
wrap = <ul>|</ul>
noBlur = 1
IProcFunc = user_cronaccessiblemenus->makeAccessible

//NO.after = xyz
# Access Keys einschalten
IProcFunc.accessKeys = 1

# Hierarchische Nummerierung der Menüpunkte einschalten
IProcFunc.dfn = 1
IProcFunc.accessKeyWrap = <span class="accessKey">|</span>
IProcFunc.appendWrap = <span class="invisible"> (ALT-|)</span>

# Die folgenden Accesskeys nicht verwenden (bereits belegt)

IProcFunc.forbiddenKeys = 0,D,B,A,F,X,m,p

# Einstellungen für nicht-aktive Seiten

NO {
wrapItemAndSub = |*| <li class="NO"> | <span class="invisible">.</span></li>|*|<li class="NO last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
# stdWrap.wrap = |abc
ATagTitle.field = abstract // description
}

# Einstellungen für Seiten, die sich in der Rootline befinden

ACT = 1
ACT {
wrapItemAndSub = |*| <li class="ACT"> | <span class="invisible">.</span></li> |*| <li class="ACT last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für die aktuelle Seite

CUR = 1
CUR {
wrapItemAndSub = |*| <li class="CUR"> | <span class="invisible">.</span></li> |*| <li class="CUR last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
doNotLinkIt = 0
}
}

# Gleiche Einstellungen für die nächsten Ebenen

temp.listMenu.2 = TMENU
temp.listMenu.2 < temp.listMenu.1

temp.listMenu.3 = TMENU
temp.listMenu.3 < temp.listMenu.2

temp.listMenu.4 = TMENU
temp.listMenu.4 < temp.listMenu.2

</pre>

==== Classic (not accessible) ====
<pre>
temp.listMenu = HMENU

# Falls das Menü nicht bei der obersten Ebene anfangen soll
temp.listMenu.entryLevel = 1

# Bei Bedarf einzelne Seiten aus dem Menü ausschließen
#temp.listMenu.excludeUidList = 1,2,3

temp.listMenu.1 = TMENU
temp.listMenu.1 {
wrap = <ul>|</ul>
noBlur = 1

# Einstellungen für nicht-aktive Seiten

NO {
wrapItemAndSub = |*| <li class="NO"> | </li>|*|<li class="NO last"> | </li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für Seiten, die sich in der Rootline befinden

ACT = 1
ACT {
wrapItemAndSub = |*| <li class="ACT"> | </li> |*| <li class="ACT last"> | </li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für die aktuelle Seite

CUR = 1
CUR {
wrapItemAndSub = |*| <li class="CUR"> | </li> |*| <li class="CUR last"> | </li>
stdWrap.htmlSpecialChars = 1
doNotLinkIt = 0
}
}

# Gleiche Einstellungen für die nächsten Ebenen

temp.listMenu.2 = TMENU
temp.listMenu.2 < temp.listMenu.1

temp.listMenu.3 = TMENU
temp.listMenu.3 < temp.listMenu.2

temp.listMenu.4 = TMENU
temp.listMenu.4 < temp.listMenu.2

</pre>

=== Multilanguage Menu ===
[[Typo3 - Multilanguage Menu]]
=== Bilder Menü ===
siehe: [[Typo3 - Bildermenü]]
=== Einfaches Menü mit 1 Ebene (CSS) ===
siehe: [[Menue als CSS formatierte Liste]]

=== Menü mit 2 Ebenen als verschachtelte Liste ===
Dieses Menü ist besonders für vertikale Navigationen geeignet

'''Constants'''
<pre>
# Einstieg Level 1
navi-L12-startID = 1
navi-L12-delimiter =   |  
navi-L12-delimiter =
</pre>

'''Setup'''
<pre>
### Top Navigation ###
temp.navi-L12 = HMENU
temp.navi-L12 {
#stdWrap.case = lower
special = directory
# Seitenid für den Einstieg
special.value = {$navi-L12-startID}
# Ebene für den Einstieg (nicht vergessen wg. 2. Level)
entryLevel = 1
1 = TMENU
1{
noBlur = 1
wrap = <ul>|</ul>
NO = 1
NO.linkWrap = |*| <li>|{$navi-L12-delimiter}</li> |*| <li>|</li>
ACT = 1
ACT.linkWrap = |*| <li class="on">|{$navi-L12-delimiter}</li> |*| <li class="on">|</li>
ACTIFSUB = 1
#Wenn Unterpunkte dann li aufmachen
ACTIFSUB.linkWrap = <li class="on">|
}
2 = TMENU
2{
noBlur = 1
NO = 1
#Unterpunkt also neue ul und danach li zu (von L1 geöffnet)
wrap = <ul>|</ul></li>
NO.linkWrap = |*| <li>|{$navi-L12-delimiter}</li> |*| <li>|</li>
ACT = 1
ACT.linkWrap = |*| <li class="on">|{$navi-L12-delimiter}</li> |*| <li class="on">|</li>

#ACTIFSUB = 1
#ACTIFSUB.linkWrap = <li class="on">|</li>
}
}
</pre>
=== Menü mit 2 Ebenen als separate Listen ===
Dieses Menü ist besonders für horizontale Navigationen geeignet.

Da die 2. Ebene relativ angegeben wird muß man bei mehreren Navigationsbäumen aufpassen, daß evt. ein Untermenü einer anderen Navigation (anderer Baum) ebenfalls angezeigt wird. Das läßt sich z.B. umgehen in dem man das Navitemplate erst im Unterbaum setzt oder indem man im Hauptbaum eine Bedingung setzt ([PIDinRootline = 123])

Ebene 1 ist im Prinzip eine einfache Liste:
'''Constants'''
<pre>
# Navi nur Level1
#Startpunkt
navi_startID = 1

#Trennzeichen für horizontale Navi:
naviL1-delimiter =   |  
</pre>
'''Setup'''
<pre>
### Top Navigation ###
temp.naviL1 = HMENU
temp.naviL1 {
#stdWrap.case = lower
special = directory
# Seitenid für den Einstieg
special.value = {$navi_startID}
1 = TMENU
1.noBlur = 1
1.wrap = <ul>|</ul>
1.NO = 1
1.NO.linkWrap = |*| <li>|{$naviL1-delimiter}</li> |*| <li>|</li>
1.ACT = 1
1.ACT.linkWrap = |*| <li class="on">|{$naviL1-delimiter}</li> |*| <li class="on">|</li>
#1.ACTIFSUB = 1
#1.ACTIFSUB.linkWrap = <li class="on">|</li>
}

</pre>

Für Ebene 2 wird eine weitere Liste generiert wenn man sich in einem bestimmten Level befindet:
'''Constants'''
<pre>
# Navigation nur ab Level x als ul (Standard entry Level1=2.Level)

#Trennzeichen für horizontale Navi:
naviLx-delimiter =   |  
naviLx-entryLevel = 1
</pre>

'''Setup'''
<pre>
temp.naviLx = HMENU
temp.naviLx {
# Seitenbaumebene ab Level 1 darstellen (2. Ebene)
entryLevel = {$naviLx-entryLevel}
# Level 2
1 = TMENU
1{
noBlur = 1
wrap = <ul>|</ul>
NO = 1
# Für horizontale Navi mit delimiter bei vertikal einfach nichts setzen
NO.linkWrap = |*| <li>|{$naviLx-delimiter}</li> |*| <li>|</li>

ACT = 1
# Für vertikale Navi ohne delimiter...
#ACT.linkWrap = <li class="on">|</li>
# und horizontal mit delimiter
ACT.linkWrap = |*| <li class="on">|{$naviLx-delimiter}</li> |*| <li class="on">|</li>

#ACTIFSUB = 1
#ACTIFSUB.linkWrap = <li class="on">|
}
}
</pre>

=== Menü als CSS formatierte Liste (allgemein) ===
[[Menue als CSS formatierte Liste]]
=== CSS-Flyout Menü ===
[[Typo3 - CSS-Flyout Menü]]

=== Sauberes grafisches Menü ===
[[Typo3 - Grafisches Menü]]

== Extensions ==
=== Autoparser (automaketemplate und Templateswitcher (tx_rlmptmplselector) konfigurieren ===
Der Template - Switcher benötigt automaketemplate (oder man arbeitet direkt mit TS-Templates).
Am besten gleich beide in einem Basis Template konfigurieren:

<pre>
### SET UP TEMPLATE SELECTOR ###
plugin.tx_rlmptmplselector_pi1 {

// Define the paths leading to our HTML template files
templatePathMain = fileadmin/dinos/templates/main/
templatePathSub = fileadmin/dinos/templates/sub/

// Define the filenames used as the default HTML templates
defaultTemplateFileNameMain = main.html
defaultTemplateFileNameSub = sub01.html

// If there is a page having no template selected, use a template
// selected earlier in the rootline. If there is none, use the default
inheritMainTemplates = 1
inheritSubTemplates = 1
}

### Autoparser Konfigurieren (alle IDs als Marker) ###

plugin.tx_automaketemplate_pi1{
# content = FILE
# content.file = fileadmin/templates/main/main.html

content < plugin.tx_rlmptmplselector_pi1
elements {
BODY.all = 1
BODY.all.subpartMarker = DOCUMENT_BODY
HEAD.all = 1
HEAD.all.subpartMarker = DOCUMENT_HEADER
HEAD.all.rmTagSections = title
DIV.all = 1
TD.all = 1
}
relPathPrefix = fileadmin/dinos/templates/main/
}

</pre>

=== News - Modul ===
Hier gibt es fertige Konfigurationen:
[[News (tt_news)]]

=== eCards - sr_sendcard ===
<pre>
# The Fast Way:
# plugin.tx_srsendcard_pi1._CSS_DEFAULT_STYLE = @import url("fileadmin/dinos/templates/css/srsendcard.css");
# But better is this (more flexible lesser Overhead)

plugin.tx_srsendcard_pi1._CSS_DEFAULT_STYLE >

[PIDinRootline = 14]
page.includeCSS.file2 = fileadmin/dinos/templates/srsendcard/srsendcard.css
[global]

plugin.tx_srsendcard_pi1{

templateFile = fileadmin/dinos/templates/srsendcard/srsendcard.tmpl
locale_all = de_DE
oldYear = 2006
# Vorschauseite (wenn gewünscht)
# previewPID = your_page_id
enableHTMLMail = 1
siteEmail = info@start-reutlingen.de
siteName = Erben der Dinos
# musicDir = EXT:sr_sendcard/music
#cardMusicFiles = autumnleaves.mid, OverTheRainbow.mid, Pomp_and_Circumstance.mid
disableMusic = 1
maxCol = 2
imageSmallWidth = 150
imageSmallHeight = 150
imageBigWidth = 300
imageBigHeight = 300
#logo
#logoAlignHor = right
#logoAlignVert = bottom
#useAlternateImageOnPrint
### For use with other pids use this one too
#createPID
#formPID
#previewPID
#useCAPTCHA = 0
#viewPID
#printPID
### Erscheinungsbild ###
cardStamp = fileadmin/dinos/templates/srsendcard/stamp.gif
#date_stdWrap
disableSendDate = 1
cardBgcolors = #FFFFFF,#A00A1C,#FF993F
cardFontcolors = #000000, #FFFFFF,#A00A1C
#disableFontcolors
#disableFontfaces
#disableCardOptions
#graphicMess
#graphicMessWidth
#graphicMessFontFiles
#graphicMessFontSizes
#fontDir
#doNotShowCardCaptions
cardPresentationOrder = manual
salutation = informal
#disableBgcolors = 1
}
</pre>

=== Zufallsbild tx_ccrandomimage ===

'''TypoScript - Setup'''
<pre>
### zufallsbild erzeugen ###
includeLibs.tx_ccrandomimage = EXT:cc_random_image/pi1/class.tx_ccrandomimage_pi1.php

// USER_INT means 'no caching'
temp.randomImage = USER_INT
temp.randomImage{
userFunc = tx_ccrandomimage_pi1->main
path = fileadmin/randomImage/
fileExt = jpg,jpeg,gif,png
#Das Render Objekt ist ein content object array (COA) mit einem Bild
#Vor dem Rendern werden die ###FILE_x### marker mit den Bildern aus path ersetzt
renderObj = COA
renderObj {
10 = IMAGE
10.file = ###FILE_1###
// ... weitere Bilder wenn benötigt
}
}

</pre>

=== hCard - Microformat ===
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:

1.
t3lib_extMgm::addToInsertRecords('fe_users');

Dazu jetzt noch das TypoScript:

1.
temp.hcard = COA
2.
temp.hcard {
3.
wrap =
4.
<div id="hcard" class="vcard">|</div>
5.

6.
10 = IMAGE
7.
10.file {
8.
import = uploads/pics/
9.
import.field = image
10.
width = 40
11.
params = class="photo"
12.
}
13.
20 = TEXT
14.
20.field = name
15.
20.typolink.parameter.field = url
16.
20.typolink.ATagParams = class="url fn"
17.
30 = TEXT
18.
30.field = company
19.
30.wrap =
20.
<div class="org">|</div>
21.

22.
40 = TEXT
23.
40.field = email
24.
40.typolink.parameter.field = email
25.
40.typolink.ATagParams = class="email"
26.
50 = COA
27.
50 {
28.
wrap =
29.
<div class="adr">|</div>
30.

31.
10 = TEXT
32.
10.field = address
33.
10.wrap =
34.
<div class="street-address">|</div>
35.

36.
20 = TEXT
37.
20.field = city
38.
20.wrap = <span class="locality">|</span>
39.
30 = TEXT
40.
30.field = zip
41.
30.wrap = <span class="postal-code">|</span>
42.
40 = TEXT
43.
40.field = country
44.
40.wrap = <span class="country-name">|</span>
45.
}
46.
60 = TEXT
47.
60.field = telephone
48.
60.wrap =
49.
<div class="tel">|</div>
50.

51.
}
52.

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

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:

1.

2.
<div id="hcard" class="vcard">
3.
<img style="float:left; margin-right:4px" src="http://typo3weblog.de/frank.png" alt="photo of " class="photo"/>
4.
<a class="url fn" href="http://typo3weblog.de">Frank Nägler</a>
5.
<div class="org">TYPO3Weblog.de</div>
6.

7.
<a class="email" href="mailto:frank.naegler@e-netconsulting.rl">frank.naegler@e-netconsulting.rl</a>
8.
<div class="adr">
9.
<div class="street-address">Sievekingsallee 150b</div>
10.

11.
<span class="locality">Hamburg</span>
12.
<span class="postal-code">22111</span>
13.
<span class="country-name">Deutschland</span>
14.
</div>
15.
<div class="tel">+49 (0)7000 623 45 37</div>
16.
</div>
17.

Cool oder?

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

Aus Typo3 Adventskalender2008

===Extension: Direct Shortcuts (sms_directshortcuts)===

http://typo3.org/extensions/repository/view/sms_directshortcuts/current/
TYPO3 generiert, wie jeder weiss, bei internen Verweisen immer eine extra Seite, die selbst wiederum einen redirect macht. Dieses vorgehen hat einerseits den Vorteil, dass man Skripte dazwischen schieben kann um z.B. Klicks zu tracken, anderseits den Nachteil, dass eine “falsche” URL im Menü zu finden ist. Dieser Nachteil macht sich bemerkbar wenn man sich mit der Suchmaschinenoptimierung von TYPO3 Seiten beschäftigt.

== Nützliche TS-Templates ==
=== Externes JavaScript einbinden ===
==== JavaScript im Header ====
Beispiel:

temp.addHeaderData=COA
[browser = msie]
temp.addHeaderData{
90 = TEXT
90.value (
<script src="fileadmin/templates/scripts/ielt7.js" type="text/javascript"></script>
)
90.wrap = 
#90.stdWrap.char = 10

}
[global]

Hier wird für IE kleiner als Version 7 ein JavaScript File eingebunden.

==== JavaScript als Marker ====
Als Temporäres Objekt, kann natürlich auch Javascript in einen Marker eingebunden werden.
==== JavaScript über Record ====
Eine Möglichkeit die das leichte ändern der Skripte zuläßt wäre folgende.
Man legt irgendwo auf einer Seite ein HTML - Element an hinterlegt das Skript und verweist mit TypoScript auf diesen RECORD. Bzw. bindet ihn im Template ein.

ToDo Beispiel

=== xhtml optimierung ===
Einiges davon braucht man in Version 4+ nicht mehr...
<pre>
#######################################################
############ XHTML optimieren
#######################################################

#Default Javascripts in externes File auslagern
config.removeDefaultJS = 1
config.removeDefaultJS = external

#<?xml... ?> Prolog deaktivieren
config.xmlprologue = none

#<html lang="de" xml:lang="de"> auf de setzen
config.htmlTag_langKey = de

#CSS Datei in externes File auslagern
config.inlineStyle2TempFile = 1
config.disablePrefixComment = 1

#RTE Tuning
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.P.class >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.remapTag >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.DIV.class >

#Angabe von Tags, die nicht mit einem zusätzlichen wrap umgeben werden dürfen
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.encapsTagList = div, p, h1, h2, h3, h4, h5, h6

#Entfernt die zusätzlichen CSS-Klassen
lib.stdheader.3 = LOAD_REGISTER
lib.stdheader.3.headerClass =
lib.stdheader.3.headerClass.noTrimWrap = |
lib.stdheader.stdWrap.dataWrap = |

#Standard-Headings aufräumen
lib.stdheader.stdWrap.dataWrap =
lib.stdheader.10.1.fontTag = <h1>|</h1>
lib.stdheader.10.2.fontTag = <h2>|</h2>
lib.stdheader.10.3.fontTag = <h3>|</h3>
lib.stdheader.10.4.fontTag = <h4>|</h4>
lib.stdheader.10.5.fontTag = <h5>|</h5>

#Content Elemente aufräumen und Kommentare entfernen
#tt_content.stdWrap.dataWrap >
tt_content.stdWrap.prefixComment >
#tt_content.header.20.dataWrap >
tt_content.header.20.prefixComment >
tt_content.default.prefixComment >
tt_content.text.stdWrap.prefixComment >
tt_content.text.20.prefixComment >
tt_content.textpic.20.stdWrap.prefixComment >
tt_content.table.20.stdWrap.prefixComment >
tt_content.mailform.20.stdWrap.wrap >
tt_content.menu.20.stdWrap.prefixComment >
tt_content.image.20.stdWrap.prefixComment >
tt_content.list.20.stdWrap.prefixComment >

#Cleargif entfernen
tt_content.image.20.spaceBelowAbove = 0
tt_content.header.stdWrap.space = 0|0
tt_content.stdWrap.space = 0|0
tt_content.stdWrap.spaceBefore = 0
tt_content.stdWrap.spaceAfter = 0
lib.stdheader.stdWrap.space = 0|0

#Auch hinter den Headlines
tt_content.text.20.parseFunc.tags.typohead.stdWrap.space = 0|0

# Sicherstellen, dass nonTypoTagStdWrap nur im Inhalt außerhalb von
#<typolist> und <typohead> arbeitet:
tt_content.text.20.parseFunc.tags.typolist.breakoutTypoTagContent = 1
tt_content.text.20.parseFunc.tags.typohead.breakoutTypoTagContent = 1

# ... und kein <BR> vor dem typohead.
tt_content.text.20.parseFunc.tags.typohead.stdWrap.wrap >
# Einstellen von nonTypoTagStdWrap, dass der Text mit P-Tags umschlossen wird.
tt_content.text.20.parseFunc.nonTypoTagStdWrap >
tt_content.text.20.parseFunc.nonTypoTagStdWrap.encapsLines {
encapsTagList = div, p
remapTag.DIV = P
wrapNonWrappedLines = |
innerStdWrap_all.ifEmpty =
innerStdWrap_all.textStyle < tt_content.text.20.textStyle
}

# Schließlich noch Entfernen der alten textstyle-Formatierung des gesamten Haupttextes.
tt_content.text.20.textStyle >

# ... und der <BR>-Tag nach dem Inhalt wird auch nicht mehr gebraucht...
tt_content.text.20.wrap >

# clear.gif entfernen
tt_content.image.20.spaceBelowAbove = 0
tt_content.header.stdWrap.space = 0|0
tt_content.stdWrap.space = 0|0
tt_content.stdWrap.spaceBefore = 0
tt_content.stdWrap.spaceAfter = 0
lib.stdheader.stdWrap.space = 0|0

# clear.gif hinter den Überschriften entfernen
tt_content.text.20.parseFunc.tags.typohead.stdWrap.space = 0|0

#Attribute für p- und pre-tags entfernen
tt_content.text.20.parseFunc.nonTypoTagStdWrap.encapsLines.addAttributes {
P.style=
PRE.style=
}

# Unterdrückt den Umbruch < br >
lib.stdheader.10.stdWrap.wrap = |
tt_content.textpic.20.spaceBelowAbove = 0
tt_content.image.20.spaceBelowAbove = 0
tt_content.textpic.20.noStretchAndMarginCells = 1
tt_content.image.20.noStretchAndMarginCells = 1

# Setup Anker-Tags entfernen
tt_content.noANameTagForFirstRecord = 1
</pre>

=== Inhalte von Backend-Feldern ausgeben ===
Hinweise dazu findest du unter:

[[TypoScript - Daten auslesen]]

=== Ein Breadcrumb Menü (Rootline-Menü) ===
Constants
<pre>
<nowiki>
#[begin-level] | [end-level]
# Variante 1: Seite 1 | Seite 2 | Seite 3
rootlineDelimiter =  | 
# Variante 2: Seite 1 > Seite 2 > Seite 3
# delimiter =  > 
</pre>
Setup
<pre>
temp.rootline = HMENU
temp.rootline {
special = rootline

# zeige komplette rootline an
special.range = 2|-1

# Variation: zeige Link auf die übergeordnete Seite
#special.range = -2|-2

# Text vor dem Rootline Menü
wrap = Sie sind hier: |

special.targets.3 = page
1 = TMENU
1.target = _top
1.NO {
ATagBeforeWrap = 0
stdWrap.htmlSpecialChars = 1
linkWrap = |{$rootlineDelimiter}|*||*| |
}
}

[globalVar = GP:L = 1]
temp.rootline.wrap = You are here: |
[GLOBAL]

[globalVar = GP:L = 2]
temp.rootline.wrap = Vous êtes ici: |
[GLOBAL]
</nowiki>
</pre>

=== Ein CSS-Template mit Markern nutzen ===
Ein CSS File wird eingelesen, enthaltene Marker dynamisch ersetzt und die Styles im Headerbereich der Seite als Inline-Styles eingebunden.

'''Constants'''
<pre>
color1 = FFE292
color2 = F68D6F
color3 = FABD9E

backgroundImage = fileadmin/templates/main/images/navBack-grey.gif
</pre>

''' Setup '''
<pre>
# das Objekt zunächst als Bibliothek zur späteren Verwendung
lib.stylesheet.default = TEMPLATE
lib.stylesheet.default {
# template einlesen
template = FILE
template.file=fileadmin/templates/main/colors.css
# Platzhalter ersetzten
marks{
COLOR1 = TEXT
COLOR1.value = {$color1}
COLOR2 = TEXT
COLOR2.value = {$color2}
COLOR3 = TEXT
COLOR3.value = {$color3}

NAVBACK = TEXT
NAVBACK.value = {$backgroundImage}
}
}

# Stylesheet in Header eintragen
page.headerData{
90 = COA
90{
wrap = <style type="text/css"></style>
50 < lib.stylesheet.default
}
}
}

</pre>

=== Bild aus Media-Feld auslesen ===
<pre>
temp.mediaFieldImage=IMAGE
temp.mediaFieldImage.file {
import.data = levelmedia: 2,slide
import = uploads/media/
import.listNum = 0
#width = 270
#height= 300
}
</pre>

=== Bild aus Ressourcen Feld auslesen ===
Hinweis Seiteneigenschaften > Resourcen
<pre>
temp.mein Bild = IMG_RESSOURCE
temp.mein Bild{
file = hintergrund*.jpg
stdWrap.wrap = <div style="background-image: | ; padding: 5px;"> ein Kasten </div>
}
</pre>

Hinweis: Typo3 vergibt beim vervielfältigen automatisch eine Endung. Damit das Bild trotzdem immer gefunden wird, ein Sternchen setzen (Joker)

=== Bild automatisch mit Alt-Tag versehen ===
Dieses TypoScript füllt das Alt-Tag Feld mit Daten aus dem Bildnamen z.B. wird Unser_Urlaubsort.jpg zu Unser Urlaubsort

[[Bild automatisch mit Alt-Tag versehen]]

=== Logo mit Verlinkung auf die Homepage (1.2)===
'''Constants'''
<pre>
# Link für das Logo
# Zahl (Seiten-ID), URL (www.zielseite.de) oder Email-Adresse
logoLink = 1
logoFile = fileadmin/templates/images/logo.gif
</pre>

''' Setup '''
<pre>
# Fügt ein Logo mit Link ein

temp.logo = IMAGE
temp.logo {
#file = /fileadmin/dinos/templates/main/images/logo-rt.gif
file = {$logoFile}
stdWrap.typolink.parameter = {$logoLink}
}
</pre>

=== Copyright mit immer aktuellem Jahr ===
'''TypoScript Setup'''
<pre>
temp.copyright = COA
temp.copyright{
5= TEXT
5.value = © 
10 = TEXT
#HeUte Timestamp einlesen
10.data = date:U
10.data.strftime = %Y
}
</pre>

ein anderes Beispiel:
<pre>
subparts.footer{
10 = TEXT
10.data = date:Y
10.wrap = <p class="footer">© | Ich</p>
}
</pre>

=== Datum der letzten Änderung anzeigen ===
'''Constants'''
lastChangePrefix = Letzte Änderung: 
'''Setup'''
<pre>
temp.lastChange = COA
temp.lastChange.5 = TEXT
temp.lastChange.5.value={$lastChangePrefix}
temp.lastChange.10 = TEXT
temp.lastChange.10.register:SYS_LASTCHANGED
temp.lastChange.10.strftime = %d.%m.%Y
</pre>

==== Variante ====
<pre>
temp.lastChange = TEXT
temp.lastChange {
data = page:lastUpdated
if.isTrue.data = page:lastUpdated
date = d.m.Y
wrap = Letzte Änderung: |
wrap2 = |
data = register : SYS_LASTCHANGED
if >
}
</pre>
=== Seiten IDs im Seitenbaum anzeigen ===
UserTS
<pre>
options {
pageTree.showPageIdWithTitle = 1
}
</pre>

=== Client Daten des Benutzers ausgeben ===

temp.browserinfo = COA_INT
temp.browserinfo {
10 = TEXT
10.data = TSFE:clientInfo|SYSTEM
10.wrap = <p> | <br />

20 = TEXT
20.data = TSFE:clientInfo|BROWSER
20.wrap = | &nbsp;

30 = TEXT
30.data = TSFE:clientInfo|VERSION
30.wrap = | </p>
}

== Die Ausgabe von Inhalten verändern ==

=== Layout-Rahmen verändern===
[[Typo3 - Rahmen (Frames)]]

=== Rendering von Inhalten ===

=== Ausgeben von Informationen im head der Seite ===
Wie kann man Stylesheet angaben, Metatags, Skripte etc. im Header ausgeben
[[Typo3 - Tipps und Tricks]] (page.head Objekt)

=== Unnötige Ausgaben im Quelltext verhindern ===
[[TYPO3 - Unnötige Ausgaben im Quelltext verhindern]]

== TypoScript - Basiswissen ==
[[Links mit TypoSkript anlegen]]

== Suche ==

weitere Infos zu Indexed Search:

[[Typo3 - indexed search]]

== Mit HTML und CObj erzeugtes Login ==
Das Beispiel von Tim Lochmüller aus dem Adventskalender 2008, zeigt wie man mit dem Template Objekte größere HTML - Bausteine verwenden kann.

Login mit TS & cObj TEMPLATE
Georg Ringer in TYPO3, Templates, Tutorial, TypoScript

Nach der interessanten Vorstellung von cli-Scripten durch Frank in Türchen 15 zeigt das folgende Tutorial einen guten Weg, einen Login/Logout-Bereich mit TS & HTML zu verwirklichen, ohne dabei auf irgendeine Extension zurückgreifen zu müssen.

Folgendes HTML ist notwendig und wird beispielsweise in fileadmin/template/login.html abgelegt: http://pastebin.com/f4e963e25
Die beiden Subparts sind jeweils für den Login- & Logout-Bereich zuständig und werden mittels Condition umgeschalten.

Das TS ist sehr einfach aufgebaut

lib.login = TEMPLATE
lib.login {
template = FILE
template.file = fileadmin/template/login.html

workOnSubpart = TPL_LOGIN
marks {
URL = TEXT
URL.data = getIndpEnv:TYPO3_REQUEST_URL

PID = TEXT
PID.value = 10789

REGISTER = TEXT
REGISTER {
value = Mitglied werden
typolink {
parameter = 10786
additionalParams = &tx_srfeuserregister_pi1[cmd]=edit
useCacheHash = 1
ATagParams = class=”link link1″
}
}
PWD = TEXT
PWD {
value = Password vergessen?
typolink {
parameter = 10788
ATagParams = class=”link”
}
}
PROFILE = TEXT
PROFILE {
value = Mein Wanderprofil!
typolink {
parameter = 10790
ATagParams = class=”link”
}
}
}
}

[usergroup = *]
lib.login.workOnSubpart = TPL_LOGOUT

[global]

Die notwendigen Variablen sind:

* URL: Die aktuelle URL, auf die nach dem Login/Logout auch weitergeleitet wird
* PID: Id der Seite, die die Benutzer enthält

Nützlich sind weiters:

* REGISTER: Link zu einer Seite, auf der man sich neu registrieren kann
* PWD/PROFILE: Weitere Links zu Seiten nach Bedarf

Die vorgestellte Variante funktioniert out-of-the-box und muss für andere Algorithmen angepasst werden.

Das Tutorial soll dazu anregen, das TEMPLATE-Objekt öfters als nur 1x zu verwenden, denn gerade wenn es um das Inkludieren von etwas mehr HTML geht, ist dies der beste, schnellste und sauberste Weg.

== Benutzer ==
=== Autor-Feld bei neuen Seiten automatisch anlegen ===
TCAdefaults.pages.author = <Name des Redakteurs>
TCAdefaults.pages.author_email = <EMail-Adresse des Redakteurs>

Das funktioniert aber nur dann wenn eine Seite neu angelegt wird. Will man viele Seiten einem Redakteur zuordnen kann man das über eien MySQL abfrage machen:

UPDATE `pages` SET `author` = '<Name des Redakteurs>', `author_email` =
'<EMail-Adresse des Redakteurs>'
WHERE 1 AND `perms_userid` = <UserId des Redakteurs>

in perms_userid steht die ID des Besitzers der Seite, deshalb kann man diesen mit Hilfe des Whereclause ausfiltern.

=== Author Feld, Email-Feld und News Author automatisch anlegen ===
Als weitere Möglichkeit gibt es die Extension cron_setdefaultauthor die genau diese Aufgaben übernimmt. Sie arbeitet im Prinzip wie oben angeführt.

== Ändern von Extension Meldungen durch den Redakteur ==

Adventskalender 2008 von Tim Lochmüller
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:

1.
plugin.tx_myplugin_pi1.searchError = RECORDS
2.
plugin.tx_myplugin_pi1.searchError {
3.
tables = tt_content
4.
source = 123
5.
}

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

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

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.

Typo3 - Baukasten

2009-03-12T15:56:56Z

91.47.50.37: /* Navigation */

weitere Infos unter [[Typo3 - Tipps und Tricks]]

== Auf Daten zugreifen ==
Beispiele gibt es hier:

[[TypoScript - Daten auslesen]]

[[Typo3 - stdWrap]]

Die stdWrap Eigenschaft steht vielen Objekten zur Verfügung. Wenn Sie vorhanden ist ist Sie der Problemlöser für fast alle Probleme :-).

[[Typo3 - TSFE]]

[[Typo3 - Das Media Feld]]

== Standardeinstellungen ==
[[Typo3 - Standardeinstellungen]]

== Quellcode aufräumen - Sourcecode verbessern - valides XHTML ==
Der Core produziert seit 4.0 valides XHTML

weitere Hilfen wenn Extensions nicht valide arbeiten bieten:

Installation von Tidy auf dem SErver (aktivieren im Install-Tool)

HTML Cleaner http://typo3.org/extensions/repository/view/qcom_htmlcleaner/2.4.0/

Das Bordeigene HTML-Cleaning: config.xhtml_cleaning = all

Vorsicht bei den Cleanern wenn JavaScript im Spiel ist weil dieser z.T. zerstört werden kann.

=== Beispiel aus dem Forum zum Quelltext aufräumen ===
<pre>
#Einstellen des DocType auf XHTML Transitional
config.doctype = xhtml_trans
#XHTML Cleaning aktivieren
config.xhtml_cleaning = all
#Default Javascripts in externes File auslagern
config.removeDefaultJS = 1
config.removeDefaultJS = external
#<?xml... ?> Prolog deaktivieren
config.xmlprologue = none
#CSS Datei in externes File auslagern
config.inlineStyle2TempFile = 1
config.disablePrefixComment = 1

#RTE Tuning
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.P.class >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.remapTag >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.DIV.class >
#Angabe von Tags, die nicht mit einem zusätzlichen wrap umgeben werden dürfen
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.encapsTagList = cite, div, p, pre, h1, h2, h3, h4, h5, h6

#Entfernt die zusätzlichen CSS-Klassen
lib.stdheader.3 = LOAD_REGISTER
lib.stdheader.3.headerClass =
lib.stdheader.3.headerClass.noTrimWrap = |
lib.stdheader.stdWrap.dataWrap = |

#Standard-Headings aufräumen
lib.stdheader.stdWrap.dataWrap =
lib.stdheader.10.1.fontTag = <h1>|</h1>
lib.stdheader.10.2.fontTag = <h2>|</h2>
lib.stdheader.10.3.fontTag = <h3>|</h3>
lib.stdheader.10.4.fontTag = <h4>|</h4>
lib.stdheader.10.5.fontTag = <h5>|</h5>

#Content Elemente aufräumen und Kommentare entfernen
tt_content.stdWrap.dataWrap >
tt_content.stdWrap.prefixComment >
tt_content.header.20.dataWrap >
tt_content.header.20.prefixComment >
tt_content.default.prefixComment >
tt_content.text.stdWrap.prefixComment >
tt_content.text.20.prefixComment >
tt_content.textpic.20.stdWrap.prefixComment >
tt_content.table.20.stdWrap.prefixComment >
tt_content.mailform.20.stdWrap.wrap >
tt_content.menu.20.stdWrap.prefixComment >
tt_content.image.20.stdWrap.prefixComment >
tt_content.list.20.stdWrap.prefixComment >
</pre>

== Navigation ==
=== GMenu mit Bildern aus den Seiteneigenschaften (Media-Feld) ===
Ein Schnipsel vom 12.3.2009 typo3 blogger
Nicht sehr oft benötigt, aber unter Umständen dennoch hilfreich: ein kleines Copy&Paste Tutorial zur Erstellung eines GMENUs mit Bildern aus dem “media”-Feld der Seiteneigenschaften. Zu beachten gibt es: der GIFBUILDER greift bei diesem Snippet das Bild nicht an, sodass es unverändert im Frontend ausgegeben wird. Dies hatte bei mir den Grund, dass die Website nur aus Bildern besteht und Photoshop nunmal bessere Ergebnisse als ImageMagick bzw. GraphicsMagick liefert - deshalb wollte ich auch nicht, dass er irgendwas an den Bildern verändert oder neu berechnet.
<pre>
temp.menu = HMENU
temp.menu {
1 = GMENU
1 {
wrap = <ul>|</ul>

noBlur = 0
NO = 1
NO {
wrap = <li>|</li>

altImgResource.import = uploads/media/
altImgResource.import.field = media
altImgResource.import.listNum = 0

ATagTitle.field = subtitle // title
}

RO = 1
RO < .NO
RO {
altImgResource.import.listNum = 1
}

ACT < .RO
}
}

lib.menu < temp.menu
</pre>
Welches Bild (falls mehrere vorhanden sind) TYPO3 nun für das Erzeugen des Menüs nimmt bestimmt folgende Zeile:

altImgResource.import.listNum = 0

Zu beachten gibt es dabei: wie in der Datentechnik üblich fängt man bei 0 zu zählen an, 0 ist dabei das erste Bild, 1 das zweite, 2 das dritte, usw.

=== Klassisches List Menu ===
Dieses Menü kann als Grundbaustein für alle möglichen Menüs verwendet werden. Man kopiert sich das Menü in ein neues Objekt und modifiziert dort die Eigenschaften wie man sie braucht. Als Alternative gibt es noch das [[Menue als CSS formatierte Liste]] in dem ein fixer Startpunkt vorgegeben ist:

==== Accessible ====
benötigt cronaccessiblemenues

<pre>
temp.listMenu = HMENU

# Falls das Menü nicht bei der obersten Ebene anfangen soll
temp.listMenu.entryLevel = 1

# Bei Bedarf einzelne Seiten aus dem Menü ausschließen
#temp.listMenu.excludeUidList = 1,2,3

temp.listMenu.1 = TMENU
temp.listMenu.1 {
wrap = <ul>|</ul>
noBlur = 1
IProcFunc = user_cronaccessiblemenus->makeAccessible

//NO.after = xyz
# Access Keys einschalten
IProcFunc.accessKeys = 1

# Hierarchische Nummerierung der Menüpunkte einschalten
IProcFunc.dfn = 1
IProcFunc.accessKeyWrap = <span class="accessKey">|</span>
IProcFunc.appendWrap = <span class="invisible"> (ALT-|)</span>

# Die folgenden Accesskeys nicht verwenden (bereits belegt)

IProcFunc.forbiddenKeys = 0,D,B,A,F,X,m,p

# Einstellungen für nicht-aktive Seiten

NO {
wrapItemAndSub = |*| <li class="NO"> | <span class="invisible">.</span></li>|*|<li class="NO last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
# stdWrap.wrap = |abc
ATagTitle.field = abstract // description
}

# Einstellungen für Seiten, die sich in der Rootline befinden

ACT = 1
ACT {
wrapItemAndSub = |*| <li class="ACT"> | <span class="invisible">.</span></li> |*| <li class="ACT last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für die aktuelle Seite

CUR = 1
CUR {
wrapItemAndSub = |*| <li class="CUR"> | <span class="invisible">.</span></li> |*| <li class="CUR last"> | <span class="invisible">.</span></li>
stdWrap.htmlSpecialChars = 1
doNotLinkIt = 0
}
}

# Gleiche Einstellungen für die nächsten Ebenen

temp.listMenu.2 = TMENU
temp.listMenu.2 < temp.listMenu.1

temp.listMenu.3 = TMENU
temp.listMenu.3 < temp.listMenu.2

temp.listMenu.4 = TMENU
temp.listMenu.4 < temp.listMenu.2

</pre>

==== Classic (not accessible) ====
<pre>
temp.listMenu = HMENU

# Falls das Menü nicht bei der obersten Ebene anfangen soll
temp.listMenu.entryLevel = 1

# Bei Bedarf einzelne Seiten aus dem Menü ausschließen
#temp.listMenu.excludeUidList = 1,2,3

temp.listMenu.1 = TMENU
temp.listMenu.1 {
wrap = <ul>|</ul>
noBlur = 1

# Einstellungen für nicht-aktive Seiten

NO {
wrapItemAndSub = |*| <li class="NO"> | </li>|*|<li class="NO last"> | </li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für Seiten, die sich in der Rootline befinden

ACT = 1
ACT {
wrapItemAndSub = |*| <li class="ACT"> | </li> |*| <li class="ACT last"> | </li>
stdWrap.htmlSpecialChars = 1
ATagTitle.field = abstract // description
}

# Einstellungen für die aktuelle Seite

CUR = 1
CUR {
wrapItemAndSub = |*| <li class="CUR"> | </li> |*| <li class="CUR last"> | </li>
stdWrap.htmlSpecialChars = 1
doNotLinkIt = 0
}
}

# Gleiche Einstellungen für die nächsten Ebenen

temp.listMenu.2 = TMENU
temp.listMenu.2 < temp.listMenu.1

temp.listMenu.3 = TMENU
temp.listMenu.3 < temp.listMenu.2

temp.listMenu.4 = TMENU
temp.listMenu.4 < temp.listMenu.2

</pre>

=== Multilanguage Menu ===
[[Typo3 - Multilanguage Menu]]
=== Bilder Menü ===
siehe: [[Typo3 - Bildermenü]]
=== Einfaches Menü mit 1 Ebene (CSS) ===
siehe: [[Menue als CSS formatierte Liste]]

=== Menü mit 2 Ebenen als verschachtelte Liste ===
Dieses Menü ist besonders für vertikale Navigationen geeignet

'''Constants'''
<pre>
# Einstieg Level 1
navi-L12-startID = 1
navi-L12-delimiter =   |  
navi-L12-delimiter =
</pre>

'''Setup'''
<pre>
### Top Navigation ###
temp.navi-L12 = HMENU
temp.navi-L12 {
#stdWrap.case = lower
special = directory
# Seitenid für den Einstieg
special.value = {$navi-L12-startID}
# Ebene für den Einstieg (nicht vergessen wg. 2. Level)
entryLevel = 1
1 = TMENU
1{
noBlur = 1
wrap = <ul>|</ul>
NO = 1
NO.linkWrap = |*| <li>|{$navi-L12-delimiter}</li> |*| <li>|</li>
ACT = 1
ACT.linkWrap = |*| <li class="on">|{$navi-L12-delimiter}</li> |*| <li class="on">|</li>
ACTIFSUB = 1
#Wenn Unterpunkte dann li aufmachen
ACTIFSUB.linkWrap = <li class="on">|
}
2 = TMENU
2{
noBlur = 1
NO = 1
#Unterpunkt also neue ul und danach li zu (von L1 geöffnet)
wrap = <ul>|</ul></li>
NO.linkWrap = |*| <li>|{$navi-L12-delimiter}</li> |*| <li>|</li>
ACT = 1
ACT.linkWrap = |*| <li class="on">|{$navi-L12-delimiter}</li> |*| <li class="on">|</li>

#ACTIFSUB = 1
#ACTIFSUB.linkWrap = <li class="on">|</li>
}
}
</pre>
=== Menü mit 2 Ebenen als separate Listen ===
Dieses Menü ist besonders für horizontale Navigationen geeignet.

Da die 2. Ebene relativ angegeben wird muß man bei mehreren Navigationsbäumen aufpassen, daß evt. ein Untermenü einer anderen Navigation (anderer Baum) ebenfalls angezeigt wird. Das läßt sich z.B. umgehen in dem man das Navitemplate erst im Unterbaum setzt oder indem man im Hauptbaum eine Bedingung setzt ([PIDinRootline = 123])

Ebene 1 ist im Prinzip eine einfache Liste:
'''Constants'''
<pre>
# Navi nur Level1
#Startpunkt
navi_startID = 1

#Trennzeichen für horizontale Navi:
naviL1-delimiter =   |  
</pre>
'''Setup'''
<pre>
### Top Navigation ###
temp.naviL1 = HMENU
temp.naviL1 {
#stdWrap.case = lower
special = directory
# Seitenid für den Einstieg
special.value = {$navi_startID}
1 = TMENU
1.noBlur = 1
1.wrap = <ul>|</ul>
1.NO = 1
1.NO.linkWrap = |*| <li>|{$naviL1-delimiter}</li> |*| <li>|</li>
1.ACT = 1
1.ACT.linkWrap = |*| <li class="on">|{$naviL1-delimiter}</li> |*| <li class="on">|</li>
#1.ACTIFSUB = 1
#1.ACTIFSUB.linkWrap = <li class="on">|</li>
}

</pre>

Für Ebene 2 wird eine weitere Liste generiert wenn man sich in einem bestimmten Level befindet:
'''Constants'''
<pre>
# Navigation nur ab Level x als ul (Standard entry Level1=2.Level)

#Trennzeichen für horizontale Navi:
naviLx-delimiter =   |  
naviLx-entryLevel = 1
</pre>

'''Setup'''
<pre>
temp.naviLx = HMENU
temp.naviLx {
# Seitenbaumebene ab Level 1 darstellen (2. Ebene)
entryLevel = {$naviLx-entryLevel}
# Level 2
1 = TMENU
1{
noBlur = 1
wrap = <ul>|</ul>
NO = 1
# Für horizontale Navi mit delimiter bei vertikal einfach nichts setzen
NO.linkWrap = |*| <li>|{$naviLx-delimiter}</li> |*| <li>|</li>

ACT = 1
# Für vertikale Navi ohne delimiter...
#ACT.linkWrap = <li class="on">|</li>
# und horizontal mit delimiter
ACT.linkWrap = |*| <li class="on">|{$naviLx-delimiter}</li> |*| <li class="on">|</li>

#ACTIFSUB = 1
#ACTIFSUB.linkWrap = <li class="on">|
}
}
</pre>

=== Menü als CSS formatierte Liste (allgemein) ===
[[Menue als CSS formatierte Liste]]
=== CSS-Flyout Menü ===
[[Typo3 - CSS-Flyout Menü]]

=== Sauberes grafisches Menü ===
[[Typo3 - Grafisches Menü]]

== Extensions ==
=== Autoparser (automaketemplate und Templateswitcher (tx_rlmptmplselector) konfigurieren ===
Der Template - Switcher benötigt automaketemplate (oder man arbeitet direkt mit TS-Templates).
Am besten gleich beide in einem Basis Template konfigurieren:

<pre>
### SET UP TEMPLATE SELECTOR ###
plugin.tx_rlmptmplselector_pi1 {

// Define the paths leading to our HTML template files
templatePathMain = fileadmin/dinos/templates/main/
templatePathSub = fileadmin/dinos/templates/sub/

// Define the filenames used as the default HTML templates
defaultTemplateFileNameMain = main.html
defaultTemplateFileNameSub = sub01.html

// If there is a page having no template selected, use a template
// selected earlier in the rootline. If there is none, use the default
inheritMainTemplates = 1
inheritSubTemplates = 1
}

### Autoparser Konfigurieren (alle IDs als Marker) ###

plugin.tx_automaketemplate_pi1{
# content = FILE
# content.file = fileadmin/templates/main/main.html

content < plugin.tx_rlmptmplselector_pi1
elements {
BODY.all = 1
BODY.all.subpartMarker = DOCUMENT_BODY
HEAD.all = 1
HEAD.all.subpartMarker = DOCUMENT_HEADER
HEAD.all.rmTagSections = title
DIV.all = 1
TD.all = 1
}
relPathPrefix = fileadmin/dinos/templates/main/
}

</pre>

=== News - Modul ===
Hier gibt es fertige Konfigurationen:
[[News (tt_news)]]

=== eCards - sr_sendcard ===
<pre>
# The Fast Way:
# plugin.tx_srsendcard_pi1._CSS_DEFAULT_STYLE = @import url("fileadmin/dinos/templates/css/srsendcard.css");
# But better is this (more flexible lesser Overhead)

plugin.tx_srsendcard_pi1._CSS_DEFAULT_STYLE >

[PIDinRootline = 14]
page.includeCSS.file2 = fileadmin/dinos/templates/srsendcard/srsendcard.css
[global]

plugin.tx_srsendcard_pi1{

templateFile = fileadmin/dinos/templates/srsendcard/srsendcard.tmpl
locale_all = de_DE
oldYear = 2006
# Vorschauseite (wenn gewünscht)
# previewPID = your_page_id
enableHTMLMail = 1
siteEmail = info@start-reutlingen.de
siteName = Erben der Dinos
# musicDir = EXT:sr_sendcard/music
#cardMusicFiles = autumnleaves.mid, OverTheRainbow.mid, Pomp_and_Circumstance.mid
disableMusic = 1
maxCol = 2
imageSmallWidth = 150
imageSmallHeight = 150
imageBigWidth = 300
imageBigHeight = 300
#logo
#logoAlignHor = right
#logoAlignVert = bottom
#useAlternateImageOnPrint
### For use with other pids use this one too
#createPID
#formPID
#previewPID
#useCAPTCHA = 0
#viewPID
#printPID
### Erscheinungsbild ###
cardStamp = fileadmin/dinos/templates/srsendcard/stamp.gif
#date_stdWrap
disableSendDate = 1
cardBgcolors = #FFFFFF,#A00A1C,#FF993F
cardFontcolors = #000000, #FFFFFF,#A00A1C
#disableFontcolors
#disableFontfaces
#disableCardOptions
#graphicMess
#graphicMessWidth
#graphicMessFontFiles
#graphicMessFontSizes
#fontDir
#doNotShowCardCaptions
cardPresentationOrder = manual
salutation = informal
#disableBgcolors = 1
}
</pre>

=== Zufallsbild tx_ccrandomimage ===

'''TypoScript - Setup'''
<pre>
### zufallsbild erzeugen ###
includeLibs.tx_ccrandomimage = EXT:cc_random_image/pi1/class.tx_ccrandomimage_pi1.php

// USER_INT means 'no caching'
temp.randomImage = USER_INT
temp.randomImage{
userFunc = tx_ccrandomimage_pi1->main
path = fileadmin/randomImage/
fileExt = jpg,jpeg,gif,png
#Das Render Objekt ist ein content object array (COA) mit einem Bild
#Vor dem Rendern werden die ###FILE_x### marker mit den Bildern aus path ersetzt
renderObj = COA
renderObj {
10 = IMAGE
10.file = ###FILE_1###
// ... weitere Bilder wenn benötigt
}
}

</pre>

=== hCard - Microformat ===
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:

1.
t3lib_extMgm::addToInsertRecords('fe_users');

Dazu jetzt noch das TypoScript:

1.
temp.hcard = COA
2.
temp.hcard {
3.
wrap =
4.
<div id="hcard" class="vcard">|</div>
5.

6.
10 = IMAGE
7.
10.file {
8.
import = uploads/pics/
9.
import.field = image
10.
width = 40
11.
params = class="photo"
12.
}
13.
20 = TEXT
14.
20.field = name
15.
20.typolink.parameter.field = url
16.
20.typolink.ATagParams = class="url fn"
17.
30 = TEXT
18.
30.field = company
19.
30.wrap =
20.
<div class="org">|</div>
21.

22.
40 = TEXT
23.
40.field = email
24.
40.typolink.parameter.field = email
25.
40.typolink.ATagParams = class="email"
26.
50 = COA
27.
50 {
28.
wrap =
29.
<div class="adr">|</div>
30.

31.
10 = TEXT
32.
10.field = address
33.
10.wrap =
34.
<div class="street-address">|</div>
35.

36.
20 = TEXT
37.
20.field = city
38.
20.wrap = <span class="locality">|</span>
39.
30 = TEXT
40.
30.field = zip
41.
30.wrap = <span class="postal-code">|</span>
42.
40 = TEXT
43.
40.field = country
44.
40.wrap = <span class="country-name">|</span>
45.
}
46.
60 = TEXT
47.
60.field = telephone
48.
60.wrap =
49.
<div class="tel">|</div>
50.

51.
}
52.

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

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:

1.

2.
<div id="hcard" class="vcard">
3.
<img style="float:left; margin-right:4px" src="http://typo3weblog.de/frank.png" alt="photo of " class="photo"/>
4.
<a class="url fn" href="http://typo3weblog.de">Frank Nägler</a>
5.
<div class="org">TYPO3Weblog.de</div>
6.

7.
<a class="email" href="mailto:frank.naegler@e-netconsulting.rl">frank.naegler@e-netconsulting.rl</a>
8.
<div class="adr">
9.
<div class="street-address">Sievekingsallee 150b</div>
10.

11.
<span class="locality">Hamburg</span>
12.
<span class="postal-code">22111</span>
13.
<span class="country-name">Deutschland</span>
14.
</div>
15.
<div class="tel">+49 (0)7000 623 45 37</div>
16.
</div>
17.

Cool oder?

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

Aus Typo3 Adventskalender2008

===Extension: Direct Shortcuts (sms_directshortcuts)===

http://typo3.org/extensions/repository/view/sms_directshortcuts/current/
TYPO3 generiert, wie jeder weiss, bei internen Verweisen immer eine extra Seite, die selbst wiederum einen redirect macht. Dieses vorgehen hat einerseits den Vorteil, dass man Skripte dazwischen schieben kann um z.B. Klicks zu tracken, anderseits den Nachteil, dass eine “falsche” URL im Menü zu finden ist. Dieser Nachteil macht sich bemerkbar wenn man sich mit der Suchmaschinenoptimierung von TYPO3 Seiten beschäftigt.

== Nützliche TS-Templates ==
=== Externes JavaScript einbinden ===
==== JavaScript im Header ====
Beispiel:

temp.addHeaderData=COA
[browser = msie]
temp.addHeaderData{
90 = TEXT
90.value (
<script src="fileadmin/templates/scripts/ielt7.js" type="text/javascript"></script>
)
90.wrap = 
#90.stdWrap.char = 10

}
[global]

Hier wird für IE kleiner als Version 7 ein JavaScript File eingebunden.

==== JavaScript als Marker ====
Als Temporäres Objekt, kann natürlich auch Javascript in einen Marker eingebunden werden.
==== JavaScript über Record ====
Eine Möglichkeit die das leichte ändern der Skripte zuläßt wäre folgende.
Man legt irgendwo auf einer Seite ein HTML - Element an hinterlegt das Skript und verweist mit TypoScript auf diesen RECORD. Bzw. bindet ihn im Template ein.

ToDo Beispiel

=== xhtml optimierung ===
Einiges davon braucht man in Version 4+ nicht mehr...
<pre>
#######################################################
############ XHTML optimieren
#######################################################

#Default Javascripts in externes File auslagern
config.removeDefaultJS = 1
config.removeDefaultJS = external

#<?xml... ?> Prolog deaktivieren
config.xmlprologue = none

#<html lang="de" xml:lang="de"> auf de setzen
config.htmlTag_langKey = de

#CSS Datei in externes File auslagern
config.inlineStyle2TempFile = 1
config.disablePrefixComment = 1

#RTE Tuning
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.P.class >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.remapTag >
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.addAttributes.DIV.class >

#Angabe von Tags, die nicht mit einem zusätzlichen wrap umgeben werden dürfen
lib.parseFunc_RTE.nonTypoTagStdWrap.encapsLines.encapsTagList = div, p, h1, h2, h3, h4, h5, h6

#Entfernt die zusätzlichen CSS-Klassen
lib.stdheader.3 = LOAD_REGISTER
lib.stdheader.3.headerClass =
lib.stdheader.3.headerClass.noTrimWrap = |
lib.stdheader.stdWrap.dataWrap = |

#Standard-Headings aufräumen
lib.stdheader.stdWrap.dataWrap =
lib.stdheader.10.1.fontTag = <h1>|</h1>
lib.stdheader.10.2.fontTag = <h2>|</h2>
lib.stdheader.10.3.fontTag = <h3>|</h3>
lib.stdheader.10.4.fontTag = <h4>|</h4>
lib.stdheader.10.5.fontTag = <h5>|</h5>

#Content Elemente aufräumen und Kommentare entfernen
#tt_content.stdWrap.dataWrap >
tt_content.stdWrap.prefixComment >
#tt_content.header.20.dataWrap >
tt_content.header.20.prefixComment >
tt_content.default.prefixComment >
tt_content.text.stdWrap.prefixComment >
tt_content.text.20.prefixComment >
tt_content.textpic.20.stdWrap.prefixComment >
tt_content.table.20.stdWrap.prefixComment >
tt_content.mailform.20.stdWrap.wrap >
tt_content.menu.20.stdWrap.prefixComment >
tt_content.image.20.stdWrap.prefixComment >
tt_content.list.20.stdWrap.prefixComment >

#Cleargif entfernen
tt_content.image.20.spaceBelowAbove = 0
tt_content.header.stdWrap.space = 0|0
tt_content.stdWrap.space = 0|0
tt_content.stdWrap.spaceBefore = 0
tt_content.stdWrap.spaceAfter = 0
lib.stdheader.stdWrap.space = 0|0

#Auch hinter den Headlines
tt_content.text.20.parseFunc.tags.typohead.stdWrap.space = 0|0

# Sicherstellen, dass nonTypoTagStdWrap nur im Inhalt außerhalb von
#<typolist> und <typohead> arbeitet:
tt_content.text.20.parseFunc.tags.typolist.breakoutTypoTagContent = 1
tt_content.text.20.parseFunc.tags.typohead.breakoutTypoTagContent = 1

# ... und kein <BR> vor dem typohead.
tt_content.text.20.parseFunc.tags.typohead.stdWrap.wrap >
# Einstellen von nonTypoTagStdWrap, dass der Text mit P-Tags umschlossen wird.
tt_content.text.20.parseFunc.nonTypoTagStdWrap >
tt_content.text.20.parseFunc.nonTypoTagStdWrap.encapsLines {
encapsTagList = div, p
remapTag.DIV = P
wrapNonWrappedLines = |
innerStdWrap_all.ifEmpty =
innerStdWrap_all.textStyle < tt_content.text.20.textStyle
}

# Schließlich noch Entfernen der alten textstyle-Formatierung des gesamten Haupttextes.
tt_content.text.20.textStyle >

# ... und der <BR>-Tag nach dem Inhalt wird auch nicht mehr gebraucht...
tt_content.text.20.wrap >

# clear.gif entfernen
tt_content.image.20.spaceBelowAbove = 0
tt_content.header.stdWrap.space = 0|0
tt_content.stdWrap.space = 0|0
tt_content.stdWrap.spaceBefore = 0
tt_content.stdWrap.spaceAfter = 0
lib.stdheader.stdWrap.space = 0|0

# clear.gif hinter den Überschriften entfernen
tt_content.text.20.parseFunc.tags.typohead.stdWrap.space = 0|0

#Attribute für p- und pre-tags entfernen
tt_content.text.20.parseFunc.nonTypoTagStdWrap.encapsLines.addAttributes {
P.style=
PRE.style=
}

# Unterdrückt den Umbruch < br >
lib.stdheader.10.stdWrap.wrap = |
tt_content.textpic.20.spaceBelowAbove = 0
tt_content.image.20.spaceBelowAbove = 0
tt_content.textpic.20.noStretchAndMarginCells = 1
tt_content.image.20.noStretchAndMarginCells = 1

# Setup Anker-Tags entfernen
tt_content.noANameTagForFirstRecord = 1
</pre>

=== Inhalte von Backend-Feldern ausgeben ===
Hinweise dazu findest du unter:

[[TypoScript - Daten auslesen]]

=== Ein Breadcrumb Menü (Rootline-Menü) ===
Constants
<pre>
<nowiki>
#[begin-level] | [end-level]
# Variante 1: Seite 1 | Seite 2 | Seite 3
rootlineDelimiter =  | 
# Variante 2: Seite 1 > Seite 2 > Seite 3
# delimiter =  > 
</pre>
Setup
<pre>
temp.rootline = HMENU
temp.rootline {
special = rootline

# zeige komplette rootline an
special.range = 2|-1

# Variation: zeige Link auf die übergeordnete Seite
#special.range = -2|-2

# Text vor dem Rootline Menü
wrap = Sie sind hier: |

special.targets.3 = page
1 = TMENU
1.target = _top
1.NO {
ATagBeforeWrap = 0
stdWrap.htmlSpecialChars = 1
linkWrap = |{$rootlineDelimiter}|*||*| |
}
}

[globalVar = GP:L = 1]
temp.rootline.wrap = You are here: |
[GLOBAL]

[globalVar = GP:L = 2]
temp.rootline.wrap = Vous êtes ici: |
[GLOBAL]
</nowiki>
</pre>

=== Ein CSS-Template mit Markern nutzen ===
Ein CSS File wird eingelesen, enthaltene Marker dynamisch ersetzt und die Styles im Headerbereich der Seite als Inline-Styles eingebunden.

'''Constants'''
<pre>
color1 = FFE292
color2 = F68D6F
color3 = FABD9E

backgroundImage = fileadmin/templates/main/images/navBack-grey.gif
</pre>

''' Setup '''
<pre>
# das Objekt zunächst als Bibliothek zur späteren Verwendung
lib.stylesheet.default = TEMPLATE
lib.stylesheet.default {
# template einlesen
template = FILE
template.file=fileadmin/templates/main/colors.css
# Platzhalter ersetzten
marks{
COLOR1 = TEXT
COLOR1.value = {$color1}
COLOR2 = TEXT
COLOR2.value = {$color2}
COLOR3 = TEXT
COLOR3.value = {$color3}

NAVBACK = TEXT
NAVBACK.value = {$backgroundImage}
}
}

# Stylesheet in Header eintragen
page.headerData{
90 = COA
90{
wrap = <style type="text/css"></style>
50 < lib.stylesheet.default
}
}
}

</pre>

=== Bild aus Media-Feld auslesen ===
<pre>
temp.mediaFieldImage=IMAGE
temp.mediaFieldImage.file {
import.data = levelmedia: 2,slide
import = uploads/media/
import.listNum = 0
#width = 270
#height= 300
}
</pre>

=== Bild aus Ressourcen Feld auslesen ===
Hinweis Seiteneigenschaften > Resourcen
<pre>
temp.mein Bild = IMG_RESSOURCE
temp.mein Bild{
file = hintergrund*.jpg
stdWrap.wrap = <div style="background-image: | ; padding: 5px;"> ein Kasten </div>
}
</pre>

Hinweis: Typo3 vergibt beim vervielfältigen automatisch eine Endung. Damit das Bild trotzdem immer gefunden wird, ein Sternchen setzen (Joker)

=== Bild automatisch mit Alt-Tag versehen ===
Dieses TypoScript füllt das Alt-Tag Feld mit Daten aus dem Bildnamen z.B. wird Unser_Urlaubsort.jpg zu Unser Urlaubsort

[[Bild automatisch mit Alt-Tag versehen]]

=== Logo mit Verlinkung auf die Homepage (1.2)===
'''Constants'''
<pre>
# Link für das Logo
# Zahl (Seiten-ID), URL (www.zielseite.de) oder Email-Adresse
logoLink = 1
logoFile = fileadmin/templates/images/logo.gif
</pre>

''' Setup '''
<pre>
# Fügt ein Logo mit Link ein

temp.logo = IMAGE
temp.logo {
#file = /fileadmin/dinos/templates/main/images/logo-rt.gif
file = {$logoFile}
stdWrap.typolink.parameter = {$logoLink}
}
</pre>

=== Copyright mit immer aktuellem Jahr ===
'''TypoScript Setup'''
<pre>
temp.copyright = COA
temp.copyright{
5= TEXT
5.value = © 
10 = TEXT
#HeUte Timestamp einlesen
10.data = date:U
10.data.strftime = %Y
}
</pre>

ein anderes Beispiel:
<pre>
subparts.footer{
10 = TEXT
10.data = date:Y
10.wrap = <p class="footer">© | Ich</p>
}
</pre>

=== Datum der letzten Änderung anzeigen ===
'''Constants'''
lastChangePrefix = Letzte Änderung: 
'''Setup'''
<pre>
temp.lastChange = COA
temp.lastChange.5 = TEXT
temp.lastChange.5.value={$lastChangePrefix}
temp.lastChange.10 = TEXT
temp.lastChange.10.register:SYS_LASTCHANGED
temp.lastChange.10.strftime = %d.%m.%Y
</pre>

==== Variante ====
<pre>
temp.lastChange = TEXT
temp.lastChange {
data = page:lastUpdated
if.isTrue.data = page:lastUpdated
date = d.m.Y
wrap = Letzte Änderung: |
wrap2 = |
data = register : SYS_LASTCHANGED
if >
}
</pre>
=== Seiten IDs im Seitenbaum anzeigen ===
UserTS
<pre>
options {
pageTree.showPageIdWithTitle = 1
}
</pre>

=== Client Daten des Benutzers ausgeben ===

temp.browserinfo = COA_INT
temp.browserinfo {
10 = TEXT
10.data = TSFE:clientInfo|SYSTEM
10.wrap = <p> | <br />

20 = TEXT
20.data = TSFE:clientInfo|BROWSER
20.wrap = | &nbsp;

30 = TEXT
30.data = TSFE:clientInfo|VERSION
30.wrap = | </p>
}

== Die Ausgabe von Inhalten verändern ==

=== Layout-Rahmen verändern===
[[Typo3 - Rahmen (Frames)]]

=== Rendering von Inhalten ===

=== Ausgeben von Informationen im head der Seite ===
Wie kann man Stylesheet angaben, Metatags, Skripte etc. im Header ausgeben
[[Typo3 - Tipps und Tricks]] (page.head Objekt)

=== Unnötige Ausgaben im Quelltext verhindern ===
[[TYPO3 - Unnötige Ausgaben im Quelltext verhindern]]

== TypoScript - Basiswissen ==
[[Links mit TypoSkript anlegen]]

== Suche ==

weitere Infos zu Indexed Search:

[[Typo3 - indexed search]]

== Mit HTML und CObj erzeugtes Login ==
Das Beispiel von Tim Lochmüller aus dem Adventskalender 2008, zeigt wie man mit dem Template Objekte größere HTML - Bausteine verwenden kann.

Login mit TS & cObj TEMPLATE
Georg Ringer in TYPO3, Templates, Tutorial, TypoScript

Nach der interessanten Vorstellung von cli-Scripten durch Frank in Türchen 15 zeigt das folgende Tutorial einen guten Weg, einen Login/Logout-Bereich mit TS & HTML zu verwirklichen, ohne dabei auf irgendeine Extension zurückgreifen zu müssen.

Folgendes HTML ist notwendig und wird beispielsweise in fileadmin/template/login.html abgelegt: http://pastebin.com/f4e963e25
Die beiden Subparts sind jeweils für den Login- & Logout-Bereich zuständig und werden mittels Condition umgeschalten.

Das TS ist sehr einfach aufgebaut

lib.login = TEMPLATE
lib.login {
template = FILE
template.file = fileadmin/template/login.html

workOnSubpart = TPL_LOGIN
marks {
URL = TEXT
URL.data = getIndpEnv:TYPO3_REQUEST_URL

PID = TEXT
PID.value = 10789

REGISTER = TEXT
REGISTER {
value = Mitglied werden
typolink {
parameter = 10786
additionalParams = &tx_srfeuserregister_pi1[cmd]=edit
useCacheHash = 1
ATagParams = class=”link link1″
}
}
PWD = TEXT
PWD {
value = Password vergessen?
typolink {
parameter = 10788
ATagParams = class=”link”
}
}
PROFILE = TEXT
PROFILE {
value = Mein Wanderprofil!
typolink {
parameter = 10790
ATagParams = class=”link”
}
}
}
}

[usergroup = *]
lib.login.workOnSubpart = TPL_LOGOUT

[global]

Die notwendigen Variablen sind:

* URL: Die aktuelle URL, auf die nach dem Login/Logout auch weitergeleitet wird
* PID: Id der Seite, die die Benutzer enthält

Nützlich sind weiters:

* REGISTER: Link zu einer Seite, auf der man sich neu registrieren kann
* PWD/PROFILE: Weitere Links zu Seiten nach Bedarf

Die vorgestellte Variante funktioniert out-of-the-box und muss für andere Algorithmen angepasst werden.

Das Tutorial soll dazu anregen, das TEMPLATE-Objekt öfters als nur 1x zu verwenden, denn gerade wenn es um das Inkludieren von etwas mehr HTML geht, ist dies der beste, schnellste und sauberste Weg.

== Benutzer ==
=== Autor-Feld bei neuen Seiten automatisch anlegen ===
TCAdefaults.pages.author = <Name des Redakteurs>
TCAdefaults.pages.author_email = <EMail-Adresse des Redakteurs>

Das funktioniert aber nur dann wenn eine Seite neu angelegt wird. Will man viele Seiten einem Redakteur zuordnen kann man das über eien MySQL abfrage machen:

UPDATE `pages` SET `author` = '<Name des Redakteurs>', `author_email` =
'<EMail-Adresse des Redakteurs>'
WHERE 1 AND `perms_userid` = <UserId des Redakteurs>

in perms_userid steht die ID des Besitzers der Seite, deshalb kann man diesen mit Hilfe des Whereclause ausfiltern.

=== Author Feld, Email-Feld und News Author automatisch anlegen ===
Als weitere Möglichkeit gibt es die Extension cron_setdefaultauthor die genau diese Aufgaben übernimmt. Sie arbeitet im Prinzip wie oben angeführt.

== Ändern von Extension Meldungen durch den Redakteur ==

Adventskalender 2008 von Tim Lochmüller
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:

1.
plugin.tx_myplugin_pi1.searchError = RECORDS
2.
plugin.tx_myplugin_pi1.searchError {
3.
tables = tt_content
4.
source = 123
5.
}

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

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

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.