Vor einiger Zeit hat Google bekanntgegeben, dass auch die  Ladegeschwindigkeit als Rankingfaktor mit einbezogen wird. Aber auch aus Sicht des Seitenbesuchers ist es sinnvoll sich mit diesem Thema zu beschäftigen. Für jedes Bild und jede CSS/JS-Datei muss der Browser eine neue Verbindung zum Server öffnen. Bei Firefox sind dies maximal 15 gleichzeitige Verbindungen pro Server die parallel abgearbeitet werden – darüber wird der Seitenaufbau minimal verzögert. Ein Besucher könnte vielleicht frustriert die Seite wieder verlassen, wenn es ihm zu lange dauert mit dem Seitenaufbau. Darum sollten Entwickler dies gleich bei der Erstellung der Seite beachten.

Ergebnisse überwachen

Um die aktuelle Ladegeschwindigkeit zu analysieren ist das Firefox-Plugin Firebug sehr nützlich.

Plugin installieren -> F12 drücken -> Reiter Netzwerk auswählen -> Seite neu laden.

Eine Bewertung der Seite kann mit den Erweiterungen YSlow von Yahoo und Page Speed von Google erfolgen. Bei YSlow kann aus drei Profilen gewählt werden um die Webseite zu bewerten, dabei auch ein Profil für kleine Seiten – die Note A steht für das beste Ergebnis. Bei Page Speed wird die Seite anhand von 100 erreichbaren Punkten bewertet.

Dateigröße reduzieren

Durch die Verwendung von Image Arrays / Image Matrix lassen sich viele Bilder in einer Datei zusammenfassen, was z.B. für Navigationsleisten und Symbole Sinn macht. Was sich an der Dateigröße noch optimieren lässt, ohne das die Qualität spürbar abnimmt, kann mit jedem guten Grafikprogramm getestet werden oder mit PunyPNG.

TYPO3 Scriptmerger

Bei TYPO3 bindet jede Extension gerne ihre eigenen CSS und JavaScript-Dateien ein. Oder der Entwickler möchte nicht auf getrennte Dateien je nach Einsatzzweck und Extension verzichten? Hier hilft es die Erweiterung Scriptmerger zu installieren, welche die Dateien zusammenfasst und mit GZip komprimiert. Damit das Zusammenfügen der Dateien funktioniert, wird die Erweiterung über ein Statisches Templates eingebunden. So können die Ergebnisse auch an einer Unterseite probiert werden ohne den Auftritt insgesamt zu gefährden. Der Media-Typ wird beachtet und möchte man wirklich nur eine einzige CSS-Datei erhalten wird dieser überall auf “all” gesetzt:

page.includeCSS {
file1.media = all
file1 = fileadmin/main.css
file2.media = all
file2 = fileadmin/tt_news.css
}

Die originalen CSS-Dateien bleiben erhalten und können ständig angepasst werden. Erst beim Löschen des Caches (Blitz-Symbol) werden die Dateien zusammengefasst, die dann unter typo3temp/scriptmerger/compressed/ abgespeichert werden und automatisch verwendet werden.

Ergebnisse Testen

Wie oben beschrieben, lässt sich über Firebug sowie die Plugins YSlow und Page Speed der Erfolg der Änderungen ablesen. Zum Schluss nicht vergessen die Seite auch in verschiedenen Browsern zu testen, dies kann mit BrowserShots und etwas Geduld (Auftrag alle 30 Minuten erneuern) erfolgen.

Google: Using site speed in web search ranking

Nach der Installation von sr_freecap, kann dieses sofort in powermail oder nach Anpassung der HTML-Templates (Beschreibung im Handbuch) bei sr_feuser_register verwendet werden.

Zuerst lässt sich mit der folgenden Zeile das sr_freecap eigene CSS via TypoScript Setup deaktivieren:

plugin.tx_srfreecap_pi2._CSS_DEFAULT_STYLE >

Um eine lesbare Schrift zu bekommen, wird die Windows True-Type Schriftart Arial Unicode MS in das benötigte gdf-Format mit Hilfe dem Tool wftopf.exe umgewandelt. Als Höhe (Height) wird beispielsweise 56 und als Breite (Char Width) 24 verwendet. Die erzeugte Datei lautet so Arial56x24.gdf und wird in dem Ordner uploads/tx_srfreecap/ abgelegt.

Im TypoScript Konstanten Feld kann nun die Konfiguration wie folgt gesetzt werden:

plugin.tx_srfreecap.imageHeight = 90
plugin.tx_srfreecap.useWordsList = 0
plugin.tx_srfreecap.generateNumbers = 0
plugin.tx_srfreecap.textColor = 0
plugin.tx_srfreecap.mergeWithBackground = 0
plugin.tx_srfreecap.backgroundBlur = 1
plugin.tx_srfreecap.backgroundMorph = 0
plugin.tx_srfreecap.backgroundType = Transparent
plugin.tx_srfreecap.maxWordLength = 6
plugin.tx_srfreecap.morphFactor = .001
plugin.tx_srfreecap.fontFiles = Arial56x24.gdf

Das Ergebnis ist ein lesbares CAPTCHA-Bild.

Beginn des Haupt-TypoScript-Templates -> Setup

page = PAGE
page.typeNum = 0

Target für Links und Such-Formular setzen -> Constants

PAGE_TARGET = _top
content.pageFrameObj = _top

alle externen Links mit “nofollow” (Wikipedia) versehen -> Constants

styles.content.links.target = _self
styles.content.links.extTarget = _blank” rel=”nofollow

Passwort vergessen-Link von felogin mit “nofollow” wegen Duplicate content -> Setup

plugin.tx_felogin_pi1.linkConfig.target = _top” rel=”nofollow

ID des Systemordners der FE-Benutzer -> Constants

styles.content.loginform.pid = 123

powermail – Felder nach Abschicken leeren -> Constants

plugin.powermail.clear.session = 1

Favicon einbinden -> Setup

page.headerData.12 = TEXT
page.headerData.12.value = <LINK href=”/favicon.ico” type=image/x-icon rel=”shortcut icon”>

Indexed Search Engine mit genauer Such-Treffer-Zahl -> Setup

page.config.index_enable = 1
plugin.tx_indexedsearch.search.exactCount = 1
plugin.tx_indexedsearch.show.rules = 0
plugin.tx_indexedsearch._DEFAULT_PI_VARS.sections= rl1_123

Einbinden eigener Javascript von jQuery_lightbox verhindern -> Setup

page.1034 >

Der Benutzer soll einem Haftungsausschluss zustimmen und so weitere Inhalte auf der Seite sehen. Dies ist über die Zugriff-Einstellungen möglich, aber wie wird der Benutzer in die neue Gruppe eingetragen? Wenn sich ein Benutzer selber einer weiteren Gruppe zuordnen soll ist dazu keine separate Extension nötig – dies kann problemlos mit Powermail erledigt werden.

Powermail kann von Haus aus Daten aus der fe_users Tabelle auslesen und damit Formularfelder vorbelegen. Damit später nicht der falsche Benutzerdatensatz geändert wird, muss unter der Extension-Konfiguration im Erweiterungs-Manager beim Feld “feusersPrefill” zusätzlich “uid” mit angegeben werden.

Im Formular wird ein neues Feld mit dem Feldtyp “Versteckt” angelegt. Den Wert bei “Name für Templates” z.b. ###UID123### muss man sich kurz merken und bei “Dieses Feld mit Daten aus der fe_user füllen” wird “uid” ausgewählt.

Nun kann man für die eine Haftungsausschluss-Seite ein Template anlegen und dort spezielle Werte definieren welche nur für diese Seite gelten sollen, aber andere Powermail-Formulare auf anderen Seiten nicht beeinflussen dürfen. Beispielsweise werden somit als Konstanten definiert:

plugin.powermail.allow.email2receiver = 0
plugin.powermail.allow.email2sender = 0
plugin.powermail.allow.dblog = 0
plugin.powermail.PID.dblog = 0
plugin.powermail.clear.session = 1

und im Setup:

plugin.tx_powermail_pi1 {
dbEntry {
fe_users._enable = TEXT
fe_users._enable.value = 1
fe_users._ifUnique.uid = update
# table “fe_user” with field “uid” is the value from powermail (tt_content uid 345) field uid123 (###uid123###)
fe_users.uid = TEXT
fe_users.uid.data = TSFE:fe_user|sesData|powermail_345|uid123
fe_users.usergroup = TEXT
fe_users.usergroup.value = 2,3
}
}

Erklärung: Der Benutzer (noch in usergroup 2) schickt das Formular ab und wird zusätzlich der usergroup 3 zugeordnet. Das Element welches das Powermail-Plugin enthält hat die uid 345 und das Formularfeld mit der vorausgefüllten uid des Benutzers hat die uid 123.

Ziel ist es also in der E-Mail an den Empfänger schreiben zu können auf welcher Seite ein Besucher das Formular ausgefüllt hat – um beispielsweise daraus zu schließen für welches Produkt Interesse besteht.

Dazu wird ein neues Feld mit dem Feldtyp “Versteckt” angelegt. Den Wert bei “Name für Templates” z.b. ###UID123### kann so schon mal im Empfänger-Mail-Text verwendet werden, falls hier nicht ###POWERMAIL_ALL### verwendet werden soll.

Per Typoscript-Setup wird nun das neue Feld befüllt mit der URL und dem Pfad der aktuellen Seite:

plugin.tx_powermail_pi1 {
prefill {
uid123 = COA
uid123 {
10 = TEXT
10.data = getIndpEnv:TYPO3_SITE_URL
20 = TEXT
20.typolink.parameter.data = TSFE:id
20.typolink.returnLast = url
}
}
}

Das Ganze funktioniert auch wunderbar wenn die URL mit RealURL “schön” ausgeschrieben wird.

Erst nach einem Blick in den Programmier-Code wird klar, dass relativ einfach eine Zielseite definiert werden kann, auf welche der Benutzer nach dem Login geschickt wird. Denn wenn man standardmäßig felogin direkt in einen Marker schreibt wird der Benutzer nach erfolgreichem Login auf der aktuellen Seite eingeloggt, d.h. die Seite wird einfach neu geladen.

marks.LOGINBOX < plugin.tx_felogin_pi1

Per TypoScript lässt sich nun neben der ID des System-Ordners der Mitglieder, auch ein eigenes HTML-Template, sowie die Zielseite per ID definieren:

plugin.tx_felogin_pi1 {
storagePid = 12
templateFile = fileadmin/felogin.html
redirectMode = login
redirectPageLogin = 123
}

Auch hier lassen sich wie gewohnt die Übersetzungen direkt überschreiben:

plugin.tx_felogin_pi1._LOCAL_LANG {
default {
ll_welcome_header = my.example.com
}
de {
ll_welcome_header = my.example.com
}
}

Arbeiten im Frontend

Diesen Tipp habe ich schon in der TypoScript Sammlung aufgelistet. Diese Template Konfiguration im Setup-Feld sorgt beispielsweise dafür, dass ein im Backend eingeloggter Redakteur im Frontend bei jedem Content-Element ein Stiftsymbol anklicken kann um den Inhalt direkt zu bearbeiten:

config.admPanel = 1

Backend-Benutzergruppe

Was genau im Frontend der jeweilige Benutzer zusätzlich sieht kann über das TSconfig-Feld der Backend-Benutzergruppe gesteuert werden:

admPanel {
# direktes editieren ermöglichen
enable.edit = 1
# Bleistift-Symbole immer anzeigen
module.edit.forceDisplayFieldIcons = 1
# weitere Symbole nicht anzeigen
module.edit.forceDisplayIcons = 0
# Admin-Panel nicht anzeigen
hide = 1
}

Damit nicht jeder Redakteur zusätzliches Seitenmaterial an verschiedenen Stellen im System verteilt, sollte der Upload von Dateien aus dem Content-Bereich verboten werden. Dann wird zwangsweise alles gemeinsam in der Dateiverwaltung abgelegt:

setup.override.edit_docModuleUpload = 0

Manchmal ist es nötig dem Redakteur die Möglichkeit zu geben den Gesamt- und Seiten-Cache zu löschen, was sonst nur dem Administrator möglich wäre:

options.clearCache {
pages = 1
all = 1
}

Layout Buttons ein-/ und ausblenden

Über das TSconfig-Feld des Root-Templates lässt sich steuern welche Buttons im Rich-Text-Editor angezeigt werden sollen:

# Aktiviere RTE für alle User
setup.default.edit_RTE = 1
# RTE Standardansicht konfigurieren
RTE.default {
# blendet Statusbar (Pfad) aus
showStatusBar =  0
# Buttons die gezeigt/versteckt werden
hideButtons = blockstylelabel, blockstyle, textstylelabel, textstyle, textindicator
hidePStyleItems = h1, h4, h5, h6, blockquote, div, pre, address
}

Absatzformatierungen definieren

Es ist natürlich problemlos möglich weitere selbst definierte Formatierungen für die Absätze (<p>-Tag) zu verwenden. Um zwei verschiedene Link-Navigations-Formatierungen zu ermöglichen wird das TSconfig-Feld des Root-Templates entsprechend erweitert. Die hier angegebene CSS-Datei (rte.css) ist lediglich zur Vorschau im Backend für den Redakteur gedacht, die neuen Klassen kommen natürlich in die globale CSS-Datei:

RTE.default.useCSS = 1
RTE.default.contentCSS = fileadmin/rte.css
RTE.default.showTagFreeClasses = 1
RTE.classes.link-gelb {
name = gelber Link
value = color: #000000; background-color: #D0C9B7;
}
RTE.classes.link-blau {
name = blauer Link
value = color: #000000; background-color: #B4C7CE;
}
RTE.default.classesParagraph = link-gelb, link-blau
RTE.default.proc.allowedClasses := addToList(link-gelb, link-blau)
RTE.default.classesParagraph := removeFromList(csc-frame-frame1, csc-frame-frame2)
RTE.default.proc.allowedClasses := removeFromList(csc-frame-frame1, csc-frame-frame2)
RTE.classesAnchor.internalLink.class >

Bei der Umsetzung von mehrsprachigen Websites mit TYPO3 besteht die Wahl zwischen zwei verschiedenen Konzepten:

1. Mehrere Seitenbäume (Two-Tree):
   Jedem Seitenbaum wird ein Domainrecord zugewiesen und mittels einer TypoScript-Condition kann der Host abgefragt und die gewünschte Sprache zugewiesen werden.
2. Ein Seitenbaum für alle Sprachen (one-tree-fits-all):
   Die gewünschte Sprache wird über einen Get-Parameter (oft “L”) abgefragt, welcher bei suchmaschinenfreundlichen URLs dennoch immer Bestandteil der URL ist.

Die beiden Methoden sind auch problemlos gemischt zu verwenden.

Falls man die erste Methode wählt muss man in der jeweiligen Startseite (Root-Verzeichnis) im TYPO3-Backend über die Listenansicht einen “Domäne” Eintrag hinzufügen. Dabei nur die URL eingeben und auf das übliche “http://” verzichten.

In der typo3conf.php muss man nun nicht für jede Domain eine Konfiguration aufbauen, sondern kann kann den gesamten “_DEFAULT”-Block kopieren:

$TYPO3_CONF_VARS['EXTCONF']['realurl']['www.domain.com']=
$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT'];

und nur die unterschiedlichen Stellen werden verändert:

$TYPO3_CONF_VARS['EXTCONF']['realurl']['www.domain.com']
['pagePath']['rootpage_id'] = 123;

Um bei Bedarf einzelne Felder entfernen (Zeilenumbruch nicht übernehmen):

unset($TYPO3_CONF_VARS['EXTCONF']['realurl']
['www.domain.com']['preVars'][0]['noMatch']);

Für die zweite Methode ist wichtig, dass für die unterschiedlichen Sprachen auch die Sprach ID gewechselt wird im TypoScript und auch ggf. die Einstellungen für pdf_generator mit mehrsprachigen Seiten berücksichtigt werden:

config.linkVars = L
page.config {
language = en
locale_all = en_EN
htmlTag_langKey = en
}
pdf_generator.config {
language = en
locale_all = en_EN
htmlTag_langKey = en
}
[globalVar = GP:L=1]
page.config {
sys_language_uid = 1
language = de
locale_all = de_DE
htmlTag_langKey = de-DE
}
pdf_generator.config {
sys_language_uid = 1
language = de
locale_all = de_DE
htmlTag_langKey = de-DE
}
[global]

Der Sprachwechsel kann wie unter RealURL mehrsprachig nutzen beschrieben “im context” geschehen, oder wenn unterschiedliche Domains für jede Sprache verwendet werden direkt über die Domain selber über:

// Sprachen über Domain setzen:
switch(t3lib_div::getIndpEnv(‘HTTP_HOST’)){
case ‘www.domain.de’;
$_GET['L'] = 0;
break;
case ‘www.domain.com’;
$_GET['L'] = 1;
break;
}

Der Wechsel von einer zur anderen Sprache ist beispielsweise per Sprachwechsler über Flaggen möglich, oder bei verschiedenen Domains direkt über diese.

Dieses Veralten ist nicht nur unschön für Bookmarks, sondern auch das “Google Webmaster Tool” bemängelt doppelte sog. Title-Tags.

Wie man überhaupt den Seiten-Titel ausgibt, ist unter Typoscript Sammlung beschrieben. Dieses TypoScript wird nun wir folgt erweitert um den Titel einer News im Header des Browsers auszugeben:

[globalVar = GP:tx_ttnews|tt_news > 0]
page.headerData.10 >
page.headerData.10 = RECORDS
page.headerData.10 {
stdWrap.wrap =<title>meine Seite -&nbsp; | </title>
tables = tt_news
source.data = GPvar:tx_ttnews|tt_news
conf {
tt_news = TEXT
tt_news.field = title
}
}
[global]

Das Ganze funktioniert natürlich auch für die Überblick-Seiten welche die Kategorien anzeigen. Hier wird dann entsprechend auf die Kategorie-Tabelle zugegriffen:

[globalVar = GP:tx_ttnews|cat > 0]
page.headerData.10 >
page.headerData.10 = RECORDS
page.headerData.10 {
stdWrap.wrap =<title>meine Seite -&nbsp; | </title>
tables = tt_news_cat
source.data = GPvar:tx_ttnews|cat
conf {
tt_news_cat = TEXT
tt_news_cat.field = title
}
}
[global]

Bevor es losgeht noch kurz ein Verweis auf meinen Blog-Eintrag TYPO3: Mehr Content Elemente – was in diesem Zusammenhang vermutlich sinnvoll sein kann.

1. benötigte Extensions

Zwei TYPO3 Erweiterungen werden benötigt: rlmp_tmplselector für die verschiedenen Templates und stfl_tmpl2columns um die nur benötigten Content Elemente dazu anzuzeigen.

2. Aufbauen der Stuktur

Haupt- und Sub-HTML-Template brauchen ihren Speicherplatz, dazu müssen die Verzeichnisse beispielsweise nach diesen Vorgaben erstellt werden: fileadmin/templates/main/ und fileadmin/templates/sub/.

3. Haupt- und Sublayout

in den Hauptlayout (main.html) verbleiben nach wie vor die benötigten Marker wie z.B. für die Navigation oder einen fest stehenden Content Bereich. Der umschließende Marker ###DOCUMENT_ALL### im Hauptlayout enthält den Marker ###CONTENT### welcher später mit dem Sublayout gefüllt wird.

<html>
<head>
<title>Standardlayout</title>
</head>
<!– ###DOCUMENT_ALL### –>
###HEADER###
Sie sind hier: ###BREADCRUMB###
###CONTENT###
<!– ###DOCUMENT_ALL### –>
</body>
</html>

Der Inhalt von Title wird später dem Redakteur angezeigt um die Templates von einander zu unterscheiden. Auch kann eine gif-Grafikdatei mit dem gleichen Dateinamen des Templates abgelegt werden um die Unterschiede zu visualisieren.

Das Sublayout (col1.html) wird von ###DOCUMENT### umschlossen und enthält alle  benötigten Marker um ein zweispaltiges Layout zu erzeugen:

<html>
<head>
<title>Layout zweispaltig</title>
</head>
<body>
<!– ###DOCUMENT### –>
<table>
<tr><td>###CONTENT_LEFT###</td><td>###CONTENT_RIGHT###</td></tr>
</table>
<!– ###DOCUMENT### –>
</body>

So ist es nun problemlos möglich ein einspaltiges (col2.html) oder zweizeiliges Layout anzulegen.

4. TypoScript konfigurieren

plugin.tx_rlmptmplselector_pi1.templateType = main
plugin.tx_rlmptmplselector_pi1.templatePathMain = fileadmin/templates/main/
plugin.tx_rlmptmplselector_pi1.templatePathSub = fileadmin/templates/sub/
plugin.tx_rlmptmplselector_pi1.defaultTemplateFileNameMain = main.html
plugin.tx_rlmptmplselector_pi1.defaultTemplateFileNameSub = col1.html
plugin.tx_rlmptmplselector_pi1.inheritMainTemplates = 1
plugin.tx_rlmptmplselector_pi1.inheritSubTemplates = 1

5. Mapping herstellen

In TS-Config der Root-Seite wird festgelegt welche Content-Elemente angezeigt werden ein Abhängigkeit der gewählten Templates:

options.stfl-tmpl2columns.enable = true
options.stfl-tmpl2columns.default_content = col1
options.stfl-tmpl2columns.mapping {
col1 = 1,0,2,3
col2 = 1,0,2
}

Damit das Mapping greift ist etwas Probierarbeit nötig. Das Handbuch empfehlt alle Aliase der Seite gemeinsam zu bearbeiten. Ggf. muss man auch das Mapping für die Root-Seite selber provozieren, bis ein Wechsel des Subtemplates automatisch nicht benötigte Content Elemente verschwinden lässt:

mod.SHARED.colPos_list = 1,0,2
TCEFORM.tt_content.colPos.removeItems = 3

6. Marker mit Inhalt füllen

hier ein TypoScript Beispiel für das Haupttemplate:

page.10 = TEMPLATE
page.10 {
template = FILE
template < plugin.tx_rlmptmplselector_pi1
template.relPathPrefix = fileadmin/templates/main/
workOnSubpart = DOCUMENT_ALL
marks.CONTENT < temp.contentAreaTemplate
marks.HEADER < temp.header
marks.BREADCRUMB < temp.breadcrumb
}

Der Inhalt des Subtemplates kann nun wie folgt gefüllt werden:

temp.contentAreaTemplate = TEMPLATE
temp.contentAreaTemplate {
template = FILE
template < plugin.tx_rlmptmplselector_pi1
template.relPathPrefix = fileadmin/templates/sub/
template.templateType = sub
workOnSubpart = DOCUMENT
marks {
CONTENT_LEFT = CONTENT
CONTENT_LEFT {
table = tt_content
select {
where = colPos = 1
orderBy = sorting
languageField = sys_language_uid
}
}
CONTENT_RIGHT = CONTENT
CONTENT_RIGHT {
table = tt_content
select {
where = colPos = 4
orderBy = sorting
languageField = sys_language_uid
}
}
}
}

Template Selector to Column View mapper (stfl_tmpl2columns)
Page Template Selector (rlmp_tmplselector)

Angenommen die Hauptsprache ist englisch (sys_language_uid=0) und der Besucher soll auf die deutsche Übersetzung (L=1) über die Landesflagge umschalten können die folgenden Zeilen verwendet werden:

temp.language = TEXT
temp.language {
value = <img border=”0″ src=”/typo3/gfx/flags/de.gif”>
typolink.parameter.data = page:uid
typolink.additionalParams = &L=1
}
[globalVar = GP:L=1]
temp.language.value = <img border=”0″ src=”/typo3/gfx/flags/gb.gif”>
temp.language.typolink.additionalParams = &L=0
[global]

Hierbei werden die Flaggen-Symbole von TYPO3 verwendet und wie jeder Marker wird auch hier der Inhalt wie folgt an das html-Layout übergeben:

marks.LANGUAGE < temp.language

Der folgende Ausschnitt aus der Datei typo3conf/localconf.php ist nach viel Handbuch lesen und Recherche entstanden. Für die Extensions tt_news (News und Kategorien) und sr_feuserregister gelten diese Einstellungen:

$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array(
‘_DEFAULT’ => array(
‘init’ => array(
‘enableCHashCache’ => 1,
‘appendMissingSlash’ => ‘ifNotFile’,
‘enableUrlDecodeCache’ => 1,
‘enableUrlEncodeCache’ => 1,
),
‘preVars’ => array(
/* realurl mit sprachwahl */
array(
‘GETvar’ => ‘L’,
‘valueMap’ => array(
/* fuer sprachwechsel im context */
‘en’ => ’1′,
),
‘noMatch’ => ‘bypass’,
),
/* tt_news */
array(
‘GETvar’ => ‘no_cache’,
‘valueMap’ => array(
‘nc’ => 1,
),
‘noMatch’ => ‘bypass’,
),
),
/* realurl mit sprachwahl – start */
‘pagePath’ => array(
‘type’ => ‘user’,
‘userFunc’ => ‘EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main’,
‘spaceCharacter’ => ‘-’,
‘languageGetVar’ => ‘L’,
‘expireDays’ => 7,
‘disablePathCache’ => 0,
‘rootpage_id’ => 20,
),
/* realurl mit sprachwahl – ende */
‘postVarSets’ => array(
‘_DEFAULT’ => array(
/* tx_srfeuserregister_pi1 */
‘user’ => array(
array(
‘GETvar’ => ‘tx_srfeuserregister_pi1[regHash]‘
)
),
/* tt_news archive – start */
‘archive’ => array(
array(
‘GETvar’ => ‘tx_ttnews[year]‘ ,
),
array(
‘GETvar’ => ‘tx_ttnews[month]‘ ,
‘valueMap’ => array(
‘january’ => ’01′,
‘february’ => ’02′,
‘march’ => ’03′,
‘april’ => ’04′,
‘may’ => ’05′,
‘june’ => ’06′,
‘july’ => ’07′,
‘august’ => ’08′,
‘september’ => ’09′,
‘october’ => ’10′,
‘november’ => ’11′,
‘december’ => ’12′,
)
),
),
// news pagebrowser
‘browse’ => array(
array(
‘GETvar’ => ‘tx_ttnews[pointer]‘,
),
),
// news categories
‘cat’ => array (
array(
‘GETvar’ => ‘tx_ttnews[cat]‘,
‘lookUpTable’ => array(
‘table’ => ‘tt_news_cat’,
‘id_field’ => ‘uid’,
‘alias_field’ => ‘title’,
‘addWhereClause’ => ‘ AND NOT deleted’,
‘useUniqueCache’ => 1,
‘useUniqueCache_conf’ => array(
‘strtolower’ => 1,
‘spaceCharacter’ => ‘-’,
),
),
),
),
// news articles and searchwords
‘get’ => array(
array(
‘GETvar’ => ‘tx_ttnews[tt_news]‘,
‘lookUpTable’ => array(
‘table’ => ‘tt_news’,
‘id_field’ => ‘uid’,
‘alias_field’ => ‘title’,
‘addWhereClause’ => ‘ AND NOT deleted’,
‘useUniqueCache’ => 1,
‘useUniqueCache_conf’ => array(
‘strtolower’ => 1,
‘spaceCharacter’ => ‘-’,
),
),
),
array(
‘GETvar’ => ‘tx_ttnews[swords]‘,
),
),
/* tt_news – ende */
)
),
/* tt_news – start */
// configure filenames for different pagetypes
‘fileName’ => array(
‘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,
),
),
),
),
/* tt_news – ende */
),
);

Realurl mehrere Domains
RealURL mehrsprachig: pro Domain eine Sprache ohne Get-Parameter / preVars

Damit in Kombination mit RealURL die Sprache auch bei übersetzten Einträgen von tt_news möglich ist, kann das folgende Typoscript im Setupfeld eingesetzt werden:

page.10.marks.LANGUAGE {
value = Deutsch
typolink.parameter.data = page:uid
wrap = <ul><li>|</li></ul>
typolink.additionalParams.cObject = COA
typolink.additionalParams.cObject {
# sprache
10 = TEXT
10.value = &L=1
10.required = 1
# news
20 = TEXT
20.data = GPvar : tx_ttnews|tt_news
20.wrap = &tx_ttnews[tt_news]=|
20.required = 1
# kategorie
30 = TEXT
30.data = GPvar : tx_ttnews|cat
30.wrap = &tx_ttnews[cat]=|
30.required = 1
# seite
40 = TEXT
40.data = GPvar : tx_ttnews|pointer
40.wrap = &tx_ttnews[pointer]=|
40.required = 1
}
}
[globalVar = GP:L=1]
page.10.marks.LANGUAGE.value = English
page.10.marks.LANGUAGE.typolink.additionalParams.cObject.10.value = &L=0
[global]

Nach der Installation von pdf_generator muss noch das Systemprogramm “htmldoc” installiert werden um die pdf-Datei zu generieren zu können. Falls dieses Programm nicht installiert werden kann oder darf (Servereinschränkungen) muss auf die Erweiterung pdf_generator2 zurück gegriffen werden, welche ohne dieses Programm zurecht kommt (die folgenden Zeilen müssen dann ggf. angepasst werden).

Zuerst lässt man mit Typoscript einen verlinktes Bild in für einen Marker erzeugen:

temp.pdf = IMAGE
temp.pdf.file = fileadmin/img/pdf.gif
temp.pdf.stdWrap.postUserFunc = tx_pdfgenerator->makePdfLink

oder einen schlichten Text-Link:

temp.pdf = TEXT
temp.pdf.value = PDF erzeugen
temp.pdf.stdWrap.postUserFunc = tx_pdfgenerator->makePdfLink

oder so:

temp.pdf = TEXT
temp.pdf {
value =
stdWrap.postUserFunc.noBlur = 1
stdWrap.postUserFunc = tx_pdfgenerator->makePdfLink
stdWrap.postUserFunc.attachment = 1
stdWrap.postUserFunc.filename = print.pdf
}

Anschließend wird bestimmt welcher Inhalt ausgelesen und somit im pdf stehen soll. Auf grafische Elemente (Header) kann hier verzichtet werden um so genau zu bestimmen welche Content Elemente, in welcher Reinfolge ausgelesen werden sollen:

pdf_generator = PAGE
pdf_generator {
50 <
51 = TEXT
51.value = example.com -
52 = TEXT
52.data = page:title
60 = CONTENT
60 {
table = tt_content
select {
where = colPos = 1
orderBy = sorting
languageField = sys_language_uid
}
}
70 = CONTENT
70 {
table = tt_content
select {
where = colPos = 4
orderBy = sorting
languageField = sys_language_uid
}
}
}

Wenn mehrere Sprachen auf der Seite aktiv sind ist wichtig dies auch dem pdf_generator mitzutzeilen, sonst wird nur die Hauptsprache in das pdf übertragen:

[globalVar = GP:L=1]
pdf_generator.config {
sys_language_uid = 1
language = de
locale_all = de_DE
htmlTag_langKey = de-DE
}
[global]

Update 23.04.2009: Falls es Probleme mit dem Download gibt, das PDF beim wiederholten Male defekt ist, dann hilft die Deaktivierung des Caches für das Plugin

pdf_generator.config.no_cache=1

pdf_generator auf typo3.org
pdf_generator2 auf typo3.org

Nach der Installation von tt_new bindet man wie im Handbuch beschrieben im root-Template der Seite die dazugehörigen statischen Templates “default” und “css” von tt_news ein. Zusätzlich wird noch das Template “News-feed (RSS,RDF,ATOM) (tt_news)” eingebunden.

Wichtig ist, dass dieses Template nach den beiden anderen tt_news Templates geladen steht, also nach/unter diesen stehen muss – sonst funktioniert es nicht.

Zuerst kann man einen Marker erzeugen, welcher den Haupt-Feed (Seiten-ID 23) ausliest:

temp.rss = IMAGE
temp.rss.file = fileadmin/img/rss.png
temp.rss.stdWrap.typolink.parameter = http://example.com/?id=23&type=100
# bzw mit RealURL:
# temp.rss.stdWrap.typolink.parameter = http://example.com/rss/rss.xml

Über die Seite 23 werden nun alle System-Ordner (Termine ID = 1, News ID = 2) ausgelesen die in “pid_list” im Konstanten-Feld des root-Templates hinterlegt sind :

plugin.tt_news.displayXML.xmlLang = de
plugin.tt_news.displayXML.xmlIcon = fileadmin/img/example.jpg
plugin.tt_news.displayXML.xmlTitle = example.com – Termine und News
plugin.tt_news.displayXML.xmlDesc = Termine und News von example.com
plugin.tt_news.pid_list = 1,2

Für die Unterseiten Termine (Seiten-ID 24) und News (Seiten-ID 25) lassen sich nun diese Variablen ebenfalls im gleichen Konstanten-Feld nach dem oberen Abschnitt überschreiben um diese getrennt auszugeben im RSS:

[PIDinRootline = 24]
plugin.tt_news.displayXML.xmlTitle = example.com – Termine
plugin.tt_news.displayXML.xmlDesc = Termine von example.com
plugin.tt_news.pid_list = 1
plugin.tt_news.singlePid = 10
[global]
[PIDinRootline = 25]
plugin.tt_news.displayXML.xmlTitle = example.com – News
plugin.tt_news.displayXML.xmlDesc = News von example.com
plugin.tt_news.pid_list = 2
plugin.tt_news.singlePid = 11
[global]

singlePid gibt hierbei die Detail-Seite an. Abschließend kann im Setup-Feld noch der Haupt RSS Feed in den Header der Seite eingefügt werden:

page.headerData.99 = TEXT
page.headerData.99.value (
<link href=”http://example.com/?id=23&type=100″
rel=”alternate” title=”example.com – Termine und News”
type=”application/rss+xml”>
)

tt_news auf typo3.org

Update 06.02.2009: singlePid zur jeweiligen Detail-Seite ergänzt.

Seitenname und Seitentitel ausgeben:

config.noPageTitle = 2
page.headerData >
page.headerData = COA
page.headerData.10 = TEXT
page.headerData.10.field = title
page.headerData.10.wrap = <title>meine Seite -&nbsp; | </title>

Seite in UTF8 ausgeben:

config.metaCharset = utf-8
config.renderCharset = utf-8

XHTML konforme Einstellungen verwenden:

page.config.doctype = xhtml_trans
page.config.xhtml_cleaning = all
page.config.xmlprologue = none

Metatags definieren:

page.meta {
AUTOR = abc
KEYWORDS = cde
DESCRIPTION = efg
}

E-Mail Adressen verschlüsseln:

config {
spamProtectEmailAddresses = 2
spamProtectEmailAddresses_atSubst = (at)
spamProtectEmailAddresses_lastDotSubst = (dot)
}

Im Frontend arbeiten:

config.admPanel = 1

TYPO3 Kommentare im Quelltext nicht anzeigen:

config.disablePrefixComment = 1

Seitensprache definieren:

page.config {
language = en
locale_all = en_EN
htmlTag_langKey = en
}

Zusätzliche externe CSS-Dateien einbinden und Verwendungszweck angeben:

page.includeCSS {
file1 = fileadmin/style.css
file1.media = screen
file2 = fileadmin/print.css
file2.media = print
}

Zusätzliche externe Javascript einbinden:

page.headerData.15 = TEXT
page.headerData.15.value (
<!–[if lt IE 7]>
<link rel=”stylesheet” type=”text/css” href=”fileadmin/ielt7.css” media=”screen” />
<![endif]–>
)

Um mehr Content Elemente mit Inhalt füllen zu können, legt man einfach eine eigene Extension an. Dies ist mit dem kickstarter möglich. Im Extension Manager erscheint nach dem installieren vom kickstarter ein neuer Punkt im Drop-Down Menü Neue Extension anlegen.

Die neue Extension findet in der Kategorie Backend ihren Platz und wird nach der Vergabe von Titel, Beschreibung und Extension-Key (z.b. more_columns) wie folgt bearbeitet.

In der Datei ext_tables.php können nun beispielsweise die folgenden Änderungen eingetragen werden um zwei zusätzliche Platzhalter (4 und 5) zu bekommen:

t3lib_extMgm::addPageTSConfig(‘mod.SHARED.colPos_list = 0,1,4,2,5,3′);
$TCA["tt_content"]["columns"]["colPos"]["config"]["items"] = array (
“0″ => array (“normal||Normal||||||||”,”0″), // get
“1″ => array (“left||Links||||||||”,”1″), // getLeft
“2″ => array (“right||Rechts||||||||”,”2″), // getRight
“3″ => array (“border||Rand||||||||”,”3″), // getBorder
“4″ => array (“middle||Mitte||||||||”,”4″),
“5″ => array (“header||Header||||||||”,”5″),
);

Die erste Zeile legt die spätere Reihenfolge fest. Im Array ab der zweiten Zeile wird definiert welche Platzhaltern zu den bereits vorhandenen 0-3 noch hinzukommen und wie diese heißen. Nach der Installation der neu erstellen Extension stehen die zusätzlichen Felder zur Verfügung.

Das Auslesen der neuen Platzhalter findet direkt über die ID statt, z.B. bei ID 5:

temp.contentHeader = CONTENT
temp.contentHeader {
  table = tt_content
  select {
    where = colPos = 5
    orderBy = sorting
    languageField = sys_language_uid
  }
}

Um gleichen Content nicht auf jeder Unterseite neu anzulegen, bzw. kopieren zu müssen, kann dieser von einer festen Stelle, z.b. aus einem System-Ordner mit der ID 50 ausgelesen werden. Dazu eignet sich das folgende Typoscript:

temp.contentBorder = CONTENT
temp.contentBorder {
table = tt_content
  select {
    pidInList = 50
    orderBy = sorting
    where = colPos = 3
    languageField = sys_language_uid
  }
}

Bei einem Header möchte man jedoch pro Seite eine andere Grafik einbinden und diese auf die Unterseiten vererben. Wenn das ganze nur für eine bestimmte Seite mit der ID 60 mit allen ihren Unterseiten gelten soll, kann man dieses Typoscript verwenden:

[PIDinRootline = 60]
temp.contentBorder = CONTENT
temp.contentBorder {
  table = tt_content
  select {
    orderBy = sorting
    where = colPos = 3
    languageField = sys_language_uid
  }
  slide = -1
}
[global]

Durch das weglassen von pidInList bezieht sich die Abfrage immer auf die aktuelle Seite und deren Rand Element (where = colPos = 3). Mit slide = -1 wird auf Unterseiten der Inhalt der Übergeordneten Seiten angezeigt. Die Anfage PIDinRootline = 60 kann auch um weitere Seiten-IDs mit Komma getrennt erweitert werden, dann gilt die Bedingung für alle diese angegebenen Seiten.