Shoutbox

2012-01-19T13:58:00Z

Bubblez:

[[Category:Extensions]]
{{AppliesTo|TLVersion=ab 2.9.3}}

Mit dieser Erweiterung können eingeloggte Benutzer im Backend chatten. Angzeigt wird ein kleines Chatfenster unten rechts, welches ein oder ausgeblendet werden kann.

shoutbox nicht im ER

[https://github.com/ideadapt/shoutbox| shoutbox auf github]

[[Datei:Msg posted.png]]

=Installation=

# Von Extension Repository. Oder von github herunterladen und in das contao Verzeichnis kopieren.
# In der Datei '''plugins\ia.jquery.shoutbox\shoutbox_be_starter.js''' die Variable tl_path anpassen.

Datei:Msg posted.png

2012-01-19T13:57:12Z

Bubblez: hat eine neue Version von „Datei:Msg posted.png“ hochgeladen

Bubblez:

Isotope-Cart-ProductAddedFeedback

2011-07-24T16:07:58Z

Bubblez: hat „Isotope-Basket-ProductAddedFeedback“ nach „Isotope-Cart-ProductAddedFeedback“ verschoben: Naming Conventions von Isotope berücksichtigen

Isotope-Basket-ProductAddedFeedback

2011-07-24T16:07:58Z

Bubblez: hat „Isotope-Basket-ProductAddedFeedback“ nach „Isotope-Cart-ProductAddedFeedback“ verschoben: Naming Conventions von Isotope berücksichtigen

#WEITERLEITUNG [[Isotope-Cart-ProductAddedFeedback]]

Isotope-Cart-ProductAddedFeedback

2011-07-24T16:06:54Z

Bubblez: Die Seite wurde neu angelegt: „ <div class="stub" align="center" style="margin-bottom:30px;"> {| cellpadding="2" cellspacing="0" style="text-align: left; color:#B65C5C; borde…“

Xampp Multidomain

2011-05-30T10:50:00Z

Bubblez: /* Verwenden von gmail als Mail-Server */

[[Category:Admin_HOWTOS]]
[[Category:Installation_und_Updates]]
[[Category:Sonstiges]]
Dieses Tutorial beschreibt die Einrichtung einer lokalen Entwicklungsumgebung mit XAMPP für mehrere parallele oder mehrsprachige Contao Installationen.

=Einrichtung=
Bei dieser Anleitung wird mit einem portablen [http://www.apachefriends.org/de/xampp.html XAMPP] Zip-Paket in Windows gearbeitet (aktuelle Version: 1.7.3). XAMPP steht für Apache, MySQL, PHP und Pearl und stellt somit ein vorkonfiguriertes Webserver-Paket bereit. Neben den eigentlichen Servern bringt XAMPP auch ein paar nette Konfigurationstools wie den PhpMyAdmin oder einen Mailserver mit. Die Pakete gibt es für Windows, Linux sowie für den Mac.

Das Zip-Paket wird in C:\webdev entpackt, was auch ausdrücklich empfohlen wird. Gerade bei Verzeichnissen mit Leer- oder Sonderzeichen (z. B. C:\Program Files\xampp) könnte es später zu Problemen kommen. Nach dem Entpacken ruft man die Datei ''C:\webdev\xampp\setup_xampp.bat'', welche die Konfiguration von XAMPP übernimmt.

<gallery widths="200" heights="300"caption="XAMPP Setup Script">
Datei:xampp-setup-1.png|Setupscript Screen 1
Datei:xampp-setup-2.png|Setupscript Screen 2
Datei:xampp-setup-3.png|Setupscript Screen 3
Datei:xampp-setup-4.png|Setupscript Screen 4
Datei:xampp-setup-5.png|Setupscript Screen 5
Datei:xampp-setup-6.png|Setupscript Screen 6
</gallery>

Nach erfolgter Konfiguration wird das Setup-Script mit Eingabe eines ''x'' beendet.

Anschließend ruft man die Datei ''C:\webdev\xampp\xampp-contol.exe'' auf und startet die Module ''Apache'', ''MySQL'' und ''Mercury''.

[[Datei:xampp-controlpanel.png|Controlpanel]]

Wenn alle Module gestartet sind, wird dieser Status im Control Panel angezeigt.

[[Datei:xampp-controlpanelstarted.png|Controlpanel mit gestarteten Modulen]]

Ruft man jetzt die Adresse ''<nowiki>http://localhost</nowiki>'' im Browser auf, sollte man das XAMPP-Logo mit einer Sprachauswahl sehen. Nach Auswahl der entsprechenden Sprache erscheint die eigentliche XAMPP-Seite, bei der unter dem Menüpunkt ''Status'' Informationen über einzelne Module ausgegeben werden.

[[Datei:xampp-status.png|XAMPP Status]]

Wichtig ist hier nur, dass MySQL und PHP AKTIVIERT ist. Der Menüpunkt ''phpinfo()'' zeigt viele Informationen über die installierte PHP-Version und deren Module an; hier sollte eine Version ab 5.2 zu sehen sein.

Zum Schluss sollte man noch über die Seite ''<nowiki>http://localhost/security/xamppsecurity.php</nowiki>'' das ROOT-Passwort für den MySQL-Server setzen. Nebenbei kann man auch das XAMPP-Verzeichnis mit einem Passwortschutz versehen. Diese Aktionen sind zwar für die Funktionalität nicht zwingend nötig, aber aus Sicherheitsgründen zu empfehlen. ''"Paranoia is applied security"'' … Nach dem Ändern des Passwortes muss über das XAMPP Control Panel der MySQL-Server neu gestartet werden, damit die Passwortänderung wirksam wird.

=Installation einer Contao Umgebung=
Um Contao installieren zu können, muss zuerst ein Contao-Paket von der [http://www.contao.org/herunterladen.html Projekt-Homepage] heruntergeladen und in das Verzeichnis ''C:\webdev\xampp\htdocs\contao'' entpackt werden.<br />
Anschließend wird über die Adresse ''<nowiki>http://localhost/phpmyadmin/</nowiki>'' eine neue Datenbank inkl. neuen Datenbank-Benutzer angelegt. Aus Sicherheitsgründen sollte man für die Datenbank den ROOT-Benutzer nicht verwenden.<br />
Über den Reiter ''Rechte'' kommt man zur Benutzerübersicht. In dieser Übersicht findet man einen Button ''Neuen Benutzer hinzufügen''. Hier kann man sehr bequem einen Benutzer samt Datenbank anlegen. Als Host wählt man immer ''Lokal'', da Webserver und Datenbanksystem auf dem selben Rechner laufen.

[[Datei:xampp-newdbuser.png|Neuen Datenbank Benutzer inkl. Datenbank erstellen]]

Jetzt kann mit der [[Installation]] von Contao begonnen werden.

Im Grunde könnte man auf diese Art beliebig viele Contao-Umgebungen parallel betreiben, natürlich in jeweils verschiedenen Verzeichnissen. Hier bestehen aber zwei grundsätzliche Probleme:
*Contao ist in einem Unterverzeichnis installiert, was an einigen Stellen zu Problemen führen kann. Contao ist hier aber sehr kulant.
*Auf diese Art ist pro Contao-Umgebung nur eine Seite realisierbar.

=Ausbau auf verschiedene Hostnamen=
Um die oben genannten Probleme zu beheben, kann für jede Contao Umgebung ein eigener Hostnamen angelegt werden, also ein Alias zu ''localhost''. Hostnamen sind für den Menschen da und werden vom Betriebssystem automatisch zu einer IP-Adresse aufgelöst. Der ''localhost'' ist dabei voreingestellt und zeigt immer auf ''127.0.0.1'', was per Definition immer der Computer ist, auf dem die Auflösung statt findet. Diese Zuordnung macht sich der Webserver zu nutze und unterscheidet damit die verschiedenen Websites.

==hosts-Datei==
Es gibt verschieden Instanzen der Namensauflösung, der erste Schritt hierbei ist in jedem Fall die sogenannte hosts-Datei, welche in jedem System existiert und erst wenn hier keine Entsprechung gefunden werden konnten, werden weitere DNS-Server befragt.

Um nun eigene Hostnamen für die IP ''127.0.0.1'' einzurichten, öffnet man mit einem Editor die Datei hosts (ohne Endung), welche bei
*Windows unter C:\WINDOWS\system32\drivers\etc\
*Linux und Mac unter /etc/
zu finden ist. Um die Datei zu ändern, sind Administrator bzw. ROOT Rechte notwendig.

Für jede Hostnamen<->IP-Adresse-Kombination steht eine Zeile, wobei die Hostnamen eindeutig sein müssen. Es dürfen also keine zwei identische Hostnamen auf eine IP-Adresse zeigen.

[[Datei:xampp-hosts.png|Datei hosts bearbeiten]]

Öffnet man nun eine der neu angelegten Hostnamen im Browser, z.B. ''<nowiki>http://xampp</nowiki>'', dann sollte die gleiche Ausgabe wie bei Aufruf von ''<nowiki>http://localhost</nowiki>'' erscheinen. Bei der Wahl der Hostnamen sollte man darauf achten, dass keine Überschneidung mit reell existierenden Domains entstehen. Trägt man beispielsweise

<source lang="text">
127.0.0.1 www.contao.org
</source>

in die hosts-Datei ein, wird man von nun ab den lokalen Webserver unter der Adresse www.contao.org erreichen, und nicht mehr die Contao-Website.<br />
Es gibt einige spezielle hosts-Editoren, die das Editieren erleichtern sollen. Google weiß mehr darüber.

==vHost-Konfiguration==
Um die verschiedenen Hostnamen den unterschiedlichen Contao-Umgebungen zuzuweisen, muss der Webserver entsprechend konfiguriert werden. Über die sogenannten virtuellen Hosts pflegt der Apache die Unterscheidung zwischen den einzelnen Umgebungen.

Hierzu stellt XAMPP die Konfigurationsdatei ''C:\webdev\xampp\apache\conf\extra\httpd-vhosts.conf'' bereit, die ebenfalls per Editor bearbeitet wird.
Man kann hier die Gelegenheit nutzen, um das htdocs-Verzeichnis mit den Contao-Dateien an einen anderen Ort zu legen, z.B. ''C:\webdev\webfiles''. Die restlichen XAMPP-htdocs sollte man unberührt lassen.

Zuerst muss man den Apache anweisen, virtuelle Hosts über die Hostnamen aufzulösen. Dazu wird das Kommentarzeichen vor ''NameVirtualHost'' entfernt.

<source lang="text">
#
# Use name-based virtual hosting.
#
NameVirtualHost *:80
</source>

Die Zugriffsrechte für das Web-Verzeichnis schränken wir entsprechend ein:

<source lang="text">
# Zugriff auf das webfiles-Verzeichnis nur vom lokalen Rechner zulassen
<Directory C:/webdev/webfiles>
Order deny,allow
Allow from 127.0.0.1
AllowOverride All
</Directory>
</source>

Jetzt erstellt man den ersten vHost-Eintrag. Diesen benutzt man für das normale ''localhost''-Verhalten. Es sollen also einfach alle Dateien aufgelistet werden. Da dies der erste vHost-Eintrag ist, erhält er auch eine Sonderstellung. Passt kein anderer vHost-Eintrag auf die Anfrage, wird dieser stellvertretend benutzt.

Ein weiteres Gimmik ist das Rewrite-Script. Es dient dazu, Subdomains auf Verzeichnisse abzubilden. Beispielweise wird die Anfrage ''<nowiki>http://verzeichnis.local/index.php</nowiki>'' auf die Datei ''C:\webdev\webfiles\*verzeichnis*\index.php'' abgebildet. Dies hat den großen Vorteil, dass ein neuer Subdomain-vHost ohne Anpassung der Serverkonfiguration erstellt werden kann. Es muss lediglich das Verzeichnis erstellt werden.

<source lang="text">
### Default vHost
<VirtualHost *:80>
DocumentRoot C:/webdev/webfiles
ServerName localhost

<Directory C:/webdev/webfiles>
Options +Indexes
</Directory>

# Der vHost soll auch alle Anfragen annehmen, die mit ".local" enden.
ServerAlias *.local

# Script zur Umleitung in das Verzeichnis, welches über dem Präfix von ".local" referenziert wird
# Bsp.: neu.local nutzt als DocumentRoot C:/webdev/webfiles/neu
UseCanonicalName Off
RewriteEngine On
RewriteCond %{HTTP_HOST} ^[^.]+\.local$
RewriteCond %{REQUEST_URI} !^/icons
RewriteRule ^(.+) %{HTTP_HOST}$1 [C]
RewriteRule ^([^.]+)\.local(.*) C:/webdev/webfiles/$1$2
</VirtualHost>
</source>

Nun wird ein vHost zum Zugriff auf die XAMPP-Weboberfläche erstellt:

<source lang="text">
### XAMPP vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/xampp/htdocs
ServerName xampp
</VirtualHost>
</source>

Ein vHost zum Zugriff auf eine Contao-Umgebung:

<source lang="text">
### contao vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/webfiles/contao
ServerName contao
</VirtualHost>
</source>

Diese vHost dient zum Zugriff auf das Verzeichnis multilang. Man achte auf den ServerAlias, welcher es ermöglicht, beliebige Subdomain-Hostnamen der Form xxx.multilang anzulagen (de.multilang, en.multilang,...).

<source lang="text">
### multilang vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/webfiles/multilang
ServerName multilang
ServerAlias *.multilang
</VirtualHost>
</source>

Zusammenfassung der Syntax:
*Ein <VirtualHost *:80>-Block pro vHost
*''ServerName'' gibt den verwendeten Hostnamen an
*''ServerAlias'' gibt weitere Hostnamen an, für die dieser vHost gilt. Hier sind Wildcards erlaubt
*''DocumentRoot'' steht für das physische Verzeichnis der Dateien

Natürlich gibt es noch eine Vielzahl weiterer Konfigurationsoptionen, diese können in der [http://httpd.apache.org/docs/ Apache-Dokumentation] nachgelesen werden.

Nachdem die Datei angepasst wurde, wird der Syntax in der Eingabeaufforderung mit ''httpd.exe -S'' überprüft (unter C:\webdev\xampp\apache\bin). Sind keine Fehler aufgetreten, kann der Webserver über das XAMPP Control Panel neu gestartet werden.

Jetzt sollten folgende vHost aktiv sein:
*''<nowiki>http://localhost</nowiki>'' -> ''C:\webdev\webfiles'' - Mit Auflistung des Inhalts. Praktisch, wenn man für etwas Kleines keinen extra vHost anlegen möchte.
*''<nowiki>http://contao</nowiki>'' -> ''C:\webdev\webfiles\contao''
*''<nowiki>http://[ordner].local</nowiki>'' -> C:\webdev\webfiles\[ordner] - wobei [ordner] beliebig sein kann, es darf nur kein Punkt oder Sonderzeichen enthalten sein. Damit hat man praktisch einen Wildcard-vHost ohne wirklich die Serverkonfiguration ändern zu müssen. '''Wichtig:''' ''[ordner].local'' muss auch in der hosts-Datei notiert werden.
*''<nowiki>http://xampp</nowiki>'' -> ''C:\webdev\xampp\htdocs'' - Über diesen vHost kann man auf die XAMPP-Weboberfläche zugreifen.
*''<nowiki>http://*.multilang</nowiki>'' -> ''C:\webdev\webfiles\mutlilang'', auch hier kann man als Subdomain alles angeben, was man in der Hosts-Datei notiert hat. Besonderheit zum oberen Beispiel: Es wird immer das selbe Verzeichnis und damit die selbe Contao-Umgebung referenziert. Damit kann man also mehrsprachige oder mehrseitige Auftritte erstellen.

=Sicherheitseinstellungen - Apache=
Abschließend werden noch ein paar Einstellungen zur Sicherheit vorgenommen.

==Zugriff von außen sperren==
In der Datei ''C:\webdev\xampp\apache\conf\httpd.conf'' befindet sich ab der Zeile 42:

<source lang="text">
# Change this to Listen on specific IP addresses as shown below to
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 0.0.0.0:80
#Listen [::]:80
Listen 80
</source>

Hier ändert man den ''Listen''-Wert auf:

<source lang="text">
Listen 127.0.0.1:80
</source>

Das veranlasst den Apache nur noch Verbindungen über das ''localhost''-Interface anzunehmen und keine Verbindungen, die über das Netzwerk von anderen Computer kommen.

In der Datei ''C:\webdev\xampp\apache\conf\extra\httpd-ssl.conf'' steht die Einstellung für HTTPS, also verschlüsselte Seiten. Hier muss in Zeile 41

<source lang="text">
Listen 443
</source>

in

<source lang="text">
Listen 127.0.0.1:443
</source>

geändert werden.

=Sicherheitseinstellungen - MySQL=
Auch dem MySQL-Server verbietet man den Zugriff von außen. In die Datei ''C:\webdev\xampp\mysql\bin\my.ini'' fügt man folgenden Zeile unter der Sektion ''[mysqld]'' ein:

<source lang="text">
bind-address = 127.0.0.1
</source>

Damit sieht die Konfigurationsdatei ab Zeile 27 so aus:

<source lang="text">
# The MySQL server
[mysqld]
basedir = "/webdev/xampp/mysql/"
datadir = "/webdev/xampp/mysql/data/"
port = 3306
socket = "MySQL"
skip-locking
key_buffer = 16M
max_allowed_packet = 1M
table_cache = 64
sort_buffer_size = 512K
net_buffer_length = 8K
read_buffer_size = 256K
read_rnd_buffer_size = 512K
myisam_sort_buffer_size = 8M
bind-address = 127.0.0.1

default-time-zone = "Europe/Paris"
</source>

Ein Neustart des MySQL-Servers macht die Konfiguration aktiv.

=.htaccess=
Standardmässig ist die Datei ''.htaccess'' nicht in der Contao-Installation aktiv. Es liegt jedoch eine vorbereitete Datei bereit; sie lautet ''.htaccess.default''. Diese muss in ''.htaccess'' umbenannt werden. Die Datei ''.htaccess'' aus dem Basisverzeichnis der Contao-Installation dient hauptsächlich dazu, schönere URLs zu erzeugen. Damit das Rewriting von Webserver entsprechend ausgeführt werden kann, muss die Option ''RewriteBase'' angepasst werden. Sie besagt, in welchem Unterverzeichnis die Installation bezüglich der Domain liegt. Hat man das System in einem Unterverzeichnis installiert (''<nowiki>http://localhost/contao/</nowiki>''), dann muss die ''RewriteBase'' auf ''/contao/'' geändert werden. Die veränderte ''.htaccess'' sieht dann ab Zeile 39 wie folgt aus:

<source lang="text">
# Uncomment the following line to set the RewriteBase.
##
RewriteBase /contao/
</source>

=Mercury - Mailserver=
Damit man auch die Mailfunktionalität von Contao lokal testen kann, bedarf es einem Mailserver. Diesen bringt XAMPP in Form von Mercury-Mail mit.

Über das ''XAMPP Control Panel'' wird dei Mailserver gestartet und per klick auf ''Admin'' öffnet sich die Mercury-Verwaltungsoberfläche.
Da nur ein SMTP-Server (für den Mailversand) und ein POP3-Server (für den Mailempfang) benötigt werden, deaktiviert man alle anderen Dienste von Mercury. Das wird über den Button ''Configuration - Protocol modules'' erledigt, wo alle Haken bis auf SMTP und POP3 entfernt werden:
<gallery widths="300" heights="300"caption="Mercury Security Settings">
Datei:xampp-mercury.png|Mercury Admin Page
Datei:xampp-mercuryprotocolmodules.png|Mercury Protocol Modules
</gallery>
Nun den Mercury-Server über das ''XAMPP Control Panel'' neustarten.

Ähnlich wie für den Apache veranlasst man auch Mercury nur Verbindungen vom ''localhost'' anzunehmen. Über ''Configuration - Mercury SMTP Server'' erreicht man die Einstellungen und unter anderem das Feld ''IP Interface to use'', was auf 127.0.0.1 zu setzen ist:

[[Datei:xampp-mercurysmtp.png|Mercury SMTP Server]]

Analog für den POP3-Server unter ''Configuration - Mercury POP3 Server'':

[[Datei:xampp-mercurypop3.png|Mercury PPOP3 Server]]

Um nun Mails empfangen zu können muss noch ein Mailbenutzer in Mercury angelegt werden. Unter ''Configuration - Manage local users'' kann man beliebige Mailkonten anlegen, an welche man dann per Contao Mails schicken kann. Am besten ändert man hierfür den schon angelegten ''newuser'' ab.

Damit die E-Mails auch abgeholt werden, richtet man sich das neue E-Mail Konto in einem Mailclient ein, beispielsweise Outlook Express. Die Logindaten hierfür sind:
* POP3-Server: ''localhost''
* SMTP-Server: ''localhost''
* Benutzer: ''user@localhost''

Die XAMPP-Weboberfläche (<nowiki>http://xampp</nowiki>) bietet den Menüpunkt Mercury Mail, hier kann man sich über PHP eine E-Mail zustellen, um die Konfiguration zu testen.

=Sendmail & externer Mailserver=
Alternativ zu einem eigenen lokalen Mailserver, kann ein bestehender Mailserver (z.B. von google mail) verwendet werden. Man erspart sich damit das Einrichten eines eigenen Mailservers und Mail-Accounts. Allerdings ist man dann von einer Verbindung zum Mailserver abhängig, das heisst also man braucht Internet, um Mails zu senden / empfangen.

==Verwenden von gmail als Mail-Server==
Die hier beschriebenen Schritte sind angelehnt an http://www.projectpier.org/node/817.

* sendmail in der php.ini aktivieren (xampp/php/php.ini). Der Abschnitt [mail function] sieht so aus:
<source lang="ini">
[mail function]
; For Win32 only.
; Eventuell Pfad zu sendmail.exe anpassen
sendmail_path = "\"D:\Programme\xampp\sendmail\sendmail.exe\" -t"
SMTP = localhost
smtp_port = 25
</source>

* sendmail.ini (im gleichen Verzeichnis wie sendmail.exe) anpassen. Überschreibe den Inhalt mit:
<source lang="ini">
[sendmail]
smtp_server=localhost
smtp_port=25
default_domain=gmail.com
error_logfile=error.log
auth_username=[deingmailname]@gmail.com
auth_password=[deingmailpasswort]
pop3_server=
pop3_username=
pop3_password=
</source>

* Installation von stunnel
Downloade & installiere stunnel von http://www.stunnel.org/?page=downloads
Klicke Start->stunnel->edit stunnel.conf (Oder öffne C:\Program Files\stunnel\stunnel.conf)
Überschreibe den Inhalt der config mit:
<source lang="ini">
cert = stunnel.pem
socket = l:TCP_NODELAY=1
socket = r:TCP_NODELAY=1
debug = 7
output = stunnel.log
client = yes
[smtpg]
accept = 127.0.0.1:25
connect = smtp.gmail.com:465
;or connect = 72.14.215.109:465 so there's no DNS lookup
</source>

* XAMPP neu starten
* stunnel starten (Startmenü)

Es ist nun möglich von contao aus, welches auf XAMPP läuft, Mails zu versenden, sofern eine Verbindung zum gmail Server besteht.

=Umzug auf ein Live-System=
Der Umzug von Contao auf ein Livesystem gestaltet sich normalerweise sehr angenehm und ist nur mit wenigen Handgriffen zu bewerkstelligen:
#Unter Systemwartung den Cache löschen.
#Mit Hilfe der [[BackupDB|Backup-DB Erweiterung]] ein Website-Template erstellen
#Die ganze Website auf den Server laden (z.B. per FTP)
#Die .htaccess-Datei anpassen. Falls die Contao-Installation lokal in einem Unterverzeichnis lag, muss die RewriteBase wieder auf "/" gestellt werden.
#Nun über das Install-Tool die Contao-Seite installieren und am Ende das mit BackupDB erstellte Template in die Datenbank einfügen.

Das sollte es schon gewesen sein.

Da diese Anleitung auf einem portablen XAMPP-Server aufgebaut ist, ist es möglich, das komplette Verzeichnis (C:\webdev) auf einen USB-Stick zu betreiben. Dies erleichtert z.B. die Presentation bei Kunden. Es befindet sich alles in diesem Verzeichnis und bedarf keiner Installation. Lediglich die angepasste [[#hosts-Datei|hosts-Datei]] kann nicht übernommen werden.

=Credits=
Die Orginal-Anleitung wurde erstellt von [[Benutzer:Psi|Psi]] ([http://www.4wardmedia.de 4ward.media])<br />
Div. Modifikationen und Anpassungen an die aktuelle XAMPP-Version / Contao-Version durch manitougs

[[Datei:4ward signature.png|link=http://www.4wardmedia.de|4ward.media]]

Xampp Multidomain

2011-05-30T10:48:30Z

Bubblez:

[[Category:Admin_HOWTOS]]
[[Category:Installation_und_Updates]]
[[Category:Sonstiges]]
Dieses Tutorial beschreibt die Einrichtung einer lokalen Entwicklungsumgebung mit XAMPP für mehrere parallele oder mehrsprachige Contao Installationen.

=Einrichtung=
Bei dieser Anleitung wird mit einem portablen [http://www.apachefriends.org/de/xampp.html XAMPP] Zip-Paket in Windows gearbeitet (aktuelle Version: 1.7.3). XAMPP steht für Apache, MySQL, PHP und Pearl und stellt somit ein vorkonfiguriertes Webserver-Paket bereit. Neben den eigentlichen Servern bringt XAMPP auch ein paar nette Konfigurationstools wie den PhpMyAdmin oder einen Mailserver mit. Die Pakete gibt es für Windows, Linux sowie für den Mac.

Das Zip-Paket wird in C:\webdev entpackt, was auch ausdrücklich empfohlen wird. Gerade bei Verzeichnissen mit Leer- oder Sonderzeichen (z. B. C:\Program Files\xampp) könnte es später zu Problemen kommen. Nach dem Entpacken ruft man die Datei ''C:\webdev\xampp\setup_xampp.bat'', welche die Konfiguration von XAMPP übernimmt.

<gallery widths="200" heights="300"caption="XAMPP Setup Script">
Datei:xampp-setup-1.png|Setupscript Screen 1
Datei:xampp-setup-2.png|Setupscript Screen 2
Datei:xampp-setup-3.png|Setupscript Screen 3
Datei:xampp-setup-4.png|Setupscript Screen 4
Datei:xampp-setup-5.png|Setupscript Screen 5
Datei:xampp-setup-6.png|Setupscript Screen 6
</gallery>

Nach erfolgter Konfiguration wird das Setup-Script mit Eingabe eines ''x'' beendet.

Anschließend ruft man die Datei ''C:\webdev\xampp\xampp-contol.exe'' auf und startet die Module ''Apache'', ''MySQL'' und ''Mercury''.

[[Datei:xampp-controlpanel.png|Controlpanel]]

Wenn alle Module gestartet sind, wird dieser Status im Control Panel angezeigt.

[[Datei:xampp-controlpanelstarted.png|Controlpanel mit gestarteten Modulen]]

Ruft man jetzt die Adresse ''<nowiki>http://localhost</nowiki>'' im Browser auf, sollte man das XAMPP-Logo mit einer Sprachauswahl sehen. Nach Auswahl der entsprechenden Sprache erscheint die eigentliche XAMPP-Seite, bei der unter dem Menüpunkt ''Status'' Informationen über einzelne Module ausgegeben werden.

[[Datei:xampp-status.png|XAMPP Status]]

Wichtig ist hier nur, dass MySQL und PHP AKTIVIERT ist. Der Menüpunkt ''phpinfo()'' zeigt viele Informationen über die installierte PHP-Version und deren Module an; hier sollte eine Version ab 5.2 zu sehen sein.

Zum Schluss sollte man noch über die Seite ''<nowiki>http://localhost/security/xamppsecurity.php</nowiki>'' das ROOT-Passwort für den MySQL-Server setzen. Nebenbei kann man auch das XAMPP-Verzeichnis mit einem Passwortschutz versehen. Diese Aktionen sind zwar für die Funktionalität nicht zwingend nötig, aber aus Sicherheitsgründen zu empfehlen. ''"Paranoia is applied security"'' … Nach dem Ändern des Passwortes muss über das XAMPP Control Panel der MySQL-Server neu gestartet werden, damit die Passwortänderung wirksam wird.

=Installation einer Contao Umgebung=
Um Contao installieren zu können, muss zuerst ein Contao-Paket von der [http://www.contao.org/herunterladen.html Projekt-Homepage] heruntergeladen und in das Verzeichnis ''C:\webdev\xampp\htdocs\contao'' entpackt werden.<br />
Anschließend wird über die Adresse ''<nowiki>http://localhost/phpmyadmin/</nowiki>'' eine neue Datenbank inkl. neuen Datenbank-Benutzer angelegt. Aus Sicherheitsgründen sollte man für die Datenbank den ROOT-Benutzer nicht verwenden.<br />
Über den Reiter ''Rechte'' kommt man zur Benutzerübersicht. In dieser Übersicht findet man einen Button ''Neuen Benutzer hinzufügen''. Hier kann man sehr bequem einen Benutzer samt Datenbank anlegen. Als Host wählt man immer ''Lokal'', da Webserver und Datenbanksystem auf dem selben Rechner laufen.

[[Datei:xampp-newdbuser.png|Neuen Datenbank Benutzer inkl. Datenbank erstellen]]

Jetzt kann mit der [[Installation]] von Contao begonnen werden.

Im Grunde könnte man auf diese Art beliebig viele Contao-Umgebungen parallel betreiben, natürlich in jeweils verschiedenen Verzeichnissen. Hier bestehen aber zwei grundsätzliche Probleme:
*Contao ist in einem Unterverzeichnis installiert, was an einigen Stellen zu Problemen führen kann. Contao ist hier aber sehr kulant.
*Auf diese Art ist pro Contao-Umgebung nur eine Seite realisierbar.

=Ausbau auf verschiedene Hostnamen=
Um die oben genannten Probleme zu beheben, kann für jede Contao Umgebung ein eigener Hostnamen angelegt werden, also ein Alias zu ''localhost''. Hostnamen sind für den Menschen da und werden vom Betriebssystem automatisch zu einer IP-Adresse aufgelöst. Der ''localhost'' ist dabei voreingestellt und zeigt immer auf ''127.0.0.1'', was per Definition immer der Computer ist, auf dem die Auflösung statt findet. Diese Zuordnung macht sich der Webserver zu nutze und unterscheidet damit die verschiedenen Websites.

==hosts-Datei==
Es gibt verschieden Instanzen der Namensauflösung, der erste Schritt hierbei ist in jedem Fall die sogenannte hosts-Datei, welche in jedem System existiert und erst wenn hier keine Entsprechung gefunden werden konnten, werden weitere DNS-Server befragt.

Um nun eigene Hostnamen für die IP ''127.0.0.1'' einzurichten, öffnet man mit einem Editor die Datei hosts (ohne Endung), welche bei
*Windows unter C:\WINDOWS\system32\drivers\etc\
*Linux und Mac unter /etc/
zu finden ist. Um die Datei zu ändern, sind Administrator bzw. ROOT Rechte notwendig.

Für jede Hostnamen<->IP-Adresse-Kombination steht eine Zeile, wobei die Hostnamen eindeutig sein müssen. Es dürfen also keine zwei identische Hostnamen auf eine IP-Adresse zeigen.

[[Datei:xampp-hosts.png|Datei hosts bearbeiten]]

Öffnet man nun eine der neu angelegten Hostnamen im Browser, z.B. ''<nowiki>http://xampp</nowiki>'', dann sollte die gleiche Ausgabe wie bei Aufruf von ''<nowiki>http://localhost</nowiki>'' erscheinen. Bei der Wahl der Hostnamen sollte man darauf achten, dass keine Überschneidung mit reell existierenden Domains entstehen. Trägt man beispielsweise

<source lang="text">
127.0.0.1 www.contao.org
</source>

in die hosts-Datei ein, wird man von nun ab den lokalen Webserver unter der Adresse www.contao.org erreichen, und nicht mehr die Contao-Website.<br />
Es gibt einige spezielle hosts-Editoren, die das Editieren erleichtern sollen. Google weiß mehr darüber.

==vHost-Konfiguration==
Um die verschiedenen Hostnamen den unterschiedlichen Contao-Umgebungen zuzuweisen, muss der Webserver entsprechend konfiguriert werden. Über die sogenannten virtuellen Hosts pflegt der Apache die Unterscheidung zwischen den einzelnen Umgebungen.

Hierzu stellt XAMPP die Konfigurationsdatei ''C:\webdev\xampp\apache\conf\extra\httpd-vhosts.conf'' bereit, die ebenfalls per Editor bearbeitet wird.
Man kann hier die Gelegenheit nutzen, um das htdocs-Verzeichnis mit den Contao-Dateien an einen anderen Ort zu legen, z.B. ''C:\webdev\webfiles''. Die restlichen XAMPP-htdocs sollte man unberührt lassen.

Zuerst muss man den Apache anweisen, virtuelle Hosts über die Hostnamen aufzulösen. Dazu wird das Kommentarzeichen vor ''NameVirtualHost'' entfernt.

<source lang="text">
#
# Use name-based virtual hosting.
#
NameVirtualHost *:80
</source>

Die Zugriffsrechte für das Web-Verzeichnis schränken wir entsprechend ein:

<source lang="text">
# Zugriff auf das webfiles-Verzeichnis nur vom lokalen Rechner zulassen
<Directory C:/webdev/webfiles>
Order deny,allow
Allow from 127.0.0.1
AllowOverride All
</Directory>
</source>

Jetzt erstellt man den ersten vHost-Eintrag. Diesen benutzt man für das normale ''localhost''-Verhalten. Es sollen also einfach alle Dateien aufgelistet werden. Da dies der erste vHost-Eintrag ist, erhält er auch eine Sonderstellung. Passt kein anderer vHost-Eintrag auf die Anfrage, wird dieser stellvertretend benutzt.

Ein weiteres Gimmik ist das Rewrite-Script. Es dient dazu, Subdomains auf Verzeichnisse abzubilden. Beispielweise wird die Anfrage ''<nowiki>http://verzeichnis.local/index.php</nowiki>'' auf die Datei ''C:\webdev\webfiles\*verzeichnis*\index.php'' abgebildet. Dies hat den großen Vorteil, dass ein neuer Subdomain-vHost ohne Anpassung der Serverkonfiguration erstellt werden kann. Es muss lediglich das Verzeichnis erstellt werden.

<source lang="text">
### Default vHost
<VirtualHost *:80>
DocumentRoot C:/webdev/webfiles
ServerName localhost

<Directory C:/webdev/webfiles>
Options +Indexes
</Directory>

# Der vHost soll auch alle Anfragen annehmen, die mit ".local" enden.
ServerAlias *.local

# Script zur Umleitung in das Verzeichnis, welches über dem Präfix von ".local" referenziert wird
# Bsp.: neu.local nutzt als DocumentRoot C:/webdev/webfiles/neu
UseCanonicalName Off
RewriteEngine On
RewriteCond %{HTTP_HOST} ^[^.]+\.local$
RewriteCond %{REQUEST_URI} !^/icons
RewriteRule ^(.+) %{HTTP_HOST}$1 [C]
RewriteRule ^([^.]+)\.local(.*) C:/webdev/webfiles/$1$2
</VirtualHost>
</source>

Nun wird ein vHost zum Zugriff auf die XAMPP-Weboberfläche erstellt:

<source lang="text">
### XAMPP vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/xampp/htdocs
ServerName xampp
</VirtualHost>
</source>

Ein vHost zum Zugriff auf eine Contao-Umgebung:

<source lang="text">
### contao vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/webfiles/contao
ServerName contao
</VirtualHost>
</source>

Diese vHost dient zum Zugriff auf das Verzeichnis multilang. Man achte auf den ServerAlias, welcher es ermöglicht, beliebige Subdomain-Hostnamen der Form xxx.multilang anzulagen (de.multilang, en.multilang,...).

<source lang="text">
### multilang vHost
<VirtualHost *:80>
DocumentRoot c:/webdev/webfiles/multilang
ServerName multilang
ServerAlias *.multilang
</VirtualHost>
</source>

Zusammenfassung der Syntax:
*Ein <VirtualHost *:80>-Block pro vHost
*''ServerName'' gibt den verwendeten Hostnamen an
*''ServerAlias'' gibt weitere Hostnamen an, für die dieser vHost gilt. Hier sind Wildcards erlaubt
*''DocumentRoot'' steht für das physische Verzeichnis der Dateien

Natürlich gibt es noch eine Vielzahl weiterer Konfigurationsoptionen, diese können in der [http://httpd.apache.org/docs/ Apache-Dokumentation] nachgelesen werden.

Nachdem die Datei angepasst wurde, wird der Syntax in der Eingabeaufforderung mit ''httpd.exe -S'' überprüft (unter C:\webdev\xampp\apache\bin). Sind keine Fehler aufgetreten, kann der Webserver über das XAMPP Control Panel neu gestartet werden.

Jetzt sollten folgende vHost aktiv sein:
*''<nowiki>http://localhost</nowiki>'' -> ''C:\webdev\webfiles'' - Mit Auflistung des Inhalts. Praktisch, wenn man für etwas Kleines keinen extra vHost anlegen möchte.
*''<nowiki>http://contao</nowiki>'' -> ''C:\webdev\webfiles\contao''
*''<nowiki>http://[ordner].local</nowiki>'' -> C:\webdev\webfiles\[ordner] - wobei [ordner] beliebig sein kann, es darf nur kein Punkt oder Sonderzeichen enthalten sein. Damit hat man praktisch einen Wildcard-vHost ohne wirklich die Serverkonfiguration ändern zu müssen. '''Wichtig:''' ''[ordner].local'' muss auch in der hosts-Datei notiert werden.
*''<nowiki>http://xampp</nowiki>'' -> ''C:\webdev\xampp\htdocs'' - Über diesen vHost kann man auf die XAMPP-Weboberfläche zugreifen.
*''<nowiki>http://*.multilang</nowiki>'' -> ''C:\webdev\webfiles\mutlilang'', auch hier kann man als Subdomain alles angeben, was man in der Hosts-Datei notiert hat. Besonderheit zum oberen Beispiel: Es wird immer das selbe Verzeichnis und damit die selbe Contao-Umgebung referenziert. Damit kann man also mehrsprachige oder mehrseitige Auftritte erstellen.

=Sicherheitseinstellungen - Apache=
Abschließend werden noch ein paar Einstellungen zur Sicherheit vorgenommen.

==Zugriff von außen sperren==
In der Datei ''C:\webdev\xampp\apache\conf\httpd.conf'' befindet sich ab der Zeile 42:

<source lang="text">
# Change this to Listen on specific IP addresses as shown below to
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 0.0.0.0:80
#Listen [::]:80
Listen 80
</source>

Hier ändert man den ''Listen''-Wert auf:

<source lang="text">
Listen 127.0.0.1:80
</source>

Das veranlasst den Apache nur noch Verbindungen über das ''localhost''-Interface anzunehmen und keine Verbindungen, die über das Netzwerk von anderen Computer kommen.

In der Datei ''C:\webdev\xampp\apache\conf\extra\httpd-ssl.conf'' steht die Einstellung für HTTPS, also verschlüsselte Seiten. Hier muss in Zeile 41

<source lang="text">
Listen 443
</source>

in

<source lang="text">
Listen 127.0.0.1:443
</source>

geändert werden.

=Sicherheitseinstellungen - MySQL=
Auch dem MySQL-Server verbietet man den Zugriff von außen. In die Datei ''C:\webdev\xampp\mysql\bin\my.ini'' fügt man folgenden Zeile unter der Sektion ''[mysqld]'' ein:

<source lang="text">
bind-address = 127.0.0.1
</source>

Damit sieht die Konfigurationsdatei ab Zeile 27 so aus:

<source lang="text">
# The MySQL server
[mysqld]
basedir = "/webdev/xampp/mysql/"
datadir = "/webdev/xampp/mysql/data/"
port = 3306
socket = "MySQL"
skip-locking
key_buffer = 16M
max_allowed_packet = 1M
table_cache = 64
sort_buffer_size = 512K
net_buffer_length = 8K
read_buffer_size = 256K
read_rnd_buffer_size = 512K
myisam_sort_buffer_size = 8M
bind-address = 127.0.0.1

default-time-zone = "Europe/Paris"
</source>

Ein Neustart des MySQL-Servers macht die Konfiguration aktiv.

=.htaccess=
Standardmässig ist die Datei ''.htaccess'' nicht in der Contao-Installation aktiv. Es liegt jedoch eine vorbereitete Datei bereit; sie lautet ''.htaccess.default''. Diese muss in ''.htaccess'' umbenannt werden. Die Datei ''.htaccess'' aus dem Basisverzeichnis der Contao-Installation dient hauptsächlich dazu, schönere URLs zu erzeugen. Damit das Rewriting von Webserver entsprechend ausgeführt werden kann, muss die Option ''RewriteBase'' angepasst werden. Sie besagt, in welchem Unterverzeichnis die Installation bezüglich der Domain liegt. Hat man das System in einem Unterverzeichnis installiert (''<nowiki>http://localhost/contao/</nowiki>''), dann muss die ''RewriteBase'' auf ''/contao/'' geändert werden. Die veränderte ''.htaccess'' sieht dann ab Zeile 39 wie folgt aus:

<source lang="text">
# Uncomment the following line to set the RewriteBase.
##
RewriteBase /contao/
</source>

=Mercury - Mailserver=
Damit man auch die Mailfunktionalität von Contao lokal testen kann, bedarf es einem Mailserver. Diesen bringt XAMPP in Form von Mercury-Mail mit.

Über das ''XAMPP Control Panel'' wird dei Mailserver gestartet und per klick auf ''Admin'' öffnet sich die Mercury-Verwaltungsoberfläche.
Da nur ein SMTP-Server (für den Mailversand) und ein POP3-Server (für den Mailempfang) benötigt werden, deaktiviert man alle anderen Dienste von Mercury. Das wird über den Button ''Configuration - Protocol modules'' erledigt, wo alle Haken bis auf SMTP und POP3 entfernt werden:
<gallery widths="300" heights="300"caption="Mercury Security Settings">
Datei:xampp-mercury.png|Mercury Admin Page
Datei:xampp-mercuryprotocolmodules.png|Mercury Protocol Modules
</gallery>
Nun den Mercury-Server über das ''XAMPP Control Panel'' neustarten.

Ähnlich wie für den Apache veranlasst man auch Mercury nur Verbindungen vom ''localhost'' anzunehmen. Über ''Configuration - Mercury SMTP Server'' erreicht man die Einstellungen und unter anderem das Feld ''IP Interface to use'', was auf 127.0.0.1 zu setzen ist:

[[Datei:xampp-mercurysmtp.png|Mercury SMTP Server]]

Analog für den POP3-Server unter ''Configuration - Mercury POP3 Server'':

[[Datei:xampp-mercurypop3.png|Mercury PPOP3 Server]]

Um nun Mails empfangen zu können muss noch ein Mailbenutzer in Mercury angelegt werden. Unter ''Configuration - Manage local users'' kann man beliebige Mailkonten anlegen, an welche man dann per Contao Mails schicken kann. Am besten ändert man hierfür den schon angelegten ''newuser'' ab.

Damit die E-Mails auch abgeholt werden, richtet man sich das neue E-Mail Konto in einem Mailclient ein, beispielsweise Outlook Express. Die Logindaten hierfür sind:
* POP3-Server: ''localhost''
* SMTP-Server: ''localhost''
* Benutzer: ''user@localhost''

Die XAMPP-Weboberfläche (<nowiki>http://xampp</nowiki>) bietet den Menüpunkt Mercury Mail, hier kann man sich über PHP eine E-Mail zustellen, um die Konfiguration zu testen.

=Sendmail & externer Mailserver=
Alternativ zu einem eigenen lokalen Mailserver, kann ein bestehender Mailserver (z.B. von google mail) verwendet werden. Man erspart sich damit das Einrichten eines eigenen Mailservers und Mail-Accounts. Allerdings ist man dann von einer Verbindung zum Mailserver abhängig, das heisst also man braucht Internet, um Mails zu senden / empfangen.

==Verwenden von gmail als Mail-Server==
Die hier beschriebenen Schritte sind angelehnt an http://www.projectpier.org/node/817.

* sendmail in der php.ini aktivieren (xampp/php/php.ini). Der Abschnitt [mail function] sieht so aus:
<source lang="ini">
[mail function]
; For Win32 only.
; Eventuell Pfad zu sendmail.exe anpassen
sendmail_path = "C:\xampp\sendmail\sendmail.exe -t"
SMTP = localhost
smtp_port = 25
</source>

* sendmail.ini (im gleichen Verzeichnis wie sendmail.exe) anpassen. Überschreibe den Inhalt mit:
<source lang="ini">
[sendmail]
smtp_server=localhost
smtp_port=25
default_domain=gmail.com
error_logfile=error.log
auth_username=[deingmailname]@gmail.com
auth_password=[deingmailpasswort]
pop3_server=
pop3_username=
pop3_password=
</source>

* Installation von stunnel
Downloade & installiere stunnel von http://www.stunnel.org/?page=downloads
Klicke Start->stunnel->edit stunnel.conf (Oder öffne C:\Program Files\stunnel\stunnel.conf)
Überschreibe den Inhalt der config mit:
<source lang="ini">
cert = stunnel.pem
socket = l:TCP_NODELAY=1
socket = r:TCP_NODELAY=1
debug = 7
output = stunnel.log
client = yes
[smtpg]
accept = 127.0.0.1:25
connect = smtp.gmail.com:465
;or connect = 72.14.215.109:465 so there's no DNS lookup
</source>

* XAMPP neu starten
* stunnel starten (Startmenü)

Es ist nun möglich von contao aus, welches auf XAMPP läuft, Mails zu versenden, sofern eine Verbindung zum gmail Server besteht.

=Umzug auf ein Live-System=
Der Umzug von Contao auf ein Livesystem gestaltet sich normalerweise sehr angenehm und ist nur mit wenigen Handgriffen zu bewerkstelligen:
#Unter Systemwartung den Cache löschen.
#Mit Hilfe der [[BackupDB|Backup-DB Erweiterung]] ein Website-Template erstellen
#Die ganze Website auf den Server laden (z.B. per FTP)
#Die .htaccess-Datei anpassen. Falls die Contao-Installation lokal in einem Unterverzeichnis lag, muss die RewriteBase wieder auf "/" gestellt werden.
#Nun über das Install-Tool die Contao-Seite installieren und am Ende das mit BackupDB erstellte Template in die Datenbank einfügen.

Das sollte es schon gewesen sein.

Da diese Anleitung auf einem portablen XAMPP-Server aufgebaut ist, ist es möglich, das komplette Verzeichnis (C:\webdev) auf einen USB-Stick zu betreiben. Dies erleichtert z.B. die Presentation bei Kunden. Es befindet sich alles in diesem Verzeichnis und bedarf keiner Installation. Lediglich die angepasste [[#hosts-Datei|hosts-Datei]] kann nicht übernommen werden.

=Credits=
Die Orginal-Anleitung wurde erstellt von [[Benutzer:Psi|Psi]] ([http://www.4wardmedia.de 4ward.media])<br />
Div. Modifikationen und Anpassungen an die aktuelle XAMPP-Version / Contao-Version durch manitougs

[[Datei:4ward signature.png|link=http://www.4wardmedia.de|4ward.media]]

Google Analytics

2011-05-17T21:58:31Z

Bubblez:

[[Category:Core]]
{{AppliesTo
|TLVersion=bis 2.8.x
|Version=ab 2.9
}}

=Allgemeines=
[[w:de:Google_Analytics|Google Analytics]] ist ein kostenloser Dienst, welcher der Analyse von Zugriffen auf Webseiten dient (Es gilt nur ein monatliches Limit an Seitenaufrufen in Höhe von 5.000.000 Aufrufen).

{{Hinweis|Um Verfälschungen auszuschließen, wird der Google Analytics Code erst im Frontend angezeigt, wenn man sich aus dem Backend ausgeloggt hat.}}

==Alternativen==
Eine Alternative zu Google Analytics stellt [[Piwik]] dar.

==Rechtliches==
Es ist rechtlich noch nicht klar, ob es nun verboten ist, die Daten in Deutschland mit Google-Analytics zu erfassen. 2 Dinge sprechen erst einmal dagegen:
#Die Google Server sind nicht unbedingt in Deutschland.
#Die IP wird erfasst und die gewonnenen Daten können nicht einfach von einem Seitenbetreiber gelöscht werden, wenn ein Besucher dies verlangt.

Es gibt inzwischen ein Addon für einige Browser von Google, die Analytics Datensammlung deaktivieren: http://tools.google.com/dlpage/gaoptout?hl=de

Wer sicher gehen möchte, der kann ab Contao 2.9 die IP von den Besuchern anonymisieren und so dem Datenschutz genügen (siehe [[#IP-Adressen_anonymisieren|IP-Adresse anonymisieren]]).

{{Achtung|'''Dies ist keine Rechtsberatung.''' Detaillierte Angaben zur rechtlichen Situation beim Einsatz von Google Analytics sind von jeder selbst bei einem Rechtsanwalt zu erfragen (am besten in dem Fachgebiet Internet).}}

=Google Analytics Konto erstellen=
Um den Dienst ''Google Analytics'' (nachfolgend GA) nutzen zu können, muss man sich zuerst ein GA-Konto [http://www.google.com/analytics/ erstellen].<br />
Nach dem Erstellen eines Accounts gibt man GA die Domain bekannt, auf der der Dienst laufen soll. Dazu klickt man auf ''Neues Konto'' ...

[[Datei:ga_createaccount.png|Google Analytics Account erstellen]]

... und anschließend auf ''Anmelden''.

[[Datei:ga_login.png|Webseite hinzufügen]]

Anschließend erfolgen die Angaben zur Webseite, auf der GA laufen soll.

[[Datei:ga_websitesettings.png|Webseiten Angaben]]

Nachdem man den Geschäftsbedingungen zugestimmt hat, kommt man zur Seite mit dem Tracking-Code. In diesem Code notiert man sich die Account-Nummer; die wird später noch benötigt.

{{Hinweis| In den Google Geschäftsbedingungen (PUnkt 8.1) wird man Aufgefordert einen dort angegebenen Satz auf seiner Webseite einzubringen. Das sollte man auf jeden Fall machen, da es dort um die Datenschutzrichtlinien geht, die eh jeder auf seiner Internetseite auszeichnen sollte! }}

[[Datei:ga_trackingcode.png|Tracking Code]]

Nach dem Speichern der Eingaben kommt man zur Übersicht, wo nun die erstellte Webseite auf scheint.

[[Datei:ga_overview.png]]
=Einbinden von Google Analytics mittels der Core-Funktion=
==Typolight bis 2.8.x==
Um GA in TYPOlight bis 2.8.x einzubinden, bearbeitet man das entsprechende Seitenlayout und fügt unter ''Experten-Einstellungen'' im Feld ''Google Analytics Id'' die vorhin notierte GA-ID ein.

[[Datei:ga_layout_tl.png|Seitenlayout]]

Anschließend speichert und schließt man das Layout.

==Contao ab 2.9==
Seit Contao 2.9 wird GA über das Template ''moo_analytics.tpl'' eingebunden. Wie man ein Template über den im Core integrierten Template-Editor einbindet, ist [[Templates_bearbeiten|hier]] beschrieben. Nachdem das Template ausgewählt wurde, wird das Template bearbeitet.

[[Datei:ga_templateedit.png|Template bearbeiten]]

Wie schon in dem Kommentar des Templates vermerkt ist, braucht nur die im Code eingefügte Blind-ID (UA-XXXXX-X) gegen die vorhin notierte GA-ID ausgetauscht werden. Anschließend kann das Template gespeichert und geschlossen werden.

Nun muss im Seitenlayout das Script eingebunden werden. Dazu setzt man unter ''Skript-Einstellungen'' einen Haken bei dem Punkt ''moo_analytics''. Es muss darauf geachtet werden, dass dieses Skript als letztes eingebunden wird! Anschließend wird das Layout gespeichert und geschlossen.

[[Datei:ga_layout.png|Seitenlayout]]

===IP-Adressen anonymisieren===
Aus Datenschutzgründen bietet GA seit geraumer Zeit die Möglichkeit, die geloggten IP-Adressen der Besucher zu anonymisieren. Dazu muss nochmal das Template bearbeitet werden und zwischen der Zeile <code>_gaq.push(['_setAccount', 'UA-XXXXX-X']);</code> und der Zeile <code>_gaq.push(['_trackPageview']);</code> eine neue Zeile mit folgendem Inhalt eingefügt werden:

<source lang="javascript">
_gaq.push(['_gat._anonymizeIp']);
</source>

Das ganze Template sieht dann wie folgt aus:
<source lang="php">
<?php

/**
* To use the script, replace UA-XXXXX-X in the code below with your Google
* Analytics ID and then add it to a Contao page layout. Make sure to insert
* it as the last moo_ script (!) and note that it will only be added to the
* page if you are not logged into the back end.
*/
if (!BE_USER_LOGGED_IN && sha1(session_id() . (!$GLOBALS['TL_CONFIG']['disableIpCheck'] ? $this->Environment->ip : '') . 'BE_USER_AUTH') != $this->Input->cookie('BE_USER_AUTH')):

?>

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

=Einbinden von Google Analytics mit Erweiterungen=
Statt der Anapssung an den Templates (ab Contao 2.9) kann die Erweiterung [[GoogleAnalytics]] genutzt werden.

=Bestimmte Rechner (Webmaster, Kunden) vom Tracking ausschliessen=
Mit GA ist es möglich, bestimmte Rechner von den Statistiken auszuschliessen. Zum Beispiel ist es sinnvoll, den Entwickler oder Webmaster von der Datenerfassung auszuschliessen, da sonst die Statistik verfälscht wird. GA bietet dafür [http://www.google.com/support/analytics/bin/answer.py?hl=de&answer=55481 die Filter Funktion auf Profil-Ebene].<br />
Eine Möglichkeit, um gezielt Rechner auszuschliessen besteht darin, auf diesen Rechnern ein bestimmtes Cookie zu installieren. GA erkennt dieses Cookie und führt dann kein Tracking aus.

==Installation==
===Google Analytics Filter===
In der GA Konto- bzw. Profilübersicht wählt man ''Bearbeiten'' für die gewünschte Domain. In den Profileinstellungen dann "Filter hinzufügen" wählen, dann die Felder wie folgt ausfüllen:<br />
Filtername: nach cookie, Benutzerdefinierter Filter, Ausschliessen, Filterfeld: Benutzerdefiniert, Filtermuster: no_report, Gross-/Klein: Nein.<br />
"Änderungen Speichern" wählen um den Filter zu erstellen.

===Auszuschliessende Rechner identifizieren===
Damit die Webseite erkennt, ob der ausführende Rechner vom Tracking ausgeschlossen werden soll oder nicht, wird ein Cookie verwendet. Das Cookie wird bei jedem Webseitenaufruf automatisch per Javascript installiert. Allerdings nur auf den Rechnern, die ein solches Cookie explizit wünschen. Das Javascript erkennt anhand des [[w:de:User_Agent|userAgent]] Strings, ob der Rechner ein Cookie wünscht oder nicht. Wenn der Google Analytics Tracking Code im userAgent String vorkommt, wird das Cookie installiert.

Um den userAgent String anzupassen kann wie folgt vorgegangen werden:
* '''Internet Explorer''': Um den userAgent String im Internet Explorer anzupassen, muss in die Registry eingegriffen werden. Dazu den folgenden Code in den Editor kopieren, den GA Tracking Code UA-XXXXX-X an den eigenen anpassen und als *.reg speichern. Anschliessend die Datei doppelklicken.
Für '''IE7:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"
</source>
Für '''IE8:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"
</source>
Für '''IE9:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
@="Mozilla/5.0"
"Version"="MSIE 9.0 UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
@="Mozilla/5.0"
"Version"="MSIE 9.0 UA-XXXXX-X"
</source>
Quelle: [http://www.ideadapt.net ideadapt]
* '''Mozilla Firefox (Version < 4)''': about:config in Adresszeile eingeben, Warnung aktzeptieren, Liste nach general.useragent.extra.firefox filtern, Eintrag mit Doppelklick bearbeiten und gewünschten Tracking Code am Ende einfügen, Änderungen mit OK übernehmen und Firefox neu starten.
{{Hinweis|Gemäss der [https://developer.mozilla.org/en/Gecko_user_agent_string_reference#implementation Gecko user agent string reference] unterstützt Firefox 4 und höher diese Variante nicht mehr. Eine Lösung ist in Arbeit.}}
* '''Opera''': opera:config#ISP|Id in Adresszeile eingeben, im Feld Id den Tracking Code eingeben, Änderungen speichern und Opera neu starten.
* '''Safari''': Im Menu auf Bearbeiten > Einstellungen, dann auf den Tab Erweitert, die Einstellung "Menu 'Entwickler' in der Menüleiste anzeigen" aktivieren. Einstellungen schliessen. Im Menu auf Entwickler > User Agent > Anderer ... Den Tracking Code am Ende einfügen und mit OK Änderungen speichern. Neustart nicht erforderlich.
* Allgmeine Anleitungen: [[w:de:User_Agent#Benutzerdefiniert|Wikipedia - für verschiedene Browser]], [http://www.fiddlertool.com/ua.aspx fiddlertool - Anzeige von userAgent und Installationsanleitungen]

===Google Analytics Javascript anpassen===
Das folgende Javascript sollte bei jedem Seitenaufruf ausgeführt werden. Dementsprechend also z.B. im Head Bereich des HTML entsprechend einbinden. Zuvor noch UA-XXXXX-X durch den eigenen Tracking Code ersetzen.
<source lang="javascript">
if(navigator.userAgent && navigator.userAgent.match(/UA-XXXXX-X/)){
_gaq.push(['_setVar', 'no_report']);
}
</source>
Dieses Script bezieht sich möglicherweise nicht auf die von Ihnen verwendete GA API Version. [http://www.google.com/support/analytics/bin/answer.py?hl=de&answer=55481 Welche Version verwende ich?]

Google Analytics

2011-05-17T21:57:06Z

Bubblez:

[[Category:Core]]
{{AppliesTo
|TLVersion=bis 2.8.x
|Version=ab 2.9
}}

=Allgemeines=
[[w:de:Google_Analytics|Google Analytics]] ist ein kostenloser Dienst, welcher der Analyse von Zugriffen auf Webseiten dient (Es gilt nur ein monatliches Limit an Seitenaufrufen in Höhe von 5.000.000 Aufrufen).

{{Hinweis|Um Verfälschungen auszuschließen, wird der Google Analytics Code erst im Frontend angezeigt, wenn man sich aus dem Backend ausgeloggt hat.}}

==Alternativen==
Eine Alternative zu Google Analytics stellt [[Piwik]] dar.

==Rechtliches==
Es ist rechtlich noch nicht klar, ob es nun verboten ist, die Daten in Deutschland mit Google-Analytics zu erfassen. 2 Dinge sprechen erst einmal dagegen:
#Die Google Server sind nicht unbedingt in Deutschland.
#Die IP wird erfasst und die gewonnenen Daten können nicht einfach von einem Seitenbetreiber gelöscht werden, wenn ein Besucher dies verlangt.

Es gibt inzwischen ein Addon für einige Browser von Google, die Analytics Datensammlung deaktivieren: http://tools.google.com/dlpage/gaoptout?hl=de

Wer sicher gehen möchte, der kann ab Contao 2.9 die IP von den Besuchern anonymisieren und so dem Datenschutz genügen (siehe [[#IP-Adressen_anonymisieren|IP-Adresse anonymisieren]]).

{{Achtung|'''Dies ist keine Rechtsberatung.''' Detaillierte Angaben zur rechtlichen Situation beim Einsatz von Google Analytics sind von jeder selbst bei einem Rechtsanwalt zu erfragen (am besten in dem Fachgebiet Internet).}}

=Google Analytics Konto erstellen=
Um den Dienst ''Google Analytics'' (nachfolgend GA) nutzen zu können, muss man sich zuerst ein GA-Konto [http://www.google.com/analytics/ erstellen].<br />
Nach dem Erstellen eines Accounts gibt man GA die Domain bekannt, auf der der Dienst laufen soll. Dazu klickt man auf ''Neues Konto'' ...

[[Datei:ga_createaccount.png|Google Analytics Account erstellen]]

... und anschließend auf ''Anmelden''.

[[Datei:ga_login.png|Webseite hinzufügen]]

Anschließend erfolgen die Angaben zur Webseite, auf der GA laufen soll.

[[Datei:ga_websitesettings.png|Webseiten Angaben]]

Nachdem man den Geschäftsbedingungen zugestimmt hat, kommt man zur Seite mit dem Tracking-Code. In diesem Code notiert man sich die Account-Nummer; die wird später noch benötigt.

{{Hinweis| In den Google Geschäftsbedingungen (PUnkt 8.1) wird man Aufgefordert einen dort angegebenen Satz auf seiner Webseite einzubringen. Das sollte man auf jeden Fall machen, da es dort um die Datenschutzrichtlinien geht, die eh jeder auf seiner Internetseite auszeichnen sollte! }}

[[Datei:ga_trackingcode.png|Tracking Code]]

Nach dem Speichern der Eingaben kommt man zur Übersicht, wo nun die erstellte Webseite auf scheint.

[[Datei:ga_overview.png]]
=Einbinden von Google Analytics mittels der Core-Funktion=
==Typolight bis 2.8.x==
Um GA in TYPOlight bis 2.8.x einzubinden, bearbeitet man das entsprechende Seitenlayout und fügt unter ''Experten-Einstellungen'' im Feld ''Google Analytics Id'' die vorhin notierte GA-ID ein.

[[Datei:ga_layout_tl.png|Seitenlayout]]

Anschließend speichert und schließt man das Layout.

==Contao ab 2.9==
Seit Contao 2.9 wird GA über das Template ''moo_analytics.tpl'' eingebunden. Wie man ein Template über den im Core integrierten Template-Editor einbindet, ist [[Templates_bearbeiten|hier]] beschrieben. Nachdem das Template ausgewählt wurde, wird das Template bearbeitet.

[[Datei:ga_templateedit.png|Template bearbeiten]]

Wie schon in dem Kommentar des Templates vermerkt ist, braucht nur die im Code eingefügte Blind-ID (UA-XXXXX-X) gegen die vorhin notierte GA-ID ausgetauscht werden. Anschließend kann das Template gespeichert und geschlossen werden.

Nun muss im Seitenlayout das Script eingebunden werden. Dazu setzt man unter ''Skript-Einstellungen'' einen Haken bei dem Punkt ''moo_analytics''. Es muss darauf geachtet werden, dass dieses Skript als letztes eingebunden wird! Anschließend wird das Layout gespeichert und geschlossen.

[[Datei:ga_layout.png|Seitenlayout]]

===IP-Adressen anonymisieren===
Aus Datenschutzgründen bietet GA seit geraumer Zeit die Möglichkeit, die geloggten IP-Adressen der Besucher zu anonymisieren. Dazu muss nochmal das Template bearbeitet werden und zwischen der Zeile <code>_gaq.push(['_setAccount', 'UA-XXXXX-X']);</code> und der Zeile <code>_gaq.push(['_trackPageview']);</code> eine neue Zeile mit folgendem Inhalt eingefügt werden:

<source lang="javascript">
_gaq.push(['_gat._anonymizeIp']);
</source>

Das ganze Template sieht dann wie folgt aus:
<source lang="php">
<?php

/**
* To use the script, replace UA-XXXXX-X in the code below with your Google
* Analytics ID and then add it to a Contao page layout. Make sure to insert
* it as the last moo_ script (!) and note that it will only be added to the
* page if you are not logged into the back end.
*/
if (!BE_USER_LOGGED_IN && sha1(session_id() . (!$GLOBALS['TL_CONFIG']['disableIpCheck'] ? $this->Environment->ip : '') . 'BE_USER_AUTH') != $this->Input->cookie('BE_USER_AUTH')):

?>

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

=Einbinden von Google Analytics mit Erweiterungen=
Statt der Anapssung an den Templates (ab Contao 2.9) kann die Erweiterung [[GoogleAnalytics]] genutzt werden.

=Bestimmte Rechner (Webmaster, Kunden) vom Tracking ausschliessen=
Mit GA ist es möglich, bestimmte Rechner von den Statistiken auszuschliessen. Zum Beispiel ist es sinnvoll, den Entwickler oder Webmaster von der Datenerfassung auszuschliessen, da sonst die Statistik verfälscht wird. GA bietet dafür [http://www.google.com/support/analytics/bin/answer.py?hl=de&answer=55481 die Filter Funktion auf Profil-Ebene].<br />
Eine Möglichkeit, um gezielt Rechner auszuschliessen besteht darin, auf diesen Rechnern ein bestimmtes Cookie zu installieren. GA erkennt dieses Cookie und führt dann kein Tracking aus.

==Installation==
===Google Analytics Filter===
In der GA Konto- bzw. Profilübersicht wählt man ''Bearbeiten'' für die gewünschte Domain. In den Profileinstellungen dann "Filter hinzufügen" wählen, dann die Felder wie folgt ausfüllen:<br />
Filtername: nach cookie, Benutzerdefinierter Filter, Ausschliessen, Filterfeld: Benutzerdefiniert, Filtermuster: no_report, Gross-/Klein: Nein.<br />
"Änderungen Speichern" wählen um den Filter zu erstellen.

===Auszuschliessende Rechner identifizieren===
Damit die Webseite erkennt, ob der ausführende Rechner vom Tracking ausgeschlossen werden soll oder nicht, wird ein Cookie verwendet. Das Cookie wird bei jedem Webseitenaufruf automatisch per Javascript installiert. Allerdings nur auf den Rechnern, die ein solches Cookie explizit wünschen. Das Javascript erkennt anhand des [[w:de:User_Agent|userAgent]] Strings, ob der Rechner ein Cookie wünscht oder nicht. Wenn der Google Analytics Tracking Code im userAgent String vorkommt, wird das Cookie installiert.

Um den userAgent String anzupassen kann wie folgt vorgegangen werden:
* '''Internet Explorer''': Um den userAgent String im Internet Explorer anzupassen, muss in die Registry eingegriffen werden. Dazu den folgenden Code in den Editor kopieren, den GA Tracking Code UA-XXXXX-X an den eigenen anpassen und als *.reg speichern. Anschliessend die Datei doppelklicken.
Für '''IE7:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"
</source>
Für '''IE8:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
"Version"="UA-XXXXX-X"
</source>
Für '''IE9:'''
<source lang="reg">
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
@="Mozilla/5.0"
"Version"="MSIE 9.0 UA-XXXXX-X"

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent]
@="Mozilla/5.0"
"Version"="MSIE 9.0 UA-XXXXX-X"
</source>
Quelle: [http://www.ideadapt.net ideadapt]
* '''Mozilla Firefox (Version < 4)''': about:config in Adresszeile eingeben, Warnung aktzeptieren, Liste nach general.useragent.extra.firefox filtern, Eintrag mit Doppelklick bearbeiten und gewünschten Tracking Code am Ende einfügen, Änderungen mit OK übernehmen und Firefox neu starten.
{{Hinweis|'''Firefox >= 4 nicht unterstützt.''' Gemäss der [https://developer.mozilla.org/en/Gecko_user_agent_string_reference#implementation Gecko user agent string reference] unterstützt Firefox 4 und höher diese Variante nicht mehr. Eine Lösung ist in Arbeit.}}
* '''Opera''': opera:config#ISP|Id in Adresszeile eingeben, im Feld Id den Tracking Code eingeben, Änderungen speichern und Opera neu starten.
* '''Safari''': Im Menu auf Bearbeiten > Einstellungen, dann auf den Tab Erweitert, die Einstellung "Menu 'Entwickler' in der Menüleiste anzeigen" aktivieren. Einstellungen schliessen. Im Menu auf Entwickler > User Agent > Anderer ... Den Tracking Code am Ende einfügen und mit OK Änderungen speichern. Neustart nicht erforderlich.
* Allgmeine Anleitungen: [[w:de:User_Agent#Benutzerdefiniert|Wikipedia - für verschiedene Browser]], [http://www.fiddlertool.com/ua.aspx fiddlertool - Anzeige von userAgent und Installationsanleitungen]

===Google Analytics Javascript anpassen===
Das folgende Javascript sollte bei jedem Seitenaufruf ausgeführt werden. Dementsprechend also z.B. im Head Bereich des HTML entsprechend einbinden. Zuvor noch UA-XXXXX-X durch den eigenen Tracking Code ersetzen.
<source lang="javascript">
if(navigator.userAgent && navigator.userAgent.match(/UA-XXXXX-X/)){
_gaq.push(['_setVar', 'no_report']);
}
</source>
Dieses Script bezieht sich möglicherweise nicht auf die von Ihnen verwendete GA API Version. [http://www.google.com/support/analytics/bin/answer.py?hl=de&answer=55481 Welche Version verwende ich?]

Catalog Templates anpassen

2011-03-26T00:48:00Z

Bubblez: /* Zeilenumbrüche in Texten von textarea Feldern im Frontend als HTML Umbrüche ausgeben */

Catalog Templates anpassen

2011-03-26T00:47:22Z

Bubblez: /* Zeilenumbruch im textarea Feld des Backend als HTML ausgeben */

Catalog Templates anpassen

2011-03-26T00:46:16Z

Bubblez:

2011-01-10T19:59:08Z

Bubblez: hat eine neue Version von „Datei:Screen manualsort.png“ hochgeladen