Download the PHP package schachbulle/contao-backendmenue-bundle without Composer

On this page you can find all versions of the php package schachbulle/contao-backendmenue-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of schachbulle/contao-backendmenue-bundle

Informations about the package contao-backendmenue-bundle

Backend-Menü-Bundle für Contao 4.13 & 5.7

Erweiterung für Contao 4.13 und Contao 5.7 zur Verwaltung benutzerdefinierter Bereiche in der Backend-Menüspalte. Administratoren können neue Menübereiche mit eigenen Namen, Icons und Positionen anlegen sowie einzelne Backend-Module zwischen diesen Bereichen verschieben.

Features

✅ Benutzerdefinierte Menübereiche — Erstelle beliebig viele neue Bereiche im Backend-Menü
✅ Frei konfigurierbare Icons — Nutze Font Awesome 6 oder Contao-Standard-Icons
✅ Module umsortieren — Verschiebe Backend-Module aus Standardbereichen in neue Bereiche
✅ Sortierbarkeit — Definiere die Reihenfolge von Bereichen und Modulen
✅ Standardbereiche erhalten — Alle Standard-Menübereiche (System, Inhalte etc.) bleiben bestehen
✅ Kompatibilität — Läuft unter Contao 4.13 LTS und 5.7 LTS

Installation

Nach der Installation die Bundle-Registrierung aktualisieren:

Verwendung

Im Backend

  1. Öffne System → Eigenes Backend-Menü
  2. Klicke auf Neu
  3. Gib einen Namen für den Bereich ein (z.B. „Meine Tools")
  4. Wähle ein Icon (Font Awesome 6, Lucide oder Contao Standard)
  5. Definiere die Position im Backend-Menü: 1 = ganz oben, 2 = an zweiter Stelle usw.; größere Werte hängen den Bereich ans Ende
  6. Speichern

Wichtig: Ein Bereich erscheint erst dann im Backend-Menü, wenn ihm über „Module verwalten" mindestens ein Modul zugeordnet wurde — leere Gruppen blendet Contao grundsätzlich aus. Ein entsprechender Hinweis wird auch in der Bereichs-Übersicht angezeigt.

Module zuordnen

  1. Im Bereiche-Listing: Klick auf Module verwalten eines Bereichs
  2. Klick auf Neu
  3. Wähle ein Backend-Modul (die Auswahl ist nach den aktuellen Menübereichen gruppiert)
  4. Speichern

Das ausgewählte Modul wird nun aus seinem Standardbereich entfernt und unter dem neuen Bereich angezeigt.

Die Reihenfolge der Module innerhalb eines Bereichs wird in dieser Übersicht per Drag & Drop festgelegt — einfach am Anfasser ziehen. Die Reihenfolge schlägt sofort auf das Backend-Menü durch.

Programmgesteuerte Nutzung

Der BackendMenuManipulator-Service kann auch direkt genutzt werden:

Icons

Das Icon eines Bereichs wird links neben dem Bereichsnamen in der Backend-Navigation angezeigt. Unter Icon-Herkunft wählst du zwischen einer der mitgelieferten Sammlungen und einer eigenen Bilddatei.

Icon-Farbe

Das Feld Icon-Farbe ist optional; bleibt es leer, gilt die Standardfarbe des Backend-Themes. Bei Bilddateien wird die Farbe nicht einfach überlagert, sondern auf die Silhouette des Bildes angewendet (CSS-Maske) — ein einfarbiges SVG lässt sich damit beliebig umfärben.

Eigene Bilddatei

Erlaubt sind SVG, PNG und GIF aus der Dateiverwaltung. Am besten quadratisch und einfarbig, dargestellt wird sie in 16 × 16 Pixeln. Wird zusätzlich eine Icon-Farbe gesetzt, dient die Datei als Maske — deshalb sind nur Formate mit Alphakanal zugelassen.

Mitgelieferte Sammlungen

Drei Icon-Sätze stehen zur Auswahl:

Font Awesome 6 (mitgeliefert)

Lucide (mitgeliefert)

Contao Standard Icons

Alle Icon-Schriften werden per ::before-Regel mit eigenen font-family-Namen gerendert, sodass es keine Konflikte mit eventuell vorhandenen Icon-Schriften gibt. Geladen wird eine Schrift nur, wenn mindestens ein Bereich sie tatsächlich nutzt.

Beispiel-Icons

Icon Beschreibung
fa-chess Schach (FA6)
fa-gear Zahnrad (FA6)
lucide-crown Krone (Lucide)
lucide-swords Schwerter (Lucide)
settings.svg Einstellungen (Contao)
filemanager.svg Dateiverwaltung (Contao)

Datenbank-Tabellen

Das Bundle erzeugt automatisch zwei Tabellen:

tl_backendmenue_bereiche

Speichert benutzerdefinierte Menübereiche:

Spalte Typ Beschreibung
id int Primärschlüssel
name varchar(255) Name des Bereichs
iconType varchar(16) library (Sammlung) oder file (eigene Datei)
icon varchar(255) Icon-Name aus einer der Sammlungen
iconFile binary(16) UUID der eigenen Bilddatei
iconColor varchar(6) Hex-Farbe ohne Raute, leer = Theme-Standard
position int Position im Backend-Menü (1 = ganz oben)
tstamp int Änderungszeitstempel
sorting int Interne Sortierung

tl_backendmenue_zuordnungen

Verknüpft Backend-Module zu benutzerdefinierten Bereichen:

Spalte Typ Beschreibung
id int Primärschlüssel
pid int Foreign Key → tl_backendmenue_bereiche
module varchar(255) Name des Backend-Moduls
tstamp int Änderungszeitstempel
sorting int Reihenfolge im Bereich (per Drag & Drop gepflegt)

Architektur

Service: BackendMenuManipulator

Kern-Service, der die Menüstruktur zur Laufzeit manipuliert:

Methoden:

EventListener: BackendMenuListener

Symfony-Listener, der auf den Contao-Hook loadBackendModule reagiert:

DCA-Dateien

Entwicklung

Tests ausführen

Code-Style prüfen

PHP-Syntax prüfen

Kompatibilität

Contao Version Status Anmerkung
4.13 LTS ✅ Unterstützt Vollständig getestet
5.0–5.6 ⚠️ Wahrscheinlich Benötigt Tests
5.7 LTS ✅ Unterstützt Vollständig getestet

PHP-Versionen: 7.4, 8.0, 8.1, 8.2, 8.3

Bekannte Limitierungen

  1. Keine Verschachtelung — Menübereiche können nicht verschachtelt werden
  2. Keine Zuordnung von Custom-Modulen — Nur vordefinierte Module aus $GLOBALS['BE_MOD'] können zugeordnet werden
  3. Keine Benutzergruppen-Filterung — Die Menü-Anpassung gilt für alle Benutzer gleich

Lizenz

GNU Lesser General Public License (LGPL 3.0 oder später)

Support

Bugs und Feature-Requests: GitHub Issues

Autor: Samson Hoppe
E-Mail: [email protected]

All versions of contao-backendmenue-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
contao/core-bundle Version ^4.13 || ^5.0
contao/manager-plugin Version ^2.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package schachbulle/contao-backendmenue-bundle contains the following files

Loading the files please wait ...