Wikizone - Benutzerbeiträge [de]

Real URL (realurl)

2008-07-25T15:00:27Z

91.47.59.186: /* Alte Simulatic Links */

== Tipps ==

===Alte Simulatic Links===
von außen erhalten...
RewriteRule ([0-9]+)\.([0-9]+)\.html$ http:///index.php?id=$1&type=$2 [R=301,L]
Sprich: meineDomain.de/123.html wird zu meineDomain.de/index.php?id=123
Wenn die Seiten andere IDs beinhalten dann kann man alte Seiten per Redirect umleiten (siehe htaccess)

===Lange Pfade abkürzen===
Manchmal hat man sehr lange Pfade wenn die Navigation in Unterordnern liegt. Mit der Extension '''aoe_realurlpath''' kann man diese Teile "cutten"

Vorgehen
* Extension installieren
* realurl konfiguration anpassen
'pagePath' => array (
'type' => 'user',
// -> delete this
// 'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
// -> use this
'userFunc' => 'EXT:aoe_realurlpath/class.tx_aoerealurlpath_pagepath.php:&tx_aoerealurlpath_pagepath->main'
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',

== Probleme lösen ==
* Fehlermeldung Pfad/sowieso/ not found nearest match is
** Problem bei der Konfigurationsdatei (Leerzeichen vorne, falsche id etc.)
* Stylesheets, Bilder etc. aus TypoScript Konfiguration werden nicht gefunden.
** BaseURL stimmt nicht config.baseURL = http://www.meineDomain.de/
* Konfiguration loswerden:
** realurl und urltools Verweisen in der localconf auf ihr Konfigurationsfile. Alle Einträge und die Dateien können gelöscht werden wenn nicht mehr benötigt.

== Quickinfo ==

* Configure Apache
* TypoScript

<pre>
config{
simulateStaticDocuments = 0
tx_realurl_enable = 1
baseURL = http://www.grauff.com/
}
</pre>
* First try autoconfiguration
* If doesen't work switch off and use manual configuration or use aeurltool (or realurlsettings) (easier to configure and contains working standard configuration)
* look section tipps for better configuration

== Configure Apache ==
RealURLs work by providing 'virtual paths' to 'virtual files'. These don't actually exist on the file-system, so you must tell Apache to let a PHP-script handle the request if it can't find the file. This way, all URLs to pages (like www.server.com/products/product1/left.html) will be 'redirected' to /index.php, which will handle the translation of the URL into GET parameters. Real files (like images, the TYPO3 backend, static html-files, etc.) will still be handled by Apache itself though.

You should put the supplied sample .htaccess file (called _.htaccess) in the root of your TYPO3-installation.

Alternatively, you could include the following lines in your httpd.conf, probably in the VirtualHost-section. Here is an example:

<pre>
<VirtualHost 127.0.0.1>
DocumentRoot /var/www/typo3/dev/testsite-3/
ServerName www.test1.intra
RewriteEngine On
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* /index.php
</VirtualHost>
</pre>

NOTICE: USING httpd.conf is currently known not to work since t3lib_div::getIndpEnv('TYPO3_SITE_URL') is not correct. Solution remains to be found.

If you put it into a .htaccess file it has to look slightly different, basically stripping the leading slashes (“/”):

<pre>
RewriteEngine On
#RewriteBase /mySubfolderIfNeeded
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php

</pre>

This will tell Apache that it should rewrite every URL that's not a filename, directory or symlink. It leaves everything starting with /typo3/ alone too.

Notice: For this work you need the Apache module “mod_rewrite”!

Also refer to the Appendix for extended information on mod_rewrite issues.

== TS Config ==
<pre>
config.simulateStaticDocuments = 0
config.baseURL = http://mydomain.com/
config.tx_realurl_enable = 1
</pre>

== localconf.php Configuration ==
with the variable $TYPO3_CONF_VARS['EXTCONF']['realurl']

This is managed automatically for newer realurl versions

<pre>
<?php

/**
*
* aeUrlTool default realurl configuration
* based on realurl-configuration of news.typo3.org
* http://news.typo3.org/about/realurl-configuration/
*
*/

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = array (
'_DEFAULT' => array (
'init' => array (
'enableCHashCache' => '1',
'appendMissingSlash' => 'ifNotFile',
'enableUrlDecodeCache' => '1',
'enableUrlEncodeCache' => '1',
),
'redirects' => array (
),
'preVars' => array (
'0' => array (
'GETvar' => 'no_cache',
'valueMap' => array (
'nc' => '1',
),
'noMatch' => 'bypass'
),
'1' => array (
'GETvar' => 'L',
'valueMap' => array (
'de' => '0',
'en' => '1',
),
'noMatch' => 'bypass',
),
'2' => array (
'GETvar' => 'lang',
'valueMap' => array (
'de' => 'de',
'en' => 'en',
),
'noMatch' => 'bypass',
),
),
'pagePath' => array (
'type' => 'user',
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',
),
'fixedPostVars' => array (
),
'postVarSets' => array (
'_DEFAULT' => array (
'archive' => array (
'0' => array (
'GETvar' => 'tx_ttnews[year]',
),
'1' => array (
'GETvar' => 'tx_ttnews[month]',
'valueMap' => array (
'january' => '01',
'february' => '02',
'march' => '03',
'april' => '04',
'may' => '05',
'june' => '06',
'july' => '07',
'august' => '08',
'september' => '09',
'october' => '10',
'november' => '11',
'december' => '12',
),
),
),
'browse' => array (
'0' => array (
'GETvar' => 'tx_ttnews[pointer]',
),
),
'select_category' => array (
'0' => array (
'GETvar' => 'tx_ttnews[cat]',
),
),
'article' => array (
'0' => array (
'GETvar' => 'tx_ttnews[tt_news]',
'lookUpTable' => array (
'table' => 'tt_news',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause' => ' AND NOT deleted',
'useUniqueCache' => '1',
'useUniqueCache_conf' => array (
'strtolower' => '1',
'spaceCharacter' => '-',
),
),
),
'1' => array (
'GETvar' => 'tx_ttnews[swords]',
),
),
),
),
'fileName' => array (
//
// if you don't want .html-URLs set the following to "false" (e.g. 'defaultToHTMLsuffixOnPrev' => false,)
// then you get http://www.yourdomain.com/imprint/ instead of http://www.yourdomain.com/imprint.html
//
'defaultToHTMLsuffixOnPrev' => true,
'index' => array (
'rss.xml' => array (
'keyValues' => array (
'type' => '100',
),
),
'rss091.xml' => array (
'keyValues' => array (
'type' => '101',
),
),
'rdf.xml' => array (
'keyValues' => array (
'type' => '102',
),
),
'atom.xml' => array (
'keyValues' => array (
'type' => '103',
),
),
),
),
),

);

?>
</pre>

Htaccess

2008-07-25T14:49:51Z

91.47.59.186: /* Erlaubte Anweisungen in .htaccess-Dateien */

== Anwendung von .htaccess - Dateien ==
=== Weiterführende Links: ===
http://httpd.apache.org/docs/1.3/howto/htaccess.html

von: http://www.uni-duesseldorf.de/Service/Webmaster/htaccess.php3 Juli 2006

Referenz: Apache Manual: http://www.uni-duesseldorf.de/apache-manual/

=== Wozu braucht man das ?===
An wen ein HTTP-Server Dokumente herausgibt, welche spezielle Verarbeitung er u.U. bei einer spezifischen Anforderung (einem request) durchführt - all das wird zunächst durch eine von der Server-Software abhängigen Konfiguration bestimmt, die ein Administrator - ein Webmaster - eingerichtet hat.

Oft ist es aber wünschenswert, daß einzelne Verantwortliche für eine Dokumentenhierarchie auf dem Web-Server selbst ohne Intervention des Webmasters Setzungen vornehmen können, daß z.B. auf einzelne Dokumente oder alle in einem bestimmten Verzeichnis nur ein Zugriff aus bestimmten Domains oder mit verifiziertem Usernamen möglich ist.

Beim Apache-HTTP-Server wie seinem Vorgänger, dem NCSA-httpd, gibt es diese Möglichkeiten durch die Einrichtung von .htaccess-Dateien in dem jeweiligen Verzeichnis. In der folgenden Darstellung wird als Referenz jeweils ein Verweis auf den entsprechenden Abschnitt in der lokale Kopie der Apache-Dokumentation für die Version 1.2 gegeben.

'''Achtung:''' In der Server-Konfiguration kann ein anderer Name als .htaccess vereinbart sein (AccesFileName-Direkt ive).

'''Zweiter Hinweis:''' Die Datei muß für den HTTP-Server lesbar sein, z.B. dadurch erreicht, daß sie öffentlich lesbar ist:

chmod 644 .htaccess

=== Zugriffsbeschränkung auf eine Domain ===
==== für alle Dateien in einem Verzeichnis ====
'''.htaccess'''

order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99

Alle Dateien in dem Verzeichnis werden nur an Clients ausgeliefert, die eine IP-Adresse beginnend mit 134.99 oder einen Hostnamen endend mit uni-duesseldorf.de besitzen; anderenfalls erfolgt eine Fehlermeldung des Servers (403 Forbidden).

Natürlich genügt in vielen Fällen eine der Alternativen. Beachten Sie dabei die Unterschiede:

* Die Angabe des Domain-Namens allein schließt - bewußt oder nicht - den Zugriff von PC's aus, die nicht im Domain Name System (DNS) registriert sind.
* Die Angabe des IP-Subnetzes allein kann andere ausschließen, die organisatorisch zur gleichen Domain gehören, technisch aber in einem anderen Subnetz hängen.

Wie lässt sich diese Zugriffsbeschränkung testen? Normalerweise benötigt man dazu einen Internet-Zugang über einen anderen Provider (T-Online, AOL, Compuserve etc.). Oder man benutzt einen Browser auf dem Server selbst z.B. in folgender Weise:

lynx http://localhost/Service/Webmaster/htaccess.phtml

Der Zugriff erfolgt dann über das Loopback-Interface mit der IP-Adresse 127.0.0.1.

Referenz: order, deny, allow.

==== für einzelne Dateien ====
'''.htaccess'''

<Files huh*.html>
order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99
</Files>

Die Zugriffsbeschränkung wie oben gilt jetzt nur für die Dateien, deren Namen auf das hinter Files angegebene Muster passen. Es kann ein einzelner Name angegeben werden oder ein Muster mit den Wildcard-Zeichen ? für ein beliebiges einzelnes Zeichen oder * für eine beliebige Folge von Zeichen.

Schließlich sind auch feinere Muster über reguläre Ausdrücke möglich. Die Syntax der Files-Direktive dafür ist:

<Files ~ "regexp">

Referenz: <Files>, order, deny, allow.

=== Zugriffsbeschränkung über Passwort ===
==== für ein Verzeichnis ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
require valid-user

Dokumente in einem Verzeichnis mit dieser .htaccess-Datei (oder einem Unterverzeichnis) können erst nach Eingabe eines gültigen Benutzernamen und Passwortes gelesen werden. Der Wert hinter AuthName wird vom Browser in der Dialog-Box für die Passwortabfrage angezeigt und dient gleichzeitig dazu, andere Dokumente mit dem gleichen Schutz zu erkennen und einmal eingelesene Werte für Username und Password ohne erneute Abfrage unmittelbar zu verwenden.

Hinter AuthUserFile steht der Pfad der Passwortdatei, die die Benutzernamen und (verschlüsselten) Passwörter enthält. Sie sieht etwa so aus:

/home/meyer/passwd

meyer:xm.kPd4VJc3Fo
mueller:eJFQCL8GftDXI

Auch die Passwortdatei muß für den HTTP-Server lesbar sein. Gerade deshalb sollte sie niemals in demselben Bereich liegen wie die vom Server bedienten Dokumente, da sonst zumindest die gültigen Benutzernamen lesbar wären. (Aus diesem Grund müssen Sie aber u.U. daran denken, auch das entsprechende Verzeichnis - wie /home/meyer im Beispiel - für den HTTP-Server zumindest suchbar zu setzen, also etwa:

chmod 711 /home/meyer

Angelegt und gepflegt werden kann die Passwortdatei mit dem Programm htpasswd:

htpasswd -c /home/meyer/passwd meyer
htpasswd /home/meyer/passwd mueller

Referenz: AuthType, AuthName, AuthUserFile, require.

==== für einzelne Dateien ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
<Files Huh*.html>
require user meyer mueller
</Files>

Die Kombination von 2. und 3. - Passwortschutz für einzelne Dateien in dem aktuellen Verzeichnis. Beim require wird hier noch eine andere Alternative gezeigt: die Aufzählung einzelner Benutzernamen aus der Passwortdatei. Wenn neue Benutzer in der Passwortdatei ergänzt werden, haben diese noch keinen Zugriff auf die so geschützten Seiten.

Wenn die gleiche Liste von Benutzern an mehreren Stellen verwendet werden soll, ist die Definition der Liste über eine Gruppendatei empfehlenswert. Für diese dritte Alternative bzgl. der require-Direktive sind fogende Änderungen notwendig:

1. In der .htaccess-Datei wird eine Gruppendatei angegeben:
AuthGrouprFile /home/meyer/groups
Für den Ort der Ablage dieser Datei gelten dieselben Erwägungen wie für die Passwortdatei oben.
2. In der require-Direktive wird jetzt auf eine Gruppendefinition in der Gruppendatei Bezug genommen:
require group meyers
3. Die Gruppendatei ist eine einfache Textdatei mit je einer Gruppendefinition pro Zeile in folgender Form:

/home/meyer/groups
meyers: meyer mueller

Referenz: AuthType, AuthName, AuthUserFile, AuthGroupFile, <Files>, require.

===Spezielle Optionen===
==== automatischer Index (Directory Listing)====
ausführliche Infos hier: [[htaccess - Directory Listing]]

'''.htaccess'''
Options +Indexes

Mittels der Options-Direktive können - so von der globalen Server-Konfiguration her erlaubt - Voreinstellungen für Verarbeitungsoptionen für das aktuelle Verzeichnis und Unterverzeichnisse überschrieben werden.

Die gezeigte Variante weist den Server an, bei der Referenz auf das aktuelle Verzeichnis oder ein Unterverzeichnis ein Directory-Listing als Index-Datei automatisch zu generieren. Er macht dies allerdings nur, wenn nicht schon eine Index-Datei (mit vordefiniertem Namen wie index.html) vorhanden ist. Ggf. kann man die hier bekannten Namen mit der Direktive

DirectoryIndex Welcome.html

einschränken.

Referenz: Options, DirectoryIndex.

=== Weiterleitung mit .htaccess ===

Hinweis: eine Alternative hierfür ist eine PHP Weiterleitung ([[PHP - Tipps und Tricks]])
Quelle Dr.Web 28.12.2006

Sie können sowohl Zugriffe auf bestimmte Dateien als auch auf Verzeichnisse bequem weiterleiten. Das klappt innerhalb der eigenen Domain, aber auch mit externen Verweisen.

Die Datei .htaccess kann mit jedem Text-Editor bearbeitet werden. Eine Umleitung könnte so aussehen:

Redirect /beispielverzeichnis http://www.drweb.de

Ruft jemand die URL http://www.drweb.de/beispielverzeichnis auf landet er ohne weiteren Zwischenstopp direkt auf der Startseite.

Mit Einzeldateien klappt es auch:

Redirect /beispielseite.shtml http://www.drweb.de

oder

Redirect /beispielseite.shtml neueseite.shtml

Wer mag, kann die gesamte Domain auf eine andere umleiten

Redirect / http://www.drweb.de/

Nützlich während Bauarbeiten, bei Reparaturen oder wenn Dateien durch andere ersetzt wurden. Da die Umleitung serverseitig geschieht, spielt der Browser des Besuchers keine Rolle.

== Erlaubte Anweisungen in .htaccess-Dateien ==

http://de.selfhtml.org/servercgi/server/htaccess.htm

Auszug (Datum des Zugriffs: 10.9.2007):
<pre>
Die Anweisung AllowOverride kann nicht innerhalb einer .htaccess notiert werden, sondern wird ausschließlich vom Server-Administrator in der zentralen Konfigurationsdatei vorgegeben. Um den AllowOverride-Wert in Erfahrung zu bringen, benötigen Sie Einsicht in die Serverkonfiguration. Kontaktieren Sie dazu gegebenenfalls Ihren Webhosting-Provider. Dieser kann den Wert auch ändern, falls Sie bestimmte bisher nicht erlaubte Anweisungen verwenden möchten. Im einzelnen gibt es dafür folgende mögliche Werte:

* Mit AllowOverride None wird der Webserver angewiesen, .htaccess-Dateien zu ignorieren. Das ist im Übrigen die Voreinstellung.
* Mit AllowOverride All wird festgelegt, dass in einer .htaccess-Datei (so gut wie) sämtliche zentrale Vorgaben überschrieben und damit abgeändert werden dürfen. Das kann bedeuten, dass Vorhaben, die eigentlich verboten sind (beispielsweise die Ausführung von CGI-Scripts), mit Hilfe einer .htaccess-Datei erlaubt werden. Als Server-Administrator werden Sie diese Anweisung also nur sehr vorsichtig einsetzen.
* Mit AllowOverride Options wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung spezieller Verzeichniseigenschaften zulässig sind.
* Mit AllowOverride Limit wird festgelegt, dass in einer .htaccess-Datei nach unten Zugriffe von bestimmten Hosts erlaubt oder untersagt werden können.
* Mit AllowOverride Indexes wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung von Verzeichnisindizes zulässig sind.
* Mit AllowOverride FileInfo wird festgelegt, dass in einer .htaccess-Datei Anweisungen zur Akzeptanz bestimmter Dokumenttypen zulässig sind - beispielsweie, um nach unten Individuelle Fehlermeldungen ausgeben zu können.
* Mit AllowOverride AuthConfig wird festgelegt, dass in einer .htaccess-Datei Autorisierungsanweisungen stehen dürfen - das betrifft beispielsweise Regelungen zum nach unten Passwortschutz.

Diese Werte können auch miteinander kombiniert werden. All ist der mächtigste Parameter, mit dem alles das zugelassen wird, was die anderen Parameter steuern.
</pre>

Nach dem Ändern muß natürlich der Server neu gestartet werden (bei Debian: apache restart)

== Moved Permanently 301 Redirect ==
Quelle:http://www.fladi.de/2008/04/28/howto-webseiten-redirect-mit-301/ (25.7.2008)

Was ist ein 301 redirect?

301 redirect ist die wohl beste Möglichkeit das aktuelle Suchmaschinenranking beim Umzug einer Seite oder des gesamten Webauftritts zu behalten. Der Code “301″ steht für “moved permanently” (dauerhaft verschoben). Ein solches Redirect wird in der .htaccess Datei eintragen. Es trägt die Form (alles in einer Zeile):

redirect 301 pfad/alte/seite/datei.html http://www.domain.de/pfad/neue/seite/datei.html

Beachte, kein “http://www” in das erste Statement zu schreiben. Es muss der komplette Pfad vom Root deines Webservers angegeben werden. Schauen wir uns die Zeile nun nochmal genauer an:

* “redirect 301″ - die eigentliche Anweisung für den Webserver
* “/pfad/alte/seite/datei.html” - die Seite die umgeleitet werden soll
* “http://www.domain.de/pfad/neue/seite.datei.html” - die komplette neue URL

Wie reagiert nun ein Suchmaschinen-Spider auf eine solche Umleitung? Die .htaccess wird ja nicht vom Spider ausgelesen, sondern vom Webserver “ausgeführt”. Der Spider jedoch erkennt den Statuscode, den der Webserver liefert. Beim nächsten Update seiner Datenbank sollte die Suchmaschine nun die alte URL aus dem Index werfen und die neue aufnehmen. Häufig kommt es aber auch vor, dass alte und neue URL gemischt auftauchen. Auch leichte Änderungen im Pagerank können auftreten. Es dauert so ca. 6-8 Wochen bis sich die Änderungen an der Seite auch in den Suchergebnissen niederschlagen.

Weitere Möglichkeiten von 301 redirect:

1. Um ALLE Dateien Deiner Domain mithilfe einer .htaccess umzuleiten kannst Du (auf einem Unix/Linux-Webserver) i.d.R. folgendes verwenden:
redirect 301 ^(.*)$ http://www.domain.de
redirectMatch permanent ^(.*)$ http://www.domain.de

Um Deine alte Startseite (index.html) umzuleiten:
redirect 301 /index.html http://www.domain.de/index.html
redirect permanent /index.html http://www.domain.de/index.html

2. Wenn Du http://domain.de auf http://www.domain.de umleiten möchtest und mod_rewrite auf dem Webserver verfügbar ist, erreichst Du dies durch folgende .htaccess:

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=permanent,L]

oder

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=301,L]

3. Alle .html Dateien auf .php Dateien umzuleiten ist durch mod_rewrite auch kein großes Problem:

RewriteEngine on
RewriteBase /
RewriteRule (.*).html$ /$1.php

4. Um ein Verzeichnis und alles darunter umzuleiten:

redirectMatch 301 ^/verzeichnis-alt/(.*) http://www.domain.de/verzeichnis-neu/

=== Warum nicht per META-Tag redirect machen? ===

Die Umleitung per META-Tag erfolgt direkt in der aufgerufenen Seite. Dort wird im HEAD-Teil

<meta http-equiv=”refresh” content=”0; url=http://www.domain.de/”>
eingetragen. Hierbei bewirkt das “content=10″, dass der Browser nach 10 Sekunden die darauffolgende URL aufruft. Wenn man “content=0″ einträgt wird die Umleitung sofort ausgeführt. Ein paar alte Browser unterstützen diese Art der Umleitung nicht. Deshalb ist es besser noch zusätzlich den Link (neue Domain) mit anzugeben.

Technisch gesehen liefert die angefragte Seite, wie auch die Seite auf die umgeleitet wird, einen Statuscode “200 OK” zurück. Es sind also zwei unabhängige Seiten. Dementsprechend versucht die Suchmaschinen auch beide Seiten zu indizieren. Hier genau liegt aber das Problem. Denn der Spider des Suchmaschinenbetreibers erkennt die Umleitung und wertet Deine Seite deshalb u.U. ab, da es sich um eine beliebte SPAM-Methode handelt. So könnte man 1000 Domains mit solchen Seiten und jeder Menge Keywords einrichten. Echte Besucher (kein Spider) werden umgeleitet auf die eigentliche Seite. Indiziert wird aber nicht nur die eigentliche Seite sondern auch die 1000 Domains mit Keywords, die meist gar nichts mit dem eingentlichen Inhalt zu tun haben.

Beim 301 redirect wird hingegen nur die echte Zielseite in den Index aufgenommen und durch den Statuscode kann der Suchmaschinenbetreiber zusätzlich noch die veralteten Seite aus dem Index werfen. Dies ist also der beste Weg um alte Seiten auf neue umzuleiten und gleichzeitig wird auch der Page Rank mit übertragen.

Real URL (realurl)

2008-07-25T14:43:07Z

91.47.59.186: /* Tipps */

== Tipps ==

===Alte Simulatic Links===
von außen erhalten...
RewriteRule ([0-9]+)\.([0-9]+)\.html$ http:///index.php?id=$1&type=$2 [R=301,L]
Wenn die Seiten andere IDs beinhalten dann kann man alte Seiten per Redirect umleiten (siehe htaccess)

===Lange Pfade abkürzen===
Manchmal hat man sehr lange Pfade wenn die Navigation in Unterordnern liegt. Mit der Extension '''aoe_realurlpath''' kann man diese Teile "cutten"

Vorgehen
* Extension installieren
* realurl konfiguration anpassen
'pagePath' => array (
'type' => 'user',
// -> delete this
// 'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
// -> use this
'userFunc' => 'EXT:aoe_realurlpath/class.tx_aoerealurlpath_pagepath.php:&tx_aoerealurlpath_pagepath->main'
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',

== Probleme lösen ==
* Fehlermeldung Pfad/sowieso/ not found nearest match is
** Problem bei der Konfigurationsdatei (Leerzeichen vorne, falsche id etc.)
* Stylesheets, Bilder etc. aus TypoScript Konfiguration werden nicht gefunden.
** BaseURL stimmt nicht config.baseURL = http://www.meineDomain.de/
* Konfiguration loswerden:
** realurl und urltools Verweisen in der localconf auf ihr Konfigurationsfile. Alle Einträge und die Dateien können gelöscht werden wenn nicht mehr benötigt.

== Quickinfo ==

* Configure Apache
* TypoScript

<pre>
config{
simulateStaticDocuments = 0
tx_realurl_enable = 1
baseURL = http://www.grauff.com/
}
</pre>
* First try autoconfiguration
* If doesen't work switch off and use manual configuration or use aeurltool (or realurlsettings) (easier to configure and contains working standard configuration)
* look section tipps for better configuration

== Configure Apache ==
RealURLs work by providing 'virtual paths' to 'virtual files'. These don't actually exist on the file-system, so you must tell Apache to let a PHP-script handle the request if it can't find the file. This way, all URLs to pages (like www.server.com/products/product1/left.html) will be 'redirected' to /index.php, which will handle the translation of the URL into GET parameters. Real files (like images, the TYPO3 backend, static html-files, etc.) will still be handled by Apache itself though.

You should put the supplied sample .htaccess file (called _.htaccess) in the root of your TYPO3-installation.

Alternatively, you could include the following lines in your httpd.conf, probably in the VirtualHost-section. Here is an example:

<pre>
<VirtualHost 127.0.0.1>
DocumentRoot /var/www/typo3/dev/testsite-3/
ServerName www.test1.intra
RewriteEngine On
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* /index.php
</VirtualHost>
</pre>

NOTICE: USING httpd.conf is currently known not to work since t3lib_div::getIndpEnv('TYPO3_SITE_URL') is not correct. Solution remains to be found.

If you put it into a .htaccess file it has to look slightly different, basically stripping the leading slashes (“/”):

<pre>
RewriteEngine On
#RewriteBase /mySubfolderIfNeeded
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php

</pre>

This will tell Apache that it should rewrite every URL that's not a filename, directory or symlink. It leaves everything starting with /typo3/ alone too.

Notice: For this work you need the Apache module “mod_rewrite”!

Also refer to the Appendix for extended information on mod_rewrite issues.

== TS Config ==
<pre>
config.simulateStaticDocuments = 0
config.baseURL = http://mydomain.com/
config.tx_realurl_enable = 1
</pre>

== localconf.php Configuration ==
with the variable $TYPO3_CONF_VARS['EXTCONF']['realurl']

This is managed automatically for newer realurl versions

<pre>
<?php

/**
*
* aeUrlTool default realurl configuration
* based on realurl-configuration of news.typo3.org
* http://news.typo3.org/about/realurl-configuration/
*
*/

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = array (
'_DEFAULT' => array (
'init' => array (
'enableCHashCache' => '1',
'appendMissingSlash' => 'ifNotFile',
'enableUrlDecodeCache' => '1',
'enableUrlEncodeCache' => '1',
),
'redirects' => array (
),
'preVars' => array (
'0' => array (
'GETvar' => 'no_cache',
'valueMap' => array (
'nc' => '1',
),
'noMatch' => 'bypass'
),
'1' => array (
'GETvar' => 'L',
'valueMap' => array (
'de' => '0',
'en' => '1',
),
'noMatch' => 'bypass',
),
'2' => array (
'GETvar' => 'lang',
'valueMap' => array (
'de' => 'de',
'en' => 'en',
),
'noMatch' => 'bypass',
),
),
'pagePath' => array (
'type' => 'user',
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',
),
'fixedPostVars' => array (
),
'postVarSets' => array (
'_DEFAULT' => array (
'archive' => array (
'0' => array (
'GETvar' => 'tx_ttnews[year]',
),
'1' => array (
'GETvar' => 'tx_ttnews[month]',
'valueMap' => array (
'january' => '01',
'february' => '02',
'march' => '03',
'april' => '04',
'may' => '05',
'june' => '06',
'july' => '07',
'august' => '08',
'september' => '09',
'october' => '10',
'november' => '11',
'december' => '12',
),
),
),
'browse' => array (
'0' => array (
'GETvar' => 'tx_ttnews[pointer]',
),
),
'select_category' => array (
'0' => array (
'GETvar' => 'tx_ttnews[cat]',
),
),
'article' => array (
'0' => array (
'GETvar' => 'tx_ttnews[tt_news]',
'lookUpTable' => array (
'table' => 'tt_news',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause' => ' AND NOT deleted',
'useUniqueCache' => '1',
'useUniqueCache_conf' => array (
'strtolower' => '1',
'spaceCharacter' => '-',
),
),
),
'1' => array (
'GETvar' => 'tx_ttnews[swords]',
),
),
),
),
'fileName' => array (
//
// if you don't want .html-URLs set the following to "false" (e.g. 'defaultToHTMLsuffixOnPrev' => false,)
// then you get http://www.yourdomain.com/imprint/ instead of http://www.yourdomain.com/imprint.html
//
'defaultToHTMLsuffixOnPrev' => true,
'index' => array (
'rss.xml' => array (
'keyValues' => array (
'type' => '100',
),
),
'rss091.xml' => array (
'keyValues' => array (
'type' => '101',
),
),
'rdf.xml' => array (
'keyValues' => array (
'type' => '102',
),
),
'atom.xml' => array (
'keyValues' => array (
'type' => '103',
),
),
),
),
),

);

?>
</pre>

Mailformplus (tx mailformplus)

2008-07-25T05:08:43Z

91.47.59.186: /* Mit Datenbank-Speicherung */

== Post processing der Formularfelder ==
Es gibt einen Hook den man nutzen kann um nach dem Erfolgreichen senden des Formulars die '''Daten an eigene PHP Skripte''' zu übergeben.
(available since 3.7, thx to Martin Kutschker)
Die Standard Funktionen wie Mails versenden oder Datensätze einfügen werden dadurch nicht beeinflusst.

'''So gehts:'''

* define a user-function which will do the processing
* create a php file with a class and function which will be called when the form was submitted:

example:

'''class.tx_myext.php'''

content:

class tx_myext {
function doit(&$params, &$ref){
......
}
}

Die Variable '''$params'' enthält dann folgende Werte:

'''$params[config]''' Variablen die mit TypoScript übermittelt wurden. Z.B.:
saveUserFunc.dummy = hello
kann mit
$params[config][dummy]
angesprochen werden.

$params[data]
enthält alle übermittelten GET und POST Variablen

=== activate the hook with TypoScript ===
Als erstes muß man die Funktion definieren die ausgeführt werden soll:
plugin.tx_thmailformplus_pi1.saveUserFunc = EXT:myext/class.tx_myext.php:tx_myext->doit
Man kann auch mit TS Variablen definieren die an das Skript übermittelt werden.

plugin.tx_thmailformplus_pi1.saveUserFunc.dummy = hello

===Beispielkonfiguration (alt-brettheim.de)===
Version von Ende 2006
<pre>
### mailformplus konfigurieren ###
#Checkbox 'Zustimmung zur Datenspeicherung' soll nicht in der DB gespeichert werden
plugin.tx_thmailformplus_pi1{
#email_redirect = 547
saveLog.exclude = datenspeicherung
#Speicherung in die Datenbank
saveDB = 1
saveDB.dbkey=uid
saveDB.dbTable = pupKarte
saveDB.fileUpload = fileadmin/pupKarte/
saveDB.fileTypes = jpg,jpeg,png,JPG,JPEG,PNG
saveDB.fileSize = 1000000

#Schlüsselfeld der DB-Tabelle
#Datenbank zuordnung
saveDB.mapping = photo:fileid,geb18:geb18,name:name,vorname:vorname,gebDatum:gebDatum,strasse:strasse,plz:plz,ort:ort,gruppe:gruppe,andereGruppe:andereGruppe,funktionGruppe:funktionGruppe,vabmitglied:vabmitglied,waffentraeger:waffentraeger,dekowaffe:dekowaffe,messer:messer,dolchEinseitig:dolchEinseitig,dolchZweiseitig:dolchZweiseitig,hiebwaffe:hiebwaffe,stichwaffe:stichwaffe,stangenwaffe:stangenwaffe,bogen:bogen,armbrust:armbrust,sonstigeWaffen:sonstigeWaffen,sprengstofferlaubnis:sprengstofferlaubnis,uneingeschraenkt:uneingeschraenkt,sonstigeWaffeArt:sonstigeWaffeArt,behoerde:behoerde,erlaubnisNr:erlaubnisNr,weitereGenehmigung:weitereGenehmigung,mitgliedSeit:mitgliedSeit,weitereVabMitgliedschaft:weitereVabMitgliedschaft,funktionen:funktionen,ehrungen:ehrungen,telefon:telefon,email:email,internWirdBezogen:internWirdBezogen,internErwuenscht:internErwuenscht,sonstiges:sonstiges
#nicht ausgefüllte Felder ausfüllen...
#saveDB.if_is_empty.dekowaffe = ka
#saveDB.debug = 1
</pre>

=== Druckversion des Formulars ===
'''1. Abschnitt für Printtemplate im mailformplus-HTML-Template:'''

'''Beispiel'''
<pre>

You just filled out the following fields:<br>
Name: ###name###<br>
Subject: ###subject###<br>
<br>
you uploaded the following files:
###photo###
<br>
###cv###
<br>

</pre>

'''2. Eine Userfunktion zum speichern und übergeben der Session Variable'''
<pre>

<?PHP
####################################
# example user-function for #
# fetching the PRINT-subtemplate #
####################################

class user_mailformplus_userfunc {
var $cObj;

# this function returns the "PRINT" subtemplate
# if defined in the mailformplus-template
# replaced with the values the user has filled out.

function user_mailformplusPrint($content,$conf) {
$printVersion = $GLOBALS["TSFE"]->fe_user->getKey("ses","th_mailformplus".$GLOBALS["TSFE"]->id);
if ($printVersion) {
return $printVersion;
}
}
}
?>
</pre>

'''3. Das zugehörige TS Template'''
<pre>
includeLibs.mailformplus_functions = fileadmin/mailformplus_userfunc.inc.php
################################
# outputs the PRINT template below normal page content
# main content
################################

temp.main_content = COA
temp.main_content {
10 < styles.content.get
20 = USER
20.userFunc = user_mailformplus_userfunc->user_mailformplusPrint
}

...

page.10.subparts.CONTENT_MAIN < temp.main_content
</pre>

== Verschiedene Beispiele ==
=== JavaScript zur Validierung und Mailformplus ===
<pre>
plugin.tx_thmailformplus_pi1.multiPage.2.js (
if((document.Formular.bremsassi1.checked==false) && (document.Formular.bremsassi2.checked==false) && (document.Formular.bremsassi3.checked==false)){
alert('Bremsassistenten - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.esp1.checked==false) && (document.Formular.esp2.checked==false) && (document.Formular.esp3.checked==false) && (document.Formular.esp4.checked==false)){
alert('Elektronisches Stabilitätsprogramm - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.spurassi1.checked==false) && (document.Formular.spurassi2.checked==false) && (document.Formular.spurassi3.checked==false)){
alert('Spurassistent - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.acc1.checked==false) && (document.Formular.acc2.checked==false) && (document.Formular.acc3.checked==false)){
alert('Automatischer Abstandsregeltempomat - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.nvs1.checked==false) && (document.Formular.nvs2.checked==false) && (document.Formular.nvs3.checked==false)){
alert('Nachtsichtassistent - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}

)
</pre>
=== Beispiel mit verschiedenen Validierungen und Upload-Feld===
<pre>
plugin.tx_thmailformplus_pi1{
#email_requiredfields = email,name
#email_attachment = ###fsvorne###
#email_sendtouser >
#debug = 1

}

plugin.tx_thmailformplus_pi1.fieldConf {
name {
errorCheck = required
}
strasse {
errorCheck = required
}
plz_ort {
errorCheck = required
}
land {
errorCheck = required
}
telefon {
errorCheck = required
}
mail {
errorCheck = email,required
}
kennzeichen {
errorCheck = required
}
hersteller {
errorCheck = required
}
fahrzeugnummer {
errorCheck = required
}
art {
errorCheck = required
}
antrieb {
errorCheck = required
}
gewicht {
errorCheck = required
}
ezul {
errorCheck = date:dd.mm.yyyy
errorCheck.dateRange.min = 01.01.1900
errorCheck.dateRange.max = 31.12.2010
}
fsvorne {
errorCheck = required
numberOfAllowedFiles = 1
fileTypes = pdf,doc,jpg,gif,png
fileSize = 1500000
fileUpload = fileadmin/plakette/uploads/
errorText = <li>Das Feld Fahrzeugschein (Vorderseite) ist nicht korrekt ausgefüllt</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Vorderseite: |</div>
}
uploadedFiles.mail {
plainTemplate = ###filePath### ###fileName###
HTMLTemplate = <a href="###filePath######fileName###">###fileName###</a><br/>
plainWrap = |
HTMLWrap = |
}
}
fshinten {
numberOfAllowedFiles = 1
fileTypes = pdf,doc,jpg,gif,png
fileSize = 1500000
fileUpload = fileadmin/plakette/uploads/
errorText = <li>Das Feld Fahrzeugschein (Rückseite) ist nicht korrekt ausgefüllt</li><br/>
uploadedFiles {
template =  ###fileName### ###fileSize###  <br />
wrap = <div>Rückseite: |</div>
}
uploadedFiles.mail {
plainTemplate = ###filePath######fileName###
HTMLTemplate = <a href="###filePath######fileName###">###fileName###</a><br/>
plainWrap = |file end
HTMLWrap = |
}
}
}

[PIDinRootline=305,307,309,311]
plugin.tx_thmailformplus_pi1.fieldConf.fsvorne{
errorText = <li>Please complete the vehicle certification (front)</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Front: |</div>
}
}
plugin.tx_thmailformplus_pi1.fieldConf.fshinten{
errorText = <li>Please complete the vehicle certification (back)</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Back: |</div>
}
}

[global]
</pre>

=== Mit Datenbank-Speicherung ===

<pre>
######################################
# config for multipage forms
######################################

[PIDinRootline = 89]
plugin.tx_thmailformplus_pi1.multiPage.2.js (
if((document.Formular.bremsassi1.checked==false) && (document.Formular.bremsassi2.checked==false) && (document.Formular.bremsassi3.checked==false)){
alert('Emergency Brake Assistant - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.esp1.checked==false) && (document.Formular.esp2.checked==false) && (document.Formular.esp3.checked==false) && (document.Formular.esp4.checked==false)){
alert('Electronic/Dynamic Stability Control/Program - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.spurassi1.checked==false) && (document.Formular.spurassi2.checked==false) && (document.Formular.spurassi3.checked==false)){
alert('Lane departure warning/Lane keeping assistant - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.acc1.checked==false) && (document.Formular.acc2.checked==false) && (document.Formular.acc3.checked==false)){
alert('Adaptive Cruise Control - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.nvs1.checked==false) && (document.Formular.nvs2.checked==false) && (document.Formular.nvs3.checked==false)){
alert('Night Vision System - please select at least one of the checkboxes.');
return false;
}

)
[global]

######################################
# general configuration/setting
######################################
plugin.tx_thmailformplus_pi1 {
# limit the number of mails that
# are sent to the user
limitMailsToUser = 1
# Debug Infos ausgeben
# saveDB.debug = 1
}

###################################################
### storage table configuration & Standard-Werte ###
###################################################

plugin.tx_thmailformplus_pi1{
fieldConf.fahrleistungEinheit.defaultValue.value = km
fieldConf.datum.defaultValue.data = date : Y-m-d H:i:s
fieldConf.iphid.defaultValue.data = getenv : REMOTE_ADDR

#Speicherung in die Datenbank
saveDB = 1
saveDB.dbkey=uid
saveDB.dbTable = tpUmfrage
saveDB.mapping = iphid:iphid,datum:datum,country:country,age:age,geschlecht:geschlecht,fahrpraxis:fahrpraxis,fahrleistungEinheit:fahrleistungEinheit,fahrleistung:fahrleistung,neuanschaffung:neuanschaffung,unfall:unfall,beruf:beruf,berufSonstiges:berufSonstiges,betrieb:betrieb,betriebSonstiges:betriebSonstiges,markengebunden:markengebunden,marke:marke,bremsassi1:bremsassi1,bremsassi2:bremsassi2,bremsassi3:bremsassi3,esp1:esp1,esp2:esp2,esp3:esp3,esp4:esp4,spurassi1:spurassi1,spurassi2:spurassi2,spurassi3:spurassi3,acc1:acc1,acc2:acc2,acc3:acc3,nvs1:nvs1,nvs2:nvs2,nvs3:nvs3,bremsassipraxis:bremsassipraxis,bremsassipot:bremsassipot,esppraxis:esppraxis,esppot:esppot,ahlpraxis:ahlpraxis,ahlpot:ahlpot,sideassipraxis:sideassipraxis,sideassipot:sideassipot,nvspraxis:nvspraxis,nvspot:nvspot,accpraxis:accpraxis,accpot:accpot,spurassipraxis:spurassipraxis,spurassipot:spurassipot,kunden01:kunden01,kunden02:kunden02,kunden03:kunden03,kunden04:kunden04,kunden05:kunden05,kunden06:kunden06,kunden07:kunden07,kunden08:kunden08,kunden09:kunden09,kunden10:kunden10,kunden11:kunden11,kunden12:kunden12,kunden13:kunden13,kunden14:kunden14,kunden15:kunden15,kunden16:kunden16,kunden17:kunden17,kunden18:kunden18,kunden19:kunden19,kunden20:kunden20,kunden21:kunden21,kunden22:kunden22,kunden23:kunden23,kunden24:kunden24,kunden25:kunden25,kunden26:kunden26,kunden27:kunden27,wissenbremsassi:wissenbremsassi,wissenesp:wissenesp,wissenahl:wissenahl,wissensideassi:wissensideassi,wissennvs:wissennvs,wissenacc:wissenacc,wissenspurassi:wissenspurassi,wissendcm:wissendcm,wissenpcs:wissenpcs,wissenisa:wissenisa,wissenrtti:wissenrtti,wissenaec:wissenaec,auffassung01:auffassung01,auffassung02:auffassung02,auffassung03:auffassung03,auffassung04:auffassung04,auffassung05:auffassung05,auffassung06:auffassung06,auffassung07:auffassung07,auffassung08:auffassung08,auffassung09:auffassung09,auffassung10:auffassung10,auffassung11:auffassung11,auffassung12:auffassung12,auffassung13:auffassung13,auffassung14:auffassung14,auffassung15:auffassung15,auffassung16:auffassung16,auffassung17:auffassung17,auffassung18:auffassung18,auffassung19:auffassung19,auffassung20:auffassung20,auffassung21:auffassung21,auffassung22:auffassung22,auffassung23:auffassung23,auffassung24:auffassung24,expeinsch01:expeinsch01,expeinsch02:expeinsch02,expeinsch03:expeinsch03,expeinsch04:expeinsch04,expeinsch05:expeinsch05,expeinsch06:expeinsch06,expeinsch07:expeinsch07,expeinsch08:expeinsch08,expeinsch09:expeinsch09,expeinsch10:expeinsch10,expeinsch11:expeinsch11,expeinsch12:expeinsch12,expeinsch13:expeinsch13,expeinsch14:expeinsch14,expeinsch15:expeinsch15,expeinsch16:expeinsch16,expeinsch17:expeinsch17,expeinsch18:expeinsch18,expeinsch19:expeinsch19,expeinsch20:expeinsch20,expeinsch21:expeinsch21,expeinsch22:expeinsch22,expeinsch23:expeinsch23,expeinsch24:expeinsch24,expeinsch25:expeinsch25,fortbildung:fortbildung,fortbildungSonstiges:fortbildungSonstiges,kommentar:kommentar

#für Checkboxen modifizierung der zu speichernden Felder ermöglichen
saveLog = 1
#saveLog.order = bremsassi-1,bremsassi-2,bremsassi-3
#saveLog.defaultValue = 0

#folgende Felder nicht speichern...
#saveLog.exclude = alter

#saveDB.dbinsert=pid:546,hidden:0,CType:textpic
#saveUserFunc = fileadmin/template/benutzerfunktion/class.tx_mailformplus.php:tx_mailformplus->writeFormData
}

######################################
# here we overwrite the default configuration for
# file uploads defined in saveDB. for one
# specific field
######################################
plugin.tx_thmailformplus_pi1.fieldConf {

######################
# improved error check
#
# Info:
# error-check is performed for every field
# having a .errorCheck value defined here in TS
#
# works together with "required" fields settings
# from mailformplus record
#
# example:
# mailformplus record "required" field is filled out with "email"
# here in TS we have defined:
# email.errorCheck = email, optional
# so the value is optional - but if it's filled out,
# it's validated to be a correct email address
#
######################
# .errorCheck can be one of the following:
#
# - email ..... validated as email
# - integer ... validated as integer
# - float .... validated as float ("." and "," allowed!)
# - required ... must be filled out
# - optional ... field is optional, but if it's filled out,
# it's validated to the rest of errorChecks defined
# - date ... validated as date. format can/has to be specified
# example:
# errorCheck = date:dd/mm/yyyy
# errorCheck = date:d.m.y
# format is case insensitive. so dd/mm/yyyy is the same as DD/MM/YYYY
#
# - time ... validated as time. format can/has to be specified
# example:
# errorCheck = time:hh:mm
# errorCheck = time:h-m
# format is case insensitive. hh:mm equals HH:MM
#
# - ereg ... validated to match the regexp given
# example for correct IP validation:
# errorCheck = ereg:^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
#
# - eregi ... like "ereg" but case insensitive
#
######################
# you can specify multiple errorchecks by separating them by ","
# example
# - errorCheck = required, email
######################
# .errorText ... text beeing displayed when error occurs
# Info:
# errorText overwrites the error-subtemplate value defined in the template
#######################

# email {
# errorCheck = email,required
# errorText = <li>fill out a correct email</li><br>
# defaultValue.value = asdf
# }

fortbildung.errorCheck = required
fortbildung.errorText =  
//..
}

</pre>

Mailformplus (tx mailformplus)

2008-07-25T05:08:06Z

91.47.59.186: /* Verschiedene Beispiele */

== Post processing der Formularfelder ==
Es gibt einen Hook den man nutzen kann um nach dem Erfolgreichen senden des Formulars die '''Daten an eigene PHP Skripte''' zu übergeben.
(available since 3.7, thx to Martin Kutschker)
Die Standard Funktionen wie Mails versenden oder Datensätze einfügen werden dadurch nicht beeinflusst.

'''So gehts:'''

* define a user-function which will do the processing
* create a php file with a class and function which will be called when the form was submitted:

example:

'''class.tx_myext.php'''

content:

class tx_myext {
function doit(&$params, &$ref){
......
}
}

Die Variable '''$params'' enthält dann folgende Werte:

'''$params[config]''' Variablen die mit TypoScript übermittelt wurden. Z.B.:
saveUserFunc.dummy = hello
kann mit
$params[config][dummy]
angesprochen werden.

$params[data]
enthält alle übermittelten GET und POST Variablen

=== activate the hook with TypoScript ===
Als erstes muß man die Funktion definieren die ausgeführt werden soll:
plugin.tx_thmailformplus_pi1.saveUserFunc = EXT:myext/class.tx_myext.php:tx_myext->doit
Man kann auch mit TS Variablen definieren die an das Skript übermittelt werden.

plugin.tx_thmailformplus_pi1.saveUserFunc.dummy = hello

===Beispielkonfiguration (alt-brettheim.de)===
Version von Ende 2006
<pre>
### mailformplus konfigurieren ###
#Checkbox 'Zustimmung zur Datenspeicherung' soll nicht in der DB gespeichert werden
plugin.tx_thmailformplus_pi1{
#email_redirect = 547
saveLog.exclude = datenspeicherung
#Speicherung in die Datenbank
saveDB = 1
saveDB.dbkey=uid
saveDB.dbTable = pupKarte
saveDB.fileUpload = fileadmin/pupKarte/
saveDB.fileTypes = jpg,jpeg,png,JPG,JPEG,PNG
saveDB.fileSize = 1000000

#Schlüsselfeld der DB-Tabelle
#Datenbank zuordnung
saveDB.mapping = photo:fileid,geb18:geb18,name:name,vorname:vorname,gebDatum:gebDatum,strasse:strasse,plz:plz,ort:ort,gruppe:gruppe,andereGruppe:andereGruppe,funktionGruppe:funktionGruppe,vabmitglied:vabmitglied,waffentraeger:waffentraeger,dekowaffe:dekowaffe,messer:messer,dolchEinseitig:dolchEinseitig,dolchZweiseitig:dolchZweiseitig,hiebwaffe:hiebwaffe,stichwaffe:stichwaffe,stangenwaffe:stangenwaffe,bogen:bogen,armbrust:armbrust,sonstigeWaffen:sonstigeWaffen,sprengstofferlaubnis:sprengstofferlaubnis,uneingeschraenkt:uneingeschraenkt,sonstigeWaffeArt:sonstigeWaffeArt,behoerde:behoerde,erlaubnisNr:erlaubnisNr,weitereGenehmigung:weitereGenehmigung,mitgliedSeit:mitgliedSeit,weitereVabMitgliedschaft:weitereVabMitgliedschaft,funktionen:funktionen,ehrungen:ehrungen,telefon:telefon,email:email,internWirdBezogen:internWirdBezogen,internErwuenscht:internErwuenscht,sonstiges:sonstiges
#nicht ausgefüllte Felder ausfüllen...
#saveDB.if_is_empty.dekowaffe = ka
#saveDB.debug = 1
</pre>

=== Druckversion des Formulars ===
'''1. Abschnitt für Printtemplate im mailformplus-HTML-Template:'''

'''Beispiel'''
<pre>

You just filled out the following fields:<br>
Name: ###name###<br>
Subject: ###subject###<br>
<br>
you uploaded the following files:
###photo###
<br>
###cv###
<br>

</pre>

'''2. Eine Userfunktion zum speichern und übergeben der Session Variable'''
<pre>

<?PHP
####################################
# example user-function for #
# fetching the PRINT-subtemplate #
####################################

class user_mailformplus_userfunc {
var $cObj;

# this function returns the "PRINT" subtemplate
# if defined in the mailformplus-template
# replaced with the values the user has filled out.

function user_mailformplusPrint($content,$conf) {
$printVersion = $GLOBALS["TSFE"]->fe_user->getKey("ses","th_mailformplus".$GLOBALS["TSFE"]->id);
if ($printVersion) {
return $printVersion;
}
}
}
?>
</pre>

'''3. Das zugehörige TS Template'''
<pre>
includeLibs.mailformplus_functions = fileadmin/mailformplus_userfunc.inc.php
################################
# outputs the PRINT template below normal page content
# main content
################################

temp.main_content = COA
temp.main_content {
10 < styles.content.get
20 = USER
20.userFunc = user_mailformplus_userfunc->user_mailformplusPrint
}

...

page.10.subparts.CONTENT_MAIN < temp.main_content
</pre>

== Verschiedene Beispiele ==
=== JavaScript zur Validierung und Mailformplus ===
<pre>
plugin.tx_thmailformplus_pi1.multiPage.2.js (
if((document.Formular.bremsassi1.checked==false) && (document.Formular.bremsassi2.checked==false) && (document.Formular.bremsassi3.checked==false)){
alert('Bremsassistenten - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.esp1.checked==false) && (document.Formular.esp2.checked==false) && (document.Formular.esp3.checked==false) && (document.Formular.esp4.checked==false)){
alert('Elektronisches Stabilitätsprogramm - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.spurassi1.checked==false) && (document.Formular.spurassi2.checked==false) && (document.Formular.spurassi3.checked==false)){
alert('Spurassistent - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.acc1.checked==false) && (document.Formular.acc2.checked==false) && (document.Formular.acc3.checked==false)){
alert('Automatischer Abstandsregeltempomat - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}
if((document.Formular.nvs1.checked==false) && (document.Formular.nvs2.checked==false) && (document.Formular.nvs3.checked==false)){
alert('Nachtsichtassistent - wählen Sie bitte mindestens einen Punkt aus.');
return false;
}

)
</pre>
=== Beispiel mit verschiedenen Validierungen und Upload-Feld===
<pre>
plugin.tx_thmailformplus_pi1{
#email_requiredfields = email,name
#email_attachment = ###fsvorne###
#email_sendtouser >
#debug = 1

}

plugin.tx_thmailformplus_pi1.fieldConf {
name {
errorCheck = required
}
strasse {
errorCheck = required
}
plz_ort {
errorCheck = required
}
land {
errorCheck = required
}
telefon {
errorCheck = required
}
mail {
errorCheck = email,required
}
kennzeichen {
errorCheck = required
}
hersteller {
errorCheck = required
}
fahrzeugnummer {
errorCheck = required
}
art {
errorCheck = required
}
antrieb {
errorCheck = required
}
gewicht {
errorCheck = required
}
ezul {
errorCheck = date:dd.mm.yyyy
errorCheck.dateRange.min = 01.01.1900
errorCheck.dateRange.max = 31.12.2010
}
fsvorne {
errorCheck = required
numberOfAllowedFiles = 1
fileTypes = pdf,doc,jpg,gif,png
fileSize = 1500000
fileUpload = fileadmin/plakette/uploads/
errorText = <li>Das Feld Fahrzeugschein (Vorderseite) ist nicht korrekt ausgefüllt</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Vorderseite: |</div>
}
uploadedFiles.mail {
plainTemplate = ###filePath### ###fileName###
HTMLTemplate = <a href="###filePath######fileName###">###fileName###</a><br/>
plainWrap = |
HTMLWrap = |
}
}
fshinten {
numberOfAllowedFiles = 1
fileTypes = pdf,doc,jpg,gif,png
fileSize = 1500000
fileUpload = fileadmin/plakette/uploads/
errorText = <li>Das Feld Fahrzeugschein (Rückseite) ist nicht korrekt ausgefüllt</li><br/>
uploadedFiles {
template =  ###fileName### ###fileSize###  <br />
wrap = <div>Rückseite: |</div>
}
uploadedFiles.mail {
plainTemplate = ###filePath######fileName###
HTMLTemplate = <a href="###filePath######fileName###">###fileName###</a><br/>
plainWrap = |file end
HTMLWrap = |
}
}
}

[PIDinRootline=305,307,309,311]
plugin.tx_thmailformplus_pi1.fieldConf.fsvorne{
errorText = <li>Please complete the vehicle certification (front)</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Front: |</div>
}
}
plugin.tx_thmailformplus_pi1.fieldConf.fshinten{
errorText = <li>Please complete the vehicle certification (back)</li><br/>
uploadedFiles {
template =   ###fileName### ###fileSize###  <br />
wrap = <div>Back: |</div>
}
}

[global]
</pre>

=== Mit Datenbank-Speicherung ===
######################################
# config for multipage forms
######################################

[PIDinRootline = 89]

plugin.tx_thmailformplus_pi1.multiPage.2.js (
if((document.Formular.bremsassi1.checked==false) && (document.Formular.bremsassi2.checked==false) && (document.Formular.bremsassi3.checked==false)){
alert('Emergency Brake Assistant - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.esp1.checked==false) && (document.Formular.esp2.checked==false) && (document.Formular.esp3.checked==false) && (document.Formular.esp4.checked==false)){
alert('Electronic/Dynamic Stability Control/Program - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.spurassi1.checked==false) && (document.Formular.spurassi2.checked==false) && (document.Formular.spurassi3.checked==false)){
alert('Lane departure warning/Lane keeping assistant - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.acc1.checked==false) && (document.Formular.acc2.checked==false) && (document.Formular.acc3.checked==false)){
alert('Adaptive Cruise Control - please select at least one of the checkboxes.');
return false;
}
if((document.Formular.nvs1.checked==false) && (document.Formular.nvs2.checked==false) && (document.Formular.nvs3.checked==false)){
alert('Night Vision System - please select at least one of the checkboxes.');
return false;
}

)
[global]

######################################
# general configuration/setting
######################################
plugin.tx_thmailformplus_pi1 {
# limit the number of mails that
# are sent to the user
limitMailsToUser = 1
# Debug Infos ausgeben
# saveDB.debug = 1
}

###################################################
### storage table configuration & Standard-Werte ###
###################################################

plugin.tx_thmailformplus_pi1{
fieldConf.fahrleistungEinheit.defaultValue.value = km
fieldConf.datum.defaultValue.data = date : Y-m-d H:i:s
fieldConf.iphid.defaultValue.data = getenv : REMOTE_ADDR

#Speicherung in die Datenbank
saveDB = 1
saveDB.dbkey=uid
saveDB.dbTable = tpUmfrage
saveDB.mapping = iphid:iphid,datum:datum,country:country,age:age,geschlecht:geschlecht,fahrpraxis:fahrpraxis,fahrleistungEinheit:fahrleistungEinheit,fahrleistung:fahrleistung,neuanschaffung:neuanschaffung,unfall:unfall,beruf:beruf,berufSonstiges:berufSonstiges,betrieb:betrieb,betriebSonstiges:betriebSonstiges,markengebunden:markengebunden,marke:marke,bremsassi1:bremsassi1,bremsassi2:bremsassi2,bremsassi3:bremsassi3,esp1:esp1,esp2:esp2,esp3:esp3,esp4:esp4,spurassi1:spurassi1,spurassi2:spurassi2,spurassi3:spurassi3,acc1:acc1,acc2:acc2,acc3:acc3,nvs1:nvs1,nvs2:nvs2,nvs3:nvs3,bremsassipraxis:bremsassipraxis,bremsassipot:bremsassipot,esppraxis:esppraxis,esppot:esppot,ahlpraxis:ahlpraxis,ahlpot:ahlpot,sideassipraxis:sideassipraxis,sideassipot:sideassipot,nvspraxis:nvspraxis,nvspot:nvspot,accpraxis:accpraxis,accpot:accpot,spurassipraxis:spurassipraxis,spurassipot:spurassipot,kunden01:kunden01,kunden02:kunden02,kunden03:kunden03,kunden04:kunden04,kunden05:kunden05,kunden06:kunden06,kunden07:kunden07,kunden08:kunden08,kunden09:kunden09,kunden10:kunden10,kunden11:kunden11,kunden12:kunden12,kunden13:kunden13,kunden14:kunden14,kunden15:kunden15,kunden16:kunden16,kunden17:kunden17,kunden18:kunden18,kunden19:kunden19,kunden20:kunden20,kunden21:kunden21,kunden22:kunden22,kunden23:kunden23,kunden24:kunden24,kunden25:kunden25,kunden26:kunden26,kunden27:kunden27,wissenbremsassi:wissenbremsassi,wissenesp:wissenesp,wissenahl:wissenahl,wissensideassi:wissensideassi,wissennvs:wissennvs,wissenacc:wissenacc,wissenspurassi:wissenspurassi,wissendcm:wissendcm,wissenpcs:wissenpcs,wissenisa:wissenisa,wissenrtti:wissenrtti,wissenaec:wissenaec,auffassung01:auffassung01,auffassung02:auffassung02,auffassung03:auffassung03,auffassung04:auffassung04,auffassung05:auffassung05,auffassung06:auffassung06,auffassung07:auffassung07,auffassung08:auffassung08,auffassung09:auffassung09,auffassung10:auffassung10,auffassung11:auffassung11,auffassung12:auffassung12,auffassung13:auffassung13,auffassung14:auffassung14,auffassung15:auffassung15,auffassung16:auffassung16,auffassung17:auffassung17,auffassung18:auffassung18,auffassung19:auffassung19,auffassung20:auffassung20,auffassung21:auffassung21,auffassung22:auffassung22,auffassung23:auffassung23,auffassung24:auffassung24,expeinsch01:expeinsch01,expeinsch02:expeinsch02,expeinsch03:expeinsch03,expeinsch04:expeinsch04,expeinsch05:expeinsch05,expeinsch06:expeinsch06,expeinsch07:expeinsch07,expeinsch08:expeinsch08,expeinsch09:expeinsch09,expeinsch10:expeinsch10,expeinsch11:expeinsch11,expeinsch12:expeinsch12,expeinsch13:expeinsch13,expeinsch14:expeinsch14,expeinsch15:expeinsch15,expeinsch16:expeinsch16,expeinsch17:expeinsch17,expeinsch18:expeinsch18,expeinsch19:expeinsch19,expeinsch20:expeinsch20,expeinsch21:expeinsch21,expeinsch22:expeinsch22,expeinsch23:expeinsch23,expeinsch24:expeinsch24,expeinsch25:expeinsch25,fortbildung:fortbildung,fortbildungSonstiges:fortbildungSonstiges,kommentar:kommentar

#für Checkboxen modifizierung der zu speichernden Felder ermöglichen
saveLog = 1
#saveLog.order = bremsassi-1,bremsassi-2,bremsassi-3
#saveLog.defaultValue = 0

#folgende Felder nicht speichern...
#saveLog.exclude = alter

#saveDB.dbinsert=pid:546,hidden:0,CType:textpic
#saveUserFunc = fileadmin/template/benutzerfunktion/class.tx_mailformplus.php:tx_mailformplus->writeFormData
}

######################################
# here we overwrite the default configuration for
# file uploads defined in saveDB. for one
# specific field
######################################
plugin.tx_thmailformplus_pi1.fieldConf {

######################
# improved error check
#
# Info:
# error-check is performed for every field
# having a .errorCheck value defined here in TS
#
# works together with "required" fields settings
# from mailformplus record
#
# example:
# mailformplus record "required" field is filled out with "email"
# here in TS we have defined:
# email.errorCheck = email, optional
# so the value is optional - but if it's filled out,
# it's validated to be a correct email address
#
######################
# .errorCheck can be one of the following:
#
# - email ..... validated as email
# - integer ... validated as integer
# - float .... validated as float ("." and "," allowed!)
# - required ... must be filled out
# - optional ... field is optional, but if it's filled out,
# it's validated to the rest of errorChecks defined
# - date ... validated as date. format can/has to be specified
# example:
# errorCheck = date:dd/mm/yyyy
# errorCheck = date:d.m.y
# format is case insensitive. so dd/mm/yyyy is the same as DD/MM/YYYY
#
# - time ... validated as time. format can/has to be specified
# example:
# errorCheck = time:hh:mm
# errorCheck = time:h-m
# format is case insensitive. hh:mm equals HH:MM
#
# - ereg ... validated to match the regexp given
# example for correct IP validation:
# errorCheck = ereg:^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
#
# - eregi ... like "ereg" but case insensitive
#
######################
# you can specify multiple errorchecks by separating them by ","
# example
# - errorCheck = required, email
######################
# .errorText ... text beeing displayed when error occurs
# Info:
# errorText overwrites the error-subtemplate value defined in the template
#######################

# email {
# errorCheck = email,required
# errorText = <li>fill out a correct email</li><br>
# defaultValue.value = asdf
# }

fortbildung.errorCheck = required
fortbildung.errorText =  
//..
}

Mailformplus (tx mailformplus)

2008-07-25T05:03:13Z

91.47.59.186: /* Verschiedene Beispiele */

Mailformplus (tx mailformplus)

2008-07-25T04:59:03Z

91.47.59.186:

Typo3 - Installation

2008-07-25T04:52:44Z

91.47.59.186:

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.
== W-Manager ==
* Datenbank und Benutzer installieren
* Dump einspielen (am besten auf webspace legen und mit wget runterziehen, oder über Plesk>phpmyadmin einspielen)
shell> mysql db_name < backup-file.sql

* Im Webverzeichnis (oder darunter) neueste Source downloaden und auspacken
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
wget http://prdownloads.sourceforge.net/typo3/dummy-4.0.4.tar.gz?download
* Im Stammverzeichnis dummy downloaden und auspacken
* dummy Inhalt in Stammverzeichnis kopieren und typo3_src symlink auf neue Source umbiegen.
* Datei-Rechte anpassen
755 Gruppe ist wwwserver - Gruppe
chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads
** bei reinem ftp Zugriff Gruppe lassen und 777
* w-manager Dateien reinkopieren (upload, fileadmin, typo3conf) evtl als tar Paket vorhalten)
* localconf.php anpassen (neue Datenbank Daten eintragen)
* Installationstool: Compare und Update Manager
* Evtl. neues DB Image:
mysqldump -u benutzername -p -B --add-drop-table datenbank > typo3DBSicherung.sql
* Seitenbaum anpassen (Sitename)
* Assets anpassen (Bilder, Logo)
* CSS Anpassen (Schriften, Farben)
* Template Anpassen (Anschrift unten)
* Print Template anpassen (Copyright...)

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

'''Hinweis:''' wenn man eine gute leere Installation hat kann man diese Daten komplett in ein sql-Standardfile exportieren und bei einer frischen Typo3 Installation komplett einspielen.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
siehe auch [[Typo3 - Grundeinstellungen]]

# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
wget http://prdownloads.sourceforge.net/typo3/dummy-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf der Hauptebene. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).
mv dummy-4.0.2/* ./

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''

* Es gibt einen '''Symlink''' auf der Hauptebene (vorher im Dummy-Verzeichnis)
typo3_src -> ../NameDesTypo3SourceOrdners
Damit der Symlink stimmt müssen wir Ihn ändern (d.h. löschen oder überschreiben)

ln -s typo3_src-4.0.2 typo3_src

Wenn man den typo3_src Symlink auf eine andere Source umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt '''löschen''':
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.
Hinweis: ab Version 4.1 reicht es eine Datei mit dem Namen ENABLE_INSTALL_TOOL im Verzeichnis typo3conf anzulegen um das Install Tool freizuschalten.
* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen

Rechte einstellen:(as root): There are at least two options.
Diese Schritte setzen die Rechte für 4 Ordner:
* fileadmin/
* typo3conf/
* typo3temp/
* uploads/

a (am Besten)

Diese Kommandos als root ausführen:
chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

wobei <wwwserver> der Name der Gruppe des Webservers ist

'''Hinweis:''' bei 1und1 (mit Plesk) ist die Gruppe i.d.R. www und der Benutzer wwwrun

b (nicht sicher aber einfach)

Nicht auf geteilten Servern nutzen:

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>
== Probleme mit Plesk ==
The script whose uid is 10001 is not allowed to access /httpdocs/html/typo3temp/cs owned by uid 30 in /httpdocs/html/t3lib/class.t3lib_div.php on line 2420

Das deutet in der Regel darauf hin, dass was mit den User-Rechten der Files nicht passt. Bei Plesk sollten die Typo3 Sourcen, sowie "httpdocs" dem FTP-User aus der Gruppe "psaserv" gehören.

== ImageMagick installieren ==
=== Mit Yast installieren ===
http://wiki.zone30.info/wikizone/index.php/ImageMagick_installieren

=== ImageMagick auf Vserver global installieren ===
19 01 2007

Wenn man ImageMagick auf seinem Vserver global installieren möchte, um für alle Typo3 installationen ImageMagick nutzen zu können, kann man wie folgt vorgehen.

Auch hier eignet sich die Version 4.2.9., zu finden unter typo3.org, recht gut.
http://typo3.sunsite.dk/software/linux/

Danach kopiert man am einfachsten mit winscp die Dateien auf den Server in das Verzeichnis:

/usr/bin.
Hier ist nur der Ordner “bin” für diese Anwendung interessant.
Im Ordner “bin” findet man folgende Dateien:

convert, combine, identify, convert.bin, combine.bin, identify.bin, wrapper.sh.
Die Dateien ohne die Endung “.bin” sind nur Verknüpfungen, und erstmal nicht wichtig.
Gebraucht werden nur convert.bin, combine.bin, identify.bin!

Die Entpackten Dateien liegen nur im usr/bin Verzeichnis.
Typo3 fragt bei der Installation automatisch dieses Verzeichnis ab, und sucht nach der passenden Programmversion.

Das wars

<pre>
Ergänzung (Steff)

bei Einsatz von Plesk kann es sein das diese Vorgehensweise nicht funktioniert. Dort kann man aber die statisch kompilierte Version in das CGI-Verzeichnis der virtuellen Hosts legen. Etwa unter /srv/www/vhosts/meineDomain.de/cgi-bin
</pre>

Auf den 1und1 Webhosting-Paketen läuft die Geschichte im Prinzip ziemlich einfach ab.
Falls keine root -Rechte vorhanden, entpackt man IM erstmal lokal in ein Verzeichnis.
Man erhält folgende Ordner Struktur.

Hier ist nur der Ordner “bin” für diese Anwendung interessant.
Im Ordner “bin” findet man folgende Dateien:

convert, combine, identify, convert.bin, combine.bin, identify.bin, wrapper.sh.
Die Dateien ohne die Endung “.bin” sind nur Verknüpfungen, und erstmal nicht wichtig.
Gebraucht werden nur convert.bin, combine.bin, identify.bin!

Diese 3 Dateien kopiert man jetzt mit einem ftp Programm auf den Webspace
in den Ordner cgi-bin, und vergibt diesem Ordner vorerst mal alle Rechte (chmod 777)

Im Ordner cgi-bin findet man nun die Dateien convert.bin, combine.bin, identify.bin
Wichtig ist jetzt, das die Endung .bin entfernt wird.

Diesen 3 Dateien auch erstmal auf chmod 777
Ergänzung Steff: später die Gruppe und Besitzer auf php-user stellen und Rechte auf 755

Jetzt wechselt man ins Typo3 Install-tool auf den Punkt “All Configuration”

Jetzt muss nur noch IM aktiviert werden, und der absolute Pfad zu den Dateien angeben werden.
Speichern nicht vergessen.

Zur Kontrolle wechselt man jetzt noch mal zum Punkt “Basic Configuration”.
Dort müsste jetzt IM aktiviert und erkannt werden.

Das war’s.
Installation unter einem VPS folgt

Quelle (mit Bildern): http://www.webdesign-limburg.com/blog/?p=21 und http://www.webdesign-limburg.com/blog/?p=21

=== auf Virtuellem Server (Suse) ===
Ist es schon da?
convert -version
sollte dann die Version ausgeben
Anleitung unter:
http://www.imagemagick.org/script/install-source.php#unix
Klassisch:

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

=== Vorstufen ===
1. Halbautomatisch
* komplettes DB Dump über phpMyAdmin o. mysqldump einspielen
* typo 3 Installieren
* fileadmin Ordner aufspielen

2. Automatisch:

* alle benötigten Dateien auf Server zum automatischen Download bereitstellen
* Batchdatei zum automatischen Ablauf

3. Anpassungen:
* neuer Header
* Maße, Farben und Schrift im CSS
* Copyright anpassen
* Printversion anpassen
* Email Adresse in Kontaktformular

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed