5.3.0 Happy 2025

Beschreibung:

Diese Version fügt eine neue walk-Methode zur BuildArray Klasse hinzu, um das Durchlaufen der Navigationsstruktur zu vereinfachen und die Flexibilität zu erhöhen. Zusätzlich wurde die README.md umfassend aktualisiert, um die neuen Features zu dokumentieren und Beispiele für die verschiedenen Anwendungsfälle zu geben.

Änderungen:

• Neue walk-Methode:
  • Die BuildArray Klasse wurde um eine walk(callable $callback) Methode erweitert, welche die rekursive Traversierung der Navigationsstruktur übernimmt. Die übergebene Callback-Funktion wird für jedes Element der Navigation ausgeführt und ermöglicht somit eine flexible Verarbeitung und Ausgabe der Navigationsdaten.
• README.md Aktualisierung:
  • Die Dokumentation wurde überarbeitet, um die walk-Methode, die getCategory-Methode und weitere Features ausführlich zu beschreiben.
  • Zusätzliche Beispiele wurden hinzugefügt, um die Verwendung der walk-Methode zu demonstrieren:
    • Erstellung einer verschachtelten HTML-Liste.
    • Logausgabe der Navigationsstruktur.
    • Zugriff auf benutzerdefinierte Daten.
  • Ein Vergleich zwischen der walk-Methode und einer eigenen rekursiven Iterationsfunktion wurde hinzugefügt, um die Vorteile der walk-Methode hervorzuheben.
  • Alle Code-Beispiele wurden um den use FriendsOfRedaxo\NavigationArray\BuildArray; Namespace-Import ergänzt, um die Beispiele direkt verwendbar zu machen.
  • Die Sektionen für die setCategoryFilterCallback() und setCustomDataCallback() Methoden wurden erweitert, um die Funktionsweise noch besser zu erklären.
  • Die Beschreibung und Dokumentation der getCategory Methode wurde ergänzt
  • Die Methoden toJson und den Konstruktor wurden ebenfalls besser beschrieben.
  • Eine klare Empfehlung wurde hinzugefügt, die walk-Methode als bevorzugte Iterationsmethode zu nutzen und eigene Iterationen weitestgehend zu vermeiden.

Vorteile:

• Die walk-Methode vereinfacht das Durchlaufen der Navigation und reduziert Code-Duplikation.
• Die walk-Methode ist flexibler, da sie individuelle Anpassungen für jedes Navigationselement über Callbacks ermöglicht.
• Die aktualisierte Dokumentation verbessert das Verständnis und die Nutzung der BuildArray Klasse.
• Der Vergleich der walk Methode mit eigener Iteration verdeutlicht den Mehrwert.
• Die Codebeispiele sind nun copy-and-paste freundlicher.

Checkliste:

• Code entspricht den Coding Standards.
• Die Dokumentation ist vollständig und verständlich.
• Die Änderungen sind rückwärtskompatibel.
• Alle Tests sind erfolgreich (falls vorhanden).
• Die Änderungen wurden lokal getestet.

What's Changed

• Neu: walk-Methode: by @skerbis in #41

Full Changelog: 5.2.0...5.3.0