การตั้งค่าปลั๊กอิน
การตั้งค่าปลั๊กอินการเพิ่ม Custom Tag Taxonomy เข้าสู่ Schema

การเพิ่ม Custom Tag Taxonomy เข้าสู่ Schema

ใน WordPress เราสามารถเพิ่มแท็กให้กับโพสต์ได้ (กล่าวคือ การใช้ taxonomy ที่มีชื่อว่า "post_tag") ซึ่งได้รับการแมปไว้ใน GraphQL schema แล้วผ่าน PostTag ที่เชื่อมโยงกับรายการ Post

Custom Post Types ที่กำหนดโดยธีมหรือปลั๊กอิน (เช่น "product") ก็สามารถมี tag taxonomy เป็นของตัวเองได้เช่นกัน (เช่น "product-tag") เนื่องจาก tag taxonomy เหล่านี้ไม่มีประเภทเฉพาะของตัวเองสำหรับ GraphQL schema (ซึ่งจะต้องใช้การขยายผ่านโค้ด PHP) จึงถูก resolve ผ่านประเภท GenericTag

เราใช้ฟิลด์ tag และ tags เพื่อดึงข้อมูลแท็ก โดยระบุ taxonomy ที่อ้างอิงผ่าน field argument taxonomy ผลลัพธ์เป็น union type TagUnion ซึ่งประกอบด้วยรายการจาก PostTag หรือ GenericTag (ขึ้นอยู่กับ taxonomy ของรายการ)

ประเภท TagUnion

การกำหนดค่า tag taxonomy ที่สามารถ query ได้

tag taxonomy ที่สามารถ query ได้จะต้องกำหนดค่าอย่างชัดเจน ซึ่งสามารถทำได้ใน 2 ที่

ในส่วน Schema Configuration ที่ใช้กับ endpoint โดยเลือกตัวเลือก "Use custom configuration" ภายใต้ "Customize configuration, or use default from Settings?" จากนั้นเลือกรายการที่ต้องการ:

การเลือก tag taxonomy ที่อนุญาตใน Schema Configuration

รายการนี้ประกอบด้วย taxonomy ทั้งหมดที่ "ไม่มีลำดับชั้น" ซึ่งเชื่อมโยงกับ custom post ที่สามารถ query ได้ กล่าวคือ รายการที่เลือกไว้ใน "Included custom post types" ในการตั้งค่าสำหรับ "Custom Posts" โดย custom post types ที่เชื่อมโยงกับแต่ละ tag taxonomy จะแสดงอยู่ใต้ (CPT: ...) หาก tag taxonomy ที่ต้องการไม่ปรากฏที่นี่ ให้ตรวจสอบว่า custom post types ที่เกี่ยวข้องทั้งหมดอยู่ใน allowlist นั้น

มิฉะนั้น หากเลือกตัวเลือก "Use configuration from Settings" จะใช้ค่าที่กำหนดไว้ใต้ส่วน "Included tag taxonomies" ในหน้าการตั้งค่าสำหรับ Schema Custom Posts:

การเลือก tag taxonomy ที่อนุญาตในการตั้งค่า
การเลือก tag taxonomy ที่อนุญาตในการตั้งค่า

การกำหนดค่าเพิ่มเติม

ผ่านการตั้งค่าสำหรับ Schema Tags เราสามารถกำหนดค่าต่อไปนี้ได้:

  • จำนวนองค์ประกอบเริ่มต้นที่จะดึงข้อมูล (กล่าวคือ เมื่อไม่ได้ตั้งค่า field argument limit) เมื่อ query รายการ tag taxonomy ใดๆ
  • จำนวนองค์ประกอบสูงสุดที่สามารถดึงข้อมูลได้ในการ query ครั้งเดียว
การตั้งค่าสำหรับขีดจำกัดของแท็ก
การตั้งค่าสำหรับขีดจำกัดของแท็ก