[Workshop] Typo3-Workshop Teil I - Installation

[steffenk]

Mein Name ist Steffen Kamper und ich beschäftige mich mit Typo3 seit ca. 3 Monaten intensiv. Man kann sogar behaupten, das ich zu dem Kreis der Typo3-Süchtigen gehöre, da Typo3 eine Faszination erzeugt, die ihr alle sicher bald spüren werdet.
Ich habe nicht die Weisheit mit Löffeln gegessen und weiss längst nicht alles, daher nutze ich den Workshop auch für mich, um mein Wissen zu vertiefen und zu fundamentalisieren.
Ausserdem habe ich selber erfahren, das der Einstieg in Typo3 einem nicht so leicht gemacht wird, muss man doch viel recherchieren und sich mühsam informieren, und gerade am Anfang weiss man ja noch nichts und kann wichtige Informationen nicht von unwichtigen Informationen trennen.
Doch genug zu meiner Person - Auf zum Workshop


Ich begrüsse alle Teilnehmer dieses Workshops, im einzelnen
Nele, Stefan_G, Nicolas, Danis, fettmme, DSB, miraculix, lipsum, Schneeschaufel, SonKite, steff11, [jacky], heatseeker, flo.s, andywarhole, 321, Asd2003, schuminator, UweB, MichaP, mpenke, Minnemann, max.m

Es freut mich, das das Interesse doch so gross ist, das zeigt auch wieder, welchen Stellenwert Typo3 eingenommen hat: es ist eins der leistungsfähigsten CMS-Systeme im Open-Source-Bereich und kann auch vielen kommerziellen Systemen die Stirn bieten.

Etwas zum Ablauf des Workshops

Ich habe mir eine interaktive Form und einen Workshop mit Anmeldung gewünscht, daher sollten ein paar Regeln gelten.
Gerade am Anfang werde ich natürlich Erklärungen bringen, die teilweise über mehrere Threads gehen. Hier bitte ich mit den Antworten zu warten, bis ich sage:
"Diskussion eröffnet"
Dies hat den Vorteil, das der Erklärungsteil als Nachschlagwerk zusammenbleibt.

Auch werde ich den Workshop in mehrere Teile unterteilen, damit es nicht solche Monsterthreads gibt, gerade das nochmal nachschlagen wird sicher für Euch wichtig sein.

Interaktiv - darunter stell ich mir vor, das alle aktiv mitarbeiten und auch ihr (Un-)Verständnis preisgeben - so können wir sicherstellen, das alle das Maximum aus dem Workshop mitnehmen.
(nicht angemeldete) "Gasthörer" möchte ich bitten, in diesen Threads nicht zu posten, sondern dafür eigene Threads zu nutzen oder bei Fehlern mir eine PN zu schicken, um den Rahmen des Workshops nicht zu sprengen.

*** da der Workshop abgeschlossen ist, steht es jedem frei zu posten ***

Status der Teilnehmer - Installation
- Nele [ok]
- Stefan_G [ok]
- Nicolas [ok]
- Danis [ok]
- fettmme [ok]
- DSB [ok]
- miraculix
- lipsum [ok]
- Schneeschaufel [ok]
- SonKite [ok]
- steff11 [ok]
- [jacky]
- heatseeker
- flo.s [ok]
- andywarhole [ok]
- 321 [ok]
- Asd2003
- schuminator [ok]
- UweB [ok]
- MichaP
- mpenke
- Minnemann [ok]
- max.m [ok]

Genug der Vorreden, wenden wir uns Typo3 zu.

Typo3
Typo3 wurde einzig von einem Entwickler geschrieben, Kasper Skårhøj

Mittlerweile ist die Crew doch erheblich grösser geworden, hier findet ihr die Mitglieder.

Wenn ihr nach Informationen sucht, so ist die erste Anlaufstelle immer typo3.org.
Leider ist hier nur englische Sprache, und auch die Struktur der Seite bringt einen nicht immer sofort an die entscheidene Stelle, aber ich werde immer wieder Links einstreuen, die ihr am besten in eure Favoritensammlung aufnehmt.

Was ist Typo3 eigentlich ?
Typo3 ist ein CMS (Content Management System) - das heisst, die Inhalte liegen getrennt vom Design in der Datenbank vor und können von Redakteuren nach einem Rechteprinzip bearbeitet werden.

Ab wann lohnt sich der Einsatz von Typo3 ?
Viele denken sicherlich - der riesige Aufwand lohnt sich doch erst, wenn es viele Redakteure gibt.
Falsch. Der Aufwand, der sogar gering ist, hat man die Installation einmal kennengelernt, lohnt sich auch für kleinere Seiten. Die Zeit, die man damit verbringt, eine eigene Admin-Seite zu konstruieren, kann man auch für die Templateerstellung in Typo3 nutzen und kann auf die ganzen Funktionen und Vorteile von Typo3 zurückgreifen.

Ist Typo3 nicht viel zu kompliziert ? Ich hab soviele Horrorgeschichten über Typo3 gehört !
Ja, die habe ich auch gehört - allerdings muss ich das deutlich revidieren.
Sicherlich ist Typo3 ein mächtiges und komplexes System, das man mit Sicherheit nicht an einem Tag begreifen kann.
Die eigentliche Schwierigkeit steckt nur in der Erstellung des Templates für eine Seite. Die Pflege selber durch die Redakteure ist aber so leicht wie der Umgang mit einer normalen Textverarbeitung und ist auch von "Daus" zu bewältigen.
Zusätzlich gibt es (auch deutsche) Handbücher für Redakteure im PDF-Format.

Brauche ich Literatur ?
Das kann ich empfehlen. Wer sich länger mit Typo3 beschäftigt, der wird ein Buch zu schätzen wissen. Auch kann man ein Buch mal mitnehmen und lesen oder als Nachschlagwerk auf dem Schreibtisch liegen haben, es hat schon grosse Vorteile gegenüber elektronischen Medien.
Hier empfehle ich das Buch von Robert Meyer: "Praxiswissen Typo3"
Wer sich jetzt noch nicht in Unkosten stürzen will, dem empfehle ich die Kurzdokumentation von Robert Meyer, die ihr euch als PDF downloaden könnt.
Ich empfehle auch hier, sich das Dokument auszudrucken.


So, da einige schon mit den Hufen scharren, folgt gleich der Praxisteil - die Installation

[steffenk]

Vorraussetzungen schaffen
Damit Typo3 gut läuft, müssen wir einige Grundvorraussetzungen schaffen.
Typo3 selbst gibt folgende Systemvorraussetzungen vor: http://typo3.org/download/system-requirements/

Fangen wir mit PHP an. Hier benötigt Typo3 mindestens 16MB Speicher, es gilt natürlich, das mehr nicht schadet
Ausserdem muss der safe_mode ausgeschaltet sein. Das grösste Dilemma am safe_mode ist, das Applikationen keine Verzeichnisse erstellen können, und dies muss Typo3 unbedingt können.

Wir schauen uns also die php.ini an, die im apache/bin-Verzeichnis liegt und öffnen sie mit einem Editor (Notepad reicht völlig)

Wir ändern folgende Zeilen ab:

safe_mode = Off

;;;;;;;;;;;;;;;;;;;
; Resource Limits ;
;;;;;;;;;;;;;;;;;;;
max_execution_time = 360     ;5 Minuten, schadet nicht
max_input_time = 120        ; 2 Minuten
memory_limit = 32M      ; wir spendieren mal 32 MB

Dies speichern wir ab und starten Apache neu, damit die Änderungen wirksam werden.


Der zweite wichtige Punkt ist ein Grafiktool, das in Typo3 zur Anwendung kommt. Es wird zwar auch auf die leistungsfähige GD-Bibliothek zurückgegriffen, die in PHP vorhanden ist, aber das weitasu mächtigere Tool ist ImageMagick.
Ist ImageMagick nicht verfügbar, läuft Typo3 zwar, doch sind viele Grafikfunktionen nicht verfügbar.
Unter Windows ist die Einbindung ein Kinderspiel, da es sich um Kommandozeilen-Tools handelt. Wir müssen lediglich einen Ordner mit dem ImageMagick zur Verfügung stellen (z.B. im xampp-Ordner).
Ich habe das schon vorbereitet und man kann es sich hier herunterladen.
Unter Linux muss dieses Tool installiert werden, das ist oft ein Stolperstein bei Webspace-Angeboten, da es standardmässig oft nicht zur Verfügung steht.

Damit hätten wir alles vorbereitet und können uns endlich der Hauptaufgabe stellen, der Installation von Typo3

Unter Windows reicht ein Paket, das ich auch schon vorbereitet habe, ihr könnt es hier herunterladen.
Die Version ist die neueste (3.8.1) und ist das sogenannte "Dummy"-Paket, d.h. es ist eine blanke Typo3-Installation ohne Beispielseiten.

Dieses Paket kann man auch unter Linux einsetzen, gerade wenn ihr keinen Konsolenzugriff habt, bietet es sich an. Hier müssen zusätzlich noch einige Ordner schreibbar gemacht werden, was man mit einem FTP-Programm erledigen kann.

[steffenk]

Installation von Typo3
Download von dem Typo3-Paket und entpack es in einen beliebigen Ordner (in unserem Beispiel t3workshop) im Dokument-Root Deines Webservers (i.d.R. htdocs)
Öffne im Editor die Datei typo3/install/index.php und kommentier die Zeile aus, die mit die beginnt (# oder // an den Anfang), sichere sie und schliesse sie.



Nun können wir die Installation beginnen und wir öffnen unseren Browser. Als Browser eignen sich alle, der eingebaute Editor ist aber im Gecko nur begrenzt einsatzfähig, daher empfehle ich IE.
Wir rufen die Typo3-Seite auf mit http://localhost/t3workshop/
Es erschient folgendes Bild:
Wir geben den Benutzer und das Passwort für die Datenbank ein und bestätigen mit "Update localconf.php".
Wir landen im Step 2:
Wir wählen in der Select-Box die Datenbank aus und machen weiter mit "Update localconf.php".
Wir landen im Step 3:
Hier importieren wir die Basisdaten von Typo3, einfach nur auf "Import Database" drücken.
Wir landen im Step 4, dem letzten:
Eine freundliche Nachricht sagt uns: "You're done !" - also wirklich schon fertig ?

Nicht ganz, aber die Basis steht. Wir klicken auf "Go to the backend login" und loggen uns mit
admin / password ein. Es öffnet sich der folgende Screen:


Fein - wir sind drin
Nun wollen wir die Installation noch abschliessen. Hierzu gehen wir links unter Tools auf "Install", wo wir ins Install-Tool gelangen. Dieses steht uns immer zur Verfügung und wir können jederzeit Änderungen an der Konfiguration vornehmen.
Das wichtigste ist erstmal ein neues Passwort, wozu wir auch direkt aufgefordert werden:

Wir bestätigen und klicken anschliessend auf "Continue.."
Und siehe da - wir müssen unser neues Passwort eingeben. Nun landen wir im Motorraum von Typo3 mit 9 Menüpunkten:

Wir beginnen mit Punkt 1. Unter Windows werden die ersten Punkte alle grüne haken haben, da wir hier uns nicht um verzeichnisrechte kümmern müssen.
Wir scrollen weiter nach unten zum Punkt "FreeType Quick-test (as GIF)". Hier werden wir sehen, das die Schrift über den Bildrand geht, wir merken uns das für einen späteren Schritt (hier muss TTFdpi auf 96 eingestellt werden). Wenn die Schrift in die gelbe Box passt, ist alles korrekt.

Wir scrollen weiter nach unten zum Punkt "Check Image Magick".
Dort steht wahrscheinlich No ImageMagick install available
Wir haben aber das Verzeichnis ImageMagick auf der Festplatte, also geben wir den vollständigen Pfad ein (z.B. C:\xampp\ImageMagick\) und klicken auf "send".
Nun sollte an diesem Punkt ImageMagick angezeigt werden.
Wir gehen weiter nach unten und tragen uns einen Site name ein (statt Blank DUMMY) - ich habe hier TP Typo3-Workshop genommen.
Ausserdem lassen wir automatisch einen Encryption-Key generieren (Generate random Key)
Jetzt klicken wir auf "Update localconf.php".

[steffenk]

Wenn wir TTFdpi noch ändern wollen, gehen wir in Menüpunkt 4 und tragen unter [TTFdpi] 96 ein (letzter Punkt unter GFX)
Bei der Gelegenheit ändern wir noch 2 Punkte unter EXT, nämlich
[noEdit] das Häkchen entfernen (damit wir im BE auch Extensions editieren können)
und
[allowGlobalInstall] anhaken (das brauchen wir später für die tt_news)

danach ganz unten auf "Update localconf.php" klicken.

Wir haben das wesentlichste erledigt und können uns nun anschauen, wie Typo3 mit der Grafikbibliothek umgeht.
Dazu wählen wir Menüpunkt 3 und scrollen nach unten zum Testmenü:


Hier können wir uns alle Tests mal anschauen.

Geschafft, die Installation steht, in Kürze folgt noch etwas zur Einrichtung, bevor wir die Diskussion eröffnen

[steffenk]

Wir sichern unser System
Alle kennen es, das Standardpasswort für Typo3. Wir sollten es sofort ändern. Nur wo finde ich den Benutzer ?
Wenn wir im "Backend" sind, so haben wir üblicherweise 3 Spalten.
Ganz links ist unser Menü, wir klicken auf Liste.
Jetzt sehen wir im rechten Frame 2 Spalten. In der ersten sehen wir die Weltkugel, das ist unser Seitenbaum (Seiten haben wir noch keine).
Klicken wir auf die Weltkugel, so sehen wir die "globalen" Datensätze, im Moment sind das die Backend-Benutzer (wir haben nur einen, admin)
und sogenannte Static Templates (61 an der Zahl)
Wir aktivieren das Kästchen "extened view" und haben nun hinter allen Datensätzen kleine Icons zur Bearbeitung.

In der Zeile vom admin klicken wir nun auf das erste dieser Symbole, den Editierstift, es öffnet sich die Eingabemaske für den user admin:

Wir ändern flux das Passwort und speichern den user ab, nur wo ?
Dise Symbole sehen wir sowohl oben als auch unten auf der Seite:

Sie bedeuten, von links nach rechts:
Speichern / Speichern und Schliessen / Schliessen / löschen

Wir nehmen das 2. Icon für Speichern und Schliessen

[steffenk]

Das ist ja alles auf englisch, geht das nicht auf deutsch ?
Das ist unsere nächste Aufgabe. Mittlerweile gibt es soviele Sprachen für Typo3, das diese nicht mit ausgeliefert werden. Wir können sie als Extension herunterladen.
Somit lernen wir ein wirklich grossartiges Feature von Typo3 kennen - die Extensions.
Extensions sind Module, die auf einem zentralen Server gelagert sind und aus Typo3 herraus heruntergeladen und installiert werden können, wir brauchen also nicht uns irgendwo das Downloadpaket zu suchen, downzuloaden, entpacken etc.

Schauen wir uns den Extensionmanager mal an. Hierzu klicken wir links auf Tools > Ext Manager
Wir sehen, das wir ein recht nacktes System haben, in dem bislang nur der Editor als Extension integriert ist.
Ganz oben haben wir eine Select-Box als Menü, wir wählen den Punkt "Import extensions from online repository"
Unter look up geben wir den Namen der Extension ein: csh_de
Wir drücken auf "Connect to online repository" und bekommen die Extension angezeigt.

Wir klicken auf das Icon links der Extension und Typo3 lädt sie automatisch herunter und packt sie in unserem Typo3-Verzeichnis aus.
Auf der anschliessenden Seite klicken wir auf "Install Extension" und die Extension wird installiert.

Wir wollen nicht nur das Backend in Deutsch, sondern auch direkt für unsere Seite die entsprechende deutsche Übersetzung haben, daher wählen wir aus der obigen Selectbox
"Available extensions to install" aus.
Aha - es ist doch schon einiges im Paket dabei, nur noch nicht installiert
Wir wählen die Extension "TS Language, German" und klicken für die Installation auf das linke Icon mit dem +. Wir wählen das Kästchen mit "Try to set as default" an und klicken auf Update.

Aber es ist ja immer noch alles auf Englisch
Richtig, wir haben aber jetzt 2 Sprachen installiert und können jetzt umstellen.
Hierzu klicken wir links auf User > Setup, wählen aus der Selectbox deutsch aus und speichern ab.
Jetzt ist alles auf deutsch, da es ein Frame ist, müssen wir einmal F5 drücken, um alles auf deutsch zu haben.

Ab hier ist mein Einführungsmonolog beendet, schaut Euch alles an und berichtet, ob alles funktioniert, fragt, beteiligt Euch. Ich werde erst fortfahren, wenn ich von (fast) allen die Bestätigung habe, das ein funktionstüchtiges Typo3-System vorliegt.

Die Diskussion ist hiermit eröffnet

[Boris]

Sehr schön! Ich freu mich schon auf die nächsten Teile

[321]

moin Steffen

und schon folgt Frage 1

Ich habs mir beim Provider installiert und bekam
- Backend-user: xxxxx
- Backend-password: yyyyy
- Installation-password: zzzzz (kein Install-User!)
mitgeteilt.

Habe dann gerade mal von 3.6.2 auf 3.8.1 updated und bekam Hinweis,
dass die DB zu überprüfen wäre.
Ich bekomme dann ein Administration Login on Blank DUMMY

Womit logge ich mich hier ein?

und 2. Auf was gilt es bei der DB zuachten?

[schuminator]

fertig soweit.
Ich bin mir nicht sicher, ob ImageMagick richtig bei mir läuft.

Current configuration
ImageMagick enabled: 1
ImageMagick path: /usr/X11R6/bin/ ()
ImageMagick path/LZW: /usr/bin/ ()
Version 5 flag: 0

GDLib enabled: 1
GDLib using PNG: 0
GDLib 2 enabled: 0
IM5 effects enabled: 0 (Blurring/Sharpening with IM 5+)
Freetype DPI: 96 (Should be 96 for Freetype 2)
Mask invert: 0 (Should be set for some IM versions approx. 5.4+)

File Formats: gif,jpg,jpeg,tif,bmp,pcx,tga,png,pdf,ai

und das steht unter dem Testmenu:

Supported file formats
This verifies that your ImageMagick installation is able to read the nine default file formats; JPG, GIF, PNG, TIF, BMP, PCX, TGA, PDF, AI. The tool 'identify' will be used to read the pixeldimensions of non-web formats. The tool 'convert' is used to read the image and write a temporary JPG-file


Test skipped
Use of ImageMagick has been disabled in the configuration. Refer to section 'Basic Configuration' to change or review you configuration settings



Info:
Parsetime
1 ms



--------------------------------------------------------------------------------
OS detected: WIN
UNIX/CGI detected: NO
PATH_thisScript: C:/apachefriends/xampp/htdocs/t3workshop/typo3/install/index.php

Gruß
schuminator

[steffenk]

@321 - Einloggen musst Du Dich mit dem Backenduser und Backend password

Das Install-Passwort brauchst Du, wenn Du im Backend den Punkt Tools / Installation aufrufst.

Dort kannst Du die DB überprüfen - Das ist Punkt 2.
Du findest einen Link "Compare" - der gibt Dir die notwendigen Updates an und führt sie dann aus.

[steffenk]

@schuminator
Rufe nochmal das Install-Menü auf, im 1.Punkt "Basic Configuration"

Dort scrolle nach unten zum Punkt ImageMagick. Es sollte so aussehen:


Wenn nicht, gib den Pfad erneut an und klick auf send. Achte beim Pfad auf einen abschliessenden Backslash.

[schuminator]

so, ImageMagick läuft, der Backslash war der Fehler. Dadurch wurde es am Anfang der Install nicht übernommen.

[Schneeschaufel]

Schön.
Bis auf einen kurzen Murks mit dem/der ImageMagick hat´s reibungslos geklappt; jetzt sitzt´s.

[spl]

Supper. Bin gereade darüber gestoßen und werde dei nächsten Teile sehr gerne Verfolgen

[DSB]

Sehr schöne Anleitung bisher.
Melde gehorsamst die korrekte Durchführung bis zum Laden der Sprach-Extension.

Da bekomme ich Fehlermledungen. Der Hostname kann nicht aufgelöst werden, da ich hinter einem Proxy mit Authentisierung sitze.
In den Settings habe ich die Parameter curlProxyServer, curlProxyUserPass gefunden. Hier fehlt aber noch die Angabe des Proxyusers.
Weisst Du wo ich einen Proxy angeben kann, damit der Zugriff aufs Internet funtoiniert?