findByCategoryIds()

[skerbis]

Hinzufügen der findByCategoryIds-Methode zur Entry-Klasse

Zusammenfassung:

In diesem Pull Request wird eine neue Methode findByCategories zur Entry-Klasse hinzugefügt. Diese Methode ermöglicht es, Einträge anhand einer oder mehrerer Kategorien zu finden, wobei der Status der Einträge ebenfalls berücksichtigt wird. Die Methode akzeptiert sowohl Strings als auch Arrays als Eingabeparameter für die Kategorie-IDs und ist kompatibel mit PHP 8.2.

Änderungen im Detail:

• Neue Methode findByCategories:

  • Parameter: - string|array|null $category_ids: Akzeptiert entweder eine kommagetrennte Liste von Kategorie-IDs als String, ein Array von Kategorie-IDs oder null. - int $status: Definiert den Mindeststatus der Einträge, die gefiltert werden sollen.
  • Funktionalität:
    • Wenn ein String übergeben wird, wird dieser in ein Array umgewandelt.
    • Die Methode verwendet whereInList, um die Einträge zu filtern, die den angegebenen Kategorien zugeordnet sind. - Es wird der status der Einträge berücksichtigt, sodass nur Einträge zurückgegeben werden, die einen bestimmten Status erfüllen.

• Typdeklaration:

  • Die Methode nutzt die neuen Union Types (string|array|null), um klar anzugeben, welche Typen akzeptiert werden.

Anwendungsbeispiel:

// Suche nach Einträgen, die den Kategorien 1 und 2 zugeordnet sind und den Status 1 oder höher haben
$entries = FriendsOfRedaxo\Neues\Entry:findByCategoryIds([1, 2], 1);

// Suche mit einer kommagetrennten Liste von Kategorien als String
$entries = FriendsOfRedaxo\Neues\Entry::findByCategoryIds('1,2', 1);

// Suche nach allen Einträgen mit einem Status von 1 oder höher, ohne Kategorienfilter
$entries = FriendsOfRedaxo\Neues\Entry:findByCategoryIds(null, 1);

[alxndr-w]

lgtm

[alxndr-w]

Ich habe die Methode noch umbenannt in findByCategoryIds(), da ich hier versuche ein Namensschema innerhalb meiner Addons beizubehalten.

Ich bin mir aber nicht sicher - funktioniert $query->whereInList('category_ids', $category_ids); auch, wenn es sich um eine m:n-Beziehung mit Relationstabelle handelt? Die IDs stehen schließlich nicht wirklich im Feld category_ids.

[alxndr-w]

(siehe Kommentar zuvor - muss erst getestet sein)

[skerbis]

👍🏻