README.de.md

SuluAdminExtrasBundle

Ein Bundle für Sulu CMS, das nützliche Tools wie Content Types (Formularfelder) und List Transformers (Visualisierungen) zur Admin-Oberfläche hinzufügt.

Dieses Bundle kombiniert und modernisiert Funktionen der ehemaligen SuluContentTypesBundle und SuluTweaksBundle für Sulu 3.0.

🇬🇧 Read English | Deutsch

---

📚 Funktionen & Dokumentation

Detaillierte Dokumentationen für jedes Feature befinden sich im docs/ Ordner:

Property Types (Formularfelder)

• Color Select - Farbauswahl mit visueller Vorschau (Liste: Type Color, s.u.)
• Number With Default - Zahl mit default_value-Unterstützung
• Slider Range - Schieberegler
• Star Rating - Auswahlfeld für Sternebewertung
• DateTime Start / End - Verlinkte Date-Time-Picker mit auto End-Zeit, Validierung von Öffnungszeiten und "Freie-Zeit-Finder"
• DateTime With Default - Date-Time-Picker mit default_value-Unterstützung
• Öffnungszeiten - Wochenplan mit Zeitfenstern, Pausen und Kopierfunktion
• Feiertage - Feiertags-Manager mit Nager.Date-API-Integration
• Ferien - Betriebsferien und Schließungszeiten mit Unterstützung wiederkehrender Daten
• Single Contact Autocomplete - Einzel-Kontakt-Select mit Autocomplete-Funktion

List Transformers (Listenansicht)

• Percent Bar - Prozentbalken
• Publish State - Anzeige Veröffentlichungsstatus in eigener Spalte (Standard wird ausgeblendet)
• Ghost Locale - Sprachstatus in eigener Spalte (Standard wird ausgeblendet)
• Type Color - Farbanzeige (Form: Color Select, s.o.)
• Star Rating - Sternebewertung
• Color Dot - Farbiger Kreis aus Hex-Wert zur schnellen visuellen Identifikation in Listen
• Status Switcher - Interaktiver Inline-Status-Umschalter mit Dropdown zum direkten Ändern des Entity-Status

Sonstiges

• Collapsible Sections - Aufklappbare Formular-Sektionen im Admin UI (hacky)
• AddNewToolbarAction - "Neu"-Button in Action-Toolbar eines Elements

---

🚀 Installation

Voraussetzung: Sulu CMS 3.0+

1. Installation über Composer

composer require manuxi/sulu-admin-extras-bundle

2. Bundle registrieren

Bundle in config/bundles.php hinzufügen:

return [
    Manuxi\SuluAdminExtrasBundle\SuluAdminExtrasBundle::class => ['all' => true],
];

3. Admin Assets einrichten

Damit die JavaScript-Komponenten im Sulu Admin geladen werden, müssen die Asset-Konfiguration des Projekts angepasst werden.

A) assets/admin/package.json anpassen Datei assets/admin/package.json im Projekt-Root öffnen. Folgende Abhängigkeit hinzufügen:

{
  "dependencies": {
    "sulu-admin-extras-bundle": "file:../../vendor/manuxi/sulu-admin-extras-bundle/src/Resources"
  }
}

B) assets/admin/app.js anpassen assets/admin/app.js (oder index.js) öffnen und das Bundle importieren:

import 'sulu-admin-extras-bundle';

C) Installieren & Bauen Folgende Befehle ausführen, um die Admin-Assets neu zu kompilieren:

cd assets/admin
npm install
npm run build

---

⚙️ Konfiguration

Die Standard-Konfigurationsdatei kann kopiert werden:

cp vendor/manuxi/sulu-admin-extras-bundle/src/Resources/config/default.yaml config/packages/sulu_admin_extras.yaml

Siehe docs für detaillierte Konfigurationsoptionen.