Typo3: Unterschied zwischen den Versionen

Aus Doku-Wiki
Zur Navigation springenZur Suche springen
Zeile 287: Zeile 287:
 
=====ReWrite verwenden=====
 
=====ReWrite verwenden=====
 
Für die Umsetztung der Links wird die ReWrite Engine des Webservers verwendet.
 
Für die Umsetztung der Links wird die ReWrite Engine des Webservers verwendet.
* Diese muss aktiviert sein:
+
* Diese muss aktiviert sein: (Befehl für Apache-Webserver)
 
  a2enmod rewrite
 
  a2enmod rewrite
 
* Im Rootverzeichnis der Webs (htdocs) legt man die Datei .htaccess mit folgendem Inhalt an:
 
* Im Rootverzeichnis der Webs (htdocs) legt man die Datei .htaccess mit folgendem Inhalt an:

Version vom 19. August 2008, 16:17 Uhr

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

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, wie weiter oben bei der Installation beschrieben
  • Im Backend auf Installation klicken und den UpdateWizard starten
  • Im Konfigurations Wizard den Database Analyser aufrufen und compare aufrufen

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

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
 }

Video Temlate Import

YouTube Video

Links zu freien Typo3-Templates

rasi.ch Typo3 Template
Andreas Viklund XHTML/CSS Vorlagen

HTML / CSS

CSS

css4you

YAML CSS Framework

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

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
  • Hier eine [Vorlage]
  • Folgender Code wird am Ende der localconf.php angefügt. Dabei muss beachtet werden,

dass das in der Datei vorhandenen schließende Tag ?> hinter den neuen Code kommt: // RealURL Beginn $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tstemplate.php']['linkData-PostProc']['tx_realurl'] = 'EXT:realurl/class.tx_realurl.php:&tx_realurl->encodeSpURL'; $TYPO3_CONF_VARS['SC_OPTIONS']['tslib/class.tslib_fe.php']['checkAlternativeIdMethods-PostProc']['tx_realurl'] = 'EXT:realurl/class.tx_realurl.php:&tx_realurl->decodeSpURL'; $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['clearPageCacheEval']['tx_realurl'] = 'EXT:realurl/class.tx_realurl.php:&tx_realurl->clearPageCacheMgm'; $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['clearAllCache_additionalTables' ['tx_realurl_urldecodecache'] = 'tx_realurl_urldecodecache'; $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['clearAllCache_additionalTables']['tx_realurl_urlencodecache'] = 'tx_realurl_urlencodecache'; $TYPO3_CONF_VARS['FE']['addRootLineFields'].= ',tx_realurl_pathsegment'; $TYPO3_CONF_VARS['EXTCONF']['realurl'] = array( '_DEFAULT' => array( 'init' => array( 'enableCHashCache' => 1, 'appendMissingSlash' => 'ifNotFile', 'enableUrlDecodeCache' => 1, 'enableUrlEncodeCache' => 1, ), 'redirects' => array(), 'preVars' => array( array( 'GETvar' => 'no_cache', 'valueMap' => array( 'nc' => 1, ), 'noMatch' => 'bypass', ), array( 'GETvar' => 'L', 'valueMap' => array( 'de' => '0', 'en' => '1', ), 'valueDescription' => array( 'de' => 'Deutsch', 'en' => 'English', ), 'noMatch' => 'bypass', ), ), 'pagePath' => array( 'type' => 'user', 'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main', 'spaceCharacter' => '_', 'languageGetVar' => 'L', 'expireDays' => 7, ###### include your rootpage id here 'rootpage_id' => 2, ), 'fixedPostVars' => array(), 'postVarSets' => array( '_DEFAULT' => array( // news archive parameters 'archive' => array( array( 'GETvar' => 'tx_ttnews[year]' , ), array( 'GETvar' => 'tx_ttnews[month]' , 'valueMap' => array( 'january' => '01', 'february' => '02', 'march' => '03', 'april' => '04', 'may' => '05', 'june' => '06', 'july' => '07', 'august' => '08', 'september' => '09', 'october' => '10', 'november' => '11', 'december' => '12', ) ), ), // news pagebrowser 'browse' => array( array( 'GETvar' => 'tx_ttnews[pointer]', ), ), // news categories 'select_category' => array ( array( 'GETvar' => 'tx_ttnews[cat]', ), ), // news articles and searchwords 'article' => array( array( 'GETvar' => 'tx_ttnews[tt_news]', 'lookUpTable' => array( 'table' => 'tt_news', 'id_field' => 'uid', 'alias_field' => 'title', 'addWhereClause' => ' AND NOT deleted', 'useUniqueCache' => 1, 'useUniqueCache_conf' => array( 'strtolower' => 1, 'spaceCharacter' => '-', ), ), ), array( 'GETvar' => 'tx_ttnews[swords]', ), ), ), ), // configure filenames for different pagetypes 'fileName' => array( 'defaultToHTMLsuffixOnPrev' => 1, 'index' => array( 'print.html' => array( 'keyValues' => array( 'type' => '98', ), ), 'rss.xml' => array( 'keyValues' => array( 'type' => 100, ), ), 'rss091.xml' => array( 'keyValues' => array( 'type' => 101, ), ), 'rdf.xml' => array( 'keyValues' => array( 'type' => 102, ), ), 'atom.xml' => array( 'keyValues' => array( 'type' => 103, ), ), ), ), ), ); // RealURL End ?>