lindesbs/linklist-bundle

Contao 5 Linklist Extension with Categories and Health Check

v0.2.2 2025-11-30 09:49 UTC

Requires

• php: ^8.3
• contao/core-bundle: ^5.3
• league/csv: ^9.0
• symfony/http-client: ^7.3
• symfony/ux-icons: ^2.31

Requires (Dev)

• contao/easy-coding-standard: ^5.0
• phpunit/phpunit: ^10.0
• rector/rector: ^1.0
• symplify/easy-coding-standard: ^10.0

MIT

• Stefan Lindecke

README

Ein umfassendes Contao 5 Bundle zur Verwaltung von Linklisten mit Kategorien, Health-Check, OpenGraph-Import und vielen weiteren Features.

Features

• Linklisten-Verwaltung: Erstellen und verwalten Sie strukturierte Linklisten mit Kategorien
• Automatischer OpenGraph-Import: Titel, Beschreibung und Sprache werden automatisch von Webseiten abgerufen
• Health-Check: Automatische Überprüfung der Link-Verfügbarkeit
• Click-Tracking: Nachverfolgung von Link-Klicks
• RSS/Atom-Feeds: Automatische Generierung von Feeds für Linklisten
• Frontend-Module: Verschiedene Darstellungsformen (Baum, Akkordeon, Karten)
• SEO-Optimierung: Schema.org JSON-LD Markup und Suchmaschinen-Integration
• CSV-Import: Massenimport von Links via CSV-Datei
• Insert-Tags: Verwendung von Links in Artikeln via {{linklist::url::ID}} und {{linklist::html::ID}}

Installation

Via Composer

composer require lindesbs/linklist-bundle

Manuelle Installation

1. Kopieren Sie das Bundle in contao/bundles/lindesbs-linklist-bundle
2. Führen Sie composer install aus
3. Aktivieren Sie das Bundle im Contao Manager
4. Führen Sie die Datenbank-Migration aus

Verwendung

Backend

Nach der Installation finden Sie das Modul "Linklisten" im Contao Backend unter Inhalte.

1. Linkliste erstellen: Erstellen Sie eine neue Linkliste
2. Links hinzufügen: Fügen Sie Links zur Liste hinzu
   • Geben Sie eine URL ein - Titel, Beschreibung und Sprache werden automatisch abgerufen (falls leer)
   • Kategorien zuweisen
   • Weitere Optionen konfigurieren (Highlight, Rel-Attribute, etc.)
3. CSV-Import: Nutzen Sie den Import-Button für Massenimports

Frontend-Module

Erstellen Sie ein Frontend-Modul vom Typ "Linkliste" und wählen Sie:

• Darstellungsform: Baum, Akkordeon oder Karten
• Linkliste: Die zu verwendende Liste
• Weitere Optionen: Template, Live-Suche, Badges, etc.

Insert-Tags

Verwenden Sie in Artikeln:

{{linklist::url::123}}  // Gibt die URL des Links mit ID 123 aus
{{linklist::html::123}}  // Gibt den vollständigen HTML-Link aus

Health-Check

Führen Sie regelmäßig den Health-Check aus:

php vendor/bin/contao-console linklist:check-links

Oder richten Sie einen Cronjob ein:

0 2 * * * cd /path/to/contao && php vendor/bin/contao-console linklist:check-links

RSS-Feeds

RSS/Atom-Feeds sind automatisch verfügbar unter:

/share/links/{list_id}.xml

Konfiguration

Affiliate-Suffix

In den Linklisten-Einstellungen können Sie einen Affiliate-Suffix konfigurieren, der automatisch an alle URLs angehängt wird.

Rel-Attribute

Für jeden Link können Sie rel="nofollow" und rel="sponsored" aktivieren.

Tracking

Aktivieren Sie Click-Tracking in den Modul-Einstellungen. Links werden dann über /link/go/{id} umgeleitet.

Entwicklung

Code-Standards

Das Bundle verwendet:

• ECS (Easy Coding Standard): composer ecs / composer ecs:fix
• PHPUnit: composer phpunit
• Rector: composer rector / composer rector:dry

Anforderungen

• PHP 8.1+
• Contao 5.0+

Lizenz

MIT License

Autor

Stefan Lindecke - https://codeberg.org/lindesbs

Hinweis

Dieses Bundle wurde mit Unterstützung von cursor.com entwickelt. Dokumentation, Commits, Debugging und gelegentlich auch Code wurden mithilfe von Cursor erstellt.