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

5.2.0 🪲YCOM?

What's Changed

• Bugfix Release für YCOM-Rechte
• Neue Methode isPermitted() by @skerbis in #40

Full Changelog: 5.1.0...5.2.0

5.1.0 What the cat? 🐈‍⬛

Neu: getCategory()

Liefert ein Array mit allen Informationen zu einer Kategorie. Funktioniert sowohl für die aktuelle Kategorie als auch für eine spezifische Kategorie-ID.

Basis-Verwendung

// Aktuelle Kategorie
$category = BuildArray::create()->getCategory();

// Spezifische Kategorie
$category = BuildArray::create()->getCategory(5);

*** Rückgabe-Array***

[
    'catId' => 5,              // ID der Kategorie
    'parentId' => 2,           // ID der Elternkategorie
    'catName' => 'News',       // Name der Kategorie
    'url' => '/news/',         // URL der Kategorie
    'hasChildren' => true,     // Hat Unterkategorien
    'children' => [],          // Array der Kindkategorien
    'path' => [0,2,5],        // Pfad von Root zur Kategorie
    'pathCount' => 3,          // Anzahl der Ebenen von Root
    'active' => true,          // Ist im aktiven Pfad
    'current' => true,         // Ist aktuelle Kategorie
    'cat' => Object,          // REX Category Objekt
    'ycom_permitted' => true,  // YCom-Berechtigung
    'filter_permitted' => true,// Filter-Erlaubnis
    'is_permitted' => true,    // Gesamtstatus der Berechtigungen
]

What's Changed

• 5.1 :: Get the current or set category as array including permission status … by @skerbis in #37

Testing @marcohanke

Full Changelog: 5.0.0...5.1.0

5.0.0 🙋Ciao Marco

What's Changed

• new toJson() by @skerbis in #32
• new setExcludedCategories by @skerbis in #33
• Fragment integration by @marcohanke in #34
• remove unused depthSaved by @marcohanke in #35
• add phpdocs and rearrange code by @marcohanke in #36

New Contributors

• @marcohanke made their first contribution in #34

Full Changelog: 4.0.0...5.0.0

4.0.0

Die depracated Class \FriendsOfRedaxo\navigationArray und die function navArray() wurden entfernt.
Sofern nicht bereits erfolgt, muss vorhandener Code angepasst werden. Siehe Readme.
Sonst keine Änderungen zu 3.1.1

Removed:

• deprecated: \FriendsOfRedaxo\navigationArray class
• depracaed: function navArray()

Full Changelog: 3.1.1...4.0.0

3.1.1 🙈 compatibility fix

Neu: Vollständige Verkettung der Factory möglich inkl. generate()

Beispiel:

$navArray = BuildArray::create()->setDepth(3)->generate();

Fixes in der Readme, Danke @erraiva

3.1.0 🐿️

Neu: Vollständige Verkettung der Factory möglich inkl. generate()

Beispiel:

$navArray = BuildArray::create()->setDepth(3)->generate();

Fixes in der Readme, Danke @erraiva

3.0.0 Namespace Odyssee 🛸🚀

3.0.0

Namespace hat sich geändert und es wurde Raum für neue zusätzliche Classes geschaffen.
Das Array wird nun mit der Class BuildArray erstellt. (Siehe Readme)

Vorher // bis 4.0.0 noch verwendbar
FriendsOfRedaxo\navigationArray(0, 3);

jetzt
new FriendsOfRedaxo\navigationArray\BuildArray(0, 3);

Bitte stellt schon jetzt auf die neue Schreibweise um.

2.0.0 -3.0.0
Was hat sich geändert?

Alles:

• Es ist nun eine Class
• Es gibt einen FilterCallback
• und CustomDataCallback
• Level werden ab den übergeben Kategorien gezählt
• Man kann mehrere Kategorien übergeben die die Ebene 0 darstellen.
• ausführliche Readme
• Anwendungsbeispiele
• Kategorie-Objekt wurde entfernt in der Übergabe
• die alte func nutzt jetzt die class. Es müssen bei einem Update keine Änderungen durchgeführt werden.
• yrewrite auto start category
• YCOM wird berücksichtigt

2.0.2
Bugfixes, missing Vars

2.0.1
Fixed php version

2.0.0

What's Changed

• Update publish-to-redaxo.yml by @aeberhard in #9
• multiple start categories by @skerbis in #10
• multiple cats as mountpoints by @skerbis in #11
• added namespace by @skerbis in #12
• Neue doku by @skerbis in #13
• added setCategoryFilterCallback by @skerbis in #14
• readme setCategoryFilterCallback by @skerbis in #15
• new setCustomDataCallback by @skerbis in #16
• newsetCustomDataCallback by @skerbis in #17
• cat object entfernt by @skerbis in #18
• factory by @skerbis in #19
• breadcrumb by @skerbis in #20
• function uses class by @skerbis in #21
• yrewrite auto start discovery by @skerbis in #22
• 0 soll auch bei yrewrite möglich sein by @skerbis in #23
• wenn kein yrewrite start = 0 by @skerbis in #24
• Ergänzung automatische Erkennung by @skerbis in #25
• set start to -1 by @skerbis in #26
• depthcheck from root of selected categories by @skerbis in #27

Full Changelog: 1.2.1...2.0.0
Full Changelog: 2.0.2...3.0.0

2.0.2 :: rex_navigation::factory what? 🐒

Was hat sich geändert?

Alles:

• Es ist nun eine Class
• Es gibt einen FilterCallback
• und CustomDataCallback
• Level werden ab den übergeben Kategorien gezählt
• Man kann mehrere Kategorien übergeben die die Ebene 0 darstellen.
• ausführliche Readme
• Anwendungsbeispiele
• Kategorie-Objekt wurde entfernt in der Übergabe
• die alte func nutzt jetzt die class. Es müssen bei einem Update keine Änderungen durchgeführt werden.
• yrewrite auto start category
• YCOM wird berücksichtigt

2.0.2
Bugfixes, missing Vars

2.0.1
Fixed php version

2.0.0

What's Changed

• Update publish-to-redaxo.yml by @aeberhard in #9
• multiple start categories by @skerbis in #10
• multiple cats as mountpoints by @skerbis in #11
• added namespace by @skerbis in #12
• Neue doku by @skerbis in #13
• added setCategoryFilterCallback by @skerbis in #14
• readme setCategoryFilterCallback by @skerbis in #15
• new setCustomDataCallback by @skerbis in #16
• newsetCustomDataCallback by @skerbis in #17
• cat object entfernt by @skerbis in #18
• factory by @skerbis in #19
• breadcrumb by @skerbis in #20
• function uses class by @skerbis in #21
• yrewrite auto start discovery by @skerbis in #22
• 0 soll auch bei yrewrite möglich sein by @skerbis in #23
• wenn kein yrewrite start = 0 by @skerbis in #24
• Ergänzung automatische Erkennung by @skerbis in #25
• set start to -1 by @skerbis in #26
• depthcheck from root of selected categories by @skerbis in #27

Full Changelog: 1.2.1...2.0.0

1.2.1

Update package.yml