Contao Community Documentation - Benutzerbeiträge [de]

Datei:Contao Fanpage Web-small.png

2011-01-30T21:12:10Z

Marc:

Installation

2010-10-16T22:33:40Z

Marc: <br /> zwischen zwei Anmerkungen entfernt

{{stub}}
[[Category:Installation und Updates]]

=Installation von Contao=
==Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster==

# Download des Contao-Cores auf www.contao.org
# Entpacken auf dem Heimrechner
# Hochladen der Dateien mittles FTP auf Ihren Server
# Hochladen des [[Systemdiagnosetool]]s ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
# Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
# Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
# Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")

==Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster==

===Download von Contao und entpacken auf dem Heimrechner===

Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
{{Anmerkung| Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden. }}

Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.

===FTP-Programm einrichten===
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
{{Achtung|Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (wie .htaccess) abgeschaltet. Bei Contao ist es '''sehr wichtig''', diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit gegen ungewolltes Auslesen von Daten.
Häufig ist es möglich Parameter für den LIST-Befehl anzugeben, dann bitte '''-la''' angeben. Hierzu sollte die Doku des verwendeten FTP-Programms weiter helfen.}}

{|
|rowspan="6" | [[Datei:1u1_ftp2.jpg|FTP-Zugangsdaten eintragen]]
|valign="top" | Protokoll:
|valign="top" | Es soll eine FTP-Verbindung aufgebaut werden.
|-
|valign="top" | Server:
|valign="top" | Hier wird einfach die Hauptdomain eingetragen,<br />welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man meist den Standard-Port einer<br />FTP-Verbindung, den Port 21 ein.
|-
|valign="top" | Benutzername:
|valign="top" | Der Benutzername wurde vom Provider mitgeteilt.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das Basisverzeichnis für die Installation<br />angegeben werden.
|}

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.

===Upload Contao===
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.

[[Datei:1u1_zip1.jpg|Contao ZIP-Archiv]]

'''Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch.'''
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.

===Aufruf des Installtools===

Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).

Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").

Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}

Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}

Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
{|
|[[Datei:1u1_install1.jpg|Datenbankconnection]]
|valign="top" | <br />Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben
|}

Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.

Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein, so lässt man das Auswahlmenü leer.

Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)

Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
'''Gratulation, die Installation ist abgeschlossen.'''

=Webhoster=
==Liste kompatibler Webhoster==

Hetzner.de (ab dem entsprechenden "Tarif inkl. MySQL-Datenbank" voll kompatibel)

{| border="0" cellpadding="5" cellspacing="1" style="vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
!Information von
|-
|1&1 Internet || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || ja || [[1 und 1 Internet|detaillierte Installationsanleitung]] || do_while
|-
| 1Blu || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt || LousyWeather
|-style="vertical-align:top;"|
| Alfahosting.de || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || one-click-Installation von Contao. || marc und psren
|-
| Arcor || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam. || Stranger
|-
| bytecamp.net || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || PHP 5 Aktivierung in .htaccess: <pre>AddType application/x-httpd-php5 .php</pre> Vereinfache Installation und PHP5 vorkonfiguriert durch eigenen Installer. [http://www.bytecamp.net/de/hosting/details/installer.html 3 Schritte bequem per Webbrowser. ]|| Franziska & Frank
|-
|BPlaced.net (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} ||
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
|| thomask
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || (hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar)
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar).
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten), Sehr verschiedene Konfigurationen der Server (auch bei gleichen Hosting-Paketen), In der Vergangenheit auch zeitweise Ausfälle, Domain teilweise nicht erreichbar.
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen.
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert), nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
|| do_while
|-
|Celeros Online || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || || cypa
|-
|Cyon.ch || KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine || Trikerdaniel
|-
|DomainFactory || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine || hschottm und Kahru
|-
|dynamic-net.ch || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || falls ER nicht ersichtlich, SOAP freischalten lassen - kurzes Supportticket, kein Problem. || [[User:Toflar|Toflar]]
|-
|fc-hosting || Profi-2 || nein || nein || nein || nein || ja || ja || {{td_yellow |Newsletterversand möglich, aber nur blockweise (100Stk.)}} || mandrael
|-
|Flyhost.de || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || ways2web
|-
|genotec.ch || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine || mamboo
|-
|Goneo.de || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || nur .de Domains gelten als Inklusivdomains, andere kostenpflichtig müssen zugebucht werden || felixpfeifer
|-
|greatnet.de || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || PHP 5 Aktivierung in .htaccess: <pre>FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</pre> || tblumrich
|-
|Hetzner || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine || firex112
|-
|Host4Free.de || individueller Tarif || nein || nein || nein || nein || ja || ja || Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht. || Psi
|-
|Hosting-Agency || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine || lucina
|-
|Hostmonster.com || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || crazycisco
|-
|Hostpoint.ch || SH Server Standard || nein || nein || nein || nein || ja || ja || Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht]
|| Trikerdaniel
|-
|Hoststar.ch || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen dass SOAP kein Sicherheitsrisiko darstellt kann Aktivierung erreicht werden. || dusi
|-
|HostTech.biz || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || m.koell
|-
|iNet Robots || ab Web Home || nein || nein || nein || nein || ja || ja || keine || do_while
|-
|intersaar.de || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || Bei Vertragsschluß am Besten gleich angeben, daß SOAP-Extensions aktiviert werden sollen. || rhagen
|-
|Mittwald || - || nein || nein || nein || nein || ja || ja || keine || Mittwald
|-
|one.com || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || cypa
|-
|Strato || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || <pre>AddHandler application/x-httpd-php5 .php</pre>''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann.
''In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:''
<pre>unset($_SERVER['HTTP_X_FORWARDED_HOST']);</pre>
teilweise sehr langsam im Datenbankzugriff
|| thomask
|-
|Suleitec || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || Soulfood
|-
|TNG || VLAMP-Server || nein || nein || nein || nein || ja || ja || Aktivierung von mod_rewrite via Support || lucina
|-
|Top-Hoster.de || Tarife "S"-"XXL", "Sommerpaket 2009" ohne Probleme, || nein || {{td_red |PHP 5 }} || nein || nein || {{td_yellow |SOAP}} | {{td_yellow |unbekannt}} || SOAP von Support aktivieren lassen.<br/>'''Tarif "XS" funktioniert nicht, hat keine MySQL-Datenbanken''' || StephanE
|-
|United-Domains || Standard || nein || nein || nein || nein || ja || ja || keine || Nina
|-
|web.de || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist. || kos
|-
|webhoster.de || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine || x-ray
|-
|WebHostOne || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja ||
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL]<br/>Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen wie man welchen Befehl schreiben muss.
|| Carino und Stranger
|-
|World4You || Domainserver Start || nein || nein || nein || nein || ja || ja || Live Update URL ev. vom Support freischalten lassen.<br/>Contao als Easy.Install im Kundencenter verfügbar. || HAST
|-
|}

==Workarounds für bestimmte Webhoster==
Bei manchen Webhostern ist es leider notwendig von obigem Standard Installationsschema abzuweichen.

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist.
Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]]).

{{Hinweis|In Zukunft wird hier eine Liste von Artikeln veröffentlicht, welche Anpassungen bei welchen Webhoster notwendig ist um Contao zum Laufen zu bekommen.}}

==Liste inkompatibler Webhoster==
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann oder sollte, da sie die Nutzung wichtiger Systemfunktionen deaktivieren.
Bitte beim Hinzufügen von Webhostern darauf achten, detailliert zu beschreiben woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung", alternativ kann auch der Inhalt des betzreffenden Forum-threads rezitiert werden und selbiger Thread als Sonstige Anmerkung verlinkt werden.

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Grund der Inkompatibilität
!Sonstige Anmerkungen
!Information von
|-
|1a websolutions.ch || Verwendet mod_security welches das Datenbank update lahm legt. || [http://www.contao-community.de/showthread.php?5895-Fehlermeldung-bei-der-Installatio Forum-Thread] || bluerate
|-
|T-Online ||Unterstützt keinen .htaccess Dateien daher keine URL Umschreibung und keine Absicherung von Verzeichnissen. || [http://www.contao-community.de/showthread.php?5621-t-online Forum-Thread] || MPstudent
|}

Installation

2010-10-16T22:14:03Z

Marc: margin der Tabelle entfernt da nicht (mehr) notwendig, störend

{{stub}}
[[Category:Installation und Updates]]

=Installation von Contao=
==Kurzanleitung für die Installation bei einem Contao-fähigen Webhoster==

# Download des Contao-Cores auf www.contao.org
# Entpacken auf dem Heimrechner
# Hochladen der Dateien mittles FTP auf Ihren Server
# Hochladen des [[Systemdiagnosetool]]s ins Verzeichnis der Contao-Installation (gewöhnlicherweise das Root-Verzeichnis Ihrer Webadresse)
# Aufrufen der Diagnosedatei in der Adresszeile Ihres Browsers und eventuelle Fehlermeldungen beseitigen
# Aufrufen der Installationsdatei: www.IhreDomain.com/contao/install.php (ersetzen Sie "www.IhreDomain.com" mit Ihrer tatsächlichen Webadresse; in diesem Fall ist Contao im Rootverzeichnis Ihres Webservers installiert; der Zugang zum BackEnd (BE) liegt im Unterverzeichnis "contao/")
# Das Installationsskript führt Sie durch die abschließenden Schritte (die erforderlichen Daten zur Datenbank erhalten Sie von Ihrem Webhoster)
# Nach erfolgreicher Installation können Sie sich im BackEnd einloggen ("www.IhreDomain.com/contao/")

==Detaillierte Anleitung für die Installation bei einem kompatiblen Webhoster==

===Download von Contao und entpacken auf dem Heimrechner===

Auf www.contao.org begibt man sich auf den Bereich [http://www.contao.org/herunterladen.html Herunterladen] und wählt die aktuellste Version von Contao zum Download und speichert diese Datei auf dem eigenen Rechner.
{{Anmerkung| Contao wird in zwei unterschiedlichen Archivformaten angeboten. pkzip (Zip-Archiv) und tar.gz (gzipped Tarball). Sollten man einen Windows PC verwenden, sollte die pkzip Version verwendet werden. }}

Nachdem die Datei heruntergeladen wurde, entpackt man sie mit dem Packprogramm seiner Wahl wie z.B. [http://www.7-zip.org/ 7-zip], welches nahezu alle gängigen Archivformate beherrscht.

===FTP-Programm einrichten===
Um Contao auf die richtige Stelle ihres Webspace zu kopieren, müssen die FTP-Zugangsdaten in ein FTP-Programm eintragen werden.
Bei Eingabe der richtigen Daten wird sich das FTP-Programm direkt in das Verzeichnis, in welchem Contao installiert werden soll, öffnen. Jedes FTP-Programm sieht anders aus, deshalb hier nur ein Beispiel. In allen Programmen sind aber immer die gleichen Angaben zu machen.
{{Achtung|Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (wie .htaccess) abgeschaltet. Bei Contao ist es '''sehr wichtig''', diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit gegen ungewolltes Auslesen von Daten.
Häufig ist es möglich Parameter für den LIST-Befehl anzugeben, dann bitte '''-la''' angeben. Hierzu sollte die Doku des verwendeten FTP-Programms weiter helfen.}}

{|
|rowspan="6" | [[Datei:1u1_ftp2.jpg|FTP-Zugangsdaten eintragen]]
|valign="top" | Protokoll:
|valign="top" | Es soll eine FTP-Verbindung aufgebaut werden.
|-
|valign="top" | Server:
|valign="top" | Hier wird einfach die Hauptdomain eingetragen,<br />welche automatisch auf die richtige IP aufgelöst wird.
|-
|valign="top" | Port:
|valign="top" | Hier trägt man meist den Standard-Port einer<br />FTP-Verbindung, den Port 21 ein.
|-
|valign="top" | Benutzername:
|valign="top" | Der Benutzername wurde vom Provider mitgeteilt.
|-
|valign="top" | Passwort:
|valign="top" | Das FTP-Passwort wurde vom Provider mitgeteilt.
|-
|valign="top" | Anfangsverzeichnis:
|valign="top" | Hier muss das Basisverzeichnis für die Installation<br />angegeben werden.
|}

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte sich auf dem Server ein leeres Verzeichnis auftun.

===Upload Contao===
In dem zuvor heruntergeladenen und entpackten Archiv ist als einziger Eintrag ein Verzeichnis mit der Versionskennung enthalten. Dieses ist das Basisverzeichnis, aus dem der Inhalt auf den Webserver geladen werden soll.

[[Datei:1u1_zip1.jpg|Contao ZIP-Archiv]]

'''Das ganze Paket (ab Basisverzeichnis) ladet man jetzt per FTP auf den Webspace hoch.'''
Wie genau dies geht, entnehme man der Bedienungsanleitung des verwendeten FTP Programmes.

===Aufruf des Installtools===

Den Installer ruft man einfach mit '''<nowiki>http://contao.meinedomain.de/contao/install.php</nowiki>''' auf (bei älteren Paketen, sprich vor Version 2.9, natürlich mit dem Pfad typolight anstatt contao).

Das Installtool verlangt als allererstes das Contao Installationspasswort. Dies ist standardmässig das kleingeschriebe Wort "contao" (bei Versionen kleiner 2.9 "typolight").

Nach Eingabe desselbigen wird man aufgefordert das Installationspasswort zu ändern.
{{Anmerkung|Das Installationspasswort muss mindestens acht Zeichen lang sein und sollte eine Kombination von gross und klein geschriebenen Buchstaben, Zahlen und Sonderzeichen sein. Dieses Passwort sollte man an einem sicheren Ort verwahren, da es jedesmal benötigt wird, wenn ein Update von Contao auf der Webseite vorgenommen wird.}}

Nachdem das Installationspasswort geändert wurde, erfolgt nun die Eingabe eines Verschlüsselungskeys.
Dieser wird von Contao dazu verwendet, Datensätze bei Bedarf verschlüsselt in der Datenbank abzulegen. Bislang wird diese Funktionalität jedoch nur von wenigen Erweiterungen verwendet.
{{Anmerkung|Diese Eingabe ist nur notwendig, wenn ein [[Webseitentemplate]] importiert werden soll. Sollte dies nicht gewünscht sein, so lässt man das Feld leer und Contao erzeugt selbständig einen Key.}}
{{Achtung|Den hierbei erzeugten Key sollte man sich auf jeden Fall, zusätzlich zum Installpasswort, notieren und sicher verwahren. Sollte er einmal verloren gehen, gibt es keine Möglichkeit mehr die verschlüsselten Daten zu entschlüsseln.}}

Nach Eingabe des Verschlüsselungskeys ist die Konfiguration der Datenbank vorzunehmen. Die zu verwendende Datenbank sollte auf jeden Fall eine MySQL Datenbank in der Version 5 sein.
{|
|[[Datei:1u1_install1.jpg|Datenbankconnection]]
|valign="top" | <br />Hier werden alle Daten eingetragen, die man von seinem Provider erhalten hat. Wenn die eingegebenen Daten korrekt sind, wird nach dem Speichern die Meldung "Datenbankverbindung ok." ausgegeben
|}

Nachdem die Zugangsdaten der Datenbankverbindung gespeichert wurden, erkennt das Installtool, dass die Datenbank nicht aktuell ist. Hier genügt es am Ende der Seite den Aktualisierungs-Button zu drücken und die Datenbank wird auf den aktuellen Stand gebracht.

Nun kann man, wenn man will, ein Webseitentemplate importieren. Von Haus aus liefert Contao das von der [http://demo.contao.org Demonstrationswebseite] bekannte Webseitentemplate "Music Academy" mit. Diese sollten Anfänger importieren, da es alle Funktionen des Cores demonstriert. Sollte kein Import gewünscht sein, so lässt man das Auswahlmenü leer.

Abschliessend muss ein Administrator angelegt werden. Hier gebe man den gewünschten Benutzernamen und das Passwort ein. Das Passwort sollte wie das Installpasswort eine Kombination unterschiedlichster Zeichen sein und muss ebenfalls mindestens acht Zeichen lang sein. (Beim Import des Webseitentemplates "Music Academy" wird automatisch ein Administrator mit angelegt.)

Nachdem der Administrator angelegt wurde, erscheint unten rechts ein Link "zum Backend", welcher ins Backend von Contao weiterleitet.<br />
'''Gratulation, die Installation ist abgeschlossen.'''

=Webhoster=
==Liste kompatibler Webhoster==

Hetzner.de (ab dem entsprechenden "Tarif inkl. MySQL-Datenbank" voll kompatibel)

{| border="0" cellpadding="5" cellspacing="1" style="vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Tarif
!SMH notwendig
!.htaccess notwendig
!php.ini notwendig
!CHMOD notwendig
!ER möglich
!LU möglich
!Sonstige Anmerkungen
!Information von
|-
|1&1 Internet || ab 1&1 Homepage Perfect || nein || {{td_red |PHP 5}} || nein || nein || ja || ja || [[1 und 1 Internet|detaillierte Installationsanleitung]] || do_while
|-
| 1Blu || Homepage Unlimited, Homepage Professional || nein || nein || nein || nein || ja || ja || PHP muss mittels einer im Verzeichnis abzulegenden Konfigurationsdatei auf Version 5 umgestellt werden. Problemlos und in den 1Blu-FAQ gut erklärt || LousyWeather
|-style="vertical-align:top;"|
| Alfahosting.de || Multipaket, Profipaket, Businesspaket || nein || nein || nein || nein || ja || ja || one-click-Installation von Contao. || marc und psren
|-
| Arcor || 700 MB Webspace || {{td_yellow |unbekannt}} || nein || nein || nein || {{td_red | SOAP}} || ja || Läuft sehr langsam, Premium-Pakete mit weniger Kunden pro Server gibt es nicht. Safe_Mode ist aktiviert, die Seite funktioniert trotzdem, nur eben sehr langsam. || Stranger
|-
| bytecamp.net || bytecamp arbeitet mit einem einzigen Tarifmodell || nein || {{td_red |PHP 5}} || nein || nein || ja || {{td_yellow|unbekannt}} || PHP 5 Aktivierung in .htaccess: <pre>AddType application/x-httpd-php5 .php</pre> Vereinfache Installation und PHP5 vorkonfiguriert durch eigenen Installer. [http://www.bytecamp.net/de/hosting/details/installer.html 3 Schritte bequem per Webbrowser. ]|| Franziska & Frank
|-
|BPlaced.net (Freehoster, in den Userseiten werbefrei) || Free || nein || nein || nein || nein || {{td_red |nein}} | {{td_red |nein}} ||
Laut User [http://www.contao-community.de/showthread.php?7436-PHP-Version-5.3.2&highlight=bplaced tommy] gibt es inzwischen Ärger mit diesem Freehoster.
|| thomask
|-
|CanHost || CAN-NUKE und andere || nein || nein || {{td_red |ja}} || nein || ja || ja || (hängt stark vom gebuchten Paket ab, einige Änderungen sind im IP-Conf möglich, sonstige sind häufig per Mail an Support machbar)
Kein Backup von Webspace und Datenbanken im Preis enthalten (hinzubuchbar).
Teilweise nur kurzes PHP-Zeitlimit (Support um Aufstockung bitten), Sehr verschiedene Konfigurationen der Server (auch bei gleichen Hosting-Paketen), In der Vergangenheit auch zeitweise Ausfälle, Domain teilweise nicht erreichbar.
Einige ausgewählte php.ini-Parameter lassen sich im IP-Conf (Konfigurationstool) selbst einstellen.
Über den Support kann man fast immer die benötigten Einstellungen bekommen (Beispiele: allow_url_fopen=On, max_execution_time=30, upload_max_filesize=8M, mcrypt aktiviert, SOAP installiert), nicht in allen Paketen läßt sich der Safe-Mode einstellen (safe_mode = Off).
|| do_while
|-
|Celeros Online || Private || nein || nein || nein || nein || ja || {{td_yellow|unbekannt}} || || cypa
|-
|Cyon.ch || KIWI || nein || laut Nutzer "zed" inzwischen nicht mehr nötig, PHP5 nun Standard || nein || nein || ja || ja || keine || Trikerdaniel
|-
|DomainFactory || ManagedHosting L, ManagedHosting M, My Home Vorkonfiguration 1, My Home Dynamic || nein || nein || nein || nein || ja || ja || keine || hschottm und Kahru
|-
|dynamic-net.ch || Alle Pakete inkl. Reseller || nein || nein || nein || nein || ja || ja || falls ER nicht ersichtlich, SOAP freischalten lassen - kurzes Supportticket, kein Problem. || [[User:Toflar|Toflar]]
|-
|fc-hosting || Profi-2 || nein || nein || nein || nein || ja || ja || {{td_yellow |Newsletterversand möglich, aber nur blockweise (100Stk.)}} || mandrael
|-
|Flyhost.de || Flyhost 100, Flyhost 50 || nein || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || ways2web
|-
|genotec.ch || Shared Pro UNIX || nein || nein || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || keine || mamboo
|-
|Goneo.de || Homepage Easy, Profi und Premium || nein || nein || nein || nein || ja || ja || nur .de Domains gelten als Inklusivdomains, andere kostenpflichtig müssen zugebucht werden || felixpfeifer
|-
|greatnet.de || Classic || nein || {{td_red |PHP 5 }} || nein || nein || ja || ja || PHP 5 Aktivierung in .htaccess: <pre>FCGIWrapper /home/www/*DEINWEB*/fcgid/php5-fcgid .php</pre> || tblumrich
|-
|Hetzner || ab dem Paket "Level 4" voll kompatibel || nein || nein || nein || nein || ja || ja || keine || firex112
|-
|Host4Free.de || individueller Tarif || nein || nein || nein || nein || ja || ja || Für größere Websites wird ein Paket ab 4maxi empfohlen, da hier mehr Arbeitsspeicher pro Prozess zur Verfügung steht. || Psi
|-
|Hosting-Agency || Agency 250 || nein || nein || nein || nein || {{td_red | SOAP}} || ja || keine || lucina
|-
|Hostmonster.com || - || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || crazycisco
|-
|Hostpoint.ch || SH Server Standard || nein || nein || nein || nein || ja || ja || Anscheinend läuft bei Hostpoint [http://www.contao-community.de/showpost.php?p=30104&postcount=32 TCPDF nicht wie gewünscht]
|| Trikerdaniel
|-
|Hoststar.ch || StarEntry || nein || {{td_red |PHP 5}} | {{td_red |mod_rewrite aktivieren lassen}} || nein || {{td_yellow | SOAP}} || ja || Über my.hoststar.ch ein Ticket erstellen für SOAP Aktivierung. Dann kommt meistens eine Antwort wie "das sei unsicher". Durch Beharrlichkeit und klar machen dass SOAP kein Sicherheitsrisiko darstellt kann Aktivierung erreicht werden. || dusi
|-
|HostTech.biz || Easy 10000 || {{td_red |Ja}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || m.koell
|-
|iNet Robots || ab Web Home || nein || nein || nein || nein || ja || ja || keine || do_while
|-
|intersaar.de || ab Web-Präsenz "Eco" aufwärts ("Eco", "Business", "Professional", "Premium") gut geeignet. || nein || nein || nein || nein || {{td_yellow | SOAP}} | {{td_yellow |unbekannt}} || Bei Vertragsschluß am Besten gleich angeben, daß SOAP-Extensions aktiviert werden sollen. || rhagen
|-
|Mittwald || - || nein || nein || nein || nein || ja || ja || keine || Mittwald
|-
|one.com || 3000MB || {{td_yellow |unbekannt}} || nein || nein || nein || ja || {{td_yellow |unbekannt}} || keine || cypa
|-
|Strato || Strato PowerPlus, Strato Speedplus || nein || {{td_red |PHP 5 }} || nein || nein || {{td_red | SOAP}} | {{td_yellow |unbekannt}} || <pre>AddHandler application/x-httpd-php5 .php</pre>''Anmerkung von planepix:'' Alternativ kann man sich im Kundencenter von Strato einloggen und links im Menü unter "Homepagestaltung" die Option "Website-Konfigurator" wählen. Dort gibt es den Punkt "PHP-Konfiguration" mit dem man die PHP-Version fürs Verzeichnis auf PHP5 einstellen kann.
''In den neuen Paketen (z.B. BasicWeb XL) muss man in der localconfig.php ggf. diese Zeile nach(!) "### INSTALL SCRIPT STOP ###" hinzufügen:''
<pre>unset($_SERVER['HTTP_X_FORWARDED_HOST']);</pre>
teilweise sehr langsam im Datenbankzugriff
|| thomask
|-
|Suleitec || ab Tarif Expert || nein || nein || nein || nein || {{td_yellow |unbekannt}} | {{td_yellow |unbekannt}} || keine || Soulfood
|-
|TNG || VLAMP-Server || nein || nein || nein || nein || ja || ja || Aktivierung von mod_rewrite via Support || lucina
|-
|Top-Hoster.de || Tarife "S"-"XXL", "Sommerpaket 2009" ohne Probleme, || nein || {{td_red |PHP 5 }} || nein || nein || {{td_yellow |SOAP}} | {{td_yellow |unbekannt}} || SOAP von Support aktivieren lassen.<br/>'''Tarif "XS" funktioniert nicht, hat keine MySQL-Datenbanken''' || StephanE
|-
|United-Domains || Standard || nein || nein || nein || nein || ja || ja || keine || Nina
|-
|web.de || colspan="8" | Siehe [[1 und 1 Internet]] da web.de eine Tochtergesellschaft ist. || kos
|-
|webhoster.de || Webhosting Starter Tarif || nein || nein || nein || nein || ja || ja || keine || x-ray
|-
|WebHostOne || ab Basic-300 (Carino: empfohlen Basic 750), Pro-1500 || nein || nein || nein || nein || ja || ja ||
[http://www.contao.org/neuigkeiten/items/typolight-als-1click-installation.html 1 Klick Installation von TL]<br/>Man kann bei speziellen Wünschen httpd.conf und php.ini selbst anpassen. Wenn man sich nicht so gut damit auskennt, kann man sogar im kostenlosen SupportChat fragen wie man welchen Befehl schreiben muss.
|| Carino und Stranger
|-
|World4You || Domainserver Start || nein || nein || nein || nein || ja || ja || Live Update URL ev. vom Support freischalten lassen.<br/>Contao als Easy.Install im Kundencenter verfügbar. || HAST
|-
|}

==Workarounds für bestimmte Webhoster==
Bei manchen Webhostern ist es leider notwendig von obigem Standard Installationsschema abzuweichen.

Diese Besonderheiten sind hier aufgeführt um zu ermöglichen, dass Contao bei diesen Webhostern läuft.

Oftmals betrifft dies den so genannten [[Safemode Hack]], welcher bei etlichen Webhostern notwendig ist.
Weiterhin ist oftmals die SOAP Erweiterung nicht in PHP enthalten, was den Erweiterungskatalog nicht verwendbar macht (Mögliche Abhilfe hierbei ist jedoch [[TensideRepository]]).

{{Hinweis|In Zukunft wird hier eine Liste von Artikeln veröffentlicht, welche Anpassungen bei welchen Webhoster notwendig ist um Contao zum Laufen zu bekommen.}}

==Liste inkompatibler Webhoster==
In dieser Liste werden Webhoster gelistet, bei denen Contao nicht eingesetzt werden kann oder sollte, da sie die Nutzung wichtiger Systemfunktionen deaktivieren.
Bitte beim Hinzufügen von Webhostern darauf achten, detailliert zu beschreiben woran es scheitert, wie z.B. "stellt nur PHP4 zur Verfügung", alternativ kann auch der Inhalt des betzreffenden Forum-threads rezitiert werden und selbiger Thread als Sonstige Anmerkung verlinkt werden.

{| border="0" cellpadding="5" cellspacing="1" style="margin:0;vertical-align:top;"
|+ <big>'''Diese Informationen basieren ausschließlich auf Erfahrungen von Nutzern. Diese Erfahrungen stimmen teilweise nicht für alle Webpakete eines Anbieters! Manchmal ändern Anbieter auch die technischen Einstellungen, so dass sich neue Umstände ergeben. Verlasst euch niemals nur darauf, sondern führt wenn möglich mindestens eine Diagnose, am besten aber eine Testinstallation auf einem Test-Webspace (beim Anbieter nachfragen) durch.'''</big>
|-
!Webhoster
!Grund der Inkompatibilität
!Sonstige Anmerkungen
!Information von
|-
|1a websolutions.ch || Verwendet mod_security welches das Datenbank update lahm legt. || [http://www.contao-community.de/showthread.php?5895-Fehlermeldung-bei-der-Installatio Forum-Thread] || bluerate
|-
|T-Online ||Unterstützt keinen .htaccess Dateien daher keine URL Umschreibung und keine Absicherung von Verzeichnissen. || [http://www.contao-community.de/showthread.php?5621-t-online Forum-Thread] || MPstudent
|}

Arbeiten mit Bildern

2010-10-16T22:10:57Z

Marc:

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]{{AppliesTo
|TLVersion=ab 2.7
|Version=ab 2.9
}}
Das Contao-Framework stellt folgende Methoden für das Arbeiten mit Bildern zur Verfügung:
# generateImage()
# getImage()
Die Original-Daten, welche meistens unter dem Ordner '''tl_files''' abgelegt sind werden aufbereitet.
Hierzu wird das Bild in der entsprechenden Größe unter '''system/html''' abgelegt und auf der Webseite werden nur noch Verweise auf diese erzeugte Kopie ausgegeben.

== getImage() ==
Die Methode getImage() ist in der Datei system/libraries/Controller.php angesiedelt und stellt fünf Parameter zur Verfügung, von welchen die ersten drei verpflichtend sind.
Die Methode erstellt eine neue Version des Original-Bildes und legt dieses im Cache Verzeichnis /system/html ab, sofern der Parameter $target nicht übergeben wird.
Es wird der Pfad zum neuen Bild zurück gegeben, wenn die Verarbeitung funktioniert hat.

Aktuell verarbeitet Contao die Bildformate welche von PHP (gdlib) unterstützt werden: jpeg, jpg, png und gif (nur lesen)

=== Parameter ===
# $image: Enthällt den Pfad zu dem Bild welches bearbeitet werden soll. (BSP: tl_files/images/foobar.jpg)
# $width: enthällt die gewünschte Breite des Bildes (z.B.: 200)
# $height: enthällt die gewünschte Höhe des Bildes (z.B.: 250)
# $mode: optionale Angabe der Skallierungsmethode
## proportional
## box
# $target: Ort an dem das neue Bild gespeichert werden soll, relativ zu TL_ROOT.

== generateImage() ==
Die Methode generateImage() ist ebenfalls in der Controller.php angesiedelt und erzeugt einen HTML <img> Tag welcher in einem Template ausgegeben werden kann. Diese Methode besitzt 3 Parameter wovon nur der Erste verpflichtend angegeben werden muss. Wird beim Parameter $src kein Pfad angegeben, sondern nur ein Bildname (Pfade beginnen immer mit / und sind relativ zum TL_ROOT zu verstehen, Bildnamen nicht) so sucht Contao das Bild im aktuellen Themes Verzeichnis. (i.d.R.: /system/themes/default/images/ sofern kein anderes Backend-Theme gewählt wurde).

=== Parameter ===
# $src: Der Pfad zum Bild welches eingebunden werden soll. (hier kann z.B. der Rückgabewert der Methode getImage() verwendet werden)
# $alt: Angabe eines Wertes für das alt-Attribut. Dieser ist laut [[w:de:W3C|W3C]] Pflicht und sollte immer angegeben werden.
# $attributes: Angabe weiterer Attribute für das zu erzeugende <img> Tag. (z.B.: inline [[w:de:CSS|CSS]] via style Attribut, etc.)

== Codebeispiele ==
Mit folgendem Code kann eine neue verkleinerte Version eines Bildes im Cache abgelegt und auf der Seite ausgegeben werden:
<source lang="php">
$strReturn = $this->generateImage($this->getImage('tl_files/images/foobar.jpg', 300, 250, 'proportional'), 'my first image');
// nun den Wert an ein Template übergeben.
$this->Template->myFirstImage = $strReturn;
</source>

Arbeiten mit Bildern

2010-10-16T22:10:31Z

Marc: <br /> unter der Hauptüberschrift entfernt

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]{{AppliesTo
|TLVersion=ab 2.7
|Version=ab 2.9
}}

Das Contao-Framework stellt folgende Methoden für das Arbeiten mit Bildern zur Verfügung:
# generateImage()
# getImage()
Die Original-Daten, welche meistens unter dem Ordner '''tl_files''' abgelegt sind werden aufbereitet.
Hierzu wird das Bild in der entsprechenden Größe unter '''system/html''' abgelegt und auf der Webseite werden nur noch Verweise auf diese erzeugte Kopie ausgegeben.

== getImage() ==
Die Methode getImage() ist in der Datei system/libraries/Controller.php angesiedelt und stellt fünf Parameter zur Verfügung, von welchen die ersten drei verpflichtend sind.
Die Methode erstellt eine neue Version des Original-Bildes und legt dieses im Cache Verzeichnis /system/html ab, sofern der Parameter $target nicht übergeben wird.
Es wird der Pfad zum neuen Bild zurück gegeben, wenn die Verarbeitung funktioniert hat.

Aktuell verarbeitet Contao die Bildformate welche von PHP (gdlib) unterstützt werden: jpeg, jpg, png und gif (nur lesen)

=== Parameter ===
# $image: Enthällt den Pfad zu dem Bild welches bearbeitet werden soll. (BSP: tl_files/images/foobar.jpg)
# $width: enthällt die gewünschte Breite des Bildes (z.B.: 200)
# $height: enthällt die gewünschte Höhe des Bildes (z.B.: 250)
# $mode: optionale Angabe der Skallierungsmethode
## proportional
## box
# $target: Ort an dem das neue Bild gespeichert werden soll, relativ zu TL_ROOT.

== generateImage() ==
Die Methode generateImage() ist ebenfalls in der Controller.php angesiedelt und erzeugt einen HTML <img> Tag welcher in einem Template ausgegeben werden kann. Diese Methode besitzt 3 Parameter wovon nur der Erste verpflichtend angegeben werden muss. Wird beim Parameter $src kein Pfad angegeben, sondern nur ein Bildname (Pfade beginnen immer mit / und sind relativ zum TL_ROOT zu verstehen, Bildnamen nicht) so sucht Contao das Bild im aktuellen Themes Verzeichnis. (i.d.R.: /system/themes/default/images/ sofern kein anderes Backend-Theme gewählt wurde).

=== Parameter ===
# $src: Der Pfad zum Bild welches eingebunden werden soll. (hier kann z.B. der Rückgabewert der Methode getImage() verwendet werden)
# $alt: Angabe eines Wertes für das alt-Attribut. Dieser ist laut [[w:de:W3C|W3C]] Pflicht und sollte immer angegeben werden.
# $attributes: Angabe weiterer Attribute für das zu erzeugende <img> Tag. (z.B.: inline [[w:de:CSS|CSS]] via style Attribut, etc.)

== Codebeispiele ==
Mit folgendem Code kann eine neue verkleinerte Version eines Bildes im Cache abgelegt und auf der Seite ausgegeben werden:
<source lang="php">
$strReturn = $this->generateImage($this->getImage('tl_files/images/foobar.jpg', 300, 250, 'proportional'), 'my first image');
// nun den Wert an ein Template übergeben.
$this->Template->myFirstImage = $strReturn;
</source>

TEE-04 Backend DCA

2010-10-16T22:05:03Z

Marc: <pre>-Tags durch korrekte <source>-Tags ersetzt

{{stub}}
Tagebuch einer Extension-Entwicklung
[[Category:Tagebuch_einer_Extension-Entwicklung]]
{{AppliesTo
|Ext1=Extension Creator
|TLVersion=ab TL 2.8}}

=Wir wagen uns in das DCA-Land=
Jetzt kommt es zu einem (vermutlich) harten Brocken. Mein Backend-Modul wird links in der Navigation des Backends (in der Sidebar) angezeigt, aber man kann noch keine Datensätze anlegen oder verändern. Dafür müssen wir einen passenden ''DCA-Record'' anlegen. Ich werde mich wieder vom [http://dev.typolight.org/projects/typolight/wiki/TutorialsExtension CD-Collection-Tutorial] und der Referenz zu den [http://www.typolight.org/dca.html DCA-Records] leiten lassen. Die Referenz ist schon mal erschlagend-beeindruckend.

Mithilfe der DCA-Records erstellt TYPOlight die Masken, mit denen man im Backend die Tabellen füllen, verändern und löschen kann. In ''/system/modules/gw_turnierpaare/dca/tl_gw_turnierpaare.php'' hat der ''Extension-Generator'' freundlicherweise schon ein Skelett für einen DCA-Record für die Tabelle ''tl_gw_turnierpaare'' angelegt.

PHP-Code:
<source lang="php">
$GLOBALS['TL_DCA']['tl_gw_turnierpaare'] = array
(
// Config
'config' => array
(
'dataContainer' => 'Table',
'enableVersioning' => true
),
...
</source>

Der zweite Array-Key in $GLOBALS ist der Name unserer Tabelle. Im darauffolgenden mehrfach verschachtelten Array gibt es zunächst die ''config''-Sektion. Hier wird zunächst festgehalten, dass es sich bei der Datenquelle um eine Tabelle handelt. Laut Referenz sind auch noch File und Folder vorgesehen. Sicherlich sind Tabellen der am häufigsten gebrauchte Datacontainer. ''enableVersioning'' erlaubt die Versionierung der Einträge - das ist OK und passt mir ins Konzept. Die Referenz verrät mir, daß ich eine "child Table" angeben kann. Da die Turniermeldungen Childs der Turnierpaare werden soll, ergänze ich also

PHP-Code:
<source lang="php">
'ctable' => 'tl_gw_meldungen'
</source>

Die verbleibenden Optionen in ''config'' erscheinen mir nicht weiter von Bedeutung. Weiter geht es mit dem Abschnitt ''list'', und dort mit ''sorting'':

PHP-Code:
<source lang="php">
// List
'list' => array
(
'sorting' => array
(
'mode' => 1,
'fields' => array(''),
'flag' => 1
),
</source>

Sortierart und Sortierreihenfolge sind für mich erst mal ok, da ich gerne nach Nachnamen von Herrn und Dame sortieren würde, verändere ich die Zeile mit ''fields'' auf:

PHP-Code:
<source lang="php">
'fields' => array('partnernachname','partnerinnachname'),
</source>

Als nächstes kommt ein Block ''label'':

PHP-Code:
<source lang="php">
'label' => array
(
'fields' => array(''),
'format' => '%s'
),
</source>

Hier scheint es wohl darum zu gehen, was in der Liste der schon bestehenden Tabelleneinträge angezeigt wird. Ich verändere die Zeilen auf

PHP-Code:
<source lang="php">
'fields' => array('partnernachname','partnervorname','partnerinnachname','partnerinvorname','startgruppe','startklassestd','startklasselat'),
'format' => '%s, %s und %s, %s - %s %s LAT / %s STD'
</source>

Etwas "domain-specific knowledge": Startgruppe ist im Prinzip die Altersklasse, Startklasse ist die Leistungsklasse (Die "Liga"), in der das Paar tanzt, und zwar unterschieden nach lateinamerikanischen und Standardtänzen. Diese Infos sind für den Sportwart interessant und sollten in der Übersichtsliste vorhanden sein. Die "''%s''" im format-String werden in der Reihenfolge mit Feldinhalten befüllt, wie wir sie oben drüber im Array angegeben haben. Der Aufbau des format-Strings sollte PHP- (oder C-)Programmierern bekannt sein. Dann kommt ein Abschnitt ''global_operations'' und ''operations'', den ich aber gar nicht verändern will:

PHP-Code:
<source lang="php">
'global_operations' => array
(
'all' => array
(
'label' => &$GLOBALS['TL_LANG']['MSC']['all'],
'href' => 'act=select',
'class' => 'header_edit_all',
'attributes' => 'onclick="Backend.getScrollOffset();"'
)
),
'operations' => array
(
'edit' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['edit'],
'href' => 'act=edit',
'icon' => 'edit.gif'
),
'copy' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['copy'],
'href' => 'act=copy',
'icon' => 'copy.gif'
),
'delete' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['delete'],
'href' => 'act=delete',
'icon' => 'delete.gif',
'attributes' => 'onclick="if (!confirm(\'' . $GLOBALS['TL_LANG']['MSC']['deleteConfirm'] . '\')) return false;Backend.getScrollOffset();"'
),
'show' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['show'],
'href' => 'act=show',
'icon' => 'show.gif'
)
)
),
</source>

Laut Referenz sollte ''global_operations'' ein Unterpunkt von ''operations'' sein, im Skelett-File des Extension-Generators stehen sie aber auf gleicher Ebene. Ich bin etwas verwundert, aber wird schon funktionieren. Nächster Abschnitt im vorgegeben File sind ''palettes'' und ''subpalettes''. Leider stehen die nicht in der Referenz, und auch die Seite über ''palettes'' macht mich nicht so richtig schlauer.

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => ''
),
// Subpalettes
'subpalettes' => array
(
'' => ''
),
</source>

Ein Blick ins [http://dev.typolight.org/projects/typolight/wiki/TutorialsExtension CD-Collection-Tutorial] verrät, dass man unter ''default'' die Felder angeben kann, die in Paletten sortiert werden sollen: Felder innerhalb der Palette mit Komma getrennt, Beginn einer neuen Palette durch ein Semikolon.
Da ich es zeitlich für diesen Post nicht schaffen werde, alle Felder meiner ''tl_gw_turnierpaare''-Tabelle zu definieren, will ich zunächst nur die Namensfelder definieren, und zum Testen 2 Paletten benutzen. Ich editiere den ''palettes''-Eintrag also in

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => 'partnernachname,partnervorname;partnerinnachname,partnerinvorname'
),
</source>

''Subpalettes'' lässt mich weiterhin ratlos, also Finger weg davon. Der letzte Teil der Skelett-Datei (und hier wird es richtig spannend!) ist das ''fields''-Array:

PHP-Code:
<source lang="php">
// Fields
'fields' => array
(
'' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare'][''],
'exclude' => true,
'inputType' => 'text',
'eval' => array('mandatory'=>true, 'maxlength'=>255
)
)
)
);
</source>

Ich halte mich erst mal an das Skelett, und füge nur die Feldnamen hinzu, und vervielfältige den Block auf insgesamt 4 Stück:

PHP-Code:
<source lang="php">
// Fields
'fields' => array
(
'partnernachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>true, 'maxlength'=>64)
),
'partnervorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnervorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinnachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinnachname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinvorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinvorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
)
)
</source>

Die Labels müssen wir später noch in den Sprachfiles definieren, ''exclude'' = ''true'' bedeutet, dass nur Admins das Feld sehen können. Da später ein Nicht-Admin die Tabelle pflegen können soll, setze ich es also überall auf ''false''. Ich hoffe mein Gedankengang ist da richtig. Wir setzen für jedes Feld die Maximallänge auf 64 Zeichen, und nur der Partner-Nachname ist verpflichtend. Warum nicht auch Vorname und der Namen der Partnerin? Ich brauche für meine Anwendung EINE klitzekleine Ausnahme, in der ich gerne eine Mannschaft in die Startliste eintragen würde. Deren Name würde dann in ''partnernachname'' stehen, die restlichen Felder wären leer.

Für den nächsten Post wird das alles noch verfeinert, weitere Optionen für die Felder hinzugefügt und vor allem alle Felder der Tabelle im DCA-Record definiert. Aber erst mal ein kleines, bescheidenes Zwischenergebnis zur Motivation:

[[Datei:Attachment_004.png|Eingabemaske]]

Und man kann auch schon was eingeben:

[[Datei:Attachment_005.png|Datensatz]]

Da Startgruppe und Klasse(n) noch nicht einzugeben sind, bleiben die in der Übersichtsliste noch leer. Aber: Grundlegend funktioniert das schonmal, und auch den Begriff ''palette'' habe ich jetzt (anhand des Screenshots) verstanden.

Im nächsten Post wird das alles erweitert und "poliert". Zur Übersicht nochmal mein aktueller Stand der Datei ''/system/modules/gw_turnierpaare/dca/tl_gw_turnierpaare.php'':

PHP-Code:
<source lang="php">
/**
* Table tl_gw_turnierpaare
*/
$GLOBALS['TL_DCA']['tl_gw_turnierpaare'] = array
(
// Config
'config' => array
(
'dataContainer' => 'Table',
'enableVersioning' => true,
'ctable' => 'tl_gw_meldungen'
),
// List
'list' => array
(
'sorting' => array
(
'mode' => 1,
'fields' => array('partnernachname','partnerinnachname'),
'flag' => 1
),
'label' => array
(
'fields' => array('partnernachname','partnervorname','partnerinnachname','partnerinvorname','startgruppe','startklassestd','startklasselat'),
'format' => '%s, %s und %s, %s - %s %s LAT / %s STD'
),
'global_operations' => array
(
'all' => array
(
'label' => &$GLOBALS['TL_LANG']['MSC']['all'],
'href' => 'act=select',
'class' => 'header_edit_all',
'attributes' => 'onclick="Backend.getScrollOffset();"'
)
),
'operations' => array
(
'edit' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['edit'],
'href' => 'act=edit',
'icon' => 'edit.gif'
),
'copy' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['copy'],
'href' => 'act=copy',
'icon' => 'copy.gif'
),
'delete' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['delete'],
'href' => 'act=delete',
'icon' => 'delete.gif',
'attributes' => 'onclick="if (!confirm(\'' . $GLOBALS['TL_LANG']['MSC']['deleteConfirm'] . '\')) return false; Backend.getScrollOffset();"'
),
'show' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['show'],
'href' => 'act=show',
'icon' => 'show.gif'
)
)
),
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => 'partnernachname,partnervorname;partnerinnachname,partnerinvorname'
),
// Subpalettes
'subpalettes' => array
(
'' => ''
),
// Fields
'fields' => array
(
'partnernachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>true, 'maxlength'=>64)
),
'partnervorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnervorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinnachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinnachname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinvorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinvorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
)
)
);
</source>
==Verwirrung im DCA-Land==
Nachdem ich einige Testpaare in meine "Minimalmaske" eingetragen habe, stelle ich fest, dass es nicht ganz so aussieht, wie ich es gerne hätte.

[[Datei:Attachment_006.png|Mehrere Datensätze]]

Für jeden Herrennachnamen gibt es eine eigene Gruppenüberschrift. Das ist irgendwie suboptimal, und verschwendet Platz. Ich hätte gerne keine Gruppenüberschriften, oder nur "A", "B", "C", usw...Ich vermute, dass das mit dem Eintrag ''['list']['sorting']['flag']'' zusammenhängt, den ich auf "1" hatte, laut Referenz ''Sort by initial letter ascending'':

PHP-Code:
<source lang="php">
// List
'list' => array
(
'sorting' => array
(
'mode' => 1,
'fields' => array('partnernachname', 'partnervorname', 'partnerinnachname', 'partnerinvorname'),
'flag' => 1
),
</source>

Ich spiele also etwas mit ''flag'' herum, und stelle fest: Irgendwie beeinflusst das garnix.
* 2 = ''Sort by initial letter descending'',
* 3 = ''Sort by initial two letters ascending'',
* 4 = ''Sort by initial two letters descending'',
* 11 = ''Sort ascending'' oder
* 12 = ''Sort descending''
machen in meiner Auflistung nirgendwo irgendeinen Unterschied. Immer wird stur ''ascending'' in der Reihenfolge meiner Sortierfelder sortiert, und für jeden "Unique" Herrennachnamen gibt es eine Gruppenüberschrift.

In meiner Verzweifelung setze ich ''['list']['sorting']['mode']'' auf 0, laut Referenz ''Records are not sorted''. Das Ergebnis sieht so aus:

[[Datei:Attachment_007.png|Datensätze unsortiert]]

Immerhin sind die Gruppenüberschriften weg...und stur ''ascending'' nach meinen Sortierfeldern sortiert. Fast schon unnötig zu erwähnen, dass ''flag'' auch hier keine Wirkung zu haben scheint.

Um das Sortieren vielleicht "von Hand" steuern zu können, füge ich streng nach Referenz die Zeile

PHP-Code:
<source lang="php">
'panelLayout' => 'search,sort,filter'
</source>

hinzu in der Erwartung, dass mir dann in der Übersicht die entsprechenden Optionen angeboten werden. Leider - nichts. Die Übersichtsliste der Turnierpaare verändert sich überhaupt nicht.

Meine ''['list']['sorting']''-Sektion sieht nun so aus:

PHP-Code:
<source lang="php">
'sorting' => array
(
'mode' => 0,
'fields' => array('partnernachname', 'partnervorname', 'partnerinnachname', 'partnerinvorname'),
'flag' => 1,
'panelLayout' => 'search,sort,filter'
),
</source>

Jemand eine Ahnung, warum das Verhalten so ist, bzw. warum mich die Referenz für die DCA-Records so im Stich lässt?
Danke...

==Leichte Entwirrung im DCA-Land==
Lösung gefunden! Bei den einzelnen ''field''-Beschreibungen muss noch die Freigabe zum Sortieren, Filtern und Suchen gegeben werden. Das sieht jetzt so aus:

PHP-Code:
<source lang="php">
// Fields
'fields' => array
(
'partnernachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname'],
'exclude' => false,
'inputType' => 'text',
'search' => true,
'sorting' => true,
'filter' => true,
'flag' => 1,
'eval' => array('mandatory'=>true, 'maxlength'=>64)
),
'partnervorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnervorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinnachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinnachname'],
'exclude' => false,
'inputType' => 'text',
'search' => true,
'sorting' => true,
'filter' => true,
'flag' => 1,
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
),
'partnerinvorname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnerinvorname'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength'=>64
)
)
)
</source>

Mit Ergebnis:

[[Datei:Attachment_008.png|Datensätze sortiert]]

Schon besser, auch wenn die Dropdown-Liste hinter ''Suchen:'' noch leer ist. Vielleicht liegt das an den noch fehlenden Feld-Labels in den Sprachdateien. Nur warum man ''flag'' bei den einzelnen Fields und nochmal global angeben muss, das will ich noch nicht verstehen...

Ergänzung: Und wenn ich ''['sorting']['mode']'' auf 2 setze, dann kann ich sogar mein Sortierfeld auswählen....sehr schön...

==DCA-Polishing==
Nachdem also die leichten Verwirrungen rund um den DCA-Record beseitigt sind, geht es weiter damit, die Backend-"Maske" für die ''tl_gw_turnierpaare''-Tabelle zu definieren und zu "polieren".

Zu jedem Feld lege ich einen Verweis auf den Erklärungs-Text an, der unter dem Eingabefeld angezeigt wird, z.B. für das ''partnernachname''-Feld im Abschnitt ''['fields']['partnernachname']'':

PHP-Code:
<source lang="php">
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname_explanation'],
</source>

Der entsprechende Text muss in den Sprachfiles natürlich noch eingetragen werden - später.

Außerdem ergänze ich den ''eval''-Wert meiner bisherigen 4 Eingabefelder um den Wert'' 'minlength' => 1'', um bei den Namen eine Mindestlänge zu erzwingen (beim Wert 1 wahrscheinlich überflüssig, aber egal).

Bei dem Nachnamen des Partners und der Partnerin ergänze ich außerdem ''<nowiki>'tl_class' => 'w50'</nowiki>''. Das sorgt dafür, dass zwei Felder nebeneinander dargestellt werden. Das Feld mit der w50-Klasse links, das darauffolgende rechts. Dadurch werden Nachname und Vorname jeder Person nebeneinander in einer Zeile dargestellt.

Meine Einstellungen für das ''partnernachname''-Feld sehen jetzt so aus:

PHP-Code:
<source lang="php">
// Fields
'fields' => array
(
'partnernachname' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['partnernachname_explanation'],
'exclude' => false,
'inputType' => 'text',
'search' => true,
'sorting' => true,
'filter' => true,
'flag' => 1,
'eval' => array('mandatory'=>true, 'minlength' => 1, 'maxlength'=>64, 'tl_class' => 'w50')
),
</source>

Wo ich gerade noch optisch etwas aufräume, baue ich den Eintrag ''default'' unter ''palettes'' so um:

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => '{name_legend},partnernachname,partnervorname,partnerinnachname,partnerinvorname;'
),
</source>

''{name_legend}'' legt die Überschrift für die "Palette" fest (also die Felder bis zum nächsten Semikolon). Der Wert muss später im Sprachenfile definiert werden. Ich habe nun alle 4 Textfelder in einer Palette. Optisches Ergebnis:

[[Datei:Attachment_009.png|Eingabemaske]]

Wenn man sich "vernünftige" Überschriften aus dem Sprachfile dazu vorstellt, schon mal ganz OK :-).

Nun geht es um die noch fehlenden Tabellenfelder.

Zunächst kommt ''startgruppe'', das bezeichnet die Altersklasse des Paars. Das Feld soll ''mandatory'' sein, aber auch eine "leere Option" erlauben. Ich will als Ausnahme auch eine Mannschaft in die Paarliste eingeben können, und Mannschaften haben keine Altersklasse. Mein Code für das ''field'' sieht so aus:

PHP-Code:
<source lang="php">
'startgruppe' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['startgruppe'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['startgruppe_explanation'],
'exclude' => false,
'inputType' => 'select',
'options' => array('KIN I','KIN II', 'JUN I', 'JUN II', 'JUG', 'HGR', 'HGR II', 'SEN I', 'SEN II', 'SEN III', 'SEN IV'),
'eval' => array('mandatory'=>true, 'includeBlankOption' => true)
),
</source>

Ich wähle also ein ''select'', also eine Dropdown-Box. In ''options'' liste ich die möglichen Altersgruppen auf, im ''eval''-Bereich gebe ich noch an, dass eine leere Option hinzugefügt werden soll.

Dann kommen ''startklasselatein'' und ''startklassestandard''. Inhaltlich kann in beiden Feldern dasselbe drinstehen, darum ist es fast nur Copy&Paste für das zweite Feld. Die Definition sieht so aus:

PHP-Code:
<source lang="php">
'startklasselatein' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['startklasselatein'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['startklasselatein_explanation'],
'exclude' => false,
'inputType' => 'select',
'options' => array('E','D', 'C', 'B', 'A', 'S', 'PRO', 'LL', 'OL', 'RL', '2. BL', '1. BL'),
'eval' => array('mandatory'=>true, 'includeBlankOption' => true, 'tl_class' => 'w50')
),
</source>

Auch hier wieder eine Dropdown-Box mit Optionen und Möglichkeit der "leeren Option". Durch ''tl_class => w50'' wird die Dropdown-Box nach links gerückt, so dass rechts daneben noch die gleichartige Box für ''startklassestandard'' passt. Die hat natürlich KEIN ''tl_class => w50''!

Eigentlich müsste ich prüfen, dass entweder in ''startklasselatein'' oder ''startklassestandard'' ein Wert ausgewählt ist (also nicht in beiden Feldern die leere Option gewählt wurde), aber das bürde ich zunächst mal dem User auf, vielleicht ergänze ich hier später eine Validation durch einen Hook.

Zur Motivation will ich meine drei neuen Felder auch in im backend sehen, dazu muss ich sie zur Liste der Paletten hinzufügen. Ich packe sie in eine eigene Palette mit Überschrift.

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => '{name_legend},partnernachname,partnervorname,partnerinnachname,partnerinvorname;
{classes_legend},startgruppe,startklasselatein,startklassestandard'
),
</source>

Ergebnis:

[[Datei:Attachment_010.png|Erweiterte Eingabemaske]]

Weiter geht's, jetzt folgen die Felder ''aktiv'', ''aktivseit'' und ''aktivbis''.

PHP-Code:
<source lang="php">
'aktiv' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktiv'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktiv_explanation'],
'exclude' => false,
'inputType' => 'checkbox',
'eval' => array('mandatory'=>true, 'isBoolean' => true)
),
</source>

''Aktiv'' wird eine Checkbox. Ich weiß zwar nicht, was es für eine Bedeutung hat, aber da eine CheckBox immer "Boolean" ist, setze ich in ''eval'' ''isBoolean => true''.

PHP-Code:
<source lang="php">
'aktivseit' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktivseit'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktivseit_explanation'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'minlength' => 4, 'maxlength' => 4, 'rgxp' => 'digit', 'tl_class' => 'w50')
),
'aktivbis' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktivbis'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['aktivbis_explanation'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'minlength' => 4, 'maxlength' => 4, 'rgxp' => 'digit')
),
</source>

''aktivseit'' und ''aktivbis'' sollen nur eine Jahreszahl enthalten. Darum setze ich Minimal- und Maximallänge auf 4 und lasse durch ''rgxp'' nur Zahlen zu. Man hätte auch eine Dropdown-Box mit Jahreszahlen drin nehmen können. Ich denke beides hat Vor- und Nachteile. Sich durch DropDown-Boxen zu scrollen, die bei "1900" anfangen, wenn man nach "2004" will, ist auch kein Vergnügen. Das erste Feld setze ich mit ''tl_class => w50'' nach links, um das zweite Feld daneben darstellen zu können.

Ich ergänze die Paletten-Definition um

PHP-Code:
<source lang="php">
{aktiv_legend:hide},aktiv,aktivseit,aktivbis;
</source>

Da die Felder nicht so oft editiert werden, schließe ich die Palette defaultmäßig.

Nun kommt schon ein kleiner Sonderfall: ''password''. Dies soll das Paar-Passwort sein, was zum Eintragen von Turnierergebnissen oder geänderten persönlichen Daten im Frontend dient. Ich will das nur in eigenen PHP-Skripten nutzen, von daher habe ich hier alle Freiheiten, wie ich das realisiere.

Ich möchte gerne, dass der Sportwart in diesem Feld ein Klartextpasswort eingeben kann. In die Datenbank soll aber nur der MD5-Hash des Passworts gelangen. Momentan plane ich, dass in dem Textfeld einfach der MD5-Hash angezeigt wird, wenn man aber etwas in dieses Feld eingibt, dass es dann aber durch einen Hook in den Hash umgewandelt wird, bevor es in der Datenbank gespeichert wird. Um die Realisation kümmere ich mich später. Erstmal soll es ein ganz normales Text-Feld sein:

PHP-Code:
<source lang="php">
'password' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['password'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['password_explanation'],
'exclude' => false,
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'minlength' => 1, 'maxlength' => 64)
)
</source>

Dieses Feld soll (alleine) in einer eigenen Palette stehen, darum ergänze ich die Palettendefinition um:

PHP-Code:
<source lang="php">
{password_legend:hide},password;
</source>

Zwischenstand der Backend-Maske:

[[Datei:Attachment_011.png|Eingabemaske mit Passwort-Feld]]

Und nochmal die gesamte Paletten-Definition:

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => '{name_legend},partnernachname,partnervorname,partnerinnachname,partnerinvorname;
{classes_legend},startgruppe,startklasselatein,startklassestandard;{aktiv_legend:hide},aktiv,aktivseit,aktivbis;{password_legend:hide},password;'
),
</source>

Leider ist damit schon wieder das Ende meiner zur Verfügung stehenden Zeit erreicht (Sorry, wenn es zu langsam voran geht). Bald geht es weiter.

== Ein Bug, ein Bug!==
Nachdem man jetzt Startklassen eingeben, entdecke ich natürlich gleich einen Bug, und zwar in ''['list']['label']['fields']''.

VORHER (falsch):

PHP-Code:
<source lang="php">
'fields' => array('partnernachname','partnervorname','partnerinnachname','partnerinvorname','startgruppe','startklassestd','startklasselat'),
</source>

NACHHER (richtig):

PHP-Code:
<source lang="php">
'fields' => array('partnernachname','partnervorname','partnerinnachname','partnerinvorname','startgruppe','startklassestandard','startklasselatein'),
</source>

D.h. die beiden Felder für die Startklasse Standard und Latein waren falsch benannt. Sorry.

Und weiter geht es mit Bugs:
Wenn ich bei Feldern, die eine "leere Option" zulassen, trotzdem in ''eval 'mandatory' => true'' fordere, kann die leere Option nicht ausgewählt werden. Gut, irgendwie auch logisch. Aus diesem Grund setze ich bei ''startgruppe'', ''startklasselatein'' und ''startklassestandard'': ''<nowiki>'mandatory'</nowiki> => false'', um auch die leere Option zuzulassen.

Und letzter kleiner Fehler:
Im ''format''-String für die Zeilen in der Übersicht der Turnierpaare ''['list']['label']['format']'' ist LAT und STD vertauscht, ich drehe das um. Neu:

PHP-Code:
<source lang="php">
'format' => '%s, %s und %s, %s - %s %s STD / %s LAT'
</source>

==Nochmals anders==
Tjaja, wie das bei so einem Tagebuch im Gegensatz zum "durchgeplanten und polierten" Tutorial so ist: Ich habe mir nochmal was anders überlegt.

Ich habe mich entschlossen, die Felder ''startklasselatein'' und ''startklassestandard'' doch ''mandatory'' zu machen, aber als Option eine Leer-Option "-" hinzuzufügen. So ist der Benutzer gezwungen, explizit anzugeben, dass ein Paar keine Startklasse in einer der beiden Sektionen hat, und in meiner Paarübersicht sieht es besser aus, wenn z.B. vor "LAT" noch ein Strich steht, statt einfach garnichts.

Bei beiden Feldern sieht der Eintrag in ''['fields']'' jetzt also so aus:

PHP-Code:
<source lang="php">
'options' => array('-', 'E','D', 'C', 'B', 'A', 'S', 'PRO', 'LL', 'OL', 'RL', '2. BL', '1. BL'),
'eval' => array('mandatory'=>true)
</source>

Dann habe ich noch entdeckt, dass man eine Checkbox nicht ''mandatory'' machen darf, weil dann MUSS sie nämlich angehakt werden. Ist irgendwie suboptimal. Also nochmal den Eintrag ''['fields']['aktiv']['eval']'' geändert auf:

PHP-Code:
<source lang="php">
'eval' => array('mandatory'=>false, 'isBoolean' => true)
</source>

Und schließlich habe ich den Format-String für die Turnierpaar-Übersicht nochmal überarbeitet. Damit die relevantesten Elemente hervor stechen, gebe ich die Nachnamen der Partner fett aus, ebenso die Startgruppe. Die Startklassen zusätzlich in orange (Standard) und rot (Latein). Die Startpässe der Paare in der jeweiligen Sektion haben die gleichen Farben, so dass dies für den Eingeweihten eine natürliche Assoziation ist.

''['list']['label']['format']'' lautet jetzt:

PHP-Code:
<source lang="php">
'format' => '<span style="font-weight: bold;">%s</span>, %s und <span style="font-weight: bold;">%s</span>, %s - <span style="font-weight: bold; margin-left: 5px">%s <span style="color: orange; margin-left: 5px;">%s STD</span> / <span style="color: red;">%s LAT</span></span>'
</source>

Und sieht so aus:

[[Datei:Attachment_012.png|Backend Datensätze]]

Aber im nächsten Post geht es endlich mit den restlichen Feldern der ''tl_gw_turnierpaare''-Tabelle weiter.
==DCA - Almost there==
Schritt 4 scheint kein Ende zu nehmen. Wie erwartet, erweist sich das Thema "DCA" als harter Brocken.

Zunächst geht es weiter mit den restlichen Feldern der ''tl_gw_turnierpaare''-Tabelle. Für Anschrift, Telefonnummer, Fax, Mobilnummer, Email-Adresse und Homepage gibt es jeweils ein Flag, ob es im öffentlichen Profil angezeigt werden soll. Ist es nicht gesetzt, sind die Daten nur im Backend sichtbar. So kann der Sportwart das Paar evtl. erreichen, falls notwendig

Statt die Anschrift in Straße, PLZ, Ort, usw. aufzusplitten, habe ich hierfür eine ''textarea'' vorgesehen. Im DCA sieht das so aus:

PHP-Code:
<source lang="php">
'anschrift' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['anschrift'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['anschrift_explanation'],
'inputType' => 'textarea',
'eval' => array('mandatory'=>false, 'cols' => 40, 'rows' => 5)
),
</source>

Alles wie gehabt, zusätzlich geben ''cols'' und ''rows'' die Spalten und Zeilen des Eingabebereichs an.

Die Definition für das Flag, ob die Anschrift öffentlich angezeigt werden soll, ist so wie beim Feld ''aktiv'':

PHP-Code:
<source lang="php">
'zeigeanschrift' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigeanschrift'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigeanschrift_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true)
),
</source>

Nicht Besonderes!
Die Felder für Telefon, Fax, Mobilnummer, EMail und Homepage sind jeweils Textfelder, denen ich je nach Art die passende Regular Expression zur Überprüfung der Inhalte zuweise. Zusätzlich hat jedes Feld die "Anzeigen"-Checkbox:

PHP-Code:
<source lang="php">
'telefon' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['telefon'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['telefon_explanation'],
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength' => 32, 'rgxp' => 'phone')
),
'zeigetelefon' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigetelefon'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigetelefon_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true, 'tl_class' => 'clr m12 w50')
),
'fax' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['fax'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['fax_explanation'],
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength' => 32, 'rgxp' => 'phone')
),
'zeigefax' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigefax'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigefax_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true, 'tl_class' => 'clr m12 w50')
),
'mobil' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['mobil'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['mobil_explanation'],
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength' => 32, 'rgxp' => 'phone')
),
'zeigemobil' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigemobil'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigemobil_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true, 'tl_class' => 'clr m12 w50')
),
'email' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['email'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['email_explanation'],
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength' => 32, 'rgxp' => 'email')
),
'zeigeemail' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigeemail'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigeemail_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true, 'tl_class' => 'clr m12 w50')
),
'homepage' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['homepage'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['homepage_explanation'],
'inputType' => 'text',
'eval' => array('mandatory'=>false, 'maxlength' => 32, 'rgxp' => 'url')
),
'zeigehomepage' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigehomepage'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['zeigehomepage_explanation'],
'inputType' => 'checkbox',
'eval' => array('mandatory'=>false, 'isBoolean' => true, 'tl_class' => 'clr m12 w50')
),
</source>

Die ''tl_class''-Werte sind so gewählt, dass jede "Anzeigen"-Checkbox links in einer Reihe mit dem entsprechenden Textfeld (rechts) in einer Zeile steht. Ich hätte es gerne andersrum gehabt, also Textfeld links, Checkbox rechts, aber trotz viel experimentieren mit den ''tl_class''-Werten ist es mir nicht gelungen, das Layout sah immer "zerschossen" aus.

Den Wert ''['palettes']['default']'' ergänze ich noch um

PHP-Code:
<source lang="php">
'{contact_legend:hide},zeigeanschrift,anschrift,zeigetelefon,telefon,zeigefax,fax,zeigemobil,mobil,zeigeemail,email,zeigehomepage,homepage;'
</source>

Ergebnis:

[[Datei:Attachment_013.png|Eingabemaske]]

''Beschreibung'' ist eine Textarea, die in eigener Palette angezeigt werden soll. Einzige Besonderheit ist hier, dass ich HTML im Inhalt zulassen will.

PHP-Code:
<source lang="php">
'beschreibung' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['beschreibung'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['beschreibung_explanation'],
'inputType' => 'textarea',
'eval' => array('mandatory'=>false, 'cols' => 80, 'rows' => 20, 'allowHtml' => true)
),
</source>

Schließlich fehlt noch das Bild. Hier wollte ich eine Bilder-Auswahl wie im Content-Element "Bild" haben. Ich habe eine Weile herumexperimentiert, insbesondere mit dem Feldtyp "radioTable" (der aber ganz falsch ist, wie mir jetzt klar ist). Lösung brachte dann ein Blick in das [http://dev.typolight.org/projects/typolight/wiki/TutorialsExtension CD-Collection-Tutorial], wo auch so eine Bilderauswahl drin ist. Der richtige DCA-Eintrag lautet:

PHP-Code:
<source lang="php">
'bild' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['bild'],
'explanation' => &$GLOBALS['TL_LANG']['tl_gw_turnierpaare']['bild_explanation'],
'inputType' => 'fileTree',
'eval' => array('mandatory'=>false, 'files'=>true, 'fieldType'=>'radio', 'filesOnly' => true, 'extensions' => 'jpg,jpeg,png,gif', 'path' => 'tl_files/GW/Bilder_Turnierpaare/')
)
</source>

Typ ist also ein ''fileTree'', in dem man mittels Radiobutton EIN File auswählen kann (''fieldType => radio''), in dem Dateien mit den Erweiterungen jpeg,jpg,png und gif angezeigt werden (''extensions''), in dem Unterverzeichnisse UND Dateien angezeigt werden (''files => true'', sonst werden NUR Verzeichnisse angezeigt), und in dem man mittels des Radiobuttons auch ausschließlich Dateien auswählen kann, KEINE Unterverzeichnisse (''filesOnly => true''). Zusätzlich gebe ich den "Basis-Pfad" an, aus dem man auswählen kann (''path''). Wobei der natürlich bei Jedem anders heißen kann...Also eigentlich nicht so toll. Muss nochmal drüber nachdenken.

Noch die Palettendefinition erweitern um

PHP-Code:
<source lang="php">
'{beschreibung_legend:hide},beschreibung;{bild_legend:hide},bild;'
</source>

und wir landen hier:

[[Datei:Attachment_014.png|Bildauswahl]]

Damit bin ich im Prinzip mit der Maskendefinition für diese Tabelle fertig, abgesehen vom Hook für das MD5-Hashing meines Passworts. Das verschiebe ich erstmal auf später :-).

Folgende "Probleme" habe ich noch: Meine Palettendefinition sieht insgesamt so aus:

PHP-Code:
<source lang="php">
// Palettes
'palettes' => array
(
'__selector__' => array(''),
'default' => '{name_legend},partnernachname,partnervorname,partnerinnachname,partnerinvorname;'.'{classes_legend},startgruppe,startklasselatein,startklassestandard;'.'{aktiv_legend:hide},aktiv,aktivseit,aktivbis;password_legend:hide},password;'.'{contact_legend:hide},zeigeanschrift,anschrift,zeigetelefon,telefon,zeigefax,fax,zeigemobil,mobil,zeigeemail,email,zeigehomepage,homepage;'.'{beschreibung_legend:hide},beschreibung;{bild_legend:hide},bild;'
),
</source>

Eigentlich erwarte ich, dass nur die oberste Palette geöffnet ist, und alle folgenden geschlossen. Komischerweise sind beim Editieren bestehender Einträge und auch bei der Neuanlage alle geöffnet bis auf ''password'' und ''beschreibung''. Ich kann nicht verstehen, wieso. Kann mich jemand schlau machen?

Die Eigenschaft ''exclude'' im Abschnitt ''fields'' soll steuern, ob das jeweilige Feld in der Usergruppenverwaltung spezifisch für einzelne Gruppen (de)aktivierbar ist. ''Bei exclude => true'' soll das Feld in der Usergruppenverwaltung erscheinen, bei ''false'' soll es dort nicht erscheinen und immer sichtbar sein (für die Gruppen, die das Backend-Modul überhaupt freigegeben haben).

Das Verhalten scheint aber ein anderes zu sein: Egal ob ich ''exclude true'' oder ''false'' zuweise, erscheint das Feld in der Usergruppenverwaltung. Nur wenn ich ''exclude'' ganz weglasse, erscheint es dort nicht. Ein Bug? Keine Ahnung. Zumindest ist es in der Referenz anders beschrieben. Da ich diese Steuerung auf Feldebene nicht brauche, sondern das ganze Backendmodul nur einer bestimmten Usergruppe freischalten möchte, habe ich die ''exclude''-Eigenschaft aus allen Felddefinitionen entfernt.

Mein "Traum" wäre, dass man, falls ein Bild schon ausgewählt ist im Filetree man sofort dieses Bild sieht, statt erst den Filetree öffnen zu müssen, um zu sehen ob irgendwo der Radiobutton gesetzt ist. So kann man beim Öffnen eines Datensatzes nicht schnell sehen, ob ein Paar ein Bild zugewiesen hat, oder nicht. Aber ich glaube, das ist so (noch) nicht vorgesehen.

So, das sollte das Ende von Schritt 4 gewesen sein (puh). Um die Maske zu vervollständigen, werde ich mit der Definition der Texte in den Sprachfiles weitermachen.

News und Kommentare in verschiedenen Layoutbereichen

2010-10-16T21:56:39Z

Marc: „Kurzbeschreibung“ unter die Hauptüberschrift gepackt

[[Category:Dev_Snippets]]{{AppliesTo
|Version=ab 2.9
}}
Eröffnet die Möglichkeit die Kommentare und das Formular von den News zu trennen und in einem anderen Layoutbereich zu präsentieren, z.B. in der rechten Spalte.

=Basiert auf:=

root/system/module/news/templates/mod_newsreader.tpl (Contao 2.9.1)

=Ausführliche Beschreibung/Sonstige Infos:=
Hier das mod_newsreader.tpl leicht modifiziert, natürlich nicht im Core, sondern eine Kopie im Ordner roots/templates/

<source lang="php">

<?php if(strpos($this->class, 'comments-only') === false): ?>
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?><?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>
<?php if ($this->headline): ?>

<<?php echo $this->hl; ?>><?php echo $this->headline; ?></<?php echo $this->hl; ?>>
<?php endif; ?>
<?php echo $this->articles; ?>


<p class="back"><a href="<?php echo $this->referer; ?>" title="<?php echo $this->back; ?>"><?php echo $this->back; ?></a></p>

<?php endif; ?>



<?php if(strpos($this->class, 'news-only') === false): ?>

<?php if ($this->allowComments && ($this->comments || !$this->requireLogin)): ?>

<div class="ce_comments block">

<<?php echo $this->hlc; ?>><?php echo $this->addComment; ?></<?php echo $this->hlc; ?>>
<?php foreach ($this->comments as $comment) echo $comment; ?>
<?php echo $this->pagination; ?>
<?php if (!$this->requireLogin): ?>


<div class="form">
<?php if ($this->confirm): ?>

<p class="confirm"><?php echo $this->confirm; ?></p>
<?php else: ?>

<form action="<?php echo $this->action; ?>" id="<?php echo $this->formId; ?>" method="post">
<div class="formbody">
<input type="hidden" name="FORM_SUBMIT" value="<?php echo $this->formId; ?>" />
<div class="widget">
<?php echo $this->fields['name']->generateWithError(); ?> <?php echo $this->fields['name']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['email']->generateWithError(); ?> <?php echo $this->fields['email']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['website']->generateWithError(); ?> <?php echo $this->fields['website']->generateLabel(); ?>
</div>
<?php if (isset($this->fields['captcha'])): ?>
<div class="widget">
<?php echo $this->fields['captcha']->generateWithError(); ?> <label for="ctrl_captcha"><?php echo $this->fields['captcha']->generateQuestion(); ?><span class="mandatory">*</span></label>
</div>
<?php endif; ?>
<div class="widget">
<?php echo $this->fields['comment']->generateWithError(); ?> <label for="ctrl_<?php echo $this->fields['comment']->id; ?>" class="invisible"><?php echo $this->fields['comment']->label; ?></label>
</div>
<div class="submit_container">
<input type="submit" class="submit" value="<?php echo $this->submit; ?>" />
</div>
</div>
</form>
<?php if ($this->hasError): ?>

<script type="text/javascript">
<![CDATA[//><!]]>
</script>
<?php endif; ?>
<?php endif; ?>

</div>

<?php endif; ?>

</div>
<?php endif; ?>
<?php endif; ?>



<?php if(strpos($this->class, 'comments-only') === false): ?>

</div>
<?php endif; ?>

</source>

Es wurden nur IF-Abfragen mit den entsprechenden ENDIFs eingefügt und entsprechende HTML-Kommentar dazu geschrieben, welche man natürlich entfernen kann. Vergibt man keine Klassen, funktioniert das Template wie im Original (Contao 2.9.1).

Jetzt noch den Artikel mit dem Newsreader kopieren, einfügen und den neuen auf rechte Spalte einstellen. Jetzt noch den Inhaltselementen dieser Artikel die Klassen news-only und comments-only mitgeben. Alles so, wie in den Screenshots zu sehen ist.

[[Datei:Frontend_News_Kommentare_getrennt.png|center|frame|Getrennte Frontend News / Kommentare]]
[[Datei:Article_News_Newsreader.png|center|frame|Article "News only" / Artikel "Comments only"]]
[[Datei:Eingabe_der_Klasse.png|center|frame|Einstellung für den Artikel "News only"]]

Die Funktion einen Kommentar hinzuzufügen funktioniert einwandfrei.

----
Freundlicherweise zur Verfügung gestellt von [http://www.contao-community.de/member.php?72-Andreas Andreas Burg] burgtech [http://andreasburg.de/ (http://andreasburg.de/)]

Bookmarking

2010-10-16T21:54:35Z

Marc: <br /> unter der Hauptüberschrift entfernt

[[Kategorie:Extensions]]
Dieses Inhaltselement ermöglicht es, Webseiten zu sozialen Lesezeichen hinzuzufügen.

{{ExtInfo
| Dev=Helmut Schottmüller ([[User:hschottm|hschottm]])
| DevSite=http://www.aurealis.de
| ExtVersion=1.0.2
| Version=2.9.0 - 2.9.1
| TLVersion=2.7.0 - 2.8.4
| ERLink=http://www.contao.org/erweiterungsliste/view/bookmarking.de.html
| DonateLink=http://aurealis.de/spenden.html
}}

== bookmarking (Social Bookmarks / Soziale Lesezeichen) ==

Mit dem bookmarking Inhaltselement kann man innerhalb von Contao-Artikeln eine oder mehrere Schaltflächen zum Speichern der aktuellen Seite bei bevorzugten Social Bookmark Anbietern zur Verfügung stellen. Unter Social Bookmarks versteht man das Speichern der Lesezeichen zu bevorzugten Internetseiten in einer extra dafür bereitgestellten Internetseite anstelle des Webbrowsers. Dadurch sind die Lesezeichen weltweit verfügbar und nicht mehr an den Internetbrowser gebunden. Wenn man die Lesezeichen öffentlich zugänglich macht entstehen dadurch sogar mächte Werkezeuge zur Trend- und Meinungsbildung. Die Anzahl der Anbieter solcher Social Bookmark Lösungen ist mittlerweile auch relativ unübersichtlich geworden.

bookmarking bietet die Unterstützung für einige ausgewählte Social Bookmark Anbieter sowie den Meta-Anbieter AddThis, der sich darauf spezialisiert hat, das Speichern von Lesezeichen für eine möglichst umfassende Anzahl von Anbietern zu ermöglichen.

Um den Verweis auf eine Seiten direkt bei einem der verfügbaren Anbieter speicherbar zu machen, legt man innerhalb eines Artikels ein Inhaltselement mit dem Namen **Social Bookmarks (Soziale Lesezeichen)** an. Dort wählt man unter Social Bookmark Anbieter die bevorzugten Anbieter aus und/oder aktiviert die Unterstützung für den AddThis Meta-Anbieter.

[[Datei:bookmarking_edit_01.png|Auswahl der einzelnen Anbieter|center|frame]]

Wenn man sich für AddThis als Anbieter entscheidet, muss man einen AddThis-Benutzernamen angeben, die Einbindung in AddThis-Seiten für statistische Zwecke die Angabe eines Benutzers erwartet. Das AddThis-Logo wird automatisch in der aktuellen Frontend-Sprache angezeigt.

[[Datei:bookmarking_edit_02.png|Auswahl und Einstellungen für den AddThis-Anbieter|center|frame]]

Im Frontend erhält man dann eine Liste der gewählten Anbieter. Durck Anklicken der jeweiligen Logos wird der Verweis auf die Seite, in die das Inhaltselement eingebunden ist, an den Anbieter gesendet.

[[Datei:bookmarking.jpg|Anzeige verschiedener Anbeiter im Contao Frontend|center|frame]]

Wenn man jede seiner Seiten für das Speichern in Social Bookmark Diensten bereit machen will, so legt man das Inhaltselement am besten innerhalb einer Kopfzeile oder einer Fußzeile ab.
Der AddThis-Dienst bietet Unterstützung für zahllose Social Bookmark Anbieter an. Sobald man mit der Maus über die AddThis-Schaltfläche navigiert, erscheint ein Popup-Fenster, über das man neben Email-Kontakt und den wichtigsten Anbietern auch auf eine Gesamtliste der verfügbaren Anbieter kommt, um seine Verlinkung gezielt ablegen zu können:

[[Datei:addthis_popup.png|AddThis Popup bei aktivierter AddThis-Schaltfläche|center|frame]]

=== Hinweise für Entwickler ===
Wenn man weitere Anbieter zu dem Inhaltselement hinzufügen möchte, muss man die Methode <source lang="php">getBookmarkingOptions()</source> der Klasse Bookmarks um die gewünschten Optionen erweitern und in der Klasse ContentBookmarking für jede Option eine Methode <source lang="php">getHrefAnbietername()</source> hinzufügen, wobei Anbietername der Name des Anbieters ist, den man in der <source lang="php">getBookmarkingOptions()</source> Methode angegeben hat.
Auf Wunsch wird dieses Element aber auch gerne vom Autor um weitere Anbieter erweitert.

--[[Benutzer:Hschottm|Hschottm]] 13:27, 11. Sep. 2010 (CEST)

Vorhandene Module erweitern

2010-10-16T21:50:53Z

Marc: Test wegen merkwürdigem <p>-Erscheinen

[[Category:Dev_HOWTOS]]{{AppliesTo
|Version=2.9 RC1
}}
=Vorwort=
Dieses Tutorial soll neben anderen vorhandenen Tutorials beim Einstieg in die Modulprogrammierung helfen. Hier wird kein eigenständiges Modul erstellt, sondern auf ein vorhandenes Core-Modul und der Demo-Installation ''Music Academy'' aufgebaut.

=Anforderung=
Die Music Academy hat in diesem Jahr so viele talentierte Schüler, dass sie mit Hilfe deren musikalischer Unterstützung verschiedene Abendveranstaltungen durchführen möchte. Manche der Veranstaltungen werden mit kostenlosem Eintritt angeboten, andere Veranstaltungen sollen kostenpflichtig sein. Um den besonders kostenbewussten Musikliebhabern in der '''Veranstaltungsliste''' auf einem Blick aufzuzeigen, welche Veranstaltungen kostenfrei sind, soll '''diese Information''' in Zukunft '''bei jeder einzelnen Veranstaltung''' direkt angezeigt werden.

Zur Umsetzung der Anforderung wird das Formular zur Eingabe von Terminen um eine zusätzliche Checkbox erweitert. Diese Checkbox ist bei Veranstaltungen mit kostenlosem Eintritt zu aktivieren. Falls die Prüfung im Template ergibt, dass der Wert der Checkbox gesetzt ist, wird eine entsprechende Information im Frontend ausgegeben.

=Kurzanleitung=
# ''TL_ROOT/system/modules/calendarFreeEntry'' - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen
# ''TL_ROOT/system/modules/calendarFreeEntry/config/database.sql'' – Datenbanktabelle um neues Feld ''freeEntry'' erweitern
# ''TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php'' – Data Container Array erweitern
# ''TL_ROOT/system/modules/calendarFreeEntry/languages'' – Sprachdateien um neues Feld ''freeEntry'' erweitern
# ''TL_ROOT/system/modules/calendarFreeEntry/templates'' – Erweiterung Template um Laden der Sprachdatei, Prüfung des Feldes freeEntry und abhängiger Ausgabe
# ''<nowiki>http://www.meinedomain.de/contao/install.php</nowiki>'' - Datenbank-Update durchführen, Template in der Eventliste ändern, Termin einstellen, testen

=Detailanleitung=
==Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur==
In dieser Anleitung wird die Extension-Erweiterung lokal erstellt und anschließend auf den Webserver hoch geladen.

<source lang="text">
TL_ROOT/system/modules/calendarFreeEntry
TL_ROOT/system/modules/calendarFreeEntry/config
TL_ROOT/system/modules/calendarFreeEntry/config/database.sql
TL_ROOT/system/modules/calendarFreeEntry/dca
TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/languages
TL_ROOT/system/modules/calendarFreeEntry/languages/de
TL_ROOT/system/modules/calendarFreeEntry/languages/de/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/languages/en
TL_ROOT/system/modules/calendarFreeEntry/languages/en/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/templates/
TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.tpl
</source>

==Erweiterung der vorhandenen Datenbanktabelle tl_calendar_events==
Dazu die Datei ''TL_ROOT/system/modules/calendarFreeEntry/config/database.sql'' öffnen und folgenden Inhalt einfügen:

<source lang="sql">
--
-- Table `tl_calendar_events`
--

CREATE TABLE `tl_calendar_events` (
`freeEntry` char(1) NOT NULL default '',
) ENGINE=MyISAM DEFAULT CHARSET=utf8;
</source>

Anschliessend speichern und schliessen.

==Erweiterung des vorhandenen Data Container Arrays (DCA)==
Dazu die Datei ''TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php'' öffnen und folgenden Inhalt einfügen:

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

//Anzeige im Backend
$GLOBALS['TL_DCA']['tl_calendar_events']['palettes']['default'] = str_replace('title,','title,freeEntry,', $GLOBALS['TL_DCA']['tl_calendar_events']['palettes']['default']);

//Beschreibung des Feldes
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['freeEntry'] = array
(
'label' => &$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'],
'inputType' => 'checkbox'
);

?>
</source>

Anschliessend speichern und schliessen.

==Erweiterung der vorhandenen Sprachdateien==
''TL_ROOT/system/modules/calendarFreeEntry/languages/de/tl_calendar_events.php''

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'] = array('Free entry', 'Zeigen Sie den Termin mit kostenlosen Eintritt an.');

?>
</source>

''TL_ROOT/system/modules/calendarFreeEntry/languages/en/tl_calendar_events.php''

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'] = array('Free Entry', 'Display the event with free entry.');

?>
</source>

==Erweiterung des vorhandenen Templates==
Damit im Template die gewünschte Information ausgegeben werden kann, wird das vorhandene Template der Kerninstallation kopiert, in das neue Modulverzeichnis eingefügt und die PHP-Logik entsprechend ergänzt. Dazu wird eine Prüfung eingebaut, die prüft, ob der Wert der Checkbox gesetzt wurde. Bei gesetztem Wert soll im Template sprachabhängig die Information ausgegeben, dass es sich um eine kostenlose Veranstaltung handelt. Damit die Inhalte der Sprachdateien zugegriffen werden kann, muss die Sprachdatei zu erst noch geladen werden. Contao wurde so konzipiert, dass ausschließlich nur die benötigten Ressourcen geladen werden, um das System auch in der Laufzeit möglichst performant zu halten.

Vorhandene Datei aus ''TL_ROOT/system/modules/calendar/templates/event_list.tpl'' in ''TL_ROOT/system /modules/calendarFreeEntry/templates'' kopieren, in ''event_list_freeEntry.tpl'' umbenennen und entsprechend erweitern:

<source lang="php">
//Load language file
<?php $this->loadLanguageFile('tl_calendar_events'); ?>
.
.
.
//Check field freeEntry
<?php if ($this->freeEntry): ?>
<p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p>
<?php endif; ?>
</source>

Dies war die letzte Datei, die erstellt / bearbeitet werden musste. Nun muss das ganze Paket in die Contao-Installation hoch geladen werden. Beim Hochladen ist darauf zu achten, dass der Ordner an die richtige Stelle kopiert wird.

[[Datei:moduleext_ftp.png|FTP]]

==Datenbank-Update, Veranstaltung eintragen, Test==
Über ''<nowiki>http://www.meinedomain.de/typolight/install.php</nowiki>'' ein Datenbank-Update durchführen (vorgeschlagene Änderungen per Haken aktivieren => Update Database).

[[Datei:moduleext_updatedb.png|Datenbank-Update durchführen]]

Anschließend im Backend unter Themes das MusicAcademy-Theme bearbeiten und bei den Frontend-Modulen das Modul ''Calendar - Event List (Eventliste)'' suchen und dieses ebenfalls bearbeiten. Unter dem Punkt ''Template-Einstellungen'' wählt man nun das neu erstellte Template ''event_list_freeEntry'' aus.

[[Datei:moduleext_template.png|Erstelltes Template auswählen]]

Wenn man nun ein neues Event erstellt oder ein vorhandenes bearbeitet, hat man unter dem ''Title''-Feld eine neue Auswahl ''Free entry'' zur Verfügung.

[[Datei:moduleext_editevent.png|Event bearbeiten]]

Wird diese Einstellung aktiviert, so wird im Frontend in der Eventliste (.../contao_music/index.php/event-list.html?month=201001) zu den normalen Informationen zusätzlich der Eintrag ''Free Entry'' angezeigt.

[[Datei:moduleext_fe.png|Frontend Ausgabe]]

=Credits=
Die Orginal-Anleitung wurde erstellt von manela<br />
Div. Korrekturen und Anpassungen an die Contao-Version durch [[user:Toflar|Toflar]], [[user:BugBuster|BugBuster]] und [[user:manitougs|manitougs]]

Hauptseite

2010-10-08T12:53:53Z

Marc: Den Abstand simuliert, der durch das margin: 0 auto entfernt wurde

[[en:Main Page]]
{| border="0" cellpadding="5" cellspacing="0" style="margin:0 auto 2em auto;"
|+ style="color:#e76700;" |<big>'''Willkommen in der Contao Community Documentation.'''</big>
|-
!colspan="3"|Hier findest du eine ständig wachsende Sammlung von Anleitungen und Problemlösungen.
|-style="text-align:center; height:200px;"
|[[Datei:Einsteiger.png|64px|verweis=Einsteiger|Neu hier?]]
[[Einsteiger|Neu hier?]]<br/>
Grundlegende Infos zu Contao
|[[Datei:Installation.png|64px|verweis=Installation|Contao installieren]]
[[Installation]]<br/>
Contao installieren
|[[Datei:Erste Schritte.png|64px|verweis=:Kategorie:Erste Schritte|Erstkonfiguration nach der Installation]]
[[:Kategorie:Erste Schritte|Erste Schritte]]<br/>
Erstkonfiguration nach der Installation
|-
|colspan="3"|'''Das ganze Projekt lebt vor allem von der Mithilfe seiner User. Solltest du Lust haben, selbst mitzumachen, melde dich an und dokumentiere mit.'''
|}

Ziel des "Contao Community Documentation" Projektes ist es, Anwendern, Verwaltern und Entwicklern Informationen zum Content Management System Contao zur Verfügung zu stellen.

Das "ccd" ist keine offizielle Seite des Contao Projekts, sondern ein von engagierten Anwendern derselbigen Software ins Leben gerufen worden.
Bitte meldet Fehler, Anmerkungen und grundsätzliches Gemecker an dieser Dokumentation daher nicht beim offiziellen Team von Contao sondern bei uns.
Das offizielle Team von Contao hat so schon genug zu tun. :)

'''Komm doch zu uns in den [[Chat HowTo‎|Chat]] auf einen ungezwungenen und freundlichen Austausch zu Contao.'''

<div style="float:right;text-align:center;">Dies ist eine<br/>[[Datei:Contao_Fanpage_Web.png|Contao unofficial fanpage]]<br/>[http://www.contao.org http://www.contao.org]</div>

Chat HowTo

2010-10-08T12:51:13Z

Marc: Der User, wie in "der Nutzer", "der Benutzer" oder Manche <- männlich User

[[en:Chat HowTo‎]]

[[Category:Sonstiges]]
=Einleitung=
Um an einem Chat in einem [[w:de:Internet_Relay_Chat|IRC-Netzwerk]] teilnehmen zu können, gibt es verschiedenste Programme für fast alle Betriebssysteme. Der (inoffizielle) Chatraum für das Content Management System Contao heist #contao (englischsprachig) bzw. #contao.de (deutschsprachig) und befindet sich im [http://www.freenode.net Freenode] Netzwerk.

=Zweck dieses Chats=
Der Chat dient zum Austausch mit anderen Usern, um Hilfe zu erfragen, zum Fachsimpeln oder einfach zum Smalltalk über das Tagesgeschehen. Er dient NICHT dazu, um sich bei Problemen Anleitungen vorlesen zu lassen oder sich die Forensuche zu ersparen!
{{Achtung|Einlog-Daten bzw Passwörter sollten NIE in den öffentlichen Chat-Raum gepostet werden. Wenn man jemandem z.B. die Zugangsdaten für sein Backend anvertrauen möchte, damit er sich ein Problem im Backend ansehen kann, sollten diese IMMER in einem privaten Chat-Raum bekanntgegeben werden. Siehe auch [[#Privater_Chat]]}}

=Firefox mit Chatzilla=
Das hier verfasste Howto bezieht sich auf das Firefox-Addon Chatzilla, da [http://www.mozilla-europe.org/de/firefox/ Firefox] ein weit verbreiteter Browser ist und für verschiedenste Betriebssysteme erhältlich ist.
==Chatzilla installieren==
Firefox bietet die Möglichkeit, seine Funktionen mittels Addons zu erweitern. Um das Addon Chatzilla zu installieren, öffnet man Firefox und folgt [https://addons.mozilla.org/de/firefox/addon/16/ diesen Link] und klickt auf den Button "Jetzt Herunterladen". Nach der Installation muss Firefox neu gestartet werden.

==Chatzilla einrichten==
Nach der Installation und dem Neustart des Browsers müssen noch ein paar Grundeinstellungen gemacht werden, um zum Freenode-Netzwerk verbinden zu können.

[[Datei:chat-howto-01.png|Firefox Addonmanager]]

Das Addons findet man über den Addon-Manager (Menüleiste Extras --> Addons).

[[Datei:chat-howto-02.png|Chatzilla Einstellungen]]

Im Addon-Manager das Plugin "Chatzilla" auswählen und auf "Einstellungen" klicken.

[[Datei:chat-howto-03.png|Chatzilla einrichten]]

Auf der Registrierkarte "General" findet man die Felder "Description" (Beschreibung), Nickname und Username.Description ist frei wählbar, unter Nickname und Username gibt man seinen Nicknamen ein. Im Anschluss werden alle Fenster mit OK bestätigt.

==Chatzilla verwenden==

[[Datei:chat-howto-04.png|Chatzilla starten]]

Chatzilla wird über die Menüleiste Extras --> Chatzilla gestartet.

[[Datei:chat-howto-05.png|Chatzilla Startfenster]]

Chatzilla hat von Haus aus verschiedene Netzwerke gespeichert. Um mit einem Server des Freenode-Netzwerkes zu verbinden, klickt man entweder mit der Maus auf den Link "Freenode" oder gibt in der Texteingabeleiste folgenden Befehl ein und klickt Enter:
<source lang="mirc">
/server irc.freenode.net
</source>

{{Anmerkung|Vor dem Verbinden muss bei vorhandenen Firewalls der Port 6667 geöffnet werden}}

[[Datei:chat-howto-06.png|Serverfenster]]

Es öffnet sich ein neuer Tab namens "Freenode" und der Verbindungsaufbau beginnt. Der Verbindungsaufbau kann mehrere Sekunden dauern und wird durch ein oranges "Connecting" angezeigt.

[[Datei:chat-howto-07.png|Verbindungsaufbau]]

Wenn die Verbindung zum Server hergestellt wurde, zeigt Chatzilla dies mit einem grünen "Connecting". Als letzter Schritt muss der Chatraum betreten werden. Um den Raum #contao bzw. #contao.de zu betreten, gibt man folgenden Befehl in die Texteingabeleiste ein und bestätigt mit "Enter":
<source lang="mirc">
/join #contao
</source>

[[Datei:chat-howto-08.png|Raumfenster]]

Das Chatfenster öffnet sich in einem neuen Tab und ist wie folgt eingeteilt.
# Tab für den Raum #contao (bzw. #contao.de)
# Texteingabeleiste: Text eingeben und Enter drücken
# Liste der im Raum befindlichen User
# Chatfenster: Hier werden die geschrieben Texte angezeigt

=Opera=
Anders als Firefox hat Opera schon ein Chat-Programm integriert. Die Installation einer Drittanbieter-Software entfällt somit.
==Opera einrichten==

[[Datei:chat-howto-10.png|Opera Chat-Konto einrichten]]

Bevor man mit Opera loschatten kann, müssen auch hier ein paar Einstellungen gesetzt werden. Zum Einrichten eines Chat-Kontos klickt man mit der Maus auf das Opera-Logo links oben in der Ecke und wählt anschließend den Punkt "E-Mail- und Chat-Konten...".

[[Datei:chat-howto-11.png|Opera Assistent]]

Die anschließende Frage zum Erstellen eines Kontos bestätigt man mit "Ja".

[[Datei:chat-howto-12.png|Opera Kontotyp]]

Beim folgenden Fenster wird als Typ des Kontos "Chat (IRC)" gewählt und bestätigt anschließend mit "Weiter".

[[Datei:chat-howto-13.png|Opera Absendername]]
[[Datei:chat-howto-14.png|Opera Nickname]]

In den nächsten beiden Fenstern wird im Feld "Von (Absendername)" und "Nickname" der Nickname eingegeben. Eine Email-Adresse ist nicht zwingend erforderlich.

[[Datei:chat-howto-15.png|Opera Serverauswahl]]

Als nächstes muss der Server gewählt werden, auf den verbunden werden soll. Hier wählt man "FreeNode, Europa" und bestätigt die Eingabe mit einem Klick auf den Button "Fertig".

[[Datei:chat-howto-16.png|Opera Chanlist Options]]

Die Einstellarbeiten sind nun fast abgeschlossen. Es wird eine Liste aller verfügbaren Räume angezeigt. Die vollständige Auflistung alles Räume kann einige Sekunden dauern. Ist die Auflistung abgeschlossen, klickt man mit der rechten Maustaste auf der linken Seite unter Konto auf den Eintrag "FreeNode, Europa" und wählt "Eigenschaften...".

[[Datei:chat-howto-17.png|Opera Konto-Eigenschaften]]

Im darauffolgenden Fenster "Konto-Eigenschaften wählt man im letzten Tab "Postausgang" unter Standardcodierung "utf-8" und bestätigt mit OK.

[[Datei:chat-howto-18.png|Opera Chanlist]]

Wieder zurück bei der Raumliste klickt man auf "Eintreten"....

[[Datei:chat-howto-19.png|Opera Chatraum betreten]]

... und gibt im Feld: Raum "contao" (bzw. contao.de) ein.

[[Datei:chat-howto-20.png|Opera Chatraum]]

Es öffnet sich der Chatraum. Dieser ist wie folgt eingeteilt:
# Texteingabeleiste: Text eingeben und Enter drücken
# Liste der im Raum befindlichen User
# Chatfenster: Hier werden die geschriebenen Texte angezeigt

==Opera verwenden==

Ist der Chat einmal eingerichtet, ist im Paneele das Chatsymbol sichtbar.

[[Datei:chat-howto-21.png|Opera Sidebar]]

Ein Klick auf dieses öffnet die Sidebar des Chats. Nun genügt ein Klick auf den Raum "contao", um diesen zu betreten.

=Nicknamen registrieren=

Ähnlich wie in einem Forum ist es möglich, sich seinen Benutzernamen zu registrieren. Die Vorteile einer Registration sind:
*Der Nickname kann von keinem anderen verwendet werden bzw. (je nach Einstellung) kann bei Verwendung durch einen Anderen auch gekickt werden.
*Man kann userspezifische Einstellungen machen
*Founder bzw OP's (vergleichbar mit einem Admin in einem Forum) können registrierten Nicks erweiterte Userrechte geben
Man KANN seinen Nicknamen registrieren, muss aber nicht !!!

Um zu prüfen, ob der gewählte Name noch frei ist, muss man mit dem Netzwerk verbunden sein. Ob man sich gerade in einen Channel befindet oder nicht, ist egal. Nun gibt man folgenden Befehl in die Texteingabeleiste ein und bestätigt mit Enter:

<source lang="mirc">
/msg nickserv info contaouser
</source>

{{Anmerkung|Für diese Anleitung wird der Benutzername "contaouser" verwendet und die Bilder mit Chatzilla gemacht. Für Opera gelten die selben Befehle.}}
Wenn der Benutzername noch frei ist, bekommt man die Antwort: contaouser is not registered

[[Datei:chat-howto-22.png|Nickname ist noch frei]]

Bevor man den Nicknamen registrieren kann, muss man sich in diesen umbenennen. Der Befehl dazu lautet:

<source lang="mirc">
/nick contaouser
</source>

Wenn das Umbennenen funktioniert hat, erhält man folgende Antwort:

[[Datei:chat-howto-23.png|Umbennenen]]

Wenn der Nickname gerade von jemand anderen benutzt wird, kommt als Antwort:

[[Datei:chat-howto-24.png|Nickname in use]]

In diesem Fall muss man es später noch einmal versuchen oder man wählt einen anderen Nicknamen.

Kurze Zusammenfassung:
Der erste Befehl kontrolliert nur, ob der gewünschte Nickname schon registriert ist oder nicht. Er sagt nichts darüber aus, ob der Nickname gerade verwendet wird oder nicht. Das sieht man erst, wenn man sich in diesem umbenennen will. Will man einen Nicknamen registrieren, darf dieser a) noch nicht registriert sein und b) auch gerade nicht in Verwendung sein.

{{Achtung|Befehle, die ein Passwort enthalten, sollten immer im Serverfenster eingegeben werden, nie im Chatraum. Chatbefehle beginnen immer mit einem / am Anfang. Tippt man schnell und vergisst den / am Anfang oder schreibt man statt / die Zahl 7, wird der Befehl nicht als solcher erkannt und wie eine normale Nachricht an den Channel geschickt, wo jeder ihn sehen kann!}}

Um den Nicknamen zu registrieren, verwendet man folgenden Befehl (erste Zeile ist die Syntax, die zweite Zeile der Befehl für unseren Beispielnick):

<source lang="mirc">
/msg nickserv register <passwort> <email>
/msg nickserv register 1234 contaouser@example.com
</source>

Bei unseren Beispielnick ist das Passwort:1234 und die Email-Adresse contaouser@example.com. Das Netzwerk antwortet:

[[Datei:chat-howto-25.png|Nick registered]]

Wie aus dieser Antwort ersichtlich, hat das Netzwerk eine Email an die angegebene Email-Adresse geschickt.

[[Datei:chat-howto-26.png|Email]]

Abschliessend muss, wie in der Email aufgefordert, die Registration mit folgendem Befehl aktiviert werden:

<source lang="mirc">
/msg NickServ VERIFY REGISTER contaouser rmcotwcvsuhb
</source>

Die Zeichenfolge "rmcotwcvsuhb" stellt den Registrierungscode dar. Wird der Befehl inkl. dem Registrierungscode richtig eingegeben, antwortet das Netzwerk mit der Meldung:

[[Datei:chat-howto-27.png|Registrierung bestätigt]]

Gratulation! Die Registration des Nicknamens wurde erfolgreich abgeschlossen.
{{Achtung|Die Aktivierung muss innerhalb 24 Stunden abgeschlossen sein, da sonst der Nickname wieder freigegeben wird.}}

Wenn man sich nun mit dem Netzwerk verbindet, erkennt das Netzwerk, dass der Nick registriert ist und fordert einen auf, sich zu identifizieren.

[[Datei:chat-howto-28.png|Identify]]

Dies geschiet mit dem Befehl (wobei 1234 in diesem Fall das Passwort ist):

<source lang="mirc">
/msg nickserv identify 1234
</source>

Das Netzwerk bestätigt die korrekte Identifizierung mit:

[[Datei:chat-howto-29.png|Bestätigung]]

==Perform mit Chatzilla==

Um die Identifizierung bei jeder Verbindung nicht immer manuell eintippen zu müssen, bieten fast alle Chattools die Möglichkeit, dies automatisch machen zu lassen. In Chatzille geht man dazu über die Menüleiste "Chatzilla" in die Einstellungen...

[[Datei:chat-howto-30.png|Chatzilla Einstellungen]]

...geht auf die freenode-Einstellungen und auf den Tab "Lists". Gleich zu Beginn ist der Abschnitt "Auto-perform". Alle in diesem Abschnitt eingefügten Befehle werden bei der Verbindung automatisch ablaufen. Mit einem Klick auf den Button "Add" kann ein neuer Befehl hinzugefügt werden.

[[Datei:chat-howto-31.png|Auto-perform]]

In dem sich aufpoppenden Fenster gibt man folgenden Befehl ein:

<source lang="mirc">
msg nickserv identify 1234
</source>

{{Anmerkung|Normalerweise werden sämtliche IRC-Befehle mit einem / am Anfang eingegeben. In diesem Fall macht das Chatzilla automatisch und der Befehl wird ohne / eingegeben.}}

[[Datei:chat-howto-32.png|Auto-perform command]]

Das Popup-Fenster wird mit "OK" bestätigt. Danach sollte das Einstellungsfenster so aussehen:

[[Datei:chat-howto-33.png|Auto-perform command added]]

Abschliessend wird auch das Einstellungsfenster mit "OK" geschlossen.

Wenn man sich jetzt neu mit dem Netzwerk verbindet, wird Chatzilla nach erfolgtem Verbindungsaufbau den Identify-Befehl automatisch an das Netzwerk senden, welchen diesen dann auch bestätigt:

[[Datei:chat-howto-34.png|auto identify confirmed]]

==Perform mit Opera==

In Opera funktioniert das Perform ähnlich. Auch hier geht man in die Einstellungen des freenode-Netzwerks, indem man einen Rechtsklick auf den freenode-Server macht und anschliessend auf "Eigenschaften" geht.

[[Datei:chat-howto-35.png|Opera chat settings]]

In den Konto-Eigenschaften wechselt man auf den Tab "Postausgang" und fügt dort den identify-Befehl ein. Anders als bei Chatzilla muss hier der Befehl normal mit / am Anfang eingegeben werden.

[[Datei:chat-howto-36.png|Opera auto perform]]

Man bestätigt die Eingabe mit "OK". Auch Opera bestätigt beim Verbinden die erfolgreiche Identifizierung in einem eigenen Tab von "NickServ":

[[Datei:chat-howto-37.png|Opera auto-perform confirmed]]

==Nickserv Hilfe==
Wenn man seinen Nicknamen registriert hat, kann man diverse Einstellungen zu dem Nicknamen machen. NickServ selbst bietet dazu eine Hilfe an. Diese ruft man mit folgenden Befehl auf:

<source lang="mirc">
/msg nickserv help
</source>

Benötigt man Hilfe z.B. zu der "GROUP"-Einstellung, ruft man diese mit folgendem Befehl auf:

<source lang="mirc">
/msg nickserv help group
</source>

=Privater Chat=
Es gibt im IRC die Möglichkeit, mit jemandem privat zu chatten, wo also nur 2 Personen daran teilnehmen, ähnlich wie in einem Forum, wo man jemanden eine private Nachricht schicken kann.

Um einen privaten Chat mit einem anderen User zu beginnen, verwendet man folgenden Befehl:

<source lang="mirc">
/query foobar
</source>
In diesem Fall wäre der Name des anderen Users "foobar".
Es öffnet sich daraufhin ein eigenes Fenster, wo mit dem anderen User gechattet werden kann.
{{Achtung|Man beginnt NIE einen privaten Chat, wenn man nicht vorher dazu aufgefordert wurde oder vorher im öffentlichen Raum den User gefragt hat. Ein Missbrauch kann einen Verweis aus dem Channel zur Folge haben und im schlimmsten Fall kann der User sogar aus dem Raum gesperrt werden.}}
Ein privater Chat kann z.B. dazu verwendet werden, wenn man jemandem seine Backend-Zugangsdaten mitteilen will, oder persönliche Daten wie Handynummer oder Email-Adresse.

=Bitte Beachten!!=
Nur, weil ein Nickname in der Nickliste erscheint, bedeutet das nicht, dass der jeweilige Nutzer gerade verfügbar ist. Es kann sein, dass der User gerade im Hintergrund arbeitet, anderweitig beschäftigt oder gar nicht vor dem PC sitzt. Manche User benutzen auch einen Bot ([[w:de:Eggdrop|Eggdrop]]) oder Bouncer ([[w:de:Bouncer|Bouncer]]), der online bleibt, wenn der Benutzer den Computer abschaltet.

Diskussion:1 und 1 Internet

2010-10-08T12:36:32Z

Marc: Die Seite wurde neu angelegt: „== Keine Portangabe bei der Installation == Ich hab die Erfahrung gemacht, daß man bei der Installation keinen Port angeben darf, da er sich sonst nicht mit der …“

== Keine Portangabe bei der Installation ==
Ich hab die Erfahrung gemacht, daß man bei der Installation keinen Port angeben darf, da er sich sonst nicht mit der DB verbindet, wenn man als Hostnamen etwas in dieser Richtung angegeben bekommt: localhost:/tmp/mysql5.sock

Kann das wer bestätigen? Ich hatte bisher nur 1 1un1-Installation also weiß ich nicht wie regelmäßig das vorkommt.

Hilfe:Inhaltsverzeichnis

2010-10-02T18:01:26Z

Marc: STUB-Warning Datei aktualisiert, da die alte im JPG-Format war und vor Artefakten gestrotzt hat

[[en:Help:Contents]]
=Verfassen von Artikeln=
Vor dem Verfassen eines neuen Artikels sollte kontrolliert werden, ob schon ein Artikel zum gleichen Thema existiert. Dies kann über die Suchfunktion oder über die [[Spezial:Alle_Seiten|Auflistung aller existierender Seiten]] geprüft werden. Vor dem Abspeichern eines Artikels sollte man den Artikel mit der Vorschau-Funktion auf event. Rechtschreibfehler o.ä. prüfen.
==Einen neuen Artikel anlegen==
Sollte die Suche zu keinem Ergebnis führen, legt man die Seite neu an.
Hierzu gibt man beispielsweise den gewünschten Titel links in der Sidebar in das Suchfeld ein und klickt anschließend auf den Button "Seite".
Die Wiki-Software meldet nun, dass die Seite nicht existiert und man möge sie doch bitte verfassen.

Nach einem Klick auf den Link '''die Seite verfassen''' gelangt man in die Eingabemaske.

Ungeduldige können auch direkt die URL: <nowiki>http://de.contaowiki.org/Wunschtitel</nowiki> in ihrem Browser eingeben, wodurch man direkt in die Eingabemaske gelangt.

'''Artikel sollten neutral und allgemein verfasst werden''' (als Beispiel nicht "''Ich betrachte die Seite''" oder "''Du betrachtest die Seite''", sondern "''Man betrachtet die Seite''"), um eine Vereinheitlichung der Artikel zu gewährleisten.

==Wichtig: Angabe der Contao-Version==
Da sich Contao ständig weiter entwickelt, ändert sich auch laufend der Quellcode. '''Daher ist es beim Verfassen von Artikeln wichtig, immer mit anzugeben, auf welche Contao-Version sich der Artikel oder das Codebeispiel bezieht.''' Ein Besucher kann ansonsten in einem Jahr nicht mehr nachvollziehen, auf welche Contao-Version(en) sich ein HowTo für z.B. ein modifiziertes Template bezieht. Durch die Angabe der Version ist er jedoch in der Lage, Änderungen an dem entsprechenden Template nachzuvollziehen und es bei Bedarf dementsprechend anzupassen.
Eine Versionsangabe erfolgt durch ff. Code zu Beginn der Seite:
<pre>{{AppliesTo
|Version=Alle Versionen
|Ext1=SuperExtension
|Ext2=HyperExtension}}</pre>
Hierbei können folgende Parameter verwendet werden:
* Version - Die Contao Version auf die sich der Artikel bezieht.
* Ext1 ... ExtN - Die Extensions die der Artikel betrifft. Die Zahl beginnt jeweils bei 1 und wird für jede weitere Extension um eins hochgezählt.
* TLVersion - Da einige Artikel neben Contao auch noch TYPOlight (pre Contao 2.9) betreffen, kann man so auch noch angeben, dass ein Artikel ggf. noch TYPOlight betrifft. Diese Angaben werden jedoch mit der Zeit verschwinden.

Dieser Code wird dann am Anfang der Seite wie auf folgender [[ModuleCatalogList|Beispielseite]] dargestellt.

==Kategorisierung==
Ein Artikel kann in einer oder mehreren Kategorien abgelegt werden. Für jede Kategorie muss eine neue Zeile zu Beginn der Seite gemacht werden.
<pre>
[[Category:Admin HOWTOS]]
[[Category:Module]]
</pre>
Um einen in Arbeit oder unvollständigen Artikel also solchen zu kennzeichnen, wird der Eintrag
<pre>{{stub}}</pre>
an oberster Stelle, noch vor den Kategorien, eingefügt. Einem unvollständigen Artikel erkennnt man beim Betrachten am Hinweis:

[[Datei:Stub-warning.png|Unvollständiger Artikel]]

Des weiteren ist der Artikel in der Liste der unvollständigen Artikel aufgeführt.

=Hinweise, Anmerkungen und Warnungen=
In einem Artikel kann man Hinweise und Warnungen hinterlegen.
Diese fügt man durch die Verwendung der jeweiligen Vorlage hinzu.
==Hinweise==
<pre>
{{Hinweis|Text des Hinweises}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Hinweis|Text des Hinweises}}

==Anmerkungen==
<pre>
{{Anmerkung|Text der Anmerkung}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Anmerkung|Text der Anmerkung}}

==Warnungen==
<pre>
{{Achtung|Text der Warnung}}
</pre>
Was folgendes Ergebnis erzeugt.
{{Achtung|Text der Warnung}}

== Meldungen mit Bild links oben und farbigem Text ==
Ich habe mir erlaubt, einige eingefärbte Meldungsboxen hinzuzufügen, bei denen die Bilder links oben sitzen (was ich bei längeren Texten ganz angenehm finde). Die Icons sind aus dem frei verfügbaren Oxygen Theme von David Vignoni. --[[Benutzer:Hschottm|Hschottm]] 16:11, 11. Sep. 2010 (CEST)

{|
!Befehl
!Ausgabe
|- style="vertical-align:top;"
| <pre>{{msgInfo|Text der Meldung}}</pre>
|{{msgInfo|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgSuccess|Text der Meldung}}</pre>
|{{msgSuccess|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgError|Text der Meldung}}</pre>
|{{msgError|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgWarning|Text der Meldung}}</pre>
|{{msgWarning|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|- style="vertical-align:top;"
| <pre>{{msgImportant|Text der Meldung}}</pre>
|{{msgImportant|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis odio ac magna ornare porttitor. Aliquam erat volutpat. Morbi vitae dignissim diam. Vestibulum ultrices vehicula posuere. Fusce nec ante tortor, quis euismod dolor. Proin quis porttitor odio. Nam lacinia, nunc sed venenatis pretium, augue risus lobortis lacus, vitae porttitor leo lorem sit amet lectus. Vivamus eu fermentum felis. Cras dictum consequat fringilla.}}
|}

=Formatierung=
==Textformatierung==
Die wichtigsten Textformatierungen lauten:

'''Fettschrift'''
<pre>'''Fettschrift'''</pre>
''Schrägschrift''
<pre>''Schrägschrift''</pre>
'''''Fett- und Schrägschrift'''''
<pre>'''''Fett- und Schrägschrift'''''</pre>
==Auflistung==
Standardauflistung
<pre>
* foo
* bar
</pre>
ergibt
* foo
* bar
Nummerierte Auflistung
<pre>
# foo
# bar
</pre>
ergibt
# foo
# bar
==Gruppierung==
Es ist möglich, einen Artikel in verschiedenen Gruppen und Untergruppen zu gliedern, um bei langen Artikeln die Übersicht zu behalten.
<pre>
=Hauptgruppe 1=
Text
==Untergruppe 1.1==
Text
==Untergruppe 1.2==
Text
=Hauptgruppe 2=
Text
==Untergruppe 2.1==
Text
==Untergruppe 2.2==
usw
</pre>
Bei mehr als 4 Gruppen wird automatisch ein Inhaltsverzeichnis am Anfang des Artikels angelegt.

==Auszeichung von Quellcode==
Um Text als Quellcode darzustellen, verwendet man das '''<nowiki><source></nowiki>'''-Tag (favorisierte Methode seit 27.08.2010).<br />
Weiter Möglichkeiten sind:
# man fügt eine Leerzeile ein und beginnt jede Zeile des zu formatierenden Textes mit einem Leerzeichen (space/blank).
# man umgibt den zu formatierenden Text mit <nowiki><pre>.... text ...</pre></nowiki>

Bei der Formatierung von Quellcode mittels <nowiki><source></nowiki>-Tag kann man optional ein Sprachattribut mit angeben.

Beispiel:
<pre>
<source lang="css">
div .classname {
color: white;
}
</source>
</pre>

Das Ergebnis sieht dann so aus:
<source lang="css">
div .classname {
color: white;
}
</source>

Die folgenden Sprachen sind per '''lang'''-Parameter verfügbar:
{| border="0" cellpadding="0" cellspacing="20"
|- valign="top"
|
* actionscript
* ada
* apache
* applescript
* asm
* asp
* autoit
* bash
* blitzbasic
* bnf
* c
* caddcl
* cadlisp
* cfdg
* cfm
* cpp-qt
* cpp
* csharp
* css-gen.cfg
* css
|
* c_mac
* d
* delphi
* diff
* div
* dos
* eiffel
* fortran
* freebasic
* gml
* groovy
* html4strict
* idl
* ini
* inno
* io
* java
* java5
* javascript
* latex
|
* lisp
* lua
* matlab
* mirc
* mpasm
* mysql
* nsis
* objc
* ocaml-brief
* ocaml
* oobas
* oracle8
* pascal
* perl
* php-brief
* php
* plsql
* python
* qbasic
* reg
|
* robots
* ruby
* sas
* scheme
* sdlbasic
* smalltalk
* smarty
* sql
* tcl
* text
* thinbasic
* tsql
* vb
* vbnet
* vhdl
* visualfoxpro
* winbatch
* xml
* z80
|}

==Umlaute/Sonderzeichen==
Will man Umlaute im Wiki als HTML-Entity (Ersatzdarstellung) darstellen (z.b. ä = &auml;), sieht die Schreibweise beispielsweise so aus:
<pre>
ä = &amp;auml;
</pre>
=Verlinkung=
==Textlinks==
Bei Textlinks unterscheidet man zwischen internen und externen Link.

Interne Links (innerhalb des TYPOlight Info Portals) werden wie folgt verlinkt:
<pre>[[Seitenname|Beschreibung]]</pre>
Für externe Links verwendet man:
<pre>[http://www.example.com Beschreibung]</pre>

Eine Ausnahme hiervon bilden beispielsweise Links auf die Wikipedia. Solche legt man, um auf die englischsprachige Seite in der Wikipedia zu verlinken, folgendermaßen an:
<pre>[[w:Seitenname|Beschreibung]]</pre>
Eine Seite in anderer Sprache, innerhalb der Wikipedia, erreicht man durch das zusätzliche anhängen des Sprachcodes. Am Beispiel Deutsch sieht dies dann so aus:
<pre>[[w:de:Seitenname|Beschreibung]]</pre>

Diese Notation nennt sich Interwiki links, von denen einige bereits eingerichtet sind. Sollten welche fehlen, bitte einem Administrator Bescheid geben, damit er baldmöglichst eingebaut wird.

==Bilderlinks==
Bevor man auf ein Bild verlinkt, muss man das Bild [[Spezial:Hochladen|hochladen]].
Um das Bild in einen Artikel einzubinden, verwendet man folgende Codes:

Die einfachste Variante ist ein Bild mit Beschreibung.
<pre>[[Datei:foo.jpg|Bechreibung]]</pre>
Des weiteren kann man Bilder auch auf andere Seiten verlinken.

Interne Links:
<pre>[[Datei:foo.jpg|link=Hauptseite|Beschreibung]]</pre>
Externe Links:
<pre>[[Datei:foo.jpg|link=http://www.example.com|Beschreibung]]</pre>

----
Bei Code- und Templatebeispielen TL-Version mit angeben!

Eine ausführliche Zusammenfassung aller Formatierungsmöglichkeiten findet man auf der [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Homepage]

=Übersetzungen des Contaowiki=

Das Contaowiki-Projekt umfasst derzeit drei Sprachen. Deutsch (http://de.contaowiki.org), Englisch (http://en.contaowiki.org) und Französisch (http://fr.contaowiki.org).
In einem Artikel sieht man links unten im Menü unter "Sprachen" in welche anderen Sprachen der Artikel bereits übersetzt wurde. Sollte eine Sprache fehlen und man sich selbst der jeweiligen Sprache ausreichend mächtig fühlen, sollte man nun daran gehen den Artikel in die fehlende Sprache zu übersetzen.
Zur genauen Vorgehensweise hier eine kleine Anleitung:
==Titelfindung==
Vorab sollte überlegt werden, wie der Artikel in der anderen Sprache heißen könnte. Nimmt man als Beispiel hier den fiktiven Artikel "Beispiel" (das Wort "Beispiel" heißt übersetzt in englischen "Example"), so sollte der auf en.contaowiki.org erstellende Artikel somit heißen: <nowiki>http://en.contaowiki.org/Example</nowiki>.
==Text übersetzen==
Nun geht es daran, den Text zu übersetzen. Man sollte daran denken, dass die im Ursprungsartikel verlinkten weiteren Artikel in der neuen Sprache vermutlich einen anderen Namen haben werden. Diese Artikel sollte man dann suchen und, sofern noch nicht existent, unter neuem Namen ebenfalls verlinken. Dies erzeugt einen roten Link und fungiert somit als Platzhalter für den Artikel, welcher dann in der Liste der [[Spezial:Gewünschte_Seiten|gewünschten Seiten]] auftaucht. Wenn man möchte, kann man die jeweiligen Artikel dann logischerweise auch gleich im Anschluss ebenfalls übersetzen.
==Verlinkungen zwischen den Sprachen setzen==
Abschließend muss den Wikis noch mitgeteilt werden, unter welchem Namen die Übersetzung in der anderen Sprache zu erreichen ist.
Hierzu verwendet man die Interwiki-Notation, wie bei Wikipedia und ähnlichen Projekten.

Im deutschen Wiki schreibt man auf der Seite "Beispiel":

<nowiki>[[en:Example]]</nowiki>
und im englischen auf der Seite "Example":

<nowiki>[[de:Beispiel]]</nowiki>

Datei:Stub-warning.png

2010-10-02T17:59:36Z

Marc: Ein Beispiel der STUB-Warnung (unvollständiger Artikel) als artefaktlose PNG-Datei

Ein Beispiel der STUB-Warnung (unvollständiger Artikel) als artefaktlose PNG-Datei

Vorlage:AppliesTo

2010-10-02T14:44:35Z

Marc: margin der Tabelle entfernt da nicht (mehr) notwendig, störend

<div class="appliesto" style="float:right;">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''betrifft'''
|-
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{Extensions|}}} | {{tableitem|heading=Extensions|value={{{Extensions|}}}}} | {{tableempty}} }}
{{ #if: {{{Ext1|}}} | {{tableitem|heading=Extensions|value={{ #foreach: Ext$n$ | {{{Ext$n$}}}<br/> }}}} | {{tableempty}} }}
|}
</div>
<noinclude>


Diese Vorlage ermöglicht es, eine Kurzübersicht über die Umgebung zu definieren, welche einen Artikel betreffen.

'''Achtung! Neue Verwendung:'''
<pre><nowiki>
{{AppliesTo
| Version=Die betroffene(n) Contao Version(en)
| Ext1=Erste Extension
| Ext2=Zweite Extension
| ... weitere Extensions je nach Notwendigkeit.
}}
</nowiki></pre>

Bsp:
<pre><nowiki>
{{AppliesTo
| Version=2.9.0-2.9.2
| Extensions=Die betroffenen Extensions als Liste
}}
</nowiki></pre>

Alte Methode (Extensions in einem Parameter):
<pre><nowiki>
{{AppliesTo
| Version=Die betroffene(n) Contao Version(en)
| Extensions=Die betroffenen Extensions als Liste
}}
</nowiki></pre>
Bsp:
<pre><nowiki>
{{AppliesTo
| Version=2.9.0-2.9.2
| Extensions=Die betroffenen Extensions als Liste
}}
</nowiki></pre>

[[Category: Vorlagen]]
</noinclude>

Visitors

2010-10-02T14:37:19Z

Marc: Vielen Dank für Ihre Aufmerksamkeit :p

[[File:Modul_visitors_fe_all.jpg|right|Besucher]]Ein kleines Modul welches die Zugriffe (Hits) und Besucher (Visits) zählt und zur Anzeige bringt.<br />
Dabei wird in der Anzeige getrennt angezeigt die Zugriffe/Besucher vom aktuellem Tag sowie die jeweilige Gesamtzahl.<br />
Der Zugriffszähler wird, wie der Name schon sagt, bei jedem Zugriff erhöht. Der Besucherzähler zeigt die Zahl der unterschiedlichen IP-Adressen, die innerhalb von 30 Minuten eine oder mehrere Seiten angefordert haben auf dem sich das Modul befindet.<br >

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=2.1.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.4 (siehe Installationshinweise)
| Depending=[[Bot Detection|Bot Detection]]
| ERLink=http://www.contao.org/erweiterungsliste/view/visitors.de.html
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
| TrackerLink=http://dev.typolight-forge.org/projects/visitors/issues
| Comment=Version für Contao 2.9 verfügbar
}}
[[en:Visitors]]
[[Kategorie:Extensions]]

=Forum=
Fragen zum Visitors Modul werden im Forum beantwortet: [http://www.contao-community.de/forumdisplay.php?28-visitors Forum - Subforen beliebter Third-Party Erweiterungen (Extensions) - Visitors]
<br />
Fehler und Wünsche können im [http://dev.typolight-forge.org/projects/visitors/issues Tracking System] gemeldet werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao Installation.<br />
Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/erweiterungsliste/view/visitors.html vom Extension Repository laden], entpacken und entsprechend übertragen.<br />
Dadurch sollte ein Verzeichnis /system/modules/visitors angelegt worden sein.<br />
Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen.<br />
( /typolight/install.php bei älteren TYPOlight Installationen )<br /><br />
<span style="color:red">'''''Da das Visitors Modul abhängig ist vom Modul "[[Bot Detection|Bot Detection]]", muss dieses bei der manuellen Installation mit installiert werden.'''''</span>

==Hinweis für ältere TYPOlight Versionen==
===TYPOlight 2.8===
Nutzer von TYPOlight 2.8.x nutzen bitte Visitors Modul Version 1.7.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10070019.de.html Direktlink])
===TYPOlight 2.7===
Nutzer von TYPOlight 2.7.x nutzen bitte Visitors Modul Version 1.4.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10040019.de.html Direktlink])
<br /><br />
==Update von Version 1.x auf Version 2.x==
{{Achtung|Die Version 2.x ist nicht vollständig kompatibel, ein Update ist aber möglich.}}
<br />
Was dabei zu beachten ist, kann hier nachgelesen werden.
*[[Visitors_Update_v1_auf_v2|'''Visitors Update Version 1 auf Version 2''']]
<br />

=Übersicht=
Das Visitors Modul bringt 2 Backend und ein Frontend Modul mit.<br />
Im Backend gibt es "Besucher" und "Besucher Statistik", für das Frontend ebenfalls "Besucher".

==Backend==

===Besucher===
[[Datei:Visitors_de_backend_besucher.jpg]]

===Besucher Statistik===
[[Datei:Visitors_de_backend_besucherstatistik.jpg]]

zeigt dann im Detail: (Klick aufs Bild für höhere Auflösung)
<gallery widths="240" heights="180" caption="Besucher Statistik">
File:Visitors_de_backend_besucherstatistikdetail.jpg|Besucher Statistik im Detail
File:Visitors_de_backend_besucherstatistikdetailBrowser.jpg|Browser Statistik
File:Visitors_de_backend_besucherstatistikdetailSearchEngine.jpg|Search Engine Referer Statistik
</gallery>

==Frontend==
Für das Frontend werden als Beispiel zwei CSS Dateien mitgeliefert:
*mod_visitors_fe.css für die normale, zeilenweise Ausgabe
*mod_visitors_fe_horizontal.css für die horizontale Ausgabe

===Besucher Statistik===
[[Datei:Modul_visitors_fe_all.jpg]]

===Besucher Statistik horizontal===
[[Datei:Modul_visitors_fe_all_horizontal.jpg]]

=Erste Schritte=
Als erstes legt man über den Menüpunkt Besucher eine neue Besucher Kategorie an. In dieser dann den Besucherzähler.<br />
Danach legt man ein Frontend Modul an und baut es in das Layout der Seite ein.<br />
Hier nun die einzelnen Schritte, jeweils mit den Default Angaben. Feinheiten werden [[Visitors#Feinheiten|später erklärt]].

==Anlegen einer Kategorie==
Um eine neue Besucher Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Besucher'. Im Hauptbereich dann auf den Button 'Neue Kategorie'.
[[Datei:Visitors_de_backend_kategorie_neu.jpg]]

Am Anfang reicht es einen Kategorie Namen anzugeben, anschließend klickt man auf "Speichern und Schließen".<br />
Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.

==Anlegen des Besucherzählers==
In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie.<br />
Dort entweder auf 'Neuer Besucherzähler' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie:
[[Datei:Visitors_de_backend_besucherzaehler_neu.jpg]]

Nun sind einige Angaben nötig:
* Namen angeben (wird über den Zahlen als Überschrift angezeigt).
* Start Datum, ist optional, dient nur zur Anzeige im Frontend
* Optional: 'Startwerte für Zähler' eingeben
* Optional: 'Besucher pro Tag' Anzeige aktivieren
* "Veröffentlicht" aktivieren
anschließend klickt man auf "Speichern und Schließen".

==Frontend Modul==
Ein neues Frontend Modul wird angelegt über:
* Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)
* Layout -> Module -> Neues Modul (TYPOlight bis 2.8.x)
<br />
Als erstes unbedingt '''zuerst den Titel''' eingeben, erst dann bei Modultyp: 'Verschiedenes'-'Besucher' auswählen. Es ändern sich nun die Formularfelder.<br />
Bei 'Besucher Kategorie' nun die vorher angelegte Kategorie auswählen, anschließend 'Speichern und Schließen'.<br />
<br />
Nun muss das angelegte Frontend Modul noch im Layout eingebunden werden:
* Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)
* Layout -> Seitenlayout -> Edit des genutzte Layouts (TYPOlight bis 2.8.x)

Bei 'Eingebundene Module' das gerade erstellte Frontend Modul einbinden (z.b in left)

==CSS Datei==
Wie erwähnt sind 2 CSS Dateien mitgeliefert für die Darstellung.<br />
Für die ersten Tests sollte die Datei <code>mod_visitors_fe.css</code> aus dem Verzeichnis <code>/system/modules/visitors</code> kopiert werden nach <code>/tl_files</code> und dann über das Backend importiert und im Layout aktiviert werden.

=Feinheiten=
Feinheiten sind einstellbar in der Kategorie, im Besucherzähler selbst sowie im selbst angelegtem Frontend Modul.

==Feinheiten in der Kategorie Definition==
===Zählweise===
Seit Version 1.6.0 kann die Zählweise bei eingeschaltetem Seiten Cache gewählt werden:
* Last Zählung, serverseitig durch Contao
* Lese Zählung, clientseitig durch Browser
** (nur im Contao cacheModus: Server- und Browsercache / Nur Browsercache)

Mit dem zweiten Punkt kann damit auch gezählt werden, wenn die Seite im Browsercache liegt und daraus aufgerufen wird.
Die System Einstellung 'Cache-Modus' wird dabei beachtet.

{{Anmerkung|Die Anzeige der aktuellen Werte erfolgt aber weiterhin nur wenn die Seite vom Server angefordert wird.}}

==Feinheiten in der Besucherzähler Definition==
===Blockzeit===
Die Blockzeit wird in Sekunden angegeben. Nach Zugriffspause dieser Zeit wird ein Zugriff als weiterer Besucher gezählt.<br />
Voreingetragen sind 1800 Sekunden, d.h. 30 Minuten.

==Feinheiten in der Frontend Modul Definition==
===Templates===
Jedem Modul kann per Auswahl ein Template zugeordnet werden. Zur Auswahl stehen 4 Templates.
* mod_visitors_fe_all
** Liefert alle Felder die möglich sind (siehe Beispielbild oben)
* mod_visitors_fe_hits
** Hier wurden die beiden Besucherzeilen entfernt
* mod_visitors_fe_visits
** Hier wurden die beiden Zugriffszeilen entfernt
* mod_visitors_fe_invisible.tpl
** Hier wird nichts angezeigt. Dieses Template dient dadurch zur reinen Zählung.

Es können eigene Templates erstellt werden. Diese müssen als Dateiname anfangen mit 'mod_visitors_fe_' und die Endung '.tpl' haben.

===Nur Gästen anzeigen===
Nach dem Aktivieren der Funktion wird das Modul versteckt, sobald ein Mitglied (Frontend Nutzer) angemeldet ist.

===Modul schützen===
Hier kann nun definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen online sind.

===Selbstzählung verhindern===
Es gab einige Ideen, wie man noch verhindern kann, eigene Zugriffe nicht zu zählen. Besonders, wenn man mit dynamischen IPs ankommt.
Hier ist nun eine Möglichkeit umgesetzt, dieses über einen angepassten User Agent String des Browsers zu tun.
<br />
Über:
* Layout -> Themes -> Frontend Module -> Modul Name (Contao ab 2.9)
* Layout -> Module -> Modul Name (TYPOlight bis 2.8.x)
vom angelegtem Besucher Modul kann im neuem Feld "Keine Zählung bei HTTP_USER_AGENT Teilkennung:" einen String eingegeben werden, dieser sollte eindeutig sein.<br />
Beispiel: CTISOK<br />
Es sind, wozu auch immer, auch mehrere Strings dort möglich, diese dann durch Komma getrennt eingeben.<br />
Im Firefox ergänzt man nun den Agent String wie folgt:<br />
# Tippe '''about:config''' in der Adresszeile ein und drücke ENTER
# Tippe '''general.useragent.extra.firefox''' in der Filter Zeile
# Doppelklick auf die gefunde Zeile
# Hier nun den Beispiel String von oben mit Leerzeichen getrennt anhängen, OK

z.B. wird so aus "Firefox/3.5.2" nun "Firefox/3.5.2 CTISOK"<br />
<br />
Die Kennung kann man sich dann durch Eingabe von '''about:''' + Enter anzeigen lassen. (letzte Zeile)<br />
<br />
Weitere Browser sind hier erläutert (eng):
[http://www.walkernews.net/2007/07/05/how-to-change-user-agent-string/ walkernews.net - how to change user agent string]

=Insert-Tags=
==Anzeige==
Seit der Version 1.2.0 gibt es Insert-Tags zum Anzeigen der Werte.
<source lang="text">
{{visitors::katid::name}}
{{visitors::katid::online}}
{{visitors::katid::start}}
{{visitors::katid::totalvisit}}
{{visitors::katid::totalhit}}
{{visitors::katid::todayvisit}}
{{visitors::katid::todayhit}}
{{visitors::katid::averagevisits}}
</source>
Seit der Version 1.5.0 und ab TYPOlight 2.8 können die Insert-Tags um den Präfix 'cache_' erweitert werden, damit sind diese dann auch cachesicher.
<source lang="text">
{{cache_visitors::katid::name}}
...
</source>
Das Modul zählt und zeigt normalerweise die Werte an. Wer für die Anzeige die Insert-Tags nutzen will, braucht das Modul weiterhin, aber nur zum Zählen. Mittels des Templates mod_visitors_fe_invisible kann es dazu unsichtbar geschaltet werden.<br />
Die "katid" ist die Kategorie ID in dem der Zähler angelegt wurde. Zur Ermittlung in der Kategorieübersicht des Moduls mit der Maus über das "i" gehen.

[[Datei:Visitors_de_backend_kategorie_id.jpg|Besucherzähler Kategorie ID]]

Dabei wird als Tooltipp die ID angezeigt.<br />
Oder das "i" anklicken, in der drauf folgenden Seite steht in der ersten Zeile die ID.<br />
Bei Kategorie ID = 1 wäre das dann also beispielsweise:<br />
<source lang="text">
{{visitors::1::online}}
</source>

<br />

==Zählung==
Eine Alternative für "nur zählen" wäre, den Insert-Tag zu nutzen den es ab Version 1.5.0 gibt, das Modul selbst verwendet diesen ebenfalls:
<source lang="text">
{{cache_visitors::katid::count}}
</source>
Beispiel für Einbau in einen Artikel (für Kategorie ID = 1):
<source lang="html4strict">
<span style="width:0px;height:0px;">{{cache_visitors::1::count}}</span>
</source>

{{Achtung|Dabei muss drauf geachtet werden, dass der Insert-Tag für die Zählung als erstes auf der Seite eingebaut wird, damit die Zählung vor der Ermittlung der Anzeigewerte erfolgt.}}

<br />

==Weitere Insert-Tags==
Seit der Version 2.1.0 gibt es Insert-Tags zum Anzeigen der Werte vom Tag an dem die meisten Besucher gezählt wurden.
<source lang="text">
{{visitors::katid::bestday::date}} - Tag (Datum) mit den meisten Besuchern
{{visitors::katid::bestday::visits}} - Anzahl Besucher vom Tag mit den meisten Besuchern
{{visitors::katid::bestday::hits}} - Anzahl Zugriffe vom Tag mit den meisten Besuchern
bzw.
{{cache_visitors::katid::bestday::date}}
{{cache_visitors::katid::bestday::visits}}
{{cache_visitors::katid::bestday::hits}}
</source>
Beim "date" Insert-Tag ist noch ein optionaler Parameter möglich, um die Datumsausgabe zu formatieren.(m.d.Y , Y-m-d, etc.)<br />
Als default wird die Systemeinstellung verwendet. Als Trennzeichen muss ein "::" verwendet werden.<br />
Ein komplettes Beispiel (hier mit Kategorie 1):
<source lang="text">
BestDay: {{visitors::1::bestday::date::j. F Y}} mit {{visitors::1::bestday::visits}} Besuchern (bei {{visitors::1::bestday::hits}} Hits)
</source>
ergibt:
BestDay: 31. August 2010 mit 25 Besuchern (bei 123 Hits)

<br />

=Besonderheiten=
==Keine Zählung==
Es wird kein Frontend Aufruf gezählt, wenn man dabei gleichzeitig im Backend angemeldet ist.
<br />

==Besucher pro Tag: Ø = 0==
Der Durschnittswert pro Tag wird pro vollständigem Kalendertag berechnet.<br />
Hat man nun nur von einem Tag vorher oder gar nur vom aktuellem Tag eine Zählung, kann kein sinnvoller Wert berechnet werden.<br />
(Durschnitt = Anzahl Besucher)<br />
In diesen Fällen wird "0" angezeigt.
<br /><br />

----
--[[Benutzer:BugBuster|BugBuster]] 19:54, 25. Jun. 2010 (UTC)

Visitors

2010-10-02T14:36:26Z

Marc: Kurzer Test wegen der floatright geschichte

[[File:Modul_visitors_fe_all.jpg|left|Besucher]]Ein kleines Modul welches die Zugriffe (Hits) und Besucher (Visits) zählt und zur Anzeige bringt.<br />
Dabei wird in der Anzeige getrennt angezeigt die Zugriffe/Besucher vom aktuellem Tag sowie die jeweilige Gesamtzahl.<br />
Der Zugriffszähler wird, wie der Name schon sagt, bei jedem Zugriff erhöht. Der Besucherzähler zeigt die Zahl der unterschiedlichen IP-Adressen, die innerhalb von 30 Minuten eine oder mehrere Seiten angefordert haben auf dem sich das Modul befindet.<br >

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=2.1.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.4 (siehe Installationshinweise)
| Depending=[[Bot Detection|Bot Detection]]
| ERLink=http://www.contao.org/erweiterungsliste/view/visitors.de.html
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
| TrackerLink=http://dev.typolight-forge.org/projects/visitors/issues
| Comment=Version für Contao 2.9 verfügbar
}}
[[en:Visitors]]
[[Kategorie:Extensions]]

=Forum=
Fragen zum Visitors Modul werden im Forum beantwortet: [http://www.contao-community.de/forumdisplay.php?28-visitors Forum - Subforen beliebter Third-Party Erweiterungen (Extensions) - Visitors]
<br />
Fehler und Wünsche können im [http://dev.typolight-forge.org/projects/visitors/issues Tracking System] gemeldet werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao Installation.<br />
Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/erweiterungsliste/view/visitors.html vom Extension Repository laden], entpacken und entsprechend übertragen.<br />
Dadurch sollte ein Verzeichnis /system/modules/visitors angelegt worden sein.<br />
Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen.<br />
( /typolight/install.php bei älteren TYPOlight Installationen )<br /><br />
<span style="color:red">'''''Da das Visitors Modul abhängig ist vom Modul "[[Bot Detection|Bot Detection]]", muss dieses bei der manuellen Installation mit installiert werden.'''''</span>

==Hinweis für ältere TYPOlight Versionen==
===TYPOlight 2.8===
Nutzer von TYPOlight 2.8.x nutzen bitte Visitors Modul Version 1.7.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10070019.de.html Direktlink])
===TYPOlight 2.7===
Nutzer von TYPOlight 2.7.x nutzen bitte Visitors Modul Version 1.4.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10040019.de.html Direktlink])
<br /><br />
==Update von Version 1.x auf Version 2.x==
{{Achtung|Die Version 2.x ist nicht vollständig kompatibel, ein Update ist aber möglich.}}
<br />
Was dabei zu beachten ist, kann hier nachgelesen werden.
*[[Visitors_Update_v1_auf_v2|'''Visitors Update Version 1 auf Version 2''']]
<br />

=Übersicht=
Das Visitors Modul bringt 2 Backend und ein Frontend Modul mit.<br />
Im Backend gibt es "Besucher" und "Besucher Statistik", für das Frontend ebenfalls "Besucher".

==Backend==

===Besucher===
[[Datei:Visitors_de_backend_besucher.jpg]]

===Besucher Statistik===
[[Datei:Visitors_de_backend_besucherstatistik.jpg]]

zeigt dann im Detail: (Klick aufs Bild für höhere Auflösung)
<gallery widths="240" heights="180" caption="Besucher Statistik">
File:Visitors_de_backend_besucherstatistikdetail.jpg|Besucher Statistik im Detail
File:Visitors_de_backend_besucherstatistikdetailBrowser.jpg|Browser Statistik
File:Visitors_de_backend_besucherstatistikdetailSearchEngine.jpg|Search Engine Referer Statistik
</gallery>

==Frontend==
Für das Frontend werden als Beispiel zwei CSS Dateien mitgeliefert:
*mod_visitors_fe.css für die normale, zeilenweise Ausgabe
*mod_visitors_fe_horizontal.css für die horizontale Ausgabe

===Besucher Statistik===
[[Datei:Modul_visitors_fe_all.jpg]]

===Besucher Statistik horizontal===
[[Datei:Modul_visitors_fe_all_horizontal.jpg]]

=Erste Schritte=
Als erstes legt man über den Menüpunkt Besucher eine neue Besucher Kategorie an. In dieser dann den Besucherzähler.<br />
Danach legt man ein Frontend Modul an und baut es in das Layout der Seite ein.<br />
Hier nun die einzelnen Schritte, jeweils mit den Default Angaben. Feinheiten werden [[Visitors#Feinheiten|später erklärt]].

==Anlegen einer Kategorie==
Um eine neue Besucher Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Besucher'. Im Hauptbereich dann auf den Button 'Neue Kategorie'.
[[Datei:Visitors_de_backend_kategorie_neu.jpg]]

Am Anfang reicht es einen Kategorie Namen anzugeben, anschließend klickt man auf "Speichern und Schließen".<br />
Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.

==Anlegen des Besucherzählers==
In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie.<br />
Dort entweder auf 'Neuer Besucherzähler' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie:
[[Datei:Visitors_de_backend_besucherzaehler_neu.jpg]]

Nun sind einige Angaben nötig:
* Namen angeben (wird über den Zahlen als Überschrift angezeigt).
* Start Datum, ist optional, dient nur zur Anzeige im Frontend
* Optional: 'Startwerte für Zähler' eingeben
* Optional: 'Besucher pro Tag' Anzeige aktivieren
* "Veröffentlicht" aktivieren
anschließend klickt man auf "Speichern und Schließen".

==Frontend Modul==
Ein neues Frontend Modul wird angelegt über:
* Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)
* Layout -> Module -> Neues Modul (TYPOlight bis 2.8.x)
<br />
Als erstes unbedingt '''zuerst den Titel''' eingeben, erst dann bei Modultyp: 'Verschiedenes'-'Besucher' auswählen. Es ändern sich nun die Formularfelder.<br />
Bei 'Besucher Kategorie' nun die vorher angelegte Kategorie auswählen, anschließend 'Speichern und Schließen'.<br />
<br />
Nun muss das angelegte Frontend Modul noch im Layout eingebunden werden:
* Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)
* Layout -> Seitenlayout -> Edit des genutzte Layouts (TYPOlight bis 2.8.x)

Bei 'Eingebundene Module' das gerade erstellte Frontend Modul einbinden (z.b in left)

==CSS Datei==
Wie erwähnt sind 2 CSS Dateien mitgeliefert für die Darstellung.<br />
Für die ersten Tests sollte die Datei <code>mod_visitors_fe.css</code> aus dem Verzeichnis <code>/system/modules/visitors</code> kopiert werden nach <code>/tl_files</code> und dann über das Backend importiert und im Layout aktiviert werden.

=Feinheiten=
Feinheiten sind einstellbar in der Kategorie, im Besucherzähler selbst sowie im selbst angelegtem Frontend Modul.

==Feinheiten in der Kategorie Definition==
===Zählweise===
Seit Version 1.6.0 kann die Zählweise bei eingeschaltetem Seiten Cache gewählt werden:
* Last Zählung, serverseitig durch Contao
* Lese Zählung, clientseitig durch Browser
** (nur im Contao cacheModus: Server- und Browsercache / Nur Browsercache)

Mit dem zweiten Punkt kann damit auch gezählt werden, wenn die Seite im Browsercache liegt und daraus aufgerufen wird.
Die System Einstellung 'Cache-Modus' wird dabei beachtet.

{{Anmerkung|Die Anzeige der aktuellen Werte erfolgt aber weiterhin nur wenn die Seite vom Server angefordert wird.}}

==Feinheiten in der Besucherzähler Definition==
===Blockzeit===
Die Blockzeit wird in Sekunden angegeben. Nach Zugriffspause dieser Zeit wird ein Zugriff als weiterer Besucher gezählt.<br />
Voreingetragen sind 1800 Sekunden, d.h. 30 Minuten.

==Feinheiten in der Frontend Modul Definition==
===Templates===
Jedem Modul kann per Auswahl ein Template zugeordnet werden. Zur Auswahl stehen 4 Templates.
* mod_visitors_fe_all
** Liefert alle Felder die möglich sind (siehe Beispielbild oben)
* mod_visitors_fe_hits
** Hier wurden die beiden Besucherzeilen entfernt
* mod_visitors_fe_visits
** Hier wurden die beiden Zugriffszeilen entfernt
* mod_visitors_fe_invisible.tpl
** Hier wird nichts angezeigt. Dieses Template dient dadurch zur reinen Zählung.

Es können eigene Templates erstellt werden. Diese müssen als Dateiname anfangen mit 'mod_visitors_fe_' und die Endung '.tpl' haben.

===Nur Gästen anzeigen===
Nach dem Aktivieren der Funktion wird das Modul versteckt, sobald ein Mitglied (Frontend Nutzer) angemeldet ist.

===Modul schützen===
Hier kann nun definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen online sind.

===Selbstzählung verhindern===
Es gab einige Ideen, wie man noch verhindern kann, eigene Zugriffe nicht zu zählen. Besonders, wenn man mit dynamischen IPs ankommt.
Hier ist nun eine Möglichkeit umgesetzt, dieses über einen angepassten User Agent String des Browsers zu tun.
<br />
Über:
* Layout -> Themes -> Frontend Module -> Modul Name (Contao ab 2.9)
* Layout -> Module -> Modul Name (TYPOlight bis 2.8.x)
vom angelegtem Besucher Modul kann im neuem Feld "Keine Zählung bei HTTP_USER_AGENT Teilkennung:" einen String eingegeben werden, dieser sollte eindeutig sein.<br />
Beispiel: CTISOK<br />
Es sind, wozu auch immer, auch mehrere Strings dort möglich, diese dann durch Komma getrennt eingeben.<br />
Im Firefox ergänzt man nun den Agent String wie folgt:<br />
# Tippe '''about:config''' in der Adresszeile ein und drücke ENTER
# Tippe '''general.useragent.extra.firefox''' in der Filter Zeile
# Doppelklick auf die gefunde Zeile
# Hier nun den Beispiel String von oben mit Leerzeichen getrennt anhängen, OK

z.B. wird so aus "Firefox/3.5.2" nun "Firefox/3.5.2 CTISOK"<br />
<br />
Die Kennung kann man sich dann durch Eingabe von '''about:''' + Enter anzeigen lassen. (letzte Zeile)<br />
<br />
Weitere Browser sind hier erläutert (eng):
[http://www.walkernews.net/2007/07/05/how-to-change-user-agent-string/ walkernews.net - how to change user agent string]

=Insert-Tags=
==Anzeige==
Seit der Version 1.2.0 gibt es Insert-Tags zum Anzeigen der Werte.
<source lang="text">
{{visitors::katid::name}}
{{visitors::katid::online}}
{{visitors::katid::start}}
{{visitors::katid::totalvisit}}
{{visitors::katid::totalhit}}
{{visitors::katid::todayvisit}}
{{visitors::katid::todayhit}}
{{visitors::katid::averagevisits}}
</source>
Seit der Version 1.5.0 und ab TYPOlight 2.8 können die Insert-Tags um den Präfix 'cache_' erweitert werden, damit sind diese dann auch cachesicher.
<source lang="text">
{{cache_visitors::katid::name}}
...
</source>
Das Modul zählt und zeigt normalerweise die Werte an. Wer für die Anzeige die Insert-Tags nutzen will, braucht das Modul weiterhin, aber nur zum Zählen. Mittels des Templates mod_visitors_fe_invisible kann es dazu unsichtbar geschaltet werden.<br />
Die "katid" ist die Kategorie ID in dem der Zähler angelegt wurde. Zur Ermittlung in der Kategorieübersicht des Moduls mit der Maus über das "i" gehen.

[[Datei:Visitors_de_backend_kategorie_id.jpg|Besucherzähler Kategorie ID]]

Dabei wird als Tooltipp die ID angezeigt.<br />
Oder das "i" anklicken, in der drauf folgenden Seite steht in der ersten Zeile die ID.<br />
Bei Kategorie ID = 1 wäre das dann also beispielsweise:<br />
<source lang="text">
{{visitors::1::online}}
</source>

<br />

==Zählung==
Eine Alternative für "nur zählen" wäre, den Insert-Tag zu nutzen den es ab Version 1.5.0 gibt, das Modul selbst verwendet diesen ebenfalls:
<source lang="text">
{{cache_visitors::katid::count}}
</source>
Beispiel für Einbau in einen Artikel (für Kategorie ID = 1):
<source lang="html4strict">
<span style="width:0px;height:0px;">{{cache_visitors::1::count}}</span>
</source>

{{Achtung|Dabei muss drauf geachtet werden, dass der Insert-Tag für die Zählung als erstes auf der Seite eingebaut wird, damit die Zählung vor der Ermittlung der Anzeigewerte erfolgt.}}

<br />

==Weitere Insert-Tags==
Seit der Version 2.1.0 gibt es Insert-Tags zum Anzeigen der Werte vom Tag an dem die meisten Besucher gezählt wurden.
<source lang="text">
{{visitors::katid::bestday::date}} - Tag (Datum) mit den meisten Besuchern
{{visitors::katid::bestday::visits}} - Anzahl Besucher vom Tag mit den meisten Besuchern
{{visitors::katid::bestday::hits}} - Anzahl Zugriffe vom Tag mit den meisten Besuchern
bzw.
{{cache_visitors::katid::bestday::date}}
{{cache_visitors::katid::bestday::visits}}
{{cache_visitors::katid::bestday::hits}}
</source>
Beim "date" Insert-Tag ist noch ein optionaler Parameter möglich, um die Datumsausgabe zu formatieren.(m.d.Y , Y-m-d, etc.)<br />
Als default wird die Systemeinstellung verwendet. Als Trennzeichen muss ein "::" verwendet werden.<br />
Ein komplettes Beispiel (hier mit Kategorie 1):
<source lang="text">
BestDay: {{visitors::1::bestday::date::j. F Y}} mit {{visitors::1::bestday::visits}} Besuchern (bei {{visitors::1::bestday::hits}} Hits)
</source>
ergibt:
BestDay: 31. August 2010 mit 25 Besuchern (bei 123 Hits)

<br />

=Besonderheiten=
==Keine Zählung==
Es wird kein Frontend Aufruf gezählt, wenn man dabei gleichzeitig im Backend angemeldet ist.
<br />

==Besucher pro Tag: Ø = 0==
Der Durschnittswert pro Tag wird pro vollständigem Kalendertag berechnet.<br />
Hat man nun nur von einem Tag vorher oder gar nur vom aktuellem Tag eine Zählung, kann kein sinnvoller Wert berechnet werden.<br />
(Durschnitt = Anzahl Besucher)<br />
In diesen Fällen wird "0" angezeigt.
<br /><br />

----
--[[Benutzer:BugBuster|BugBuster]] 19:54, 25. Jun. 2010 (UTC)

Safemode Hack

2010-09-12T18:08:09Z

Marc: Dem pre mit dem PHP-Code die Klasse mw-geshi zugewiesen

{{stub}}
[[Category:Installation und Updates]]
[[Category:Fehlersuche]]
=Contao Safemode Hack (SMH)=
==Definition des SMH==
Der Contao-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei ''system/config/localconfig.php'' nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die ''localconfig.php'' entsprechend anzupassen, damit Contao die Datei beschreiben kann.

Ist man wirklich in der misslichen Lage, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] durchlaufen lassen.

{{Anmerkung|Es ist empfehlenswert, wenn man den Safemode Hack verwenden muss, einen weiteren FTP-User zu erstellen, der exklusive Rechte - eingeschränkt auf die Contao-Installation - auf dem Server hat. Dies hat vor allem Sicherheitsrelevante Hintergründe, da bei einem übernommenen System nur die Contao Installation betroffen wäre, und nicht etwa der gesamte FTP-Server.}}

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre class="mw-geshi">
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/contao/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst - erstellten Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die Contao-Installation liegt auf dem Server im Ordern ''dev/cms/contao/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/contao/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''contao/'' anzugeben.
Dies ist auch völlig unabhängig von etwaigen Subdomains, die man eingerichtet hat, da der Safemode Hack in Relation zum FTP-Server und nicht in Relation zur Domain/dem Apache steht.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordnern (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen und diese zu verändern, wart aber dennoch ein gewisses Maß an Sicherheit, da ein Außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt, nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü ''Tools -> Besitzrechte''. Dort stellt man den User vom FTP-User (idR der Zugangsname zum KAS) zum PHP-User und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil; man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den User bei einem Dateiupload über FTP im KAS wieder umzustellen. Man kann aber dennoch das Dateiverwaltungssystem von Contao verwenden, um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Vorlage:Hinweis

2010-09-12T17:23:52Z

Marc: span.title für bessere Formatierung && eine td weniger wegen der Kontinuität

<div class="hint infotext" >
{| cellpadding="2" cellspacing="0" style="text-align: left; border: 1px solid #C9AFFF; background-color: #ddddff"
| [[File:Hinweis.png]] || <span class="title">'''Hinweis:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Kein Hinweis angegeben }}
|}
</div>
<noinclude>

Diese Vorlage wird verwendet um einen Hinweis innerhalb eines Artikels zu formatieren.

<pre><nowiki>
{{Hinweis
|Text des Hinweises
}}
</nowiki></pre>
[[Category:Vorlagen]]
[[en:Template:Hint]]
</noinclude>

Vorlage:Achtung

2010-09-12T17:22:44Z

Marc: span.title für bessere Formatierung

<div class="caution infotext">
{| style="border-bottom: 1px solid #C9AFFF; border-top: 1px solid #C9AFFF; background-color: #ddddff"
| [[Bild:Achtung.png]] || <span class="title">'''Achtung:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Der Text dieser Anmerkung fehlt }}
|}
</div>
<noinclude>
[[Category: Vorlagen]]
Diese Vorlage ermöglicht es, einen Warnhinweis zu definieren.
<pre><nowiki>
{{Achtung |Der Text
}}
</nowiki></pre>
</noinclude>

Vorlage:Stub

2010-09-12T17:20:55Z

Marc: span.title für bessere Formatierung

<div class="stub" align="center" style="margin-bottom:30px;">
{| cellpadding="2" cellspacing="0" style="text-align: left; border: 1px solid #C9AFFF; background-color: #ddddff"
| | [[Bild:Stub.png]] || <span class="title">'''Unvollständiger Artikel:'''</span> dieser Artikel ist noch nicht sauber bearbeitet.
Bitte [{{fullurl:{{FULLPAGENAME}}|action=edit}} erweitere ihn] und entferne erst anschliessend diesen Hinweis.<includeonly>[[Category:Stub]]</includeonly>
|}
</div>
<noinclude>
Diese Vorlage kategorisiert alle Artikel die sie verwenden in die Kategorie [[:Category:Stub|Stub]].

Verwende Sie um unvollständige Artikel zu markieren.
[[Category: Vorlagen]]
</noinclude>

Vorlage:Anmerkung

2010-09-12T17:17:48Z

Marc: mani schau mal so ists doch nett? :D

<div class="comment infotext">
{| cellpadding="2" cellspacing="0" style="text-align: left; border: 1px solid #C9AFFF; background-color: #ddddff"
| [[Bild:Anmerkung.png]] || <span class="title">'''Anmerkung:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Text fehlt }}
|}
</div>
<noinclude>

Diese Vorlage ermöglicht es, eine kurze Anmerkung zu definieren.

<pre><nowiki>
{{Anmerkung
|Text der Anmerkung
}}
</nowiki></pre>
[[Category: Vorlagen]]
</noinclude>

Vorlage:Anmerkung

2010-09-12T16:51:21Z

Marc: Klasse in die DIV

<div class="comment infotext">
{| cellpadding="2" cellspacing="0" style="text-align: left; border: 1px solid #C9AFFF; background-color: #ddddff"
| [[Bild:Anmerkung.png]] || '''Anmerkung:''' {{ #if: {{{1|}}} | {{{1|}}} | Text fehlt }}
|}
</div>
<noinclude>

Diese Vorlage ermöglicht es, eine kurze Anmerkung zu definieren.

<pre><nowiki>
{{Anmerkung
|Text der Anmerkung
}}
</nowiki></pre>
[[Category: Vorlagen]]
</noinclude>

Vorlage:Anmerkung

2010-09-12T16:50:11Z

Marc: Ein td weniger - wegen der Konsistenz (siehe caution)

<div>
{| class="comment infotext" cellpadding="2" cellspacing="0" style="text-align: left; border: 1px solid #C9AFFF; background-color: #ddddff"
| [[Bild:Anmerkung.png]] || '''Anmerkung:''' {{ #if: {{{1|}}} | {{{1|}}} | Text fehlt }}
|}
</div>
<noinclude>

Diese Vorlage ermöglicht es, eine kurze Anmerkung zu definieren.

<pre><nowiki>
{{Anmerkung
|Text der Anmerkung
}}
</nowiki></pre>
[[Category: Vorlagen]]
</noinclude>

Chat HowTo

2010-05-29T14:38:04Z

Marc:

[[Category:Anwender_HOWTOS]]
=Einleitung=
Um an einem Chat in einem [[w:de:Internet_Relay_Chat|IRC-Netzwerk]] teilnehmen zu können, gibt es verschiedenste Programme für fast alle Betriebssysteme. Der (inoffizielle) Chatraum für das Content Management System Contao heist #contao (englischsprachig) bzw. #contao.de (deutschsprachig) und befindet sich im [http://www.freenode.net Freenode] Netzwerk.

=Zweck dieses Chats=
Der Chat dient zum Austausch mit anderen Usern, um Hilfe zu erfragen, zum Fachsimpeln oder einfach zum Smalltalk über das Tagesgeschehen. Er dient NICHT dazu, um sich bei Problemen Anleitungen vorlesen zu lassen oder sich die Forensuche zu ersparen!
{{Achtung|Einlog-Daten bzw Passwörter sollten NIE in den öffentlichen Chat-Raum gepostet werden. Wenn man jemandem z.B. die Zugangsdaten für sein Backend anvertrauen möchte, damit er sich ein Problem im Backend ansehen kann, sollten diese IMMER in einem privaten Chat-Raum bekanntgegeben werden. Siehe auch [[#Privater_Chat]]}}

=Firefox mit Chatzilla=
Das hier verfasste Howto bezieht sich auf das Firefox-Addon Chatzilla, da [http://www.mozilla-europe.org/de/firefox/ Firefox] ein weit verbreiteter Browser ist und für verschiedenste Betriebssysteme erhältlich ist.
==Chatzilla installieren==
Firefox bietet die Möglichkeit, seine Funktionen mittels Addons zu erweitern. Um das Addon Chatzilla zu installieren, öffnet man Firefox und folgt [https://addons.mozilla.org/de/firefox/addon/16/ diesen Link] und klickt auf den Button "Jetzt Herunterladen". Nach der Installation muss Firefox neu gestartet werden.

==Chatzilla einrichten==
Nach der Installation und dem Neustart des Browsers müssen noch ein paar Grundeinstellungen gemacht werden, um zum Freenode-Netzwerk verbinden zu können.

[[Datei:chat-howto-01.png|Firefox Addonmanager]]

Das Addons findet man über den Addon-Manager (Menüleiste Extras --> Addons).

[[Datei:chat-howto-02.png|Chatzilla Einstellungen]]

Im Addon-Manager das Plugin "Chatzilla" auswählen und auf "Einstellungen" klicken.

[[Datei:chat-howto-03.png|Chatzilla einrichten]]

Auf der Registrierkarte "General" findet man die Felder "Description" (Beschreibung), Nickname und Username.Description ist frei wählbar, unter Nickname und Username gibt man seinen Nicknamen ein. Im Anschluss werden alle Fenster mit OK bestätigt.

==Chatzilla verwenden==

[[Datei:chat-howto-04.png|Chatzilla starten]]

Chatzilla wird über die Menüleiste Extras --> Chatzilla gestartet.

[[Datei:chat-howto-05.png|Chatzilla Startfenster]]

Chatzilla hat von Haus aus verschiedene Netzwerke gespeichert. Um mit einem Server des Freenode-Netzwerkes zu verbinden, klickt man entweder mit der Maus auf den Link "Freenode" oder gibt in der Texteingabeleiste folgenden Befehl ein und klickt Enter:
<pre>/server irc.freenode.net</pre>
{{Anmerkung|Vor dem Verbinden muss bei vorhandenen Firewalls der Port 6667 geöffnet werden}}

[[Datei:chat-howto-06.png|Serverfenster]]

Es öffnet sich ein neuer Tab namens "Freenode" und der Verbindungsaufbau beginnt. Der Verbindungsaufbau kann mehrere Sekunden dauern und wird durch ein oranges "Connecting" angezeigt.

[[Datei:chat-howto-07.png|Verbindungsaufbau]]

Wenn die Verbindung zum Server hergestellt wurde, zeigt Chatzilla dies mit einem grünen "Connecting". Als letzter Schritt muss der Chatraum betreten werden. Um den Raum #contao bzw. #contao.de zu betreten, gibt man folgenden Befehl in die Texteingabeleiste ein und bestätigt mit "Enter":
<pre>/join #contao</pre>

[[Datei:chat-howto-08.png|Raumfenster]]

Das Chatfenster öffnet sich in einem neuen Tab und ist wie folgt eingeteilt.
# Tab für den Raum #contao (bzw. #contao.de)
# Texteingabeleiste: Text eingeben und Enter drücken
# Liste der im Raum befindlichen User
# Chatfenster: Hier werden die geschrieben Texte angezeigt

=Opera=
Anders als Firefox hat Opera schon ein Chat-Programm integriert. Die Installation einer Drittanbieter-Software entfällt somit.
==Opera einrichten==

[[Datei:chat-howto-10.png|Opera Chat-Konto einrichten]]

Bevor man mit Opera loschatten kann, müssen auch hier ein paar Einstellungen gesetzt werden. Zum Einrichten eines Chat-Kontos klickt man mit der Maus auf das Opera-Logo links oben in der Ecke und wählt anschließend den Punkt "E-Mail- und Chat-Konten...".

[[Datei:chat-howto-11.png|Opera Assistent]]

Die anschließende Frage zum Erstellen eines Kontos bestätigt man mit "Ja".

[[Datei:chat-howto-12.png|Opera Kontotyp]]

Beim folgenden Fenster wird als Typ des Kontos "Chat (IRC)" gewählt und bestätigt anschließend mit "Weiter".

[[Datei:chat-howto-13.png|Opera Absendername]]
[[Datei:chat-howto-14.png|Opera Nickname]]

In den nächsten beiden Fenstern wird im Feld "Von (Absendername)" und "Nickname" der Nickname eingegeben. Eine Email-Adresse ist nicht zwingend erforderlich.

[[Datei:chat-howto-15.png|Opera Serverauswahl]]

Als nächstes muss der Server gewählt werden, auf den verbunden werden soll. Hier wählt man "FreeNode, Europa" und bestätigt die Eingabe mit einem Klick auf den Button "Fertig".

[[Datei:chat-howto-16.png|Opera Chanlist Options]]

Die Einstellarbeiten sind nun fast abgeschlossen. Es wird eine Liste aller verfügbaren Räume angezeigt. Die vollständige Auflistung alles Räume kann einige Sekunden dauern. Ist die Auflistung abgeschlossen, klickt man mit der rechten Maustaste auf der linken Seite unter Konto auf den Eintrag "FreeNode, Europa" und wählt "Eigenschaften...".

[[Datei:chat-howto-17.png|Opera Konto-Eigenschaften]]

Im darauffolgenden Fenster "Konto-Eigenschaften wählt man im letzten Tab "Postausgang" unter Standardcodierung "utf-8" und bestätigt mit OK.

[[Datei:chat-howto-18.png|Opera Chanlist]]

Wieder zurück bei der Raumliste klickt man auf "Eintreten"....

[[Datei:chat-howto-19.png|Opera Chatraum betreten]]

... und gibt im Feld: Raum "contao" (bzw. contao.de) ein.

[[Datei:chat-howto-20.png|Opera Chatraum]]

Es öffnet sich der Chatraum. Dieser ist wie folgt eingeteilt:
# Texteingabeleiste: Text eingeben und Enter drücken
# Liste der im Raum befindlichen User
# Chatfenster: Hier werden die geschriebenen Texte angezeigt

==Opera verwenden==

Ist der Chat einmal eingerichtet, ist im Paneele das Chatsymbol sichtbar.

[[Datei:chat-howto-21.png|Opera Sidebar]]

Ein Klick auf dieses öffnet die Sidebar des Chats. Nun genügt ein Klick auf den Raum "contao", um diesen zu betreten.

=Nicknamen registrieren=

Ähnlich wie in einem Forum ist es möglich, sich seinen Benutzernamen zu registrieren. Die Vorteile einer Registration sind:
*Der Nickname kann von keinem anderen verwendet werden bzw. (je nach Einstellung) kann bei Verwendung durch einen Anderen auch gekickt werden.
*Man kann userspezifische Einstellungen machen
*Founder bzw OP's (vergleichbar mit einem Admin in einem Forum) können registrierten Nicks erweiterte Userrechte geben
Man KANN seinen Nicknamen registrieren, muss aber nicht !!!

Um zu prüfen, ob der gewählte Name noch frei ist, muss man mit dem Netzwerk verbunden sein. Ob man sich gerade in einen Channel befindet oder nicht, ist egal. Nun gibt man folgenden Befehl in die Texteingabeleiste ein und bestätigt mit Enter:
<pre>/msg nickserv info contaouser</pre>
{{Anmerkung|Für diese Anleitung wird der Benutzername "contaouser" verwendet und die Bilder mit Chatzilla gemacht. Für Opera gelten die selben Befehle.}}
Wenn der Benutzername noch frei ist, bekommt man die Antwort: contaouser is not registered

[[Datei:chat-howto-22.png|Nickname ist noch frei]]

Bevor man den Nicknamen registrieren kann, muss man sich in diesen umbenennen. Der Befehl dazu lautet:
<pre>/nick contaouser</pre>
Wenn das Umbennenen funktioniert hat, erhält man folgende Antwort:

[[Datei:chat-howto-23.png|Umbennenen]]

Wenn der Nickname gerade von jemand anderen benutzt wird, kommt als Antwort:

[[Datei:chat-howto-24.png|Nickname in use]]

In diesem Fall muss man es später noch einmal versuchen oder man wählt einen anderen Nicknamen.

Kurze Zusammenfassung:
Der erste Befehl kontrolliert nur, ob der gewünschte Nickname schon registriert ist oder nicht. Er sagt nichts darüber aus, ob der Nickname gerade verwendet wird oder nicht. Das sieht man erst, wenn man sich in diesem umbenennen will. Will man einen Nicknamen registrieren, darf dieser a) noch nicht registriert sein und b) auch gerade nicht in Verwendung sein.

{{Achtung|Befehle, die ein Passwort enthalten, sollten immer im Serverfenster eingegeben werden, nie im Chatraum. Chatbefehle beginnen immer mit einem / am Anfang. Tippt man schnell und vergisst den / am Anfang oder schreibt man statt / die Zahl 7, wird der Befehl nicht als solcher erkannt und wie eine normale Nachricht an den Channel geschickt, wo jeder ihn sehen kann!}}

Um den Nicknamen zu registrieren, verwendet man folgenden Befehl (erste Zeile ist die Syntax, die zweite Zeile der Befehl für unseren Beispielnick):
<pre>
/msg nickserv register <passwort> <email>
/msg nickserv register 1234 contaouser@example.com
</pre>
Bei unseren Beispielnick ist das Passwort:1234 und die Email-Adresse contaouser@example.com. Das Netzwerk antwortet:

[[Datei:chat-howto-25.png|Nick registered]]

Wie aus dieser Antwort ersichtlich, hat das Netzwerk eine Email an die angegebene Email-Adresse geschickt.

[[Datei:chat-howto-26.png|Email]]

Abschliessend muss, wie in der Email aufgefordert, die Registration mit folgendem Befehl aktiviert werden:
<pre>/msg NickServ VERIFY REGISTER contaouser rmcotwcvsuhb</pre>
Die Zeichenfolge "rmcotwcvsuhb" stellt den Registrierungscode dar. Wird der Befehl inkl. dem Registrierungscode richtig eingegeben, antwortet das Netzwerk mit der Meldung:

[[Datei:chat-howto-27.png|Registrierung bestätigt]]

Gratulation! Die Registration des Nicknamens wurde erfolgreich abgeschlossen.
{{Achtung|Die Aktivierung muss innerhalb 24 Stunden abgeschlossen sein, da sonst der Nickname wieder freigegeben wird.}}

Wenn man sich nun mit dem Netzwerk verbindet, erkennt das Netzwerk, dass der Nick registriert ist und fordert einen auf, sich zu identifizieren.

[[Datei:chat-howto-28.png|Identify]]

Dies geschiet mit dem Befehl (wobei 1234 in diesem Fall das Passwort ist):
<pre>/msg nickserv identify 1234</pre>
Das Netzwerk bestätigt die korrekte Identifizierung mit:

[[Datei:chat-howto-29.png|Bestätigung]]

==Perform mit Chatzilla==

Um die Identifizierung bei jeder Verbindung nicht immer manuell eintippen zu müssen, bieten fast alle Chattools die Möglichkeit, dies automatisch machen zu lassen. In Chatzille geht man dazu über die Menüleiste "Chatzilla" in die Einstellungen...

[[Datei:chat-howto-30.png|Chatzilla Einstellungen]]

...geht auf die freenode-Einstellungen und auf den Tab "Lists". Gleich zu Beginn ist der Abschnitt "Auto-perform". Alle in diesem Abschnitt eingefügten Befehle werden bei der Verbindung automatisch ablaufen. Mit einem Klick auf den Button "Add" kann ein neuer Befehl hinzugefügt werden.

[[Datei:chat-howto-31.png|Auto-perform]]

In dem sich aufpoppenden Fenster gibt man folgenden Befehl ein:
<pre>msg identify 1234</pre>
{{Anmerkung|Normalerweise werden sämtliche IRC-Befehle mit einem / am Anfang eingegeben. In diesem Fall macht das Chatzilla automatisch und der Befehl wird ohne / eingegeben.}}

[[Datei:chat-howto-32.png|Auto-perform command]]

Das Popup-Fenster wird mit "OK" bestätigt. Danach sollte das Einstellungsfenster so aussehen:

[[Datei:chat-howto-33.png|Auto-perform command added]]

Abschliessend wird auch das Einstellungsfenster mit "OK" geschlossen.

Wenn man sich jetzt neu mit dem Netzwerk verbindet, wird Chatzilla nach erfolgtem Verbindungsaufbau den Identify-Befehl automatisch an das Netzwerk senden, welchen diesen dann auch bestätigt:

[[Datei:chat-howto-34.png|auto identify confirmed]]

==Perform mit Opera==

In Opera funktioniert das Perform ähnlich. Auch hier geht man in die Einstellungen des freenode-Netzwerks, indem man einen Rechtsklick auf den freenode-Server macht und anschliessend auf "Eigenschaften" geht.

[[Datei:chat-howto-35.png|Opera chat settings]]

In den Konto-Eigenschaften wechselt man auf den Tab "Postausgang" und fügt dort den identify-Befehl ein. Anders als bei Chatzilla muss hier der Befehl normal mit / am Anfang eingegeben werden.

[[Datei:chat-howto-36.png|Opera auto perform]]

Man bestätigt die Eingabe mit "OK". Auch Opera bestätigt beim Verbinden die erfolgreiche Identifizierung in einem eigenen Tab von "NickServ":

[[Datei:chat-howto-37.png|Opera auto-perform confirmed]]

==Nickserv Hilfe==
Wenn man seinen Nicknamen registriert hat, kann man diverse Einstellungen zu dem Nicknamen machen. NickServ selbst bietet dazu eine Hilfe an. Diese ruft man mit folgenden Befehl auf:
<pre>/msg nickserv help</pre>
Benötigt man Hilfe z.B. zu der "GROUP"-Einstellung, ruft man diese mit folgendem Befehl auf:
<pre>/msg nickserv help group</pre>

=Privater Chat=
Es gibt im IRC die Möglichkeit, mit jemandem privat zu chatten, wo also nur 2 Personen daran teilnehmen, ähnlich wie in einem Forum, wo man jemanden eine private Nachricht schicken kann.

Um einen privaten Chat mit einem anderen User zu beginnen, verwendet man folgenden Befehl:
<pre>/query foobar</pre>
In diesem Fall wäre der Name des anderen Users "foobar".
Es öffnet sich daraufhin ein eigenes Fenster, wo mit dem anderen User gechattet werden kann.
{{Achtung|Man beginnt NIE einen privaten Chat, wenn man nicht vorher dazu aufgefordert wurde oder vorher im öffentlichen Raum den User gefragt hat. Ein Missbrauch kann einen Verweis aus dem Channel zur Folge haben und im schlimmsten Fall kann der User sogar aus dem Raum gesperrt werden.}}
Einen privater Chat kann z.B. dazu verwendet werden, wenn man jemandem seine Backend-Zugangsdaten mitteilen will, oder persönliche Daten wie Handynummer oder Email-Adresse.

=Bitte Beachten!!=
Nur, weil ein Nickname in der Nickliste erscheint, bedeutet das nicht, dass der jeweilige Nutzer gerade verfügbar ist. Es kann sein, dass das User gerade im Hintergrund arbeitet, anderweitig beschäftigt oder gar nicht vor dem PC sitzt. Manche User benutzen auch einen Bot ([[w:de:Eggdrop|Eggdrop]]) oder Bouncer ([[w:de:Bouncer|Bouncer]]), der online bleibt, wenn der Benutzer den Computer abschaltet.

Safemode Hack

2010-03-10T23:36:35Z

Marc:

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei ''system/config/localconfig.php'' nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die ''localconfig.php'' entsprechend anzupassen, damit TYPOlight die Datei beschreiben kann.

Ist man wirklich in der misslichen Lage, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] durchlaufen lassen.

<pre class="hinweis" style="white-space: pre-wrap;">Hinweis:
Es ist empfehlenswert, wenn man den Safemode Hack verwenden muss, einen weiteren FTP-User zu erstellen, der exklusive Rechte - eingeschränkt auf die TYPOlight-Installation - auf dem Server hat. Dies hat vor allem Sicherheitsrelevante Hintergründe, da bei einem übernommenen System nur die TYPOlight Installation betroffen wäre, und nicht etwa der gesamte FTP-Server.</pre>

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst - erstellten Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.
Dies ist auch völlig unabhängig von etwaigen Subdomains, die man eingerichtet hat, da der Safemode Hack in Relation zum FTP-Server und nicht in Relation zur Domain/dem apache steht.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordnern (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen und diese zu verändern, wart aber dennoch ein gewisses Maß an Sicherheit, da ein Außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt, nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü ''Tools -> Besitzrechte''. Dort stellt man den User vom FTP-User (idR der Zugangsname zum KAS) zum PHP-User und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil; man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den User bei einem Dateiupload über FTP im KAS wieder umzustellen. Man kann aber dennoch das Dateiverwaltungssystem von TYPOlight verwenden, um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Safemode Hack

2010-03-10T23:25:20Z

Marc: Sicherheitshinweis hinzugefügt

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei ''system/config/localconfig.php'' nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die ''localconfig.php'' entsprechend anzupassen, damit TYPOlight die Datei beschreiben kann.

Ist man wirklich in der misslichen Lage, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] durchlaufen lassen.

<pre>Hinweis:
Es ist empfehlenswert, wenn man den Safemode Hack verwenden muss, einen weiteren FTP-User zu erstellen, der exklusive Rechte - eingeschränkt auf die TYPOlight-Installation - auf dem Server hat. Dies hat vor allem Sicherheitsrelevante Hintergründe, da bei einem übernommenen System nur die TYPOlight Installation betroffen wäre, und nicht etwa der gesamte FTP-Server.</pre>

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst - erstellten Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.
Dies ist auch völlig unabhängig von etwaigen Subdomains, die man eingerichtet hat, da der Safemode Hack in Relation zum FTP-Server und nicht in Relation zur Domain/dem apache steht.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordnern (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen und diese zu verändern, wart aber dennoch ein gewisses Maß an Sicherheit, da ein Außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt, nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü ''Tools -> Besitzrechte''. Dort stellt man den User vom FTP-User (idR der Zugangsname zum KAS) zum PHP-User und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil; man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den User bei einem Dateiupload über FTP im KAS wieder umzustellen. Man kann aber dennoch das Dateiverwaltungssystem von TYPOlight verwenden, um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Safemode Hack

2010-03-10T23:19:17Z

Marc:

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei ''system/config/localconfig.php'' nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die ''localconfig.php'' entsprechend anzupassen, damit TYPOlight die Datei beschreiben kann.

Ist man wirklich in der misslichen Lage, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] durchlaufen lassen.

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst - erstellten Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.
Dies ist auch völlig unabhängig von etwaigen Subdomains, die man eingerichtet hat, da der Safemode Hack in Relation zum FTP-Server und nicht in Relation zur Domain/dem apache steht.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordnern (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen und diese zu verändern, wart aber dennoch ein gewisses Maß an Sicherheit, da ein Außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt, nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü ''Tools -> Besitzrechte''. Dort stellt man den User vom FTP-User (idR der Zugangsname zum KAS) zum PHP-User und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil; man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den User bei einem Dateiupload über FTP im KAS wieder umzustellen. Man kann aber dennoch das Dateiverwaltungssystem von TYPOlight verwenden, um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Benutzer:Marc

2010-03-10T23:08:21Z

Marc: Die Seite wurde neu angelegt: „<pre> </pre> Hier gibt`s nichts zu sehen.“

<pre> </pre>
Hier gibt`s nichts zu sehen.

Safemode Hack

2010-03-10T23:05:07Z

Marc: Änderung 147 von Marc (Diskussion) wurde rückgängig gemacht.

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei system/config/localconfig.php nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die localconfig.php entsprechend anzupassen, damit TYPOlight die Datei beschreiben darf.

Solltest man wirklich in der misslichen Lage sein, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt nun kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] laufen lassen.

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst erstellten - Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordner (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen, diese zu verändern wart aber dennoch ein gewisses Maß an Sicherheit, da ein außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü Tools -> Besitzrechte. Dort stellt man den Nutzer vom FTP-Nutzer (idR der Zugangsname zum KAS) zum PHP-Nutzer und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil, man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den Nutzer bei einem Dateiupload über FTP im KAS wieder umzustellen. Weiterhin kann aber das Dateiverwaltungssystem von TYPOlight verwendet werden um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Safemode Hack

2010-03-10T23:04:43Z

Marc:

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei system/config/localconfig.php nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die localconfig.php entsprechend anzupassen, damit TYPOlight die Datei beschreiben darf.

Solltest man wirklich in der misslichen Lage sein, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt nun kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] laufen lassen.

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst - erstellten Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordner (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen, diese zu verändern wart aber dennoch ein gewisses Maß an Sicherheit, da ein außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü Tools -> Besitzrechte. Dort stellt man den Nutzer vom FTP-Nutzer (idR der Zugangsname zum KAS) zum PHP-Nutzer und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil, man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den Nutzer bei einem Dateiupload über FTP im KAS wieder umzustellen. Weiterhin kann aber das Dateiverwaltungssystem von TYPOlight verwendet werden um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Safemode Hack

2010-03-10T23:02:48Z

Marc: Erweiterung um das manuelle Einrichten des Safemode Hack

{{stub}}
[[Category:Installation und Updates]]
=TYPOlight Safemode Hack (SMH)=
==Definition des SMH==
Der TYPOlight-Installer meldet, dass man den Safemode Hack (SMH) aktivieren soll:

[[Datei:installer-smh.jpg]]

Diese Meldung besagt zunächst nur, dass der Installer erkannt hat, dass die Datei system/config/localconfig.php nicht beschreibbar ist.

Sollte auf dem Server der Safemode deaktiviert sein, sollte es ausreichen, die Dateirechte für die localconfig.php entsprechend anzupassen, damit TYPOlight die Datei beschreiben darf.

Solltest man wirklich in der misslichen Lage sein, dass auf dem Server in PHP der Safemode aktiviert sein sollte, dann führt nun kein Weg daran vorbei die FTP-Zugangsdaten in die Eingabemaske einzugeben.

Bevor man mit der Installation beginnt, sollte man jedoch das [[Systemdiagnosetool]] laufen lassen.

==Safemode Hack manuell einrichten==
Manchmal kann es vorkommen, daß man nach einem Update gezwungen ist den Safemode Hack erneut einzurichten. Man kann dann in aller Regel nicht mehr auf das Installer-Interface zugreifen und muss die Daten manuell eintragen. Hierzu editiert man die Datei ''system/config/localconfig'' und fügt folgenden Code ein:
<pre>
$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = '127.0.0.1';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'pfad/zu/typolight/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ftp-user';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'ftp-passwort';
</pre>

* Für ftp-user und ftp-passwort nimmt man natürlich die vom Provider - oder selbst erstellten - Userdaten.
* Der Host kann variieren, ist aber meist localhost.
* Der ftp-Pfad ist immer relativ vom FTP-Nutzer anzugeben. Nehmen wir an die typolight-Installation liegt auf dem Server im Ordern ''dev/cms/typolight/'' so hat der FTP-Nutzer foo, der Zugriff auf ''/'' hat, ''dev/cms/typolight/'' anzugeben, aber der Nutzer bar, der nur Zugriff auf ''dev/cms'' hat, lediglich ''typolight/'' anzugeben.

==Safemode Hack auf all-inkl.com==
Eine interessante Alternative zum Safemode Hack bietet das Besitzrechte-Tool vom Hoster all-inkl.com. Mit diesem kann man den Besitzer von Dateien und Ordner (auch rekursiv) zwischen FTP-User und PHP-User umschalten. Dies ermöglicht Skripten auf diese Dateien zuzugreifen, diese zu verändern wart aber dennoch ein gewisses Maß an Sicherheit, da ein außenstehender, falls er eine Sicherheitslücke entdeckt und ausnutzt nicht auf das ganze System zugreifen kann, sondern nur auf die im KAS festgelegten PHP-Dateien und -Ordner, außerdem erfährt so ein Angreifer (oder neugieriger Mitbenutzer) keine sensiblen Zugangsdaten.

[[Datei:Safemodehack-all-inkl-besitzrechte.png]]

Um nun den Besitzer dieses Ordner rekursiv zu wechseln meldet man sich im KAS an (kas.all-inkl.com) und navigiert in in das Menü Tools -> Besitzrechte. Dort stellt man den Nutzer vom FTP-Nutzer (idR der Zugangsname zum KAS) zum PHP-Nutzer und setzt den Haken bei rekursiv.

[[Datei:Safemodehack-all-inkl-besitzrechte-php.png]]

Das Ganze hat aber auch einen Nachteil, man kann keine Dateien mehr aus seinem FTP-Programm heraus verändern oder erstellen, da die gesamte Ordnerstruktur jetzt dem PHP-User gehört.

[[Datei:Safemodehack-all-inkl-ftp-ansicht.png]]

Deshalb sollte man nicht vergessen den Nutzer bei einem Dateiupload über FTP im KAS wieder umzustellen. Weiterhin kann aber das Dateiverwaltungssystem von TYPOlight verwendet werden um Dateien hochzuladen, umzubennenen und zu bearbeiten.

Safemode Hack

2010-03-10T22:12:41Z

Marc: Erweiterung um das KAS von all-inkl

Datei:Safemodehack-all-inkl-ftp-ansicht.png

2010-03-10T21:54:35Z

Marc: Die FTP-Ansicht eines im KAS-System von all-inkl.com geänderten Ordners, dessen Besitzrechte auf den PHP-User übertragen wurden. Ansicht in filezilla.

Die FTP-Ansicht eines im KAS-System von all-inkl.com geänderten Ordners, dessen Besitzrechte auf den PHP-User übertragen wurden. Ansicht in filezilla.

Datei:Safemodehack-all-inkl-besitzrechte-php.png

2010-03-10T21:53:11Z

Marc: Das KAS-System unter Tools -> Besitzrechte zur Veranschaulichung einer Alternative den Safemodehack zu umgehen. Eine weitere Illustration mit genauem Vorgang.

Das KAS-System unter Tools -> Besitzrechte zur Veranschaulichung einer Alternative den Safemodehack zu umgehen. Eine weitere Illustration mit genauem Vorgang.

Datei:Safemodehack-all-inkl-besitzrechte.png

2010-03-10T21:52:26Z

Marc: Das KAS-System unter Tools -> Besitzrechte zur Veranschaulichung einer Alternative den Safemodehack zu umgehen.

Das KAS-System unter Tools -> Besitzrechte zur Veranschaulichung einer Alternative den Safemodehack zu umgehen.