Typo3
Inhaltsverzeichnis
- 1 Links
- 2 Dokus
- 3 Installation und KonfigurationSchritt für Schritt
- 4 Version-Updates
- 5 Arbeiten mit Typo3
- 6 Tipps und Tricks
- 7 Video Temlate Import
- 8 Links zu freien Typo3-Templates
- 9 HTML / CSS
- 10 Extensions (Erweiterungen)
Links
Typo3 Homepage
Typo3-Seite in deutsch
TSref in Deutsch online
Dokus
Installationsanleitungen für Typo 3
http://www.tim-bormann.de/index.php?section=157
http://www.website4all.de/support/typo3/typo3-install-tool.html
http://www.website4all.de/support/typo3/typo3-installieren.html
Installation von ImageMagick
http://www.website4all.de/support/typo3/imagemagick-installieren.html
Installation von HTMLDOC
http://www.website4all.de/support/typo3/htmldoc-installieren.html
XPDF installieren
http://www.website4all.de/support/typo3/xpdf-installieren.html
Catdoc installieren
http://www.website4all.de/support/typo3/catdoc-installation.html
Installation und KonfigurationSchritt für Schritt
Webserver und Datenbank installieren
aptitude install apache2 mysql-server
Das DB-Passwort gleich setzen
Typo3 installieren
Zuerst besorgt man sich die aktuellen Sourcen:
[Download]
# cd /[WEBROOT] # wget http://mesh.dl.sourceforge.net/sourceforge/typo3/dummy-4.1.5.tar.gz # wget http://mesh.dl.sourceforge.net/sourceforge/typo3/typo3_src-4.1.5.tar.gz
Diese werden im WebRoot ausgepackt:
# cd /[WEBROOT] # tar xzvf typo3_src-4.1.5.tar.gz # tar xzvf dummy-4.1.5.tar.gz # ls -al [WEBROOT] dummy-4.1.5 typo3_src-4.1.5
Danach die Dateien im Verzeichnis dummy-4.1.5 in das htdocs kopieren:
# cp -a [WEBROOT]/dummy-4.1.5/* [WEBROOT]/htdocs/
Im Dummy-Paket muss eventuell noch der Link zum Verzeichnis typo3_src-4.1.5 angepasst werden. Es sollte dann so aussehen:
# ls -al [WEBROOT]/dummy-4.1.5/ typo3_src -> ../typo3_src-4.1.5
Jetzt noch die Rechte:
Gruppe
# cd /[WEBROOT]/htdocs # chgrp -R www-data * # cd /[WEBROOT]/ # chgrp -R www-data typo3_src-4.1.5 # ls -al drwxr-xr-x 5 user www-data 4096 2007-12-14 15:09 typo3_src-4.1.5 # ls -al drwxr-xr-x 6 user www-data 4096 2008-01-06 08:26 htdocs
Schreibrechte
# cd /[WEBROOT]/htdocs/ # chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads # cd [WEBROOT]/typo3_src-4.1.5 # chmod -R g+w typo3/ext/
Somit sind die Vorarbeiten für die Installation von Typo3 beendet.
Um das Installationstool zu verwenden, muss noch folgende Datei anelegt werden:
cd /[WEBROOT]/htdocs/ touch typo3conf/ENABLE_INSTALL_TOOL
Zusatztools installieren
Aus den Sourcen
Folgende Links erklären die Installation:
Installation von ImageMagick
http://www.website4all.de/support/typo3/imagemagick-installieren.html
Installation von HTMLDOC
http://www.website4all.de/support/typo3/htmldoc-installieren.html
XPDF installieren
http://www.website4all.de/support/typo3/xpdf-installieren.html
Catdoc installieren
http://www.website4all.de/support/typo3/catdoc-installation.html
Unter Debian
# aptitude install graphicsmagick htmldoc xpdf catdoc php5 php5-mcrypt php5-curl php5-gd
Installationstool starten
MySQL Datenbankanlegen
Hier gibt es zwei Weg, die Datenbank anzulegen, entweder vor ausführen des Typo3 Installtools,
oder mithilfe des Typo3 Installtolls. Diese fragt nach dem Start die benötigten Daten zum anlegen der DB ab.
Benötigt wird hierbei ein Benutzer der die Datenbank anlegen darf mit dessen Passwort, sowie den DB-Server (Z.B loclahost).
Als erstes wird eine MySQL Datenbank angelegt.
Beispiel, kann den eigenen Bedürfnissen angepasst werden
Datenbank: typo3 Benutzer: typo3 Passwort: typo3
Installation im Browser starten
http://www.example.com/
Dann der Installation folgen.
1: Basic Configuration
- Hier werden eventuelle Fehler mit Verzeichnissen oder deren Rechten angezeigt.
- Weiter unten sieht man eine Grafik mit Schriftinhalt, sollte diese Schrift nicht mittig ausgerichet sein,
muss folgender Wert [GFX][TTFdpi]= auf 96 angepasst werden. - Hier wird auch der Site Name: angepasst. Z.B www.example.com oder MySite
5: All Configuration
Alle Werte können hier nicht erklärt werden, folgende lohnen sich anzupassen:
1) gdlib_2 = 1 2) forceCharset = utf-8 3) multiplyDBfieldSize = 2 // wird wegen utf-8 erweitert
Speichern
2: Database Analyser
Um die Ämderungen multiplyDBfieldSize in die Datenbank zu übernehmen, muss in dieser Sektion ein,
Abgleich der DB-Einstellungen und Vorgaben ausgeführt werden. Dies geschieht mit COMPARE.
Möglicherweise muß dieser Befehl mehrmals ausgeführt werden, bis alle Änderungen übernommen sind.
4: Image Processing
In dieser Sektion bietet Typo3 einige Tests an. Diese sollte man durchführen. Bei Fehlermeldunen sollten diese noch entsprechend den Angaben beseitigt werden.
10: About
Hier wird nun ein neues Passwort für die Konfiguration von Typo3 vergeben.
Diese Passwort wird für das Install-Tool benötigt.
Login in die Administration von Typo3
Benutzer: admin Passwort: password
Konfiguration von Typo3 im Adminbereich
Passwort ändern
Zuerst sollte man das Passwort vom Admin-Konto ändern.
Dies kann im Adminbereich unter
User-> Setup geändert werden.
Sprache ändern
1.) Um die Sprache anzupassn geht folgendermassen vor:
EXZ Manager -> Translation handling: German -> Update from repository -> Save selection
2.) Die Sprache im Benutzer ändern:
User -> Setup -> Language: German -> Save Configuration -> Update from repository
Jetz noch das Backend neu laden, dann stehen die Menüs in Deutsch zur Verfügung.
Reference Index der Datenbank erstellen
DB-Check/DB-Überprüfen -> Auswahl: Manage Reference Index -> Update now
Absichern der Installation
Datenbankbenutzer anpassen
Falls die Installation von Typo3 mit dem Root-Benutzer der MySql-DB durchgeführt wurde,
sollte man dies nachträglich ändern. Dazu legt man in der MySql Datenbank einen Benutzer
für die Typo3 DB mit allen rechten an. Diese Benutzer wird dann im Install-Tool noch angepasst.
Damit wird verhindert, dass der DB-Benutzer für Typo3 auch auf andere Datenbanken zugreifen kann.
Nun im Install-Tool die Sektion 1: Basic Configuration den Datenbankbenutzer und das Passwort ändern.
Installation beenden
Folgende Datei löschen:
rm /[WEBROOT]/htdocs/typo3conf/ENABLE_INSTALL_TOOL
Version-Updates
- Die aktuellen Sourcen werden mit wget von der Internetseite von typo3.org herunter laden.
- Den Link im [WEBROOT]/htdocs/typo3source auf die neue Sourec legen.
- Rechte anpassen
Gruppe # cd /[WEBROOT]/ # chgrp -R www-data typo3_src-4.1.5 # cd [WEBROOT]/typo3_src-4.1.5 # chmod -R g+w typo3/ext/
- Um das Installationstool zu verwenden, muss noch folgende Datei anelegt werden:
cd /[WEBROOT]/htdocs/ touch typo3conf/ENABLE_INSTALL_TOOL
- Im Backend auf Installation klicken und den UpdateWizard starten
- Im Konfigurations Wizard den Database Analyser aufrufen und compare aufrufen
- Folgende Datei wieder löschen:
rm /[WEBROOT]/htdocs/typo3conf/ENABLE_INSTALL_TOOL
Arbeiten mit Typo3
Links
Online Tutorial wird Sie mit den grundlegenden Arbeitsweisen von TYPO3 vertraut machen
OpenOffice Tutorial wird Sie mit den grundlegenden Arbeitsweisen von TYPO3 vertraut machen
PDF Tutorial wird Sie mit den grundlegenden Arbeitsweisen von TYPO3 vertraut machen
Demo Portal
TYPO3-Templates mit TemplaVoilà erstellen
Zen Wireframe Typo3 Template
Tipps und Tricks
Fehler beim Upload von Bildern
Wenn der Upload von bilder nicht geht, sollte die php.ini überprüft werden.
Debian Etch, Apache2, PHP5
# vi /etc/php5/apache2/php.ini ; File Uploads ; ;;;;;;;;;;;;;;;; file_uploads = On upload_tmp_dir = /tmp upload_max_filesize = 100M
post_max_size = 100M
Bearbeiten von Inhalten im Frontend
Es müssen an drei Stellen Anpassungen vorgenommen werden.
- Auswahl auf der Anmeldeseite Fontend/Backend
Dies wird in der Datei [WEBROOT]/typo3conf/localconf.php
$TYPO3_CONF_VARS['BE']['interfaces'] = 'frontend, backend';
- Im obersten Projekttemplate folgenden Eintrag hinzufügen
admPanel = 1
Für den Administrator reicht dieser Eintrag schon aus.
- Für normale Benutzer muss durch folgende TSconfig-Einträge in der Benutzergruppe, das Panel erst sichtbar gemacht werden
config.admPanel = 1 admPanel { enable.edit = 1 module.edit.forceNoPopup = 0 module.edit.forceDisplayFieldIcons = 1 module.edit.displayIcons = 1 module.edit.forceDisplayIcons = 1 hide = 1 }
Domain wechsel bei einem bestehenden Projekt
Wenn sich die Domain einer bestehenden Seite ändert müssen folgende Angaben geändert werden:
- Typo2 Install Tool
- Diese wird entweder im Backend aufgerufen oder über http://[URL]/typo3/install/
- Hier wird im Punkt 1: Basic Configuration unter Site name: der Domain-Name angegeben
- Wenn im TypoScript folgenden Anweisung gesetzt ist, muss diese entsprechend geänder werden
- baseURL = http://www.example.com/
Video Temlate Import
Links zu freien Typo3-Templates
rasi.ch Typo3 Template
Andreas Viklund XHTML/CSS Vorlagen
HTML / CSS
CSS
Extensions (Erweiterungen)
Index_Search (Erstellt Sucheindex und Suche-Formular)
Index Search ist in Typo3 schon im System enthalten und kann über den Erweiterungsmanager installiert werden.
Um das Formular und die Suchergebnisse sauber Darstellen zu können, sollte noch folgendes Plugin installiert werden:
ch_is_templates
Erweiterung ch_is_templates
Diese Erweiterung stellt ein gut konfiguriertes Template für Index_Search zur Verfügung
- Erklärung zu ch_is_templates:
Wer sich die Extension indexed_search installiert, steht vor einem Problem: Die Ausgabe der Suchergebnisse ist ein schöner, traditioneller Tabellenverhau, der sich schlecht zähmen läßt. Wer lieber auf Tabellen verzichtet und Absätze und Listen mit CSS formatiert, installiert sich zusätzlich ch_is_templates, eine Extension, die ein gut durchkommentiertes Template für Suchformular, erweiterte Suche und Suchergebnisse mitbringt. Das Template search.html aus typo3/typo3conf/ext/ch_is_templates in das gewünscht Templateverzeichnis, z.B. fileadmin/templates/, kopieren und anpassen. Im Setup des TYPO3-Templates der Suchseite wird der Pfad zu search.html so eingetragen:
plugin.tx_indexedsearch.templateFile = fileadmin/templates/search.html
- Einzige Voraussetzung: TYPO3 3.8 und indexed_search mindestens ab 2.1.3
Counter (cs_counter)
Index_Search (Erstellt Sucheindex und Suche-Formular)
Index Search ist in Typo3 schon im System enthalten und kann über den Erweiterungsmanager installiert werden.
Um das Formular und die Suchergebnisse sauber Darstellen zu können, sollte noch folgendes Plugin installiert werden:
ch_is_templates
Counter W3C-Validate konform anpassen
Um die Ausgaben des Counters uber W3C ohne Fehler validieren zu können, muss dieser
im Quellcode angepasst werden.
vi ..typo3conf/ext/cs_counter/pi1/class.tx_cscounter_pi1.php
Am bestem sucht man nach dem Wort absmiddle. Hier findetr sich dan folgender Abschnitt:
01 # Build <img> tag 02 $temp .= "<img "; 03 $temp .= "src=\"" . t3lib_extMgm::siteRelPath("cs_counter") . "digits/$prefix$digit.gif\" "; 04 if (!empty($this->template['bitmapWidth'])) 05 $temp .= "width=\"" . $this->template['bitmapWidth'] . "\" "; 06 if (!empty($this->template['bitmapHeight'])) 07 $temp .= "height=\"" . $this->template['bitmapHeight'] . "\" "; 08 /* $temp .= "alt=\"$digit\" title=\"$digit\" align=\"absmiddle\""; */ 09 $temp .= "alt=\"$digit\" title=\"$digit\" align=\"absmiddle\""; 10 $temp .= ">";
Zu ändern sin die Zeilen 09 und 10 wie unten gezeigt:
09 $temp .= "alt=\"$digit\" title=\"$digit\" align=\"middle\""; 10 $temp .= " />";
Gästebuch (ve_guestbook)
Datumsausgabe im Gästebuch
Das Gästebuch zeigt bei mir den Tag des Eintrages auf Englisch an. Leider (vieleicht dich, sihe unten) habe ich keine WorkaRound gefunden, dies zu ändern.
Deshalb verändere ich die ausgabe des Datum mit TypoScript (TS), so dass kein Tag angezeigt wird
Dazu werden folgende Einträge im TS des PlugIns hinzugefügt:
# Gästebuch VE_GAESTBOOK plugin.tx_veguestbook_pi1 { templateFile = fileadmin/templates/guestbook_template.tmpl datetime_stdWrap.strftime= Eingetragen am: %d.%m.%Y um %H:%M Uhr date_stdWrap.strftime= %d.%m.%y time_stdWrap.strftime= %H:%M
Datumsangabe in PHP anpassen
- In PHP kann diese Einstellung Systemweit in der php.ini angepasst werden
- oder direkt im Script mit
<?php setlocale(LC_TIME, 'de_DE.iso885915@euro'); echo date("l dS of F Y h:i:s A"); ?>
- Testzeile um die Asgabe zu testen
<?php echo date("l dS of F Y h:i:s A"); ?>
RealURL
RealURL verwandelt die Typo3-Links (index.php?id=22) in statisch ausehende Links. Das hat den Vorteil,
dass Suchmaschinen den Content der Seite auch finden und es erhöht die Lesbarkeit für die Besucher.
TSconfig einträge
- Setup
In den Template-Einstellungen müssen folgende Einstellungen vorgenommen werden:
baseURL = http://www.example.com/ prefixLocalAnchors = all tx_realurl_enable = 1 simulateStaticDocuments = 0 disablePrefixComment = 1
- Erklärung
baseURL # Muss eingetragen werden, da RealURL die Domain sonst nicht kennt prefixLocalAnchors = all # Umsetzung von #-Zeichen (Anker) simulateStaticDocuments = 0 # Würde bei '1' die Angabe index.php?id=21 ind 21.html verwandeln
ReWrite verwenden
Für die Umsetztung der Links wird die ReWrite Engine des Webservers verwendet.
- Diese muss aktiviert sein: (Befehl für Apache-Webserver)
a2enmod rewrite
- Im Rootverzeichnis der Webs (htdocs) legt man die Datei .htaccess mit folgendem Inhalt an:
RewriteEngine On RewriteRule ^typo3$ - [L] RewriteRule ^typo3/.*$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-l RewriteRule .* index.php
Typo3 Anpassung in der localconf.php
Die Datei findet sich im Rootverzeichnis des Webservers:
[WebRoot]/typo3conf/localconf.php
- Dieser Code wird am Ende der localconf.php angefügt.
Dabei muss beachtet werden, dass in der Code vor das schließende Tag ?> eingefügt wird:
- Weiter muss der Code noch an ein einigen Stellen angepasst werden:
RootPage eintragen 'pagePath' => array( 'type' => 'user', 'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main', 'spaceCharacter' => '_', 'languageGetVar' => 'L', 'expireDays' => 7, ###### Die ID der RootPage muss anstelle der 2 eingetragen werden ''''rootpage_id' => 2,''' Die ID der RootPage erfährt man, wenn man im Backend mit der Maus auf die Root-Seite zeigt
Festlegen, wie der Pfad aussehen soll 'fileName' => array( 'defaultToHTMLsuffixOnPrev' => 1, Der Wert defaultToHTMLsuffixOnPrev bestimmt das Aussehen der Seitenpfade. 1 = www.example.com/startseite.html | 0 = www.example.com/startseite/
Wenn das Plugin tx_cronprintlink_pi1 verwendet wird, muss folgender Eintrag vorhanden sein 'fileName' => array( 'defaultToHTMLsuffixOnPrev' => 1, 'index' => array( 'print.html' => array( 'keyValues' => array( 'type' => '98', ), ), Bei Type wird die ID eingetragen, die im TypoScript Setup des Plugins unser "typeNum = 98" angegeben wurde
Shibboleth
Mit dieser Typo3 Erweiterung ist es möglich, Frontend- Nutzer mittels Shibboleth am Typo3 anzumelden. Bei der Anmeldung werden Attribute des Nutzers (username,email + optional Vor.- und Nachname) in die T3 Datenbank übernommen und bei jedem Login aktualisiert. Die so angelegten T3- FrontEnd- Nutzer werden einem Sysfolder (konfigurierbar) sowie einer Nutzergruppe (konfigurierbar) zugeordnet. In der T3 FrontEnd- Nutzerverwaltung können weitere Gruppenzuordnungen getroffen, sowie weitere Nutzerattribute (z.B. phone) ergänzt werden. Der Schutz von Inhalten erfolgt durch die Gruppenzugehörigkeit des Nutzers.
Shibboleth-Erweiterung Doku und Download