Dodawanie niestandardowej taksonomii kategorii do schematu
Możemy dodawać kategorie do postów w WordPress (tj. używając taksonomii o nazwie "category"). Jest to już zmapowane w schemacie GraphQL za pomocą PostCategory, powiązanego z wpisem Post.
Custom Post Types zdefiniowane przez dowolny motyw lub wtyczkę (takie jak "product") mogą również mieć własną taksonomię kategorii z nimi powiązaną (taką jak "product-cat"). Ponieważ te taksonomie kategorii nie dostarczają własnego specyficznego typu dla schematu GraphQL (co wymagałoby rozszerzenia przez kod PHP), są one rozwiązywane za pomocą typu GenericCategory.
Używamy pól category i categories do pobierania danych kategorii, które wskazują, do której taksonomii się odnoszą, za pomocą argumentu pola taxonomy. Wynik jest typu unii CategoryUnion, który zawiera wpisy z PostCategory lub GenericCategory (w zależności od taksonomii wpisu).
Konfigurowanie taksonomii kategorii możliwych do odpytywania
Taksonomie kategorii, które mogą być odpytywane, muszą być skonfigurowane jawnie. 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 "hierarchiczne" powiązane z odpytywalnymi wpisami niestandardowymi, tj. tymi wybranymi w sekcji "Included custom post types" w ustawieniach "Custom Posts". Typy niestandardowych postów powiązane z każdą taksonomią kategorii są wyświetlane w (CPT: ...). Jeśli żądana taksonomia kategorii nie pojawia się tutaj, upewnij się, że wszystkie jej powiązane typy niestandardowych postów 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 category taxonomies" na stronie ustawień Schema Custom Posts:
Dodatkowa konfiguracja
Za pomocą ustawień Schema Categories możemy również zdefiniować:
- Domyślną liczbę elementów do pobrania (tj. gdy argument pola
limitnie jest ustawiony) podczas odpytywania listy dowolnej taksonomii kategorii - Maksymalną liczbę elementów, które można pobrać w jednym wykonaniu query
