PHPackages mandrael/contao-autolink - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. mandrael/contao-autolink ActiveContao-bundle[Utility & Helpers](/categories/utility) mandrael/contao-autolink ======================== Automatic, backend-managed keyword autolinking for Contao via the outputFrontendTemplate hook. 0.5.3(1mo ago)07LGPL-3.0-or-laterPHPPHP ^8.2CI passing Since Jun 20Pushed 1mo ago1 watchersCompare [ Source](https://github.com/mandrael/contao-autolink)[ Packagist](https://packagist.org/packages/mandrael/contao-autolink)[ Docs](https://github.com/mandrael/contao-autolink)[ RSS](/packages/mandrael-contao-autolink/feed)WikiDiscussions main Synced 1w ago READMEChangelog (4)Dependencies (9)Versions (5)Used By (0) [![Autolink-Logo](logo.svg)](logo.svg) **Deutsch** | [English](README.en.md) Autolink – Automatische Verlinkung für Contao ============================================= [](#autolink--automatische-verlinkung-für-contao) Autolink bietet eine Backend-Oberfläche, um Suchbegriffe zu definieren, die im Frontend automatisch verlinkt werden. Die Erweiterung durchsucht die gerenderte Seitenausgabe nach den konfigurierten Begriffen und erzeugt interne Links (auf eine Contao-Seite), externe Links (auf eine URL) oder ein einfaches, gestyltes ``. Die Suche lässt sich auf bestimmte Seiten beschränken. Dies ist die modernisierte Fassung: ein Composer-Bundle, das sich über den **Contao Manager** oder `composer require` installieren lässt – kein Kopieren von Ordnern nach `system/modules` mehr. - Kompatibilität: eine einzige Codebasis für die Contao-LTS-Versionen **4.13, 5.3 und 5.7**, **PHP 8.2+** - Service-basierter `outputFrontendTemplate`-Hook (`#[AsHook]`) - Datenbank: **InnoDB / utf8mb4**; Schema im DCA definiert (kein manueller `database.sql`-Import) und unverändert gegenüber der Legacy-Tabelle - **SVG**-Icon statt des alten GIF Installation ------------ [](#installation) ### Contao Manager [](#contao-manager) Im Contao Manager nach `mandrael/contao-autolink` suchen, hinzufügen und die Updates ausführen. Der Manager führt die Datenbank-Migration aus und installiert die Bundle-Assets automatisch. ### Composer [](#composer) ``` composer require mandrael/contao-autolink ``` Anschließend die Datenbank-Migration anwenden (`contao:migrate` / Contao Manager), damit die Tabelle `tl_autolink` angelegt wird, und die Bundle-Assets installieren (`contao:install` läuft bei Manager-Updates mit). Verwendung ---------- [](#verwendung) Im Backend **Inhalte → Autolink** öffnen, einen Eintrag anlegen, den Suchbegriff eingeben, die Link-Art (intern / extern / keine) und das Ziel wählen und veröffentlichen. Der Begriff wird dann im Frontend automatisch verlinkt. In der Übersicht lässt sich jeder Eintrag über das Sichtbarkeits-Auge direkt ein- und ausblenden; neue Einträge sind standardmäßig eingeblendet. Gesucht wird immer **wortgenau**: ein Begriff wird nur als vollständiges Wort bzw. vollständige Phrase verlinkt, nie innerhalb eines größeren Wortes (z. B. wird „Salzburg" nicht in „Salzburger" verlinkt). Überschneiden sich Begriffe (z. B. „Salzburg" und „Pfadfinderhaus Salzburg"), gewinnt die **längere Phrase**: sie wird als Ganzes verlinkt, der darin enthaltene kürzere Begriff wird nicht erneut verlinkt — unabhängig von der Sortier-Reihenfolge. Pro Eintrag konfigurierbar: Groß-/Kleinschreibung, reguläre Ausdrücke, ein CSS-Selektor zur Eingrenzung des Suchbereichs, eine Sprache (`lang`-Attribut), ein Tooltip (als natives `title`-Attribut gerendert), Seitenbeschränkung (inkl. Unterseiten), eine eigene CSS-ID/-Klasse, ein Popup-Link, Selbstverlinkung und ein Veröffentlichungs-Zeitfenster. Umstieg von der Legacy-Erweiterung ---------------------------------- [](#umstieg-von-der-legacy-erweiterung) Das Schema der Tabelle `tl_autolink` ist unverändert, bestehende Einträge funktionieren also weiter – einfach den alten Ordner `system/modules/autolink`entfernen und über Composer / Contao Manager installieren. **Hinweis:** Die alten MooTools-basierten Tooltips (`Tips`) gibt es in modernem Contao nicht mehr. Der Tooltip-Text wird jetzt als natives `title`-Attribut gerendert; bestehende Einträge zeigen ihren Text also weiterhin beim Überfahren an, nur ohne das MooTools-Styling. Screenshots ----------- [](#screenshots) Backend [![Backend](docs/images/autolink-backend.png)](docs/images/autolink-backend.png) Links anlegen [![Links anlegen](docs/images/autolink-link-creation.png)](docs/images/autolink-link-creation.png) Neues Icon [![Neues Icon](docs/images/autolink-new-icon.png)](docs/images/autolink-new-icon.png) Basierend auf Andreas Schempps Autolink – was hinzugekommen ist --------------------------------------------------------------- [](#basierend-auf-andreas-schempps-autolink--was-hinzugekommen-ist) Dieses Bundle setzt die ursprünglich von **[Andreas Schempp](https://github.com/aschempp/contao-autolink)** für TYPOlight / frühes Contao geschriebene **Autolink**-Erweiterung fort, die über Contao 3 weitergeführt und hier für aktuelles Contao modernisiert wurde. Das Original-Repo ist archiviert und läuft auf aktuellem Contao nicht mehr; es wird daher zur Attribution und Historie referenziert, nicht als Abhängigkeit eingebunden. Der Backend-Funktionsumfang und das `tl_autolink`-Schema sind **von Schempps Original geerbt**, das bereits umfangreich war: Suchbegriff → interner / externer / kein Link, wortgenaue Suche, Groß-/Kleinschreibung, reguläre Ausdrücke, CSS-Selektor-Eingrenzung, `lang`-Attribut, Tooltip, Seiten-/Unterseiten- Beschränkung, eigene CSS-ID/-Klasse, Popup-Links, Selbstverlinkung und Veröffentlichungs-Zeitfenster. Geändert haben sich Plattform, Unterbau und Verpackung – plus Laufzeit-Verbesserungen und eine bewusste Vereinfachung: **Plattform & Installation** - Läuft mit einer einzigen Codebasis auf den Contao-LTS-Versionen **4.13, 5.3 und 5.7**; ursprünglich TYPOlight / Contao 2–3. - Installiert als **Composer-Bundle über den Contao Manager** statt durch Kopieren eines Ordners nach `system/modules`. - **PHP 8.2+** (vorher PHP 5). **Architektur** - Die Frontend-Verlinkung ist ein service-basierter **`#[AsHook('outputFrontendTemplate')]`**-Listener statt eines klassischen globalen Hooks. - Das Backend-Sprach-Dropdown ist ein **`#[AsCallback]`** auf Basis des Service **`contao.intl.locales`** (das entfernte `System::getLanguages()` entfällt). - Datenbankzugriff über **Doctrine DBAL** statt des Legacy-`Database`-Singletons. - Das Schema wird aus den **DCA-`sql`-Keys** erzeugt (kein manuelles `database.sql`); das Schema selbst ist unverändert, bestehende Daten migrieren ohne Diff. **Performance & Robustheit** - **Große Seiten werden jetzt zuverlässig verlinkt:** Das Eingabe-Limit des Parsers wurde vom Standardwert (600 KB) auf 4 MB angehoben. Oberhalb des alten Limits wurde die Verlinkung für die gesamte Seite still übersprungen. - **Schneller bei vielen Begriffen pro Seite:** Begriffe, die auf einer Seite nicht vorkommen, werden vor dem rechenintensiven HTML-Parsing übersprungen (Unicode-fähiger `mb_stripos`-Vorfilter). Auf einer Beispielseite mit 60 konfigurierten, aber nicht vorkommenden Begriffen sank die Listener-Last von ~175 ms auf ~3 ms – relevant für Seiten mit vielen Einträgen (z. B. Kursseiten). **Daten & Assets** - Tabelle auf **InnoDB / utf8mb4** umgestellt (vorher MyISAM / utf8). - **SVG**-Icon statt des alten GIF. - **Französische** Übersetzung ergänzt (das Original lieferte nur Deutsch und Englisch). - Gebündelter HTML-Parser auf **simplehtmldom 1.9.1** angehoben – die letzte gepflegte 1.x-Version, die den von der Verlinkung genutzten `text`-Selektor korrigiert – byte-identisch zum Original-Release gehalten. **Verhalten** - Tooltips werden als natives **`title`-Attribut** gerendert; die alten MooTools-„Tips"-Assets (`tips.css`, `bubble.png`) entfallen. - **Der Teilstring-Modus wurde entfernt; gesucht wird immer wortgenau.** Der alte Teilstring-Modus überverlinkte (er traf z. B. „Salzburg" innerhalb von „Salzburger") und wird für phrasenbasierte Verlinkung nicht gebraucht. Regex-Einträge sind nicht betroffen (sie werden exakt wie geschrieben gematcht). **Schema-Hinweis:** Die nun ungenutzte Spalte `tl_autolink.words` wird entfernt – die einzige bewusste Schema-Änderung; der Rest der Tabelle bleibt unverändert. **Qualität** - Test-Suite + GitHub-Actions-CI und PHPStan-Analyse; verifiziert auf Contao 4.13, 5.3 und 5.7 (Backend-Modul, Migration, Frontend-Verlinkung). Credits ------- [](#credits) Ursprüngliche Idee und Matching-Logik: **[Andreas Schempp](https://github.com/aschempp/contao-autolink)**. Contao selbst ist © Leo Feyer. Das modernisierte Bundle wird von **[mandrael](https://github.com/mandrael)** (Michael Gasperl) gepflegt. Lizenz ------ [](#lizenz) GNU Lesser General Public License v3.0 oder später (`LGPL-3.0-or-later`) – siehe [LICENSE](LICENSE). Das entspricht der Lizenz des ursprünglichen Werks, von dem dieses Bundle abgeleitet ist. Der gebündelte HTML-Parser (`src/Resources/contrib/simple_html_dom.php`) steht unter der MIT-Lizenz – siehe [src/Resources/contrib/LICENSE](src/Resources/contrib/LICENSE). Der gebündelte HTML-Parser -------------------------- [](#der-gebündelte-html-parser) Das Frontend-Matching nutzt [simple\_html\_dom 1.9.1](https://sourceforge.net/projects/simplehtmldom/files/simplehtmldom/)(MIT), byte-identisch zum Original-Release gebündelt. Ein interessantes Detail, warum er einfach weiterläuft: Er bleibt von PHP 5.6 bis 8.4+ kompatibel, gerade weil er bewusst minimal ist – keine Typ-Deklarationen (nichts, was neuere PHP-Versionen als veraltet markieren könnten), magische Methoden `__get`/`__set` statt dynamischer Eigenschaften (er löst also nie die PHP-8.2-Abkündigung aus) und nur der stabile Kern der Sprache (Arrays, Strings, PCRE), ohne jedes von PHP entfernte Konstrukt. Dieselbe Zurückhaltung ist auch der Grund, warum er robust und nicht schnell ist. ### Health Score 38 — LowBetter than 83% of packages Maintenance93 Actively maintained with recent releases Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 4 Last Release 34d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1d32d1d3f59862d236215afa20d4d02efc3d9da6cfab5584f0619eb6022c1305?d=identicon)[mandrael](/maintainers/mandrael) --- Top Contributors [![mandrael](https://avatars.githubusercontent.com/u/5021908?v=4)](https://github.com/mandrael "mandrael (44 commits)") --- Tags contaokeywordsseoautolinklinks ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/mandrael-contao-autolink/health.svg) ``` [![Health](https://phpackages.com/badges/mandrael-contao-autolink/health.svg)](https://phpackages.com/packages/mandrael-contao-autolink) ``` ### Alternatives [contao-community-alliance/dc-general Universal data container for Contao 1680.8k92](/packages/contao-community-alliance-dc-general) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)