README

Ein schlankes Contao-Bundle zur zentralen Verwaltung von Links mit hierarchischen Kategorien. Links lassen sich im Backend kategorisiert pflegen und im Frontend über zwei verschiedene Frontend-Module ausgeben — einmal als flache Kategorienliste, einmal mit Unterkategorie-Struktur.

Anforderungen

Installation

composer require srhinow/simple-link-bundle

Nach der Installation die Datenbank-Migration ausführen:

php bin/console contao:migrate

Funktionsumfang

Backend

Das Bundle fügt unter der Gruppe „content" das Backend-Modul „Links" (do=links) hinzu. Es besteht aus zwei Verwaltungsbereichen, die über die globale Operation „Link Kategorien" verknüpft sind.

Link-Kategorien (tl_link_categories)

Kategorien sind hierarchisch aufgebaut (Baumstruktur via pid). Unterkategorien können beliebig tief verschachtelt werden. Die Sortierung erfolgt per Drag & Drop im Baum.

Verfügbare Aktionen: Bearbeiten · Kopieren · Kopieren mit Unterkategorien · Verschieben · Löschen · Anzeigen

Links (tl_links)

Jeder Link gehört genau einer Kategorie an und enthält eine URL sowie optionale Metadaten.

Die Listenansicht zeigt URL und Name als klickbaren Link. Über die Filter-Leiste kann nach Kategorie gefiltert werden.

Frontend-Module

Das Bundle registriert zwei Frontend-Module in der Gruppe „Einfache Links":

1. Link-Liste (link_list)

Zeigt alle Root-Kategorien (oberste Ebene) mit ihren direkt zugeordneten Links. Jede Kategorie wird als aufklappbarer Accordion-Bereich dargestellt.

Einstellungsfelder im Backend:

Haupttemplate: mod_link_list.html.twig

Verfügbare Template-Variablen in mod_link_list.html.twig:

Struktur eines categories-Eintrags:

2. Link-Liste mit Unterkategorien (sub_category_link_list)

Zeigt Root-Kategorien mit ihren Unterkategorien. Jede Unterkategorie erhält eine eigene Überschrift und Linkliste. Root-Kategorien ohne Unterkategorien werden übersprungen.

Gleiche Backend-Einstellungen wie link_list.

Haupttemplate: mod_link_list.html.twig (dasselbe Wrapper-Template)

Struktur eines categories-Eintrags (hier entries = array von gerenderten Unterkategorie-Blöcken als HTML-Strings):

Templates

mod_link_list.html.twig

Wrapper-Template für beide Module. Gibt Kategorien als Accordion aus:

{% for cat in categories %}
    <div class="toggler">
        <h2>...</h2>
    </div>
    <div class="accordion">
        {% for entry in cat.entries %}{{ entry|raw }}{% endfor %}
    </div>
{% endfor %}

link_default.html.twig

Standard-Item-Template für einen einzelnen Link (genutzt von link_list).

Verfügbare Variablen:

link_in_subcategory.html.twig

Template für eine Unterkategorie mit allen ihren Links (genutzt von sub_category_link_list).

Verfügbare Variablen:

Struktur eines entries-Eintrags:

Templates anpassen

Alle Templates liegen im Bundle unter contao/templates/. Für projektspezifische Anpassungen die gewünschte Datei in den Projekt-Templates-Ordner kopieren:

templates/
└── bz-niedersachsen/
    ├── mod_link_list.html.twig        # Wrapper beider Module
    ├── link_default.html.twig         # Einzelner Link (flache Liste)
    └── link_in_subcategory.html.twig  # Unterkategorie mit Links

Eigene Link-Item-Templates müssen mit dem Präfix link_ beginnen, damit sie im Backend-Dropdown erscheinen.

Datenbankstruktur

tl_link_categories

tl_links

Aufbau einer Kategorienhierarchie (Empfehlung)

Link-Kategorien (Backend)
├── Kategorie A  (pid=0, Root)
│   ├── Unterkategorie A1  (pid=A)
│   └── Unterkategorie A2  (pid=A)
└── Kategorie B  (pid=0, Root)
    └── Unterkategorie B1  (pid=B)

• Für link_list: Direkte Links unter Root-Kategorien anlegen.
• Für sub_category_link_list: Links unter Unterkategorien anlegen; Root-Kategorien dienen nur als Gruppenüberschrift.

Changelog

Siehe Changelog.md für die vollständige Versionshistorie.

Lizenz

GPL-3.0+

Autor

Sven Rhinow — sr-tag.de
Support: kservice@sr-tag.de
Quellcode: gitlab.com/srhinow/simple-link-bundle