Skip to content

README.de.md

Latest commit

 

History

History
143 lines (94 loc) · 4.42 KB

README.de.md

File metadata and controls

143 lines (94 loc) · 4.42 KB
Raw

SuluExtendedAccountBundle

php workflow symfony workflow License: MIT GitHub Tag Supports Sulu 3.0 or later

🇬🇧 English | Deutsch

Ein Sulu-Bundle zur Erweiterung der Account-Entity um Firmendaten, Geschäftszeiten, gesetzliche Feiertage und Betriebsferien.

Hinweis: Dieses Bundle ersetzt das ehemalige manuxi/sulu-additional-account-data-bundle (SuluAdditionalAccountDataBundle).

Firmendaten

Öffnungszeiten

📋 Voraussetzungen

  • PHP 8.2 oder höher
  • Sulu CMS 3.0 oder höher
  • Symfony 6.2 / 7.0 oder höher
  • SuluAdminExtrasBundle (wird automatisch als Abhängigkeit installiert)

👩🏻‍🏭 Installation

Schritt 1: Paket installieren

composer require manuxi/sulu-extended-account-bundle

Falls Symfony Flex nicht verwendet wird, muss das Bundle in der config/bundles.php registriert werden:

return [
    //...
    Manuxi\SuluExtendedAccountBundle\SuluExtendedAccountBundle::class => ['all' => true],
];

Schritt 2: Routing konfigurieren

Folgendes in die config/routes/routes_admin.yaml eintragen:

SuluExtendedAccountBundle:
    resource: '@SuluExtendedAccountBundle/Resources/config/routes_admin.yaml'

Schritt 3: Datenbankschema aktualisieren

# Vorschau der benötigten SQL-Änderungen
php bin/console doctrine:schema:update --dump-sql

# Änderungen anwenden
php bin/console doctrine:schema:update --force

Wichtig: Es sollten nur die Schema-Änderungen dieses Bundles verarbeitet werden.

Schritt 4: Admin-Assets einrichten

Die Öffnungszeiten-Features (Geschäftszeiten, Feiertage, Betriebsferien) verwenden Content Types aus dem SuluAdminExtrasBundle. Die JavaScript-Komponenten müssen in den Admin-Assets registriert werden.

A) assets/admin/package.json aktualisieren

Die Abhängigkeit für das AdminExtrasBundle hinzufügen:

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

B) assets/admin/app.js aktualisieren

Das Bundle importieren:

import 'sulu-admin-extras-bundle';

C) Installieren & Bauen

cd assets/admin
npm install
npm run build

Detaillierte Anweisungen finden sich in der Installationsanleitung.

✨ Features

Firmendaten

  • Handelsregisternummer, Registergericht, Firmenbeschreibung und Slogan

Öffnungszeiten

  • Wöchentlicher Geschäftszeiten-Plan mit Zeitslots und Pausen
  • Gesetzliche Feiertage via Nager.Date API
  • Betriebsferien / Schließzeiten

Twig-Funktionen

Das Bundle stellt Twig-Funktionen für die Frontend-Ausgabe bereit:

Funktion Rückgabe Beschreibung
is_open_now(accountId) bool Ob der Account gerade geöffnet ist
get_business_hours(accountId) array Vollständiger Wochenplan
get_today_hours(accountId) array|null Heutige Öffnungszeiten
is_holiday(accountId) bool Ob heute ein Feiertag ist

Siehe Funktionen für Anwendungsbeispiele.

📖 Dokumentation

Detaillierte Dokumentation im docs/ Verzeichnis:

🧶 Konfiguration

Aktuell ist keine zusätzliche Konfiguration erforderlich.

👩‍🍳 Mitwirken

Issues und Pull Requests sind willkommen! Feedback zur Verbesserung des Bundles ist jederzeit erwünscht.

📝 Lizenz

Dieses Bundle wird unter der MIT-Lizenz veröffentlicht.

🎉 Credits

Erstellt und gewartet von manuxi.

Danke an das Sulu-Team für das tolle CMS und den fantastischen Support!