Lernseite · Extensions, Suche und Schnittstellen
Extensions, Suche und Schnittstellen beraten
Kein Projekt kommt mit dem reinen TYPO3-Core aus. Als Beraterin oder Berater musst du wissen, was TYPO3 von Haus aus kann, wo seine Grenzen liegen und welche Extensions sich bewährt haben. Auf dieser Seite begleitest du ein Kundenprojekt von der Wunschliste bis zur Empfehlung: Extensions auswählen, News und geschützte Bereiche planen, die passende Suche finden und andere Systeme anbinden.
Das Beispiel ist die Ferienregion Seetal. Sie möchte ihre Website neu aufbauen. Im Workshop kommt diese Wunschliste zusammen:
- Die Redaktion will Neuigkeiten und Veranstaltungen veröffentlichen.
- Gastgeber sollen sich in einem eigenen Bereich anmelden und dort Preislisten als PDF herunterladen.
- Besucher sollen über zwei Websites hinweg suchen können, auch in PDF-Broschüren, mit Filtern nach Ort und Kategorie.
- Das Buchungssystem und das Newsletter-Werkzeug sollen mit TYPO3 Daten austauschen.
Für jeden Punkt stellst du dieselbe Frage: Kann der Core das, gibt es eine bewährte Extension, oder braucht es eine Eigenentwicklung?
Was eine Extension ist und wo der Core endet
Eine Extension ist ein Softwarepaket, das den Funktionsumfang von TYPO3 erweitert. Sie kann Inhaltselemente, Plugins, Backend-Module, neue Datensatztypen oder Schnittstellen mitbringen. Technisch ist jede Extension ein Composer-Paket. Auch der Core selbst besteht aus Extensions, den System-Extensions. Und das Site Package mit Templates und Design des Projekts ist ebenfalls eine Extension.
Man unterscheidet drei Gruppen:
- System-Extensions gehören zum Core. Das Core-Team entwickelt sie und veröffentlicht sie zusammen mit jeder TYPO3-Version.
- Drittanbieter-Extensions kommen von Agenturen und Entwicklern aus der Community, etwa die News-Extension.
- Projekt-Extensions baut man nur für ein Projekt, allen voran das Site Package.
Wichtig ist der Unterschied zwischen Extension und Plugin. Ein Plugin ist in TYPO3 ein besonderes Inhaltselement mit dynamischer Funktion, zum Beispiel eine News-Liste oder ein Suchformular. Eine Extension kann mehrere Plugins liefern oder gar keins. Vorsicht bei Kunden, die WordPress kennen: Dort heißt „Plugin“, was in TYPO3 eine Extension ist.
Wer die Grenzen des Core kennt, kann Aufwände früh und realistisch schätzen. Der Core bringt schon viel mit: Seiten und Inhaltselemente, Mehrsprachigkeit, ein Formular-Framework, SEO-Felder, Weiterleitungen, Workspaces für Freigaben, Frontend-Login, eine einfache Suche und den Scheduler für geplante Aufgaben.
Der Core bringt aber kein News- oder Veranstaltungsmodul mit. Er enthält auch keinen Onlineshop mit Warenkorb und Zahlungsabwicklung, keinen Newsletter-Versand und keine Suche mit Filtern. Dafür braucht es Extensions oder externe Systeme.
Einen guten Einstieg in die Auswahl bietet das Getting-Started-Tutorial von TYPO3. Unter Recommended Extensions listet es häufig eingesetzte Extensions für typische Anforderungen, etwa News, Content Blocks, Container oder die Solr-Suche. Pflicht ist keine davon, und die eigene Prüfung im Projekt ersetzt die Liste nicht.
Extensions finden und bewerten
Fast alle öffentlich verfügbaren Extensions liegen im TYPO3 Extension Repository, kurz TER, unter extensions.typo3.org. Die Detailseite einer Extension zeigt die Beschreibung, alle Versionen mit den unterstützten TYPO3-Versionen, den Composer-Paketnamen und Links zu Dokumentation und Code-Repository. Die Download-Pakete im TER sind für Installationen ohne Composer gedacht.
In einer Composer-Installation holt man Extensions von Packagist unter packagist.org. Dort sind die meisten TYPO3-Extensions ebenfalls registriert. Installiert wird mit dem Befehl composer require und dem Paketnamen. Ein Paketname hat immer die Form Hersteller, Schrägstrich, Paket, zum Beispiel georgringer/news oder typo3/cms-seo. Verwechsle ihn nicht mit anderen Schreibweisen: EXT:news ist die Kurzform des Extension-Schlüssels in TYPO3-Pfaden, und tx_news_domain_model_news ist ein Tabellenname. Archive hochladen kann man nur im Classic Mode über den Extension Manager.
Bevor du eine Extension empfiehlst, prüfst du ihre Qualität. Diese Angaben helfen dabei:
- Unterstützt sie die TYPO3-Version des Projekts, also TYPO3 14?
- Wann gab es die letzte Veröffentlichung, und wie sieht die Versionshistorie aus?
- Gibt es eine Dokumentation und ein öffentliches Repository mit gepflegten Issues?
- Wie verbreitet ist sie, und wie fallen Rückmeldungen der Community aus?
- Gab es Sicherheitsmeldungen, und wer pflegt sie: eine aktive Agentur, ein Team oder eine Einzelperson?
Die Optik der Beschreibung oder die Farbe des Icons sagen über die Qualität nichts.
Warum ist das so wichtig? Extensions stammen von vielen Autoren mit unterschiedlicher Qualität. Laut TYPO3-Dokumentation liegen die meisten bekannten Sicherheitslücken in Extensions und nicht im Core. Und eine Extension, die die nächste TYPO3-Version nicht unterstützt, kann ein Upgrade blockieren.
Die System-Extensions
Einige System-Extensions braucht jede Installation zwingend: core, backend, frontend, extbase, fluid und install, dazu filelist und extensionmanager. Diese acht sind als geschützt markiert und lassen sich nicht deinstallieren. Daneben gibt es viele optionale, die man nach Bedarf installiert. Ein Berater sollte die wichtigsten erklären können:
- form liefert den Formular-Editor, seo die Metadaten und Sitemaps, redirects die Weiterleitungen.
- workspaces bildet Freigabeprozesse ab, scheduler führt geplante Aufgaben aus.
- felogin bringt das Login für Website-Besucher, indexed_search die eingebaute Suche.
- webhooks und reactions verbinden TYPO3 mit anderen Systemen.
Neu in TYPO3 14 ist das Theme Camino, als Paket typo3/theme-camino mit dem Extension-Schlüssel theme_camino. Es ist das Standard-Theme für neue Sites der Version 14. In klassischen Neuinstallationen ist es von Anfang an aktiv, in Composer-Installationen fordert man das Paket eigens an. Das bekannte Bootstrap Package ist dagegen eine Drittanbieter-Extension.
Welche Vorteile haben System-Extensions? Sie durchlaufen denselben Review- und Testprozess wie der Core. Sie werden mit jeder Version getestet und über die ganze Laufzeit einer LTS-Version mit Sicherheitsupdates versorgt. Das macht Projekte stabiler und besser planbar. Updates brauchen sie trotzdem, und optionale System-Extensions kann man weglassen oder entfernen.
Beim Aufsetzen hilft der Composer Helper auf get.typo3.org. Dort wählst du die TYPO3-Version und die gewünschten System-Extensions. Heraus kommt der passende composer-require-Befehl.
News mit EXT:news
Für die Neuigkeiten der Seetal ist EXT:news von Georg Ringer die naheliegende Wahl. Sie ist eine der bekanntesten Drittanbieter-Extensions, ihr Paketname ist georgringer/news. Mit ihr erstellt und verwaltet man Nachrichten und gibt sie als Liste und Detailansicht aus. Newsletter verschickt sie nicht.
Ein News-Datensatz kann drei Arten haben:
- Eine normale News mit eigenem Text, Teaser, Bildern und Dateien.
- Eine News, die auf eine interne Seite in TYPO3 verweist.
- Eine News, die auf eine externe URL verweist, etwa eine Pressemeldung auf einer anderen Website.
News sind Datensätze, keine Seiten. Man legt sie in einem oder mehreren Ordnern im Seitenbaum ab, also Seiten vom Typ Ordner, auch Sysfolder genannt. Im Plugin wählt man diese Ordner als Datensatzsammlung, auf Englisch Startingpoint. So trennt man News nach Bereichen und steuert sie über Berechtigungen. Thematisch ordnet man News mit Kategorien aus dem Core, der Tabelle sys_category, und mit eigenen Tags. Plugins können nach Kategorien filtern.
Für die Ausgabe bietet EXT:news viele Ansichten: Liste, Detailansicht, Datumsmenü, Kategorie- und Tag-Listen, Suchformular und Suchergebnis. Einen Warenkorb oder eine Terminbuchung bietet es nicht. Das Aussehen passt man über Fluid-Templates im Site Package und über die Einstellungen im Plugin an.
Rund um EXT:news gibt es ergänzende Extensions. Für die Veranstaltungen der Seetal passt eventnews: Es ergänzt News-Datensätze um Felder wie Datum und Ort. Liste, Kategorien und Templates bleiben erhalten. Für eine große Veranstaltungsverwaltung mit Anmeldung gibt es eigenständige Extensions.
Geschlossene Benutzergruppen
Der Gastgeber-Bereich ist eine geschlossene Benutzergruppe: ein Bereich der Website, den nur angemeldete Besucher bestimmter Gruppen sehen dürfen. TYPO3 bildet das mit Bordmitteln ab:
- Frontend-Benutzer und Frontend-Benutzergruppen sind Datensätze in einem Ordner. Rechte bekommt immer die Gruppe, nie der einzelne Benutzer.
- Im Reiter Zugriff einer Seite oder eines Inhaltselements wählst du die Gruppen, die es sehen dürfen.
- Das Plugin Login-Formular kommt aus der System-Extension felogin. Es bringt Weiterleitungen nach Login und Logout und die Funktion „Passwort vergessen“ mit. Backend-Benutzer verwaltet dagegen die Extension beuser.
Zwei Gruppen gibt es immer. Bei Anmeldung verbergen zeigt ein Element nur Besuchern, die nicht angemeldet sind. Bei jeder Anmeldung anzeigen zeigt es allen angemeldeten Besuchern, egal in welcher Gruppe.
Jetzt kommt eine Falle, die viele Kunden nicht kennen: Dateien schützt das nicht. Eine PDF in fileadmin liegt in einem öffentlichen Verzeichnis. Der Webserver liefert sie direkt aus, ohne TYPO3 zu fragen. Wer die URL kennt, kann sie abrufen, auch wenn die Seite mit dem Link geschützt ist.
Für die Preislisten der Gastgeber gibt es zwei sinnvolle Wege:
- Eine Extension für geschützte Downloads aus dem TER. Sie liefert Dateien erst aus, wenn die Anmeldung geprüft ist.
- Ein nicht öffentlicher Speicher, etwa außerhalb des Webroots, dessen Dateien nur über TYPO3 ausgeliefert werden.
Komplizierte Dateinamen sind dagegen nur Verschleierung und kein Schutz.
Möchte ein Kunde, dass sich Partner mit ihrem Microsoft- oder Google-Konto anmelden, reicht felogin allein nicht. felogin kennt Benutzername und Passwort samt Wiederherstellung. Weitere Anmeldewege liefern Extensions für externe Login-Anbieter, etwa über OAuth 2 oder OpenID Connect. Sie nutzen die Authentifizierungs-API von TYPO3. Backend-Konten für externe Partner wären dagegen ein Sicherheitsrisiko.
Wozu eine Website-Suche?
Eine Suche auf der Website hilft Besuchern, Inhalte schneller zu finden. Je größer und vielfältiger eine Website ist, desto wichtiger wird sie. Mit der Sichtbarkeit bei Google und anderen externen Suchmaschinen hat sie nichts zu tun. Im TYPO3-Umfeld gibt es vier verbreitete Lösungen.
Indexed Search ist als System-Extension im Core enthalten. Sie indiziert Seiten im Frontend, während TYPO3 sie rendert. Dabei registriert sie die Wörter einer Seite, zählt und gewichtet sie und speichert sie in eigenen Datenbanktabellen. Einen externen Server braucht sie nicht. Für den Inhalt von PDF- und Word-Dateien ruft sie externe Programme auf dem Server auf, etwa pdftotext und catdoc. Fehlen diese Programme, werden nur Seiten indiziert.
ke_search ist eine Drittanbieter-Extension. Sie liest die Inhalte direkt aus der Datenbank, statt Seiten im Frontend abzugreifen. Ihren Index speichert sie in der TYPO3-Datenbank und nutzt die Volltextsuche von MySQL oder MariaDB, also die Abfrage mit MATCH und AGAINST. Sie bietet Filter, sogenannte Facetten, und Indexer für Seiten, News, Dateien und mehr. Einen eigenen Suchserver braucht sie nicht.
Apache Solr ist ein eigenständiger Suchserver auf Basis der Bibliothek Apache Lucene. Die Extension EXT:solr verbindet TYPO3 mit diesem Server. Ohne laufenden Solr-Server funktioniert sie nicht.
Elasticsearch ist ebenfalls ein eigener Suchserver auf Basis von Lucene. Es ist keine System-Extension, sondern wird über Drittanbieter-Extensions angebunden.
Die passende Suche empfehlen
Die Wahl hängt an wenigen Fragen: Wie groß ist die Website? Gibt es mehrere Sites oder externe Quellen? Braucht man Facetten, Synonyme und Autovervollständigung? Und was erlaubt das Hosting?
Warum ist Indexed Search bei sehr großen Websites mit vielen Zugriffen oft nicht die erste Wahl? Index und Suche laufen in der TYPO3-Datenbank. Bei großen Datenmengen belastet das die Datenbank, und Funktionen wie Synonyme oder eine feine Steuerung der Relevanz sind begrenzt. Für viele kleinere Sites reicht Indexed Search aber völlig aus.
Für die Seetal mit zwei Sites, PDF-Broschüren, Facetten nach Ort und Kategorie und Gastgebern aus dem Buchungssystem empfiehlst du Solr, am besten als gehosteten Dienst.
Apache Solr und EXT:solr
EXT:solr bringt viele fertige Funktionen für TYPO3 mit:
- Facetten zum Filtern der Treffer, etwa nach Ort oder Kategorie.
- Autovervollständigung und Suchvorschläge während der Eingabe.
- Rechtschreibvorschläge im Stil von „Meinten Sie …?“.
- Hervorhebung der Suchbegriffe, Synonyme, Stoppwörter und Mehrsprachigkeit.
- Zugriffsbeschränkungen nach Frontend-Benutzergruppen.
- Eine Index-Queue, die Änderungen aus dem Backend zeitnah in den Index übernimmt.
Eine automatische Übersetzung der Inhalte oder einen Newsletter-Versand bietet sie nicht.
Systemanforderungen: Solr ist eine Java-Anwendung. Der Server braucht also eine Java-Laufzeitumgebung, dazu genug Arbeitsspeicher und Plattenplatz für den Index. Oft läuft Solr als Docker-Container oder als Dienst beim Hoster. Jede Version von EXT:solr unterstützt nur bestimmte Solr-Versionen, die Versionen müssen zusammenpassen. Mit mehr Inhalten, mehr Sprachen und mehr Anfragen wächst der Index, und Speicher- und Rechenbedarf steigen. Bei hoher Last plant man Skalierung, etwa mit mehr Speicher oder Replikation.
Ob Solr passt, entscheidest du durch Abwägung: Datenmenge, Facetten, Mehrsprachigkeit und externe Quellen auf der einen Seite, Betriebsaufwand, Know-how und Kosten des Solr-Servers auf der anderen. Solr ist mächtig, aber nicht immer die beste Wahl. Bei kleinen Sites ist der Aufwand oft zu groß.
Schnittstellen: was eine API leistet
Eine API, ausgeschrieben Application Programming Interface, ist eine definierte Schnittstelle. Über sie kommunizieren Programme miteinander und tauschen Daten aus. Web-APIs arbeiten meist über HTTP, oft im REST-Stil mit JSON.
Die Anbindung über APIs hat klare Vorteile:
- Daten müssen nicht doppelt gepflegt werden, etwa Gastgeber im Buchungssystem und auf der Website.
- Man kann Funktionen anderer Dienste nutzen, etwa Zahlungen oder Kartendienste.
Sie bringt aber auch Risiken, die du offen ansprechen solltest:
- Die Website wird abhängig vom Anbieter. Fällt der Dienst aus, ändert er seine API oder seine Preise, ist die Website betroffen.
- Es braucht eine sichere Authentifizierung. Zugangsschlüssel und Geheimnisse gehören nicht in den Code und nicht an öffentliche Orte.
- Werden personenbezogene Daten übertragen, sind Datenschutz, Rechtsgrundlage und Auftragsverarbeitung zu klären.
- APIs sind nicht wartungsfrei. Langfristige Pflege gehört ins Budget, und verschlüsselt sind sie nicht von selbst.
Webhooks und Reactions
Für einfache Integrationen bringt TYPO3 zwei optionale System-Extensions mit. Beide verwaltest du im Modul Administration, Integrations, das nur Administratoren sehen.
Ein Webhook ist eine automatische HTTP-Nachricht, die ein System bei einem Ereignis an ein anderes schickt. Der Empfänger muss also nicht ständig nachfragen. Die Extension webhooks sendet solche Nachrichten von TYPO3 aus. Der Core bringt diese Auslöser mit:
- Eine Seite wurde angelegt oder geändert, auch veröffentlicht oder verborgen. Der Auslöser heißt Page Modification.
- Eine Datei wurde hinzugefügt, geändert oder entfernt.
- Eine Anmeldung ist fehlgeschlagen.
- Eine Prüfung der Multi-Faktor-Authentifizierung ist fehlgeschlagen.
Die Dokumentation nennt bei Page Modification auch gelöschte Seiten. Im Code von TYPO3 14.3 meldet der Auslöser aber nur Anlegen und Ändern. Ist die System-Extension redirects installiert, kommt ein Auslöser für aufgerufene Weiterleitungen hinzu. Normale Seitenaufrufe im Frontend oder Suchanfragen lösen dagegen keinen Webhook aus. Entwickler können aber eigene Auslöser aus PSR-14-Events ergänzen.
Wie weiß der Empfänger, dass eine Nachricht wirklich von TYPO3 kommt? Jeder Webhook hat einen geheimen Signatur-Schlüssel. TYPO3 berechnet daraus, aus der Kennung des Webhooks und dem Inhalt einen Hash nach dem Verfahren HMAC mit SHA-256. Diesen Hash schickt TYPO3 im Header Webhook-Signature mit. Der Empfänger rechnet mit demselben Schlüssel nach und vergleicht. So erkennt er gefälschte oder veränderte Nachrichten.
Eine Reaction ist die Gegenrichtung. Die Extension reactions verarbeitet eingehende Webhooks: Ein externes System schickt eine autorisierte POST-Anfrage an TYPO3, und TYPO3 führt eine Aktion aus. Mitgeliefert ist die Reaction Create database record. Sie legt einen Datensatz an und füllt ihn mit Daten aus der Anfrage, etwa eine News aus einem Pressesystem. Weitere Reaction-Typen können Entwickler ergänzen.
Jede Reaction hat eine eindeutige Kennung und ein Geheimnis, englisch Secret. Beides erzeugt das Backend beim Anlegen. Das Geheimnis wird nur einmal angezeigt. Gespeichert wird es wie ein Backend-Passwort nur als Hash, also nicht im Klartext. Wer es kennt, kann die Reaction auslösen und zum Beispiel Datensätze anlegen. Deshalb gehört es in einen sicheren Speicher des aufrufenden Systems.
Das Wichtigste in Kürze
- Eine Extension ist ein Softwarepaket, ein Plugin ein Inhaltselement mit dynamischer Funktion.
- Extensions findet man im TER, installiert sie in Composer-Projekten aber über Packagist mit composer require.
- Vor jeder Empfehlung prüfst du Kompatibilität, Pflege, Dokumentation und Sicherheit der Extension.
- Pflicht sind die System-Extensions core, backend, frontend, extbase, fluid und install, dazu filelist und extensionmanager. Formulare, SEO, Weiterleitungen und Workspaces gibt es optional im Core, Camino ist seit TYPO3 14 das Standard-Theme.
- EXT:news speichert News in Ordnern, die im Plugin als Datensatzsammlung gewählt sein müssen.
- Seitenschutz schützt keine Dateien in fileadmin.
- Indexed Search ist im Core, ke_search braucht MySQL oder MariaDB, Solr braucht einen eigenen Java-Server.
- Webhooks senden aus TYPO3 hinaus, Reactions nehmen Anfragen von außen an.
Begriffe
- Extension
- Softwarepaket, das TYPO3 um Funktionen erweitert.
- System-Extension
- Extension, die zum Core gehört und mit ihm ausgeliefert wird.
- TER
- TYPO3 Extension Repository, das öffentliche Verzeichnis der Extensions.
- Packagist
- Paketverzeichnis, aus dem Composer die Pakete lädt.
- Plugin
- Inhaltselement, das eine Funktion einer Extension auf eine Seite bringt.
- Datensatzsammlung
- Ordner, aus denen ein Plugin seine Datensätze holt, englisch Startingpoint.
- Geschlossene Benutzergruppe
- Frontend-Bereich nur für angemeldete Mitglieder bestimmter Gruppen.
- Facette
- Filter in einer Suche, etwa nach Ort oder Kategorie.
- Lucene
- Such- und Indexbibliothek, auf der Solr und Elasticsearch aufbauen.
- Index-Queue
- Warteschlange in EXT:solr, die Änderungen zeitnah in den Index bringt.
- Webhook
- Automatische HTTP-Nachricht von TYPO3 an ein anderes System bei einem Ereignis.
- Reaction
- Aktion in TYPO3, die eine autorisierte Anfrage von außen auslöst.
- HMAC
- Prüfsumme, die mit einem geheimen Schlüssel berechnet wird.