![[Translate to German:] Access permissions](/blog/fileadmin/user_upload/Can_TYPO3_editors_get_access_permission_to_the_TYPO3_Indexing_backend_module.jpg "[Translate to German:] Access permissions")
T3Planet License Manager Aktivierung: Vollständige Schritt-für-Schritt-Anleitung
Extensions
Einfache Anleitung zur TYPO3 Indexed Search (Einrichtung, Konfiguration & Optimierung)
Willkommen bei den TYPO3-Suchfunktionen! In diesem Blog erkunden Sie die 7 besten TYPO3-Suchlösungen mit Vergleich und Schritt-für-Schritt-Anleitung zu den indizierten Such- und Crawler-Funktionen von TYPO3. Suchfunktion! Eine der unterschätzten nützlichen Komponenten, um die Erfahrung der Besucher Ihrer Website zu verbessern. Meiner Meinung nach sollten zumindest für mittlere bis große TYPO3-Websites Suchfunktionen vorhanden sein.
Die Suche ist eine der am meisten unterschätzten Komponenten einer TYPO3 Website, dennoch wirkt sie sich direkt auf Benutzerfreundlichkeit, Engagement und Conversion aus.
In diesem Leitfaden erhalten Sie einen klaren Überblick über TYPO3 Suchlösungen und eine Schritt-für-Schritt-Anleitung zur Installation und Konfiguration von EXT:indexed_search, einschließlich Crawler-Einrichtung für die automatisierte Indexierung.
Dieser Leitfaden hilft Ihnen:
- Verfügbare TYPO3-Suchoptionen zu verstehen
- Zu entscheiden, wann indexed_search die richtige Wahl ist
- indexed_search korrekt einzurichten und zu konfigurieren
- Häufige Probleme und Leistungsbeschränkungen zu vermeiden
Hinweis: Dieser Leitfaden behandelt TYPO3 v9- und v10-Setups. Die Grundkonzepte bleiben bei neueren TYPO3-Versionen gleich, auch wenn geringfügige Konfigurationsunterschiede möglich sind.
Warum Suchfunktionen für Ihre TYPO3-Website wichtig sind
Eine moderne TYPO3-Website soll schnellen Zugriff auf relevante Inhalte bieten. Während die Navigation hilfreich ist, ist die Suche oft der schnellste Weg zu Informationen, insbesondere auf inhaltsreichen Websites.
Laut Search Engine Journal halten über 40 % der Nutzer die Suchfunktion für wichtiger als die Navigation, wenn sie das finden möchten, was sie benötigen. Dadurch ist die Suche nicht nur eine Funktion, sondern ein zentraler Bestandteil der Benutzerfreundlichkeit.
Hier ist, warum sie wichtig ist:
- Schnellere Inhaltsfindung
Nutzer können direkt auf das zugreifen, wonach sie suchen, ohne durch mehrere Seiten navigieren zu müssen. - Verbesserte Nutzerbindung
Besucher, die die Suche verwenden, bleiben mit höherer Wahrscheinlichkeit länger und erkunden mehr Inhalte. - Höheres Conversion-Potenzial
Schneller Zugriff auf relevante Inhalte reduziert Reibung und erhöht die Zielerreichung. - Wertvolle Nutzereinblicke
Suchanfragen zeigen, was Nutzer tatsächlich wollen, und helfen Ihnen dabei, Inhalte und Struktur zu optimieren. - Unverzichtbar für mobile Nutzer
Auf kleineren Bildschirmen wird die Suche zur wichtigsten Möglichkeit, komplexe Websites zu navigieren.
Überblick über TYPO3-Suchoptionen (Core vs. Extensions)
TYPO3 bietet mehrere Möglichkeiten, Suchfunktionen zu implementieren – von der integrierten Core-Extension bis hin zu fortgeschrittenen Drittanbieter-Lösungen. Der richtige Ansatz hängt von der Größe Ihrer Website, den Leistungsanforderungen und dem Umfang der Suchfunktionen ab, die Sie benötigen.
Im Allgemeinen lassen sich TYPO3-Suchlösungen in zwei Kategorien einteilen:
- Core-Lösung:
EXT:indexed_search, geeignet für kleine bis mittelgroße Websites mit grundlegenden Suchanforderungen. - Fortgeschrittene Extensions und externe Suchmaschinen:
Lösungen wie Solr, ke_search oder Elasticsearch-basierte Extensions, die für größere Websites entwickelt wurden, die bessere Performance, Skalierbarkeit und fortgeschrittene Funktionen wie Facettensuche benötigen.
Unten finden Sie einen Vergleich häufig verwendeter TYPO3-Suchlösungen:
| Name der Extension | Lösungstyp | TYPO3-Version | Templates-Unterstützung | Indexierungsmethode | Dateiindexierung | Facetten |
| indexed_search | Integrierter TYPO3-Core | Alle | Ja (Marker & Fluid) | Scheduler, On-Page | Ja | Nein |
| Apache Solr | Externer Solr-Server | v9–v10 | Ja | Scheduler | Ja | Ja |
| ke_search | TYPO3 Extension | v9–v10 | Ja (Fluid) | Scheduler | Ja | Ja |
| mksearch | Solr / Lucene / Elasticsearch | v8–v9 | Ja | Scheduler | Ja | Ja |
| search_core | Elasticsearch / Algolia / Solr | v8 | Ja | Scheduler | Ja | Ja |
| Google CSE | Extern (Google-Suche) | v9–v10 | Eingeschränkt | Extern | Ja | Nein |
Im folgenden Abschnitt betrachten wir diese Extensions genauer und helfen Ihnen, die richtige TYPO3-Suchlösung für Ihr Projekt auszuwählen.
Top TYPO3 Search Extensions (Verglichen)
Bevor wir in die Einrichtung von TYPO3 EXT:indexed_search eintauchen, hier ein praktischer Überblick über die am häufigsten verwendeten TYPO3-Such-Extensions, einschließlich ihrer optimalen Einsatzbereiche und Einschränkungen.
#1 EXT:indexed_search (TYPO3 Core)
Am besten geeignet für:
Kleine bis mittelgroße TYPO3-Websites mit grundlegenden Suchanforderungen
Hauptstärken:
- In den TYPO3 Kern integriert
- Keine zusätzliche Einrichtung erforderlich
- Unterstützt grundlegende Volltextsuche und Dateiindexierung
Einschränkungen:
- Begrenzte Skalierbarkeit für große Websites
- Keine Facettensuche
- Leistung kann bei großen Datensätzen abnehmen
#2 EXT:solr (Apache Solr für TYPO3)
Am besten geeignet für:
Mittelgroße bis große Websites mit erweiterten Suchanforderungen
Hauptstärken:
- Hohe Performance und schnelle Ergebnisse
- Facettensuche, Synonyme, Relevanzanpassung
- Skalierbar für Enterprise-Projekte
Einschränkungen:
- Erfordert Einrichtung eines externen Solr-Servers
- Höherer Wartungs- und Konfigurationsaufwand
#3 EXT:ke_search
Am besten geeignet für:
Kleine bis mittelgroße Websites, die mehr Flexibilität als indexed_search benötigen
Hauptstärken:
- Einfach zu installieren und zu konfigurieren
- Unterstützt Facettensuche
- Flexible Indexierung aus Datenbankeinträgen
Einschränkungen:
- Nicht so leistungsstark wie Solr für großangelegte Projekte
- Leistung hängt von der Größe der Datenbank ab
#4 EXT:mksearch
Am besten geeignet für:
Projekte, die eine flexible Backend-Integration (Solr, Lucene, Elasticsearch) erfordern
Hauptstärken:
- Unterstützt mehrere Suchmaschinen
- Hochgradig anpassbar und erweiterbar
Einschränkungen:
- Komplexere Einrichtung
- Weniger verbreitet, kleinere Community-Unterstützung
#5 EXT:search_core
Am besten geeignet für:
Entwickler, die benutzerdefinierte Suchimplementierungen mit externen Suchmaschinen benötigen
Hauptstärken:
- Unterstützt Elasticsearch, Algolia, Solr
- Flexible API für individuelle Integrationen
Einschränkungen:
- Begrenzte Unterstützung für neuere TYPO3 Versionen
- Erfordert Entwicklungsaufwand
#6 EXT:pr_googlecse
Am besten geeignet für:
Schnelle Implementierung der Suche mit Google Custom Search
Hauptstärken:
- Einfach einzurichten
- Keine Indexierung innerhalb von TYPO3 erforderlich
- Nutzt die Suchfunktionen von Google
Einschränkungen:
- Eingeschränkte Kontrolle über die Suchergebnisse
- Externe Abhängigkeit
- Nicht ideal für datenschutzsensible oder Enterprise-Projekte
#7 Weitere TYPO3-Such Extensions
TYPO3 bietet außerdem zusätzliche Such-Extensions über das TYPO3 Extension Repository (TER) sowie die Möglichkeit, benutzerdefinierte Lösungen basierend auf spezifischen Projektanforderungen zu entwickeln.
Am besten geeignet für:
Individuelle oder spezielle Anwendungsfälle
Einschränkungen:
- Unterschiedliche Unterstützungs- und Wartungsniveaus
- Kann zusätzliche Entwicklung und Tests erfordern
Im nächsten Abschnitt helfen wir Ihnen dabei, zu entscheiden, welche TYPO3-Suchlösung am besten zu Ihrem Projekt passt, basierend auf der Größe, Komplexität und den Leistungsanforderungen Ihrer Website.
Welche TYPO3-Such-Extension sollten Sie wählen?
Die Wahl der richtigen TYPO3-Suchlösung hängt hauptsächlich von der Größe Ihrer Website, der Komplexität der Inhalte und den Leistungsanforderungen ab. Anstatt nur die Funktionen zu vergleichen, ist es praktischer, anhand realer Anwendungsfälle zu entscheiden.
Schnelle Entscheidungshilfe
| Website-Größe / Anforderung | Empfohlene Lösung | |
| Kleine Website (bis ca. 500 Seiten) | indexed_search oder ke_search | |
| Mittelgroße Website (500–2000 Seiten) | ke_search oder Solr | |
| Große Website (2000+ Seiten) | Solr oder Elasticsearch-basierte Lösungen | |
| Facettensuche / Filter benötigt | ke_search oder Solr | |
| Hohe Leistung & Skalierbarkeit benötigt | Solr | |
| Schnelle Einrichtung mit minimalem Aufwand | indexed_search |
Wann EXT:indexed_search wählen
Wählen Sie indexed_search, wenn:
- Sie eine kleine bis mittelgroße TYPO3-Website haben
- Sie eine einfache, integrierte Lösung benötigen
- Sie minimale Einrichtung und Wartung wünschen
Vermeiden Sie es, wenn:
- Ihre Website groß oder inhaltsreich ist
- Sie erweiterte Funktionen wie Facettierung oder Relevanzanpassung benötigen
- Die Suchleistung kritisch ist
Wann ke_search wählen
Wählen Sie ke_search, wenn:
- Sie mehr Flexibilität als bei indexed_search benötigen
- Sie Facettensuche ohne externe Server möchten
- Ihr Projekt mittelgroß ist
Vermeiden Sie es, wenn:
- Sie eine großangelegte oder Enterprise-Website betreiben
Wann Solr (EXT:solr) wählen
Wählen Sie Solr, wenn:
- Sie an einem großen TYPO3-Projekt arbeiten
- Sie schnelle, skalierbare Suchleistung benötigen
- Sie erweiterte Funktionen (Facetten, Synonyme, Ranking-Kontrolle) brauchen
Vermeiden Sie es, wenn:
- Sie eine schnelle, wartungsarme Einrichtung möchten
- Sie keine Ressourcen für die Serverkonfiguration haben
Wichtige Einschränkung, die zu beachten ist
Laut TYPO3-Dokumentation wurde indexed_search nicht vollständig für den großangelegten Einsatz benchmarked. Bestehende Benchmarks decken bis etwa 2000 Seiten und ~400.000 indexierte Datensätze ab. Darüber hinaus können Leistung und Skalierbarkeit Optimierungen oder alternative Lösungen wie Solr erfordern.
Praktische Zusammenfassung
- Verwenden Sie indexed_search für Einfachheit
- Verwenden Sie ke_search für Flexibilität ohne große Infrastruktur
- Verwenden Sie Solr für Leistung und Skalierbarkeit
Im nächsten Abschnitt konzentrieren wir uns darauf, wie TYPO3 EXT:indexed_search Schritt für Schritt installiert und konfiguriert wird.
Einschränkungen von TYPO3 Indexed Search
Während EXT:indexed_search eine praktische integrierte Lösung ist, weist sie klare Einschränkungen auf, die vor der Implementierung berücksichtigt werden sollten – insbesondere bei größeren oder leistungsrelevanten TYPO3-Projekten.
Leistungseinschränkungen
Indexed Search basiert auf datenbankgestützter Indexierung und Abfragen. Mit zunehmender Anzahl indexierter Seiten können Suchanfragen langsamer werden, insbesondere bei hohem Traffic oder komplexen Suchanfragen. In größeren Setups können die Antwortzeiten erheblich steigen.
Skalierbarkeitsbeschränkungen
Diese Lösung ist nicht für großangelegte Websites ausgelegt. Laut TYPO3-Dokumentation wurden Benchmarks nur bis etwa 2000 Seiten und ~400.000 indexierte Datensätze getestet. Darüber hinaus kann die Leistung abnehmen, und zusätzliche Optimierungsmaßnahmen sind erforderlich.
Begrenzte erweiterte Funktionen
Im Vergleich zu Lösungen wie Solr oder Elasticsearch fehlen indexed_search folgende Funktionen:
- Facettensuche (Filter)
- Erweiterte Relevanzanpassung
- Synonym-Verarbeitung
- Echtzeit-Indexierung
Abhängigkeit von der Indexierungsmethode
Standardmäßig werden Seiten indexiert, wenn sie im Frontend aufgerufen werden. Dies kann zu unvollständiger Indexierung führen, sofern ein Crawler oder Scheduler nicht korrekt eingerichtet ist.
Wann Indexed Search nicht verwenden
Vermeiden Sie die Verwendung von indexed_search, wenn:
- Ihre Website mehr als 2000 Seiten oder große Datensätze enthält
- Sie schnelle, unternehmensgerechte Suchleistung benötigen
- Sie erweiterte Suchfunktionen (Facetten, Filter, Ranking-Kontrolle) benötigen
- Ihr Projekt eine skalierbare oder zukunftssichere Architektur verlangt
In solchen Fällen sollten Sie Solr oder andere externe Suchlösungen in Betracht ziehen, um bessere Leistung und Flexibilität zu erzielen.
Wie installiere ich die indizierte Suche von TYPO3 (Schritt für Schritt)
Installation von EXT:indexed_search. EXT:indexed_search ist im TYPO3-Core enthalten, sodass in den meisten Fällen keine manuelle Installation erforderlich ist.
Für Composer-basierte TYPO3-Projekte
Wenn Ihr Projekt indexed_search nicht enthält, installieren Sie es über Composer:
composer require typo3/cms-indexed-search:^10.4Aktivierung von TYPO3 Indexed Search
Nach der Installation stellen Sie sicher, dass die Extension aktiviert ist:
Schritt 1: Gehen Sie zu Admin Tools → Extensions
Schritt 2: Suchen Sie nach „Indexed Search Engine“
Schritt 3: Aktivieren Sie die Extension
Tipp: Wenn die Installation über Composer erfolgt ist, ist die Extension in der Regel standardmäßig aktiviert. Eine erneute Aktivierung stellt sicher, dass Datenbankschema-Updates korrekt angewendet werden.
So konfigurieren Sie TYPO3 Indexed Search richtig
Einrichtung von EXT:indexed_search. Nach der Installation und Aktivierung von EXT:indexed_search folgen Sie diesen Schritten, um sicherzustellen, dass sie korrekt funktioniert und genaue Ergebnisse liefert.
Schritt 1: Erstellen Sie eine Suchseite
Schritt 1: Gehen Sie zu Web → Seite
Schritt 2: Erstellen Sie eine neue Seite (z. B. „Suche“) in Ihrem Seitenbaum
Schritt 3: Fügen Sie auf dieser Seite das Plugin „Indexed Search“ ein
Schritt 1: Gehen Sie zu Web → Template
Schritt 2: Wählen Sie Ihre Root-/Hauptseite aus
Schritt 3: Klicken Sie auf „Gesamten Template-Datensatz bearbeiten“
Schritt 4: Wechseln Sie zum Reiter „Includes“
Schritt 5: Fügen Sie „Indexed Search (indexed_search)“ hinzu
Sie sollten nun das Suchformular auf Ihrer Suchseite sehen.
Schritt 3: Indexierung und Cache aktivieren (kritisch)
Wenn die Suche keine Ergebnisse liefert, ist dies in der Regel die Ursache.
config.no_cache = 0
config {
index_enable = 1
index_externals = 1
index_metatags = 1
}
# Optional language setting
config.language = dk
Schritt 4: Root-Seite für die Indexierung konfigurieren
Schritt 1: Gehen Sie zu Web → Seite → Root-Seite
Schritt 2: Seiten-Eigenschaften bearbeiten
Schritt 3: Im Reiter „Verhalten“:
- „Als Root-Seite verwenden“ aktivieren
- „In Suche einbeziehen“ aktivieren
Schritt 5: Wie die Indexierung ausgelöst wird
Standardmäßig indexiert TYPO3 Indexed Search Seiten, wenn sie im Frontend aufgerufen werden.
- Seiten müssen mindestens einmal aufgerufen werden, um indexiert zu werden
- Neue oder versteckte Seiten erscheinen nicht automatisch in der Suche
- Für die vollständige Indexierung der Website wird ein Crawler oder Scheduler empfohlen
Schritt 6: Header/Footer von der Indexierung ausschließen (optional)
Um die Indexierung nur auf relevante Inhalte zu beschränken, definieren Sie Suchmarker:
page.10 {
stdWrap.dataWrap = <!--TYPO3SEARCH_begin-->|<!--TYPO3SEARCH_end-->
}Schritt 7: Suchvorlagen anpassen (optional)
Überschreiben Sie die Standardvorlagen, indem Sie benutzerdefinierte Pfade festlegen:
plugin.tx_indexedsearch.view {
templateRootPaths {
0 = EXT:indexed_search/Resources/Private/Templates/
10 = {$plugin.tx_indexedsearch.view.templateRootPath}
20 = EXT:yourextension/Resources/Private/Templates/
}
partialRootPaths {
0 = EXT:indexed_search/Resources/Private/Partials/
10 = {$plugin.tx_indexedsearch.view.partialRootPath}
20 = EXT:yourextension/Resources/Private/Partials/
}
}Um die Benutzeroberfläche anzupassen, bearbeiten Sie:
- Formular:
/Partials/Form.html - Suchtemplate:
/Templates/Search/Search.html - Ergebnisse:
/Partials/Searchresult.html
Schritt 8: Indexierungskonfigurations-Datensatz hinzufügen
Schritt 1: Gehen Sie zu Web → Liste → Root-Seite
Schritt 2: Erstellen Sie einen neuen „Indexing Configuration“-Datensatz
Schritt 3: Konfigurieren Sie ihn basierend auf Ihrer Inhaltsstruktur
Schritt 9: Erweiterte TypoScript-Konfiguration
Feinabstimmung des Suchverhaltens mit:
// TypoScript Setup
plugin.tx_indexedsearch.settings {
// This configuration is used to wrap a single page title in a search result item breadcrumb.
breadcrumbWrap = / || /
// Explicitly display search hits although the visitor has no access to it.
displayForbiddenRecords = 1
// Display the numbers of search results.
displayResultNumber = 0
// Display the link to the advanced search page.
displayAdvancedSearchLink = 1
// List of amount of results to be displayed per page. Sending a different amount via GET or POST will result in the default value being used to prevent DOS attacks.
blind.numberOfResults = 10,25,50,100
// A list of integers which should be root-pages to search from. Thus you can search multiple branches of the page tree by setting this property to a list of page id numbers.
rootPidList =
// Restrict the file type list when searching for files.
mediaList = pdf
// Set the target page UID for the extbase variant of the plugin.
targetPid =
// Determines the length of the cropped title Defaults to 50
results.titleCropAfter = 50
// Determines the length of the cropped summary Defaults to 180
results.summaryCropAfter = 180
// Determines the length of cropped links in the summary Defaults to 60
results.hrefInSummaryCropAfter = 60
// Excludes doktypes in path. Defaults to “”, Example: pathExcludeDoktypes = 254 Exclude sys_folder (doktype: 254) in path for result.
results.pathExcludeDoktypes =
}Schnelle Checkliste, falls die Suche keine Ergebnisse liefert
- Cache ist aktiviert
config.no_cache = 0 - Indexierung ist aktiviert
index_enable = 1 - Seite ist als „In Suche einbeziehen“ markiert
- Seite wurde mindestens einmal aufgerufen
- Keine Zugriffsbeschränkungen verhindern die Indexierung
Sobald die Konfiguration abgeschlossen ist, beginnt TYPO3 Indexed Search damit, Ihre Seiten zu indexieren und Ergebnisse anzuzeigen. Für größere Websites empfiehlt es sich, einen Crawler zu verwenden, um die Indexierung effizient zu automatisieren.
TYPO3 Indexed Search Features erklärt
Bevor Sie die Extension konfigurieren, ist es wichtig zu verstehen, was indexed_search bietet.
Hauptfunktionen
- Relevanz-Ranking auf Inhaltsbasis
Suchergebnisse werden priorisiert basierend auf:- Seitentitel
- Meta-Keywords
- Meta-Beschreibung
- Seiteninhalt
- Dateiindexierung
Kann externe Dateien indexieren, z. B.:- HTML, TXT
- PDF (über pdftotext)
- DOC (über catdoc)
- Flexible Suchtypen
Unterstützt:- Exakte Übereinstimmung
- Teilübereinstimmung
- Phonetische Suche (Metaphone)
- Ranking basierend auf Wortfrequenz
Ergebnisse werden danach sortiert, wie häufig Suchbegriffe im Inhalt erscheinen. - Groß-/Kleinschreibung-unabhängige Suche
Sorgt für konsistente Ergebnisse unabhängig von der Schreibweise. - Satzebene-Scanning
Ermöglicht Treffer innerhalb des Inhalts, selbst wenn dieser nicht explizit als strukturierte Daten indexiert ist.
Im nächsten Abschnitt konfigurieren wir TYPO3 EXT:indexed_search Schritt für Schritt, um eine korrekte Indexierung und genaue Suchergebnisse sicherzustellen.
TYPO3 Indexed Search funktioniert nicht? (Häufige Probleme beheben)
Wenn TYPO3 EXT:indexed_search keine Ergebnisse liefert oder sich fehlerhaft verhält, hängt das Problem meist mit der Indexierung, Konfiguration oder den Cache-Einstellungen zusammen. Verwenden Sie diese Checkliste, um das Problem schnell zu identifizieren und zu beheben.
1. Keine Suchergebnisse angezeigt
Mögliche Ursachen:
- Seiten sind noch nicht indexiert
- Cache ist deaktiviert
- Indexierung ist nicht aktiviert
Lösung:
config.no_cache = 0
config {
index_enable = 1
}Stellen Sie außerdem sicher:
- Die Seite ist als „In Suche einbeziehen“ markiert
- Die Seite wurde mindestens einmal im Frontend aufgerufen
2. Seiten werden nicht indexiert
Mögliche Ursachen:
- Seiten wurden im Frontend nicht aufgerufen
- Indexierung ist deaktiviert
- Crawler ist nicht konfiguriert
Lösung:
- Seiten manuell im Frontend öffnen, um die Indexierung auszulösen
- Oder einen Crawler/Scheduler verwenden, um die gesamte Website zu indexieren
3. Suche liefert unvollständige Ergebnisse
Mögliche Ursachen:
- Nur ein Teil des Inhalts wurde indexiert
- Externe Dateien nicht konfiguriert
- Marker begrenzen den indexierten Inhalt
Lösung:
config {
index_externals = 1
index_metatags = 1
}Überprüfen Sie außerdem:
- TYPO3 SEARCH-Marker schließen keine wichtigen Inhalte aus
- Dateiindexierungs-Tools (PDF, DOC) sind korrekt konfiguriert
4. Langsame Suchleistung
Mögliche Ursachen:
- Große Anzahl indexierter Seiten
- Vollwortsuche aktiviert
- Datenbankintensive Abfragen
Lösung:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.type = 0Zusätzliche Maßnahmen:
- Umfang des indexierten Inhalts einschränken
- Crawler anstelle der Frontend-Indexierung verwenden
- Für große Websites Solr in Betracht ziehen
5. Doppelte Suchergebnisse
Mögliche Ursachen:
- Mehrere indexierte Versionen derselben Seite
- URL-Variationen (Parameter, cHash)
Lösung:
plugin.tx_indexedsearch.settings.exactCount = 16. Suche funktioniert, aber Ergebnisse sind irrelevant
Mögliche Ursachen:
- Schlechte Inhaltsstruktur
- Fehlende Meta-Daten
- Schwache Keyword-Signale
Lösung:
- Seitentitel und Meta-Beschreibungen verbessern
- Klare Überschriften und strukturierte Inhalte verwenden
- Sicherstellen, dass relevante Keywords im Inhalt vorhanden sind
7. Backend-Indexierungsdaten nicht sichtbar
Mögliche Ursachen:
- Fehlende Zugriffsrechte
- Falsche Modulnutzung
Lösung:
- Web → Indexing-Modul prüfen
- Sicherstellen, dass der Backend-Benutzer über die entsprechenden Zugriffsrechte verfügt
8. Suche funktioniert nicht für eingeschränkte Seiten
Mögliche Ursachen:
- Zugriffsbeschränkungen blockieren die Indexierung
Lösung:
plugin.tx_indexedsearch.settings.displayForbiddenRecords = 1Schnelle Debug-Checkliste
- Cache aktiviert
- Indexierung aktiviert
- Seiten aufgerufen oder Crawler konfiguriert
- Seiten in Suche einbezogen
- Keine Zugriffsbeschränkungen verhindern die Indexierung
- TypoScript korrekt angewendet
Wenn Probleme auf größeren Websites weiterhin bestehen, kann dies auf die Einschränkungen von indexed_search hinweisen. In solchen Fällen sollte eine skalierbarere Lösung wie Solr in Betracht gezogen werden.
Wie TYPO3 Indexed Search funktioniert (Technischer Überblick)
Um zu verstehen, wie TYPO3 indexed_search funktioniert, ist es wichtig, zwei zentrale Prozesse zu betrachten: Indexierung und Suche.
1. Indexierung: Wie TYPO3 Inhalte speichert
Indexierung ist der Prozess des Sammelns und Speicherns von Inhalten Ihrer TYPO3-Website in einer durchsuchbaren Datenbank.
- Wenn eine Seite im Frontend aufgerufen wird, scannt TYPO3 automatisch deren Inhalt
- Es extrahiert Wörter aus:
- Seitentitel
- Meta-Tags
- Body-Inhalt (oder definierte Bereiche mithilfe von Markern)
- Jedes Wort wird analysiert, gezählt und zusammen mit seiner Position und Häufigkeit gespeichert
Diese Daten werden anschließend in TYPO3-Datenbanktabellen gespeichert und erstellen einen strukturierten Index, der effizient durchsucht werden kann.
Wichtig:
Standardmäßig erfolgt die Indexierung beim Seitenaufruf. Wenn eine Seite nie geöffnet wird, wird sie nicht indexiert, sofern kein Crawler verwendet wird.
2. Suche: Wie Ergebnisse abgerufen werden
Wenn ein Benutzer eine Suche durchführt:
- TYPO3 prüft die indexierte Wortdatenbank
- Es findet passende Einträge für die Suchanfrage
- Es ruft alle Seiten ab, die mit diesen Wörtern verknüpft sind
- Ergebnisse werden bewertet basierend auf:
- Häufigkeit des Keywords
- Position des Keywords (Titel > Meta > Body)
- Relevanzbewertung
Das System zeigt die Ergebnisse anschließend in der Reihenfolge ihrer Relevanz an.
3. Ranking-Logik (Wie Ergebnisse priorisiert werden)
TYPO3 indexed_search verwendet ein grundlegendes Relevanzmodell:
- Eine höhere Gewichtung erhalten Keywords in:
- Seitentiteln
- Meta-Beschreibungen
- Eine niedrigere Gewichtung gilt für Body-Inhalte
- Worthäufigkeit erhöht das Ranking
- Exakte Übereinstimmungen werden gegenüber teilweisen Übereinstimmungen priorisiert
Dies stellt sicher, dass relevantere Seiten weiter oben in den Suchergebnissen erscheinen.
4. Indexierungs-Workflow
Der typische Workflow sieht folgendermaßen aus:
- Eine Seite wird im Frontend besucht
- TYPO3 extrahiert und verarbeitet Inhalte
- Wörter werden in der Index-Datenbank gespeichert
- Ein Benutzer führt eine Suche durch
- TYPO3 fragt den Index ab
- Ergebnisse werden bewertet und angezeigt
5. Manuelle vs. automatisierte Indexierung
Es gibt zwei Arten, wie Indexierung erfolgt:
- Frontend-basierte Indexierung (Standard)
Seiten werden indexiert, wenn Benutzer oder Administratoren sie besuchen - Crawler-basierte Indexierung (empfohlen für größere Websites)
Ein Crawler besucht systematisch alle Seiten und erstellt den Index automatisch
6. Zentrale Einschränkungen im Workflow
- Indexierung hängt vom Seitenzugriff ab, sofern sie nicht automatisiert ist
- Große Datenmengen erhöhen die Datenbanklast
- Keine erweiterte Ranking-Logik im Vergleich zu Solr/Elasticsearch
Praktische Erkenntnis
TYPO3 indexed_search ist effektiv für kleinere Websites, bei denen eine einfache keywordbasierte Suche ausreicht. Bei größeren oder komplexeren Projekten werden die Einschränkungen bei Indexierung und Ranking deutlicher, wodurch fortgeschrittene Suchlösungen besser geeignet sind.
So überwachen Sie Indexierung & Suche im TYPO3-Backend
TYPO3 bietet integrierte Tools, mit denen sich der Indexierungsstatus und die Suchaktivitäten direkt über das Backend überwachen lassen.
Zugriff auf das Indexierungsmodul
- TYPO3 v10+: Web → Indexing
- TYPO3 v9 und darunter: Web → Info
Verfügbare zentrale Berichte
- Allgemeine Statistiken
Übersicht über indizierte Daten, Datenbankeinträge und die meistgesuchten Suchbegriffe
- Seitenübersicht (Liste: Seiten)
Zeigt indizierte Seiten mit Details wie Titel, Dateigröße, Wortanzahl und Zeitpunkt der letzten Indizierung an
- Detaillierte Statistiken
Vollständige Aufschlüsselung der indexierten Wörter und Inhalte pro Seite
Seiten neu indexieren
- Einen Seiteneintrag aus dem Indexierungsmodul löschen
- Die Seite erneut im Frontend aufrufen → sie wird automatisch erneut indexiert
Indexierung für bestimmte Seiten deaktivieren
- Einzelne Seite:
page.config.index_enable = 0Frontend-Integration: TYPO3-Plugins für die indexierte Suche
Sie können TYPO3 indexed_search mithilfe der folgenden Ansätze in Ihr Frontend integrieren:
1. Natives Plugin (EXT:indexed_search)
- Standard-TYPO3-Plugin
- Stellt Suchformular + Ergebnisseite bereit
- Unterstützt einfache und erweiterte Suche
2. EXT:macina_searchbox
- Fügt eine schlanke Suchbox hinzu
- Übergibt Suchanfragen an indexed_search
- Einfache Fluid-basierte Anpassung
3. EXT:indexed_search_autocomplete
- Fügt Autocomplete-Funktionalität hinzu
- Verbessert die Benutzererfahrung
- Funktioniert auf Basis von indexed_search
Indexierung mit TYPO3 Crawler automatisieren
Für größere Websites ist die manuelle Indexierung (über Seitenaufrufe) nicht ausreichend. TYPO3 Crawler automatisiert die Indexierung auf der gesamten Website.
Installation
composer req aoepeople/crawler// Create queue
$ vendor/bin/typo3 crawler:buildQueue <page-id> <configurationKey1,configurationKey2,...> [--depth <depth>] [--number <number>] [--mode <exec|queue|url>]
// Run queue
$ vendor/bin/typo3 crawler:processQueue [--amount <pages to crawl>] [--sleeptime <milliseconds>] [--sleepafter <seconds>]
// Flush queue
# replace vendor/bin/typo3 with your own cli runner
$ vendor/bin/typo3 crawler:flushQueue <pending|finished|all> [--page <id of top page>]* * * * * [pathToYourTYPO3Installation-composer-bin-dir]/typo3cms crawler:buildQueue <startpage> <configurationKeys> > /dev/nullScheduler-Integration
- Gehen Sie zu System → Scheduler
- Aufgabe hinzufügen: Konsolenbefehle ausführen
- Crawler-Befehle auswählen
![[Translate to German:] add TYPO3 scheduler](/blog/fileadmin/user_upload/TYPO3_Scheduler.jpg "[Translate to German:] add TYPO3 scheduler")
// sites/yoursite/config.yaml
routeEnhancers:
IndexedSearchPlugin:
type: Extbase
extension: IndexedSearch
plugin: Pi2
routes:
-
routePath: /req
_controller: 'Search::search'
_arguments:
page: '@widget_0/currentPage'
defaultController: 'Search::search'Externe Dateindexierung
Erforderliche Binärdateien installieren:
- pdftotext (PDF)
- catdoc (DOC)
- xlhtml, ppthtml, unrtf, unzip
Pfade konfigurieren unter:
Admin-Tools → Einstellungen → indexed_search
plugin.tx_indexedsearch._DEFAULT_PI_VARS.results = 5plugin.tx_indexedsearch.settings.exactCount = 1// ext_tables.php
$GLOBALS['TBE_MODULES']['_configuration']['web_IndexedSearchIsearch']['access'] = 'group,user';Indexierung bei Seitenaufrufen deaktivieren
- Admin Tools → Settings → indexed_search
- Deaktivieren: Seiten im Frontend indexieren
Leistungsoptimierung für TYPO3 Indexed Search
Verwenden Sie die Vollwortsuche für schnellere Ergebnisse:
plugin.tx_indexedsearch._DEFAULT_PI_VARS.type = 0- Umfang der indexierten Inhalte begrenzen
- Crawler statt Frontend-Indexierung verwenden
- Vermeiden Sie die Indexierung unnötiger Seiten (z. B. Suchergebnisseite)
Für große Websites sollte ein Wechsel zu Solr für bessere Leistung in Betracht gezogen werden
Praktische Anwendungsfälle: Wann Indexed Search am Besten Funktioniert
- Kleine Unternehmenswebsites (≤500 Seiten)
- Dokumentations- oder inhaltsgetriebene Websites
- Projekte, die eine schnelle Einrichtung mit minimalem Wartungsaufwand benötigen
Nicht geeignet für:
- Große Unternehmensportale
- E-Commerce mit komplexen Filtern
- Anforderungen an Hochleistungs-Suche
Fazit: Sollten Sie TYPO3 Indexed Search verwenden?
TYPO3 indexed_search ist eine zuverlässige Lösung für kleine bis mittlere Websites, die eine einfache, integrierte Suchfunktion benötigen.
- Verwenden Sie es für schnelle Implementierung und geringen Wartungsaufwand
- Vermeiden Sie es für groß angelegte oder leistungskritische Projekte
Wenn Ihr Projekt an Größe oder Komplexität zunimmt, bietet ein Upgrade auf Solr oder eine andere fortgeschrittene Suchlösung bessere Skalierbarkeit und Kontrolle.
FAQs
TYPO3 indexed_search ist eine integrierte TYPO3-Extension, die eine Volltextsuche über Webseiteninhalte und indexierte Inhalte ermöglicht, ohne dass externe Tools erforderlich sind.
Gehen Sie zu Admin Tools → Extensions, suchen Sie nach „Indexed Search Engine“ und aktivieren Sie sie. Stellen Sie sicher, dass die Indexierung in TypoScript aktiviert ist.
Dies tritt normalerweise auf, wenn Seiten nicht indexiert sind. Stellen Sie sicher, dass der Cache aktiviert ist, die Indexierung aktiv ist und die Seiten besucht oder über einen Crawler indexiert wurden.
Es indexiert Seiteninhalte in einer Datenbank und ruft Ergebnisse basierend auf Keyword-Relevanz, Häufigkeit und Position innerhalb des Inhalts ab.
Ja, es kann Dateien wie PDFs und DOCs indexieren, erfordert jedoch Server-Tools wie pdftotext und catdoc zur Inhaltsextraktion.
Nein, es ist am besten für kleine bis mittlere Websites geeignet. Für groß angelegte Projekte werden Lösungen wie Solr empfohlen.
Verwenden Sie die Vollwortsuche, begrenzen Sie die indexierten Inhalte, aktivieren Sie Caching und verwenden Sie einen Crawler anstelle der Frontend-basierten Indexierung.
Löschen Sie den indexierten Eintrag im Backend und rufen Sie die Seite erneut auf, oder verwenden Sie einen Crawler, um alle Seiten automatisch neu zu indexieren.
Bearbeiten Sie die Seiteneigenschaften und deaktivieren Sie die Option „In Suche einbeziehen“.
indexed_search ist eine grundlegende integrierte Lösung, während Solr eine fortschrittliche externe Suchmaschine ist, die bessere Leistung, Skalierbarkeit und Funktionen wie Faceting bietet.
claim lawyers