Wikizone - Benutzerbeiträge [de]

TYPO3 - Scheduler

2011-03-02T12:19:04Z

94.216.225.112:

== Links ==

[[Typo3 Command Line Interface (CLI)]]

== Scheduler Cronjob ==
=== Quickstart ===
* Scheduler im TYPO3 installieren falls noch nicht aktiv
* User _cli_scheduler ohne besondere Rechte im TYPO3 Backend anlegen
* entweder Cronjob über Shell anlegen mit Scheduler aufruf (s.u.)
* oder bei Zugriff nur über php exec Funktion nutzen Beispiel all-inkl:
* Geschützter Ordner /cron/ anlegen
* scheduler.phpx anlegen (s.u.)
* über Administration Cronjob anlegen

=== Erläuterung ===

Benötigt Backend User _cli_scheduler

Aufruf allgemein

/pfad/zu/php /pfad/zu/typo3/cli_dispatch.phpsh scheduler

z.B.
/usr/local/bin/php /home/bob/www/typo3/cli_dispatch.phpsh scheduler
auf Mac mit XAMPP
/Applications/XAMPP/xamppfiles/bin/php /Applications/XAMPP/xamppfiles/htdocs/typo3_test/typo3/cli_dispatch.phpsh scheduler

=== Scheduler Cronjob auf all Inkl Servern ===

* Datei mit Endung '''.phpx''' anlegen. Am besten in ein Verzeichnis mit Namen /cronjobs oder /tasks o.ä. Das Skript muß für php ausführbar sein.
* Eventuell '''Verzeichnis schützen''' (über kasserver mit htaccess Schutz).
* Die enthaltene '''exec Funktion''' muß den absoluten Pfad zum Skript bekommen.

Beispiel:

'''cron/scheduler.phpx'''

<?php
exec("php /www/htdocs/w00c43b9/typo3/cli_dispatch.phpsh scheduler",$ausgabe);
echo "<pre>";
print_r($ausgabe);
echo "</pre>";
?>

== Scheduler in eigener Extension ==

'''Beispiel gbimporter'''

Der gbimporter importiert per Cronjob entfernte .csv Dateien und liest sie in die TYPO3 Datenbank ein. Die benötigten Daten legt man als Datensatz im Backend an. Die Extension ist folgendermaßen aufgebaut.

Damit wir den Scheduler nutzen können müssen wir Folgendes tun:

=== Scheduler Task in der ext_localconf.php registrieren ===

<pre>
...
## Scheduler Aufgabe anmelden (ab Version 4.3)
$TYPO3_CONF_VARS['SC_OPTIONS']['scheduler']['tasks']['tx_gbimporter_import'] = array(
'extension' => $_EXTKEY, // Extension Key ;-)
'title' => 'GB Importer', // Der Titel der Aufgabe
'description' => 'Importieren von CSV Daten per Cronjob', // Die Beschreibung der Aufgabe
// 'additionalFields' => 'tx_extkey_TaskName_AdditionalFieldProvider' // Zusätzliche Felder
);
...
</pre>

Somit weiß TYPO3 daß es einen task'' tx_gbimporter_import'' geben soll der über den Scheduler ausgeführt werden darf, und wie es den Task im Backend anzeigen muß. Über die additionalFields könnte man zusätzliche Felder im Backend anzeigen die man für weitere Einstellungen nutzen könnte (siehe weiterführende Links)

=== Scheduler Task über ext_autoload.php laden ===
Damit TYPO3 nun noch weiß was es bei Aufruf der Aufgabe ''tx_gbimporter_import'' tun soll brauchen wir eine passende Klasse die den auszuführenden php Code enthält. Diese laden wir einfach über den autoload Mechanismus: Enthält eine Extension die Datei ext_autoload.php, wird diese automatisch beim initialisieren der Extension ausgeführt. Daher können wir in dieser Datei die Klasse class.tx_gbimporter_import laden:

'''ext_autoload.php'''

<pre>
<?php
return array(
'tx_gbimporter_import' => t3lib_extMgm::extPath('gbimporter', 'tasks/class.tx_gbimporter_import.php')
);
?>
</pre>

Wie man sieht können wir hier auf den Code der Klasse referenzieren. Diese müssen wir nun natürlich noch anlegen.

=== Funktionen für den Task anlegen ===
Wie im vorherigen Schritt angegeben legen wir die Datei
task/class.tx_gbimporter_import.php
an. Diese erweitert die TYPO3 Klasse
tx_scheduler_Task
und enthält mindestens die Funktion '''execute()''', die beim Start des Tasks aufgerufen wird. Damit der Scheduler entscheiden kann ob der Cronjob funktioniert hat, muß die Funktion true oder false zurückgeben

'''class.tx_gbimporter_import.php'''

<pre>
<?php
class tx_gbimporter_import extends tx_scheduler_Task {

public function execute() {
$this->init();
foreach($this->arrConfigData as $configKey=>$arrConfig){
$this->configUid = $arrConfig['uid'];
...
if($this->getRemoteFile(...)){
// delete old Data on this Page
$this->deleteOldData(...);
// insert new Data on this Page
$this->insertNewData(...);
return true;
}else{
return false;
}

}
}
...
}
?>
</pre>

Typo3 - indexed search

2011-03-02T10:31:18Z

94.216.225.112: /* Einschränken des Suchbereichs im Template */

== Links ==
http://wiki.typo3.org/index.php/De:Indexed_search

== Suchergebnis verbessern ==
Es gibt einige Problemchen mit der Indexed Search die man beheben kann:

=== Suchbereich einschränken ===
Um zu verhindern, daß Metatags, Navigation etc. mit indiziert werden schränkt man den Suchbereich ein. Dafür stehen die Marker für den Suchbereich verwenden.

Ob das bei den Metatags funktioniert bleibt zu testen. Ansonsten kann auch im Quellcode der Bereich auskommentiert werden:

In der class.indexer.php die 6 Zeilen nach Zeile 1215

<pre>
// get keywords and description metatags
...
</pre>

== Performance in der indexed Search Extension ==

=== Tipps zur besseren Performance und Schonung der Datenbank ===

Nur nach ganzen Worten suchen bringt sehr viel.

Ebenso nur innerhalb des page Objekts aktivieren (page.config.index_enable = 1 nicht config.index_enable = 1)

Interessanter Artikel auf typo3.net: Informationen für eine schlanke, performante Indexsuche
http://www.typo3.net/forum/list/list_post//63315/
Darin geht es z.B. um folgende Tipps:
* Reduzierung der GET-Parameter, die zu einem neuen pHash-Wert führen und eine Beschränkung auf weniger indizierte Wörter auf einer Seite, vor allem wenn die Wörter sich auf der Seite regelmässig ändern (z.B. LIST- & LATEST-Ansicht bei tt_news).
* Bei Parametern, die am Inhalt nichts ändern (z.B. anderes Layout bei gleichem Inhalt) könnte ein Cookie anstatt eines GET-Parameters verwendet werden
* Bei einer Bildergallerie könnten vielleicht die Seiten komplett aus der Suche herausgenommen werden, wenn sich bei dem unterschiedlichen Links nur ein Bild ändert, aber keine indizierbaren Texte vorhanden sind.
* Bei der Extension tt_news sollte keine backPid verwendet werden, da ansonsten zu jeder backPid und zu jeder News Einträge in die "index_rel"-Tabelle gemacht werden. Hätten Sie 1000 Seiten mit der LATEST-Ansicht und 1000 News und durchschnittlich 100 verschiedene Wörter pro News, dann würden ca. 100.000.000 Zeilen in der DB gespeichert!

Die backPid können Sie im TypoScript mit
<pre>
plugin.tt_news.dontUseBackPid = 1
</pre>
deaktivieren. Anstatt dem dynamisch generierten Zurück-Button in der SINGLE-Ansicht könnte dann ein Zurück-Link mit JavaScript gemacht werden:
<a href="javascript:history.back()" title="Zurück zur Listenansicht">« Zurück</a>

Listenansichten sollten grundsätzlich von der Indizierung ausgeschlossen werden. Entweder man setzt mit den Seiteneigenschaften gleich die gesamte Seite auf "Nicht suchen"
oder man definiert die Marker für Such-Beginn & Such-Ende so, dass die Listen nicht indiziert werden.
Sie könnten z.B. den Content-Marker auf den Seiten mit den Listen so machen:
<pre>
page.10.marks.CONTENT_NORMAL = CONTENT
page.10.marks.CONTENT_NORMAL {
wrap = |
table = tt_content
...
}
</pre>
Auf normalen Seiten oder der Single-Ansicht müsste der wrap dann so aussehen:
<pre>
page.10.marks.CONTENT_NORMAL = CONTENT
page.10.marks.CONTENT_NORMAL {
wrap = |
table = tt_<content
...
}
</pre>

Die '''Druckansicht''' sollte man möglichst über '''CSS''' und nicht über einen Print-Button machen. Wenn man aber dennoch mit einer Print- oder '''PDF-Darstellung''' arbeiten will, dann sollten diese Inhalte '''nicht auch noch indiziert''' werden. Zum Einen hilft eine '''geschickte Anordnung der Marker TYPO3SEARCH_begin und TYPO3SEARCH_end''', zum Anderen sollte im '''TypoScript nicht im global gültigem config-Abschnitt index_enable auf 1''' gesetzt werden. Wenn dies nicht beachtet wird, hat man für jede typeNum neue Einträge in der "index_rel"-Tabelle!

'''Falsch wäre:'''
<pre>
config {
index_enable = 1
index_externals = 1
}
page {
...
}
</pre>

'''Richtig wäre:'''
<pre>
page {
config {
index_enable = 1
index_externals = 1
}
...
}
</pre>

Ein einmal gesetzter '''Encryption-Key sollte nicht mehr gewechselt werden''', da sich ansonsten alle '''cHash-Werte''' ändern. Dies würde zu sehr vielen neuen Einträgen in der DB führen. (Zudem kann dies unter Umständen den '''Pagerank''' bei Goole zerstören und '''Abmeldelinks beim Newsletter''' funktionieren auch nicht mehr).

Wenn TYPO3 Version 4.1+ verwendet wird, sollte man gegebenenfalls die Tabellen "index_..." komplett löschen und mit einem COMPARE im Install-Tool neu anlegen lassen. Wenn die Datenbank '''InnoDB''' unterstützt, werden die Tabellen dann auch als InnoDB-Tabellen angelegt. Hier können die Tabellen ausgelesen werden, obwohl vielleicht in diesem Augenblick ein Eintrag geschrieben wird. Die älteren '''MyISAM-Tabellen werden nämlich während eines Schreibzugriffs komplett gesperr'''t.

'''Nach den Optimierungen sollten die Tabellen wenigstens geleert werden''', damit die überflüssigen Daten dann auch nicht mehr in der DB liegen bleiben. Danach sollte auch im TYPO3-Backend unter Web->Info->Indexed search->Technical Details überprüft werden, ob die Änderungen zum Erfolg geführt haben, oder ob noch unnötige Einträge vorhanden sind.

=== Performance Fragen ===
Wenn es mehr Seiten werden kann die indexed Search Extension zum Performance Killer werden.
Dafür gibt es mehrere Gründe:

'''1. Die Volltextsuche http://bugs.typo3.org/view.php?id=5089'''
Es gibt aus Gründen der Kompatibilität keinen fulltext index in den Tabellen.
Daher schlägt Peter Russ im Bugtracker vor: fulltext index to index_fulltext.fulltext and index_words.baseword

'''2. changed query in class.tx_indexedsearch.php to use fulltext'''
capabilites of MySql.
Das ist im obigen Link im verlinkten diff File beschrieben. Großer Performance Gewinn, allerdings keine Teilsuche (typo findet auch typo2) mehr möglich.
nochmal zu der Änderung zur Performance-Steigerung:

in der typo3/sysext/indexed_search/pi/class.tx_indexedsearch.php
ungefähr Zeile 820 sollte muss case 1 bis 3 aukommentiert werden und
case 10 noch angepast werden, so dass es dann so aussehen sollte:

<pre>
// Perform search for word:
switch($theType) {

/*
* can't see any difference in this cases, but Kaspar might know
case '1':
$wSel = "IW.baseword LIKE
'%".$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words')."%'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '2':
$wSel = "IW.baseword LIKE '".$GLOBALS['TYPO3_DB']->quoteStr($sWord,
'index_words')."%'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '3':
$wSel = "IW.baseword LIKE
'%".$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words')."'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
*/
case '1':
case '2':
case '3':
$wSel='match(IW.baseword)
against("'.$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words').'")';
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '10':
$wSel = 'IW.metaphone = '.$this->indexerObj->metaphone($sWord);
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '20':
$res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
'ISEC.phash',
'index_section ISEC, index_fulltext IFT',
'match(IFT.fulltextdata)
against(\''.$GLOBALS['TYPO3_DB']->quoteStr($sWord,
'index_fulltext').'\') AND
ISEC.phash = IFT.phash
'.$this->sectionTableWhere(),
'ISEC.phash'
);
$wSel = '1=1';
if ($this->piVars['type']==20) $this->piVars['order'] = 'mtime';
// If there is a fulltext search for a sentence there is a likeliness
that sorting cannot be done by the rankings from the rel-table (because
no relations will exist for the sentence in the word-table). So
therefore mtime is used instaed. It is not required, but otherwise some
hits may be left out.
break;
default:
$wSel = 'IW.wid = '.$hash = $this->indexerObj->md5inthash($sWord);
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
}

...
</pre>

Weiterhin muss wie beschreiben z.b mittels phpmyadmin-Interface der
Index-Typ des Indizes fulltext in der Tabelle index_fulltext auf
FULLTEXT gesetzt werden, sowie in der Inidize baseword in der Tabelle
index_words auf FULLTEXT.

In der t.dev-Liste haben sie lange darüber diskutiert, wie es
integrierbar ist. Problem ist wohl, dass der FULLTEXT-Index in anderen
DB-Systemen nicht unterstützt wird, und die Sache ja kompatibel bleiben
soll. Es gab ein paar gute Lösungsansätze und irgendwann wirds sicher
konfigurierbar.

Noch zu der Frage:
> Geht eine täglich Re-Indizierung nicht ziemlich auf en Traffic bzw.
> Serverperformance? Ganz davon abgesehen, dass ich von cronjob's auch
> nicht viel weiss... Wie sähe denn so ein cronjob aus?

Sinnvollerweise realisiert man dass so, dass die Re-Indexierung in der
Nacht läuft. Weiterhin kann man dann ausschalten, dass die Seiten im
Frontend überhaupt indexiert werden - bringt also sogar einen
Performance Vorteil.

'''3. Mehrfach indizierte Inhalte bei tt_news'''
Lösung aus der Mailing Liste:

Die mehrfachindizierung bei tt_news habe ich hoffentlich dadurch
gelöst, indem ich dontUseBackPid = 1 verwende und nur jeweils die
SINGLE-News-Seite indizieren lasse. D. h. ich habe bei den LIST und
LATEST Seiten "Nicht suchen" aktiviert. Ist das so richtig?

== Ein Suchfeld ins Template einbinden ==
Hinweis: dies beschreibt die Einbindung eines Suchfeldes der indexed_search Extension. Wie man ein Suchfeld für die Standard Suche einbindet siehst du hier:

[[TYPO3 - Standard Suche auf jeder Seite einbinden]]

==== Extension einbinden ====
Indexed Search Engine (indexed_search)installieren
(Standardmäßig vorhanden)

Translation Handling -> Übersetzungen aktualisieren

==== HTML-Template & CSS ====
Beispiel:
<pre>
<div id="searchBox">
</div>
</pre>
===== Einschränken des Suchbereichs im Template =====
Im Template werden folgende Marker eingesetzt:
<pre>

...

</pre>

Sind keine Marker vorhanden wird alles Durchsucht ist nur einer der Marker vorhanden wird alles nach (begin Marker) bzw. vor (end Marker) dem Marker durchsucht

===== Suche auf bestimmten Seiten =====
Man kann auch die Suche auf bestimmte Seiten / Sections beschränken ohne auf TypoScript zurückzugreifen. Indexed Search benutzt dafür den Parameter
tx_indexedsearch[sections]

er enthält einen Wert der Form
value="rl2_111,222"

rl2 bedeutet 2. Level über Root (möglich sind rl1, rl2, ?)

111 bedeutet Seitenid 111

===== CSS =====
<pre>
#searchBox input{
width: 140px;
}
#searchBox input.searchBox-button{
position: relative;
border: none;
width: auto;
top: 2px;
}
div.tx-indexedsearch-whatis{
padding-left: 12px;
}

</pre>

==== Konfiguration der Extension ====

TypoScript indexedSearch-config (V1.1)

''' Constants '''
<pre>
searchRoot = 1
searchResultPage = 4
searchPic = fileadmin/common/images/lupe.gif
</pre>

'''Setup'''
<pre>
plugin.tx_indexedsearch._CSS_DEFAULT_STYLE >
page.config.index_enable = 1
config{
# Index-Suche einschalten
index_enable = 1
# Externe Dateien auch durchsuchen (pdf,doc...benötigt Erweiterungen)
index_externals = 0
}
plugin.tx_indexedsearch{
# Startpunkte der Suche (12,45...)
search.rootPidList = {$searchRoot}
# Diverse Optionen zur Anzeige im Frontend...
show.rules = 0
show.resultNumber = 0
blind.sections = 1
show.L1sections = 0
show.L2sections = 0
show.advancedSearchLink = 0

# auf bestimmte Medientypen einschränken
# search.mediaList = pdf, doc
}

# Temporäres Objekt für das Suchfeld (in neueren Versionen auch Templates möglich
# es kann auch die macina Searchbox eingesetzt werden (Template Support Mehrsprachigkeit...)

temp.searchBox = TEXT
temp.searchBox.insertData = 1
temp.searchBox.value (
<div class="searchBox">
<form action="index.php?id={$searchResultPage}&tx_indexedsearch[sword]" method="post">
<input type="text" name="tx_indexedsearch[sword]" value="Suche" class="searchBox-field" title="Suche" />
<input type="image" src="{$searchPic}" alt="Start" title="Start" class="searchBox-button"/>
<input type="hidden" name="stype" value="L0" />
<input type="hidden" name="scols" value="tt_content.header-bodytext-imagecaption" />
<input type="hidden" name="locationData" value="{$searchResultPage}:pages:{$searchResultPage}" />
</form>
</div>
)

#plugin.tx_macinasearchbox_pi1.pidSearchpage = {$searchResultPage}
</pre>

=== Suche nur in der aktuellen Sprache ===
<pre>
# für die default-Sprache:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang = 0

# für die Sprache ?&L=1
[globalVar = GP:L = 1]
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang = 1
[global]
</pre>

Oder für jede Sprache gültig:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang < config.sys_language_uid

==== Sprachlabels ====
Wie in Typo3 üblich z.B.:
<pre>
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_prev = <<
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_page =
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_next = >>
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_display = ###TAG_BEGIN###%s###TAG_END### - ###TAG_BEGIN###%s###TAG_END### (###TAG_BEGIN###%s###TAG_END###)
</pre>

In manchen Versionen gibt es einen Fehler in der französichen Übersetzung deshalb:

plugin.tx_indexedsearch._LOCAL_LANG.fr.pi_list_browseresults_display = Résultat ###TAG_BEGIN###%s à %s###TAG_END### sur un total de ###TAG_BEGIN###%s###TAG_END###

'''Suchergebnis:'''
manchmal möchte man dem Suchergebnis eine eigene Überschrift statt des Seitennamens mitgeben. Das macht man mit:
$GLOBALS['TSFE']->indexedDocTitle = 'suchtitel'

==== im Main Template ====
'''Setup:'''
### SearchBox ###
subparts.searchBox < temp.searchBox

=== Kleine Verbesserungen ===
Ein bischen Javascript kann den komfort verbessern:

Beispiel
<pre>
<input type="text" onfocus="if(this.value=='Seminarsuche')this.value='';" onblur="if(this.value=='')this.value='Seminarsuche';" value="Seminarsuche" name="tx_indexedsearch[sword]" class="searchbox-field">

</pre>

== Tutorial von Marlies Cohen ==

When I first started with Typo3 Indexed Search gave me some problems. It is a very basic extension.

Place this line of code in the Setup of your TypoScript of your rootpage:

# Indexed Search activated
page.config.index_enable = 1

Now comes the trick to get your pages indexed.

-> Log out of Typo3

-> Go to your home page

-> Log back in to Typo3

-> Now your pages should be cached and searchable

The reason for this is that as long as you are logged in to Typo3 your pages are not cached, once you log out and view pages they are cached. Knowing this saves a lot of hassles.

== Clearing Indexed Search Cache ==

-> switch to the "Info" module on the left and

-> choose "indexed search" on the right dropdown (in the details view). now you can see all your pages that have been indexed

-> click on the trash-item to delete the indexed record for a specific page-tree (attention: recursive!).

== Optionen der indexed search ==
Da gibts ne ganze Menge:

http://www.typo3.net/forum/list/list_post//27370/

<pre>
plugin.tx_indexedsearch {
blind {
###settings: 0=aktiv (sichtbar), -1 inaktiv (nicht sichtbar)

## Vergleichs-Typ (Ganzes Wort, Wortteil,etc)
type=-1

## type default option (und /oder)
defOp=0

## Bereich(e) der website
sections=0

## Suche in Medientypen (erweiterungen)
media=1

## Sortierung
order=-1

## Ansicht (Sektionshierachie / Liste)
group=-1

## Ansicht: Erweiterte Vorschau
extResume = -1

## Sprachwahlbox
lang=0

## Aufsteigend absteigend
desc=-1

## Ergebnisse (Anzahl der Treffer pro Seite)
results=-1
}
show {
###settings: 1=aktiv (sichtbar), 0 inaktiv (nicht sichtbar)

## zeige Kurzanleitung
rules=1

## Erstellungsinformationen des Hashes
parsetimes=1

## Zweite ebene im Bereichs-dropdown anzeigen
L2sections=1

## Erste ebene im Bereichs-dropdown anzeigen
L1sections=1

## Alle "nicht im menü" oder "im menü verstecken"
##(aber nicht "versteckte" seiten) mit anzeigen in section?
LxALLtypes=0

## leeren des Suchfeldes nach suche
clearSearchBox = 0

## Aktuelles suchwort zu den bisherigen suchwörtern hinzufügen
clearSearchBox.enableSubSearchCheckBox=0
}
search {
## Seiten-Id auf der die Suchergebnisse ausgegeben werden sollen.
## Leer lassen entspricht auf gleicher Seite ausgeben
rootPidList =

## Anzahl der auszugebenden treffer
page_links = 10
}
}
</pre>

Scheint nicht zu funktionnieren

plugin.tx_indexedsearch.search.page_links = 5

stattdessen das hier verwenden:

plugin.tx_indexedsearch._DEFAULT_PI_VARS.results = 5

Typo3 - indexed search

2011-03-02T09:52:46Z

94.216.225.112: /* Tutorial von Marlies Cohen */

== Links ==
http://wiki.typo3.org/index.php/De:Indexed_search

== Suchergebnis verbessern ==
Es gibt einige Problemchen mit der Indexed Search die man beheben kann:

=== Suchbereich einschränken ===
Um zu verhindern, daß Metatags, Navigation etc. mit indiziert werden schränkt man den Suchbereich ein. Dafür stehen die Marker für den Suchbereich verwenden.

Ob das bei den Metatags funktioniert bleibt zu testen. Ansonsten kann auch im Quellcode der Bereich auskommentiert werden:

In der class.indexer.php die 6 Zeilen nach Zeile 1215

<pre>
// get keywords and description metatags
...
</pre>

== Performance in der indexed Search Extension ==

=== Tipps zur besseren Performance und Schonung der Datenbank ===

Nur nach ganzen Worten suchen bringt sehr viel.

Ebenso nur innerhalb des page Objekts aktivieren (page.config.index_enable = 1 nicht config.index_enable = 1)

Interessanter Artikel auf typo3.net: Informationen für eine schlanke, performante Indexsuche
http://www.typo3.net/forum/list/list_post//63315/
Darin geht es z.B. um folgende Tipps:
* Reduzierung der GET-Parameter, die zu einem neuen pHash-Wert führen und eine Beschränkung auf weniger indizierte Wörter auf einer Seite, vor allem wenn die Wörter sich auf der Seite regelmässig ändern (z.B. LIST- & LATEST-Ansicht bei tt_news).
* Bei Parametern, die am Inhalt nichts ändern (z.B. anderes Layout bei gleichem Inhalt) könnte ein Cookie anstatt eines GET-Parameters verwendet werden
* Bei einer Bildergallerie könnten vielleicht die Seiten komplett aus der Suche herausgenommen werden, wenn sich bei dem unterschiedlichen Links nur ein Bild ändert, aber keine indizierbaren Texte vorhanden sind.
* Bei der Extension tt_news sollte keine backPid verwendet werden, da ansonsten zu jeder backPid und zu jeder News Einträge in die "index_rel"-Tabelle gemacht werden. Hätten Sie 1000 Seiten mit der LATEST-Ansicht und 1000 News und durchschnittlich 100 verschiedene Wörter pro News, dann würden ca. 100.000.000 Zeilen in der DB gespeichert!

Die backPid können Sie im TypoScript mit
<pre>
plugin.tt_news.dontUseBackPid = 1
</pre>
deaktivieren. Anstatt dem dynamisch generierten Zurück-Button in der SINGLE-Ansicht könnte dann ein Zurück-Link mit JavaScript gemacht werden:
<a href="javascript:history.back()" title="Zurück zur Listenansicht">« Zurück</a>

Listenansichten sollten grundsätzlich von der Indizierung ausgeschlossen werden. Entweder man setzt mit den Seiteneigenschaften gleich die gesamte Seite auf "Nicht suchen"
oder man definiert die Marker für Such-Beginn & Such-Ende so, dass die Listen nicht indiziert werden.
Sie könnten z.B. den Content-Marker auf den Seiten mit den Listen so machen:
<pre>
page.10.marks.CONTENT_NORMAL = CONTENT
page.10.marks.CONTENT_NORMAL {
wrap = |
table = tt_content
...
}
</pre>
Auf normalen Seiten oder der Single-Ansicht müsste der wrap dann so aussehen:
<pre>
page.10.marks.CONTENT_NORMAL = CONTENT
page.10.marks.CONTENT_NORMAL {
wrap = |
table = tt_<content
...
}
</pre>

Die '''Druckansicht''' sollte man möglichst über '''CSS''' und nicht über einen Print-Button machen. Wenn man aber dennoch mit einer Print- oder '''PDF-Darstellung''' arbeiten will, dann sollten diese Inhalte '''nicht auch noch indiziert''' werden. Zum Einen hilft eine '''geschickte Anordnung der Marker TYPO3SEARCH_begin und TYPO3SEARCH_end''', zum Anderen sollte im '''TypoScript nicht im global gültigem config-Abschnitt index_enable auf 1''' gesetzt werden. Wenn dies nicht beachtet wird, hat man für jede typeNum neue Einträge in der "index_rel"-Tabelle!

'''Falsch wäre:'''
<pre>
config {
index_enable = 1
index_externals = 1
}
page {
...
}
</pre>

'''Richtig wäre:'''
<pre>
page {
config {
index_enable = 1
index_externals = 1
}
...
}
</pre>

Ein einmal gesetzter '''Encryption-Key sollte nicht mehr gewechselt werden''', da sich ansonsten alle '''cHash-Werte''' ändern. Dies würde zu sehr vielen neuen Einträgen in der DB führen. (Zudem kann dies unter Umständen den '''Pagerank''' bei Goole zerstören und '''Abmeldelinks beim Newsletter''' funktionieren auch nicht mehr).

Wenn TYPO3 Version 4.1+ verwendet wird, sollte man gegebenenfalls die Tabellen "index_..." komplett löschen und mit einem COMPARE im Install-Tool neu anlegen lassen. Wenn die Datenbank '''InnoDB''' unterstützt, werden die Tabellen dann auch als InnoDB-Tabellen angelegt. Hier können die Tabellen ausgelesen werden, obwohl vielleicht in diesem Augenblick ein Eintrag geschrieben wird. Die älteren '''MyISAM-Tabellen werden nämlich während eines Schreibzugriffs komplett gesperr'''t.

'''Nach den Optimierungen sollten die Tabellen wenigstens geleert werden''', damit die überflüssigen Daten dann auch nicht mehr in der DB liegen bleiben. Danach sollte auch im TYPO3-Backend unter Web->Info->Indexed search->Technical Details überprüft werden, ob die Änderungen zum Erfolg geführt haben, oder ob noch unnötige Einträge vorhanden sind.

=== Performance Fragen ===
Wenn es mehr Seiten werden kann die indexed Search Extension zum Performance Killer werden.
Dafür gibt es mehrere Gründe:

'''1. Die Volltextsuche http://bugs.typo3.org/view.php?id=5089'''
Es gibt aus Gründen der Kompatibilität keinen fulltext index in den Tabellen.
Daher schlägt Peter Russ im Bugtracker vor: fulltext index to index_fulltext.fulltext and index_words.baseword

'''2. changed query in class.tx_indexedsearch.php to use fulltext'''
capabilites of MySql.
Das ist im obigen Link im verlinkten diff File beschrieben. Großer Performance Gewinn, allerdings keine Teilsuche (typo findet auch typo2) mehr möglich.
nochmal zu der Änderung zur Performance-Steigerung:

in der typo3/sysext/indexed_search/pi/class.tx_indexedsearch.php
ungefähr Zeile 820 sollte muss case 1 bis 3 aukommentiert werden und
case 10 noch angepast werden, so dass es dann so aussehen sollte:

<pre>
// Perform search for word:
switch($theType) {

/*
* can't see any difference in this cases, but Kaspar might know
case '1':
$wSel = "IW.baseword LIKE
'%".$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words')."%'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '2':
$wSel = "IW.baseword LIKE '".$GLOBALS['TYPO3_DB']->quoteStr($sWord,
'index_words')."%'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '3':
$wSel = "IW.baseword LIKE
'%".$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words')."'";
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
*/
case '1':
case '2':
case '3':
$wSel='match(IW.baseword)
against("'.$GLOBALS['TYPO3_DB']->quoteStr($sWord, 'index_words').'")';
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '10':
$wSel = 'IW.metaphone = '.$this->indexerObj->metaphone($sWord);
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
case '20':
$res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
'ISEC.phash',
'index_section ISEC, index_fulltext IFT',
'match(IFT.fulltextdata)
against(\''.$GLOBALS['TYPO3_DB']->quoteStr($sWord,
'index_fulltext').'\') AND
ISEC.phash = IFT.phash
'.$this->sectionTableWhere(),
'ISEC.phash'
);
$wSel = '1=1';
if ($this->piVars['type']==20) $this->piVars['order'] = 'mtime';
// If there is a fulltext search for a sentence there is a likeliness
that sorting cannot be done by the rankings from the rel-table (because
no relations will exist for the sentence in the word-table). So
therefore mtime is used instaed. It is not required, but otherwise some
hits may be left out.
break;
default:
$wSel = 'IW.wid = '.$hash = $this->indexerObj->md5inthash($sWord);
$res = $this->execPHashListQuery($wSel,' AND is_stopword=0');
break;
}

...
</pre>

Weiterhin muss wie beschreiben z.b mittels phpmyadmin-Interface der
Index-Typ des Indizes fulltext in der Tabelle index_fulltext auf
FULLTEXT gesetzt werden, sowie in der Inidize baseword in der Tabelle
index_words auf FULLTEXT.

In der t.dev-Liste haben sie lange darüber diskutiert, wie es
integrierbar ist. Problem ist wohl, dass der FULLTEXT-Index in anderen
DB-Systemen nicht unterstützt wird, und die Sache ja kompatibel bleiben
soll. Es gab ein paar gute Lösungsansätze und irgendwann wirds sicher
konfigurierbar.

Noch zu der Frage:
> Geht eine täglich Re-Indizierung nicht ziemlich auf en Traffic bzw.
> Serverperformance? Ganz davon abgesehen, dass ich von cronjob's auch
> nicht viel weiss... Wie sähe denn so ein cronjob aus?

Sinnvollerweise realisiert man dass so, dass die Re-Indexierung in der
Nacht läuft. Weiterhin kann man dann ausschalten, dass die Seiten im
Frontend überhaupt indexiert werden - bringt also sogar einen
Performance Vorteil.

'''3. Mehrfach indizierte Inhalte bei tt_news'''
Lösung aus der Mailing Liste:

Die mehrfachindizierung bei tt_news habe ich hoffentlich dadurch
gelöst, indem ich dontUseBackPid = 1 verwende und nur jeweils die
SINGLE-News-Seite indizieren lasse. D. h. ich habe bei den LIST und
LATEST Seiten "Nicht suchen" aktiviert. Ist das so richtig?

== Ein Suchfeld ins Template einbinden ==
Hinweis: dies beschreibt die Einbindung eines Suchfeldes der indexed_search Extension. Wie man ein Suchfeld für die Standard Suche einbindet siehst du hier:

[[TYPO3 - Standard Suche auf jeder Seite einbinden]]

==== Extension einbinden ====
Indexed Search Engine (indexed_search)installieren
(Standardmäßig vorhanden)

Translation Handling -> Übersetzungen aktualisieren

==== HTML-Template & CSS ====
Beispiel:
<pre>
<div id="searchBox">
</div>
</pre>
===== Einschränken des Suchbereichs im Template =====
Im Template werden folgende Marker eingesetzt:
<pre>

...

</pre>

Sind keine Marker vorhanden wird alles Durchsucht ist nur einer der Marker vorhanden wird alles nach (begin Marker) bzw. vor (end Marker) dem Marker durchsucht

===== CSS =====
<pre>
#searchBox input{
width: 140px;
}
#searchBox input.searchBox-button{
position: relative;
border: none;
width: auto;
top: 2px;
}
div.tx-indexedsearch-whatis{
padding-left: 12px;
}

</pre>

==== Konfiguration der Extension ====

TypoScript indexedSearch-config (V1.1)

''' Constants '''
<pre>
searchRoot = 1
searchResultPage = 4
searchPic = fileadmin/common/images/lupe.gif
</pre>

'''Setup'''
<pre>
plugin.tx_indexedsearch._CSS_DEFAULT_STYLE >
page.config.index_enable = 1
config{
# Index-Suche einschalten
index_enable = 1
# Externe Dateien auch durchsuchen (pdf,doc...benötigt Erweiterungen)
index_externals = 0
}
plugin.tx_indexedsearch{
# Startpunkte der Suche (12,45...)
search.rootPidList = {$searchRoot}
# Diverse Optionen zur Anzeige im Frontend...
show.rules = 0
show.resultNumber = 0
blind.sections = 1
show.L1sections = 0
show.L2sections = 0
show.advancedSearchLink = 0

# auf bestimmte Medientypen einschränken
# search.mediaList = pdf, doc
}

# Temporäres Objekt für das Suchfeld (in neueren Versionen auch Templates möglich
# es kann auch die macina Searchbox eingesetzt werden (Template Support Mehrsprachigkeit...)

temp.searchBox = TEXT
temp.searchBox.insertData = 1
temp.searchBox.value (
<div class="searchBox">
<form action="index.php?id={$searchResultPage}&tx_indexedsearch[sword]" method="post">
<input type="text" name="tx_indexedsearch[sword]" value="Suche" class="searchBox-field" title="Suche" />
<input type="image" src="{$searchPic}" alt="Start" title="Start" class="searchBox-button"/>
<input type="hidden" name="stype" value="L0" />
<input type="hidden" name="scols" value="tt_content.header-bodytext-imagecaption" />
<input type="hidden" name="locationData" value="{$searchResultPage}:pages:{$searchResultPage}" />
</form>
</div>
)

#plugin.tx_macinasearchbox_pi1.pidSearchpage = {$searchResultPage}
</pre>

=== Suche nur in der aktuellen Sprache ===
<pre>
# für die default-Sprache:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang = 0

# für die Sprache ?&L=1
[globalVar = GP:L = 1]
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang = 1
[global]
</pre>

Oder für jede Sprache gültig:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.lang < config.sys_language_uid

==== Sprachlabels ====
Wie in Typo3 üblich z.B.:
<pre>
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_prev = <<
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_page =
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_next = >>
plugin.tx_indexedsearch._LOCAL_LANG.de.pi_list_browseresults_display = ###TAG_BEGIN###%s###TAG_END### - ###TAG_BEGIN###%s###TAG_END### (###TAG_BEGIN###%s###TAG_END###)
</pre>

In manchen Versionen gibt es einen Fehler in der französichen Übersetzung deshalb:

plugin.tx_indexedsearch._LOCAL_LANG.fr.pi_list_browseresults_display = Résultat ###TAG_BEGIN###%s à %s###TAG_END### sur un total de ###TAG_BEGIN###%s###TAG_END###

'''Suchergebnis:'''
manchmal möchte man dem Suchergebnis eine eigene Überschrift statt des Seitennamens mitgeben. Das macht man mit:
$GLOBALS['TSFE']->indexedDocTitle = 'suchtitel'

==== im Main Template ====
'''Setup:'''
### SearchBox ###
subparts.searchBox < temp.searchBox

=== Kleine Verbesserungen ===
Ein bischen Javascript kann den komfort verbessern:

Beispiel
<pre>
<input type="text" onfocus="if(this.value=='Seminarsuche')this.value='';" onblur="if(this.value=='')this.value='Seminarsuche';" value="Seminarsuche" name="tx_indexedsearch[sword]" class="searchbox-field">

</pre>

== Tutorial von Marlies Cohen ==

When I first started with Typo3 Indexed Search gave me some problems. It is a very basic extension.

Place this line of code in the Setup of your TypoScript of your rootpage:

# Indexed Search activated
page.config.index_enable = 1

Now comes the trick to get your pages indexed.

-> Log out of Typo3

-> Go to your home page

-> Log back in to Typo3

-> Now your pages should be cached and searchable

The reason for this is that as long as you are logged in to Typo3 your pages are not cached, once you log out and view pages they are cached. Knowing this saves a lot of hassles.

== Clearing Indexed Search Cache ==

-> switch to the "Info" module on the left and

-> choose "indexed search" on the right dropdown (in the details view). now you can see all your pages that have been indexed

-> click on the trash-item to delete the indexed record for a specific page-tree (attention: recursive!).

== Optionen der indexed search ==
Da gibts ne ganze Menge:

http://www.typo3.net/forum/list/list_post//27370/

<pre>
plugin.tx_indexedsearch {
blind {
###settings: 0=aktiv (sichtbar), -1 inaktiv (nicht sichtbar)

## Vergleichs-Typ (Ganzes Wort, Wortteil,etc)
type=-1

## type default option (und /oder)
defOp=0

## Bereich(e) der website
sections=0

## Suche in Medientypen (erweiterungen)
media=1

## Sortierung
order=-1

## Ansicht (Sektionshierachie / Liste)
group=-1

## Ansicht: Erweiterte Vorschau
extResume = -1

## Sprachwahlbox
lang=0

## Aufsteigend absteigend
desc=-1

## Ergebnisse (Anzahl der Treffer pro Seite)
results=-1
}
show {
###settings: 1=aktiv (sichtbar), 0 inaktiv (nicht sichtbar)

## zeige Kurzanleitung
rules=1

## Erstellungsinformationen des Hashes
parsetimes=1

## Zweite ebene im Bereichs-dropdown anzeigen
L2sections=1

## Erste ebene im Bereichs-dropdown anzeigen
L1sections=1

## Alle "nicht im menü" oder "im menü verstecken"
##(aber nicht "versteckte" seiten) mit anzeigen in section?
LxALLtypes=0

## leeren des Suchfeldes nach suche
clearSearchBox = 0

## Aktuelles suchwort zu den bisherigen suchwörtern hinzufügen
clearSearchBox.enableSubSearchCheckBox=0
}
search {
## Seiten-Id auf der die Suchergebnisse ausgegeben werden sollen.
## Leer lassen entspricht auf gleicher Seite ausgeben
rootPidList =

## Anzahl der auszugebenden treffer
page_links = 10
}
}
</pre>

Scheint nicht zu funktionnieren

plugin.tx_indexedsearch.search.page_links = 5

stattdessen das hier verwenden:

plugin.tx_indexedsearch._DEFAULT_PI_VARS.results = 5

Projekte

2011-03-02T09:46:59Z

94.216.225.112:

== Hilfen für div. Projekte ==

[[Gesundheitsregion Reutlingen Tübingen Zollernalb]]

== Projektsammlung (Referenzen) ==
<pre>
www.tourismus-reutlingen.de
www.dekraaviation.de
www.baum-und-garten.de
www.geo-bit.de
www.gkk.de ?
hortense
siedlevoss
porsche
svo
hammetweil
oferdingen sportheim
u7
launer
aszwei
narda-sts
hb-tech ?
baywa
</pre>