Dodawanie niestandardowej taksonomii tagów do schematu
Możemy dodawać tagi do wpisów w WordPress (czyli używając taksonomii o nazwie "post_tag"). Jest to już odwzorowane w schemacie GraphQL za pomocą typu PostTag, powiązanego z wpisem Post.
Custom Post Types zdefiniowane przez dowolny motyw lub wtyczkę (takie jak "product") mogą również mieć własną taksonomię tagów powiązaną z nimi (taką jak "product-tag"). Ponieważ te taksonomie tagów nie mają własnego, specyficznego typu dla schematu GraphQL (co wymagałoby rozszerzenia za pomocą kodu PHP), są one rozwiązywane za pomocą typu GenericTag.
Używamy pól tag i tags do pobierania danych tagów, które wskazują, do której taksonomii się odnoszą, za pomocą argumentu pola taxonomy. Wynik jest typu union TagUnion, który zawiera wpisy z PostTag lub GenericTag (w zależności od taksonomii wpisu).
Konfigurowanie odpytywalnych taksonomii tagów
Taksonomie tagów, które mogą być odpytywane, muszą być jawnie skonfigurowane. Można to zrobić w 2 miejscach.
W Konfiguracji Schematu zastosowanej do endpointu, wybierając opcję "Use custom configuration" w sekcji "Customize configuration, or use default from Settings?" a następnie wybierając żądane elementy:
Ta lista zawiera wszystkie taksonomie „niehierarchiczne" powiązane z odpytywalnymi custom posts, czyli tymi wybranymi w "Included custom post types" w Ustawieniach dla "Custom Posts". Powiązane custom post types każdej taksonomii tagów są wyświetlane w (CPT: ...). Jeśli żądana taksonomia tagów nie pojawia się tutaj, upewnij się, że wszystkie powiązane z nią custom post types znajdują się na tej liście dozwolonych.
W przeciwnym razie, przy wyborze opcji "Use configuration from Settings", używana jest wartość zdefiniowana w sekcji "Included tag taxonomies" na stronie Ustawień dla Schema Custom Posts:
Dodatkowa konfiguracja
Za pomocą Ustawień dla Schema Tags możemy również zdefiniować:
- Domyślną liczbę elementów do pobrania (czyli gdy argument pola
limitnie jest ustawiony) podczas odpytywania listy dowolnej taksonomii tagów - Maksymalną liczbę elementów, które można pobrać w ramach jednego wykonania query
