Typo3

Aus Doku-Wiki
Zur Navigation springenZur Suche springen

Inhaltsverzeichnis

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

  1. Hier werden eventuelle Fehler mit Verzeichnissen oder deren Rechten angezeigt.
  2. Weiter unten sieht man eine Grafik mit Schriftinhalt, sollte diese Schrift nicht mittig ausgerichet sein,
    muss folgender Wert [GFX][TTFdpi]= auf 96 angepasst werden.
  3. 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

Video Temlate Import

YouTube Video

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

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

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