Menguasai Kategori WordPress API

API Direktori Klasifikasi WordPress yang mendalam: Memperolehi dan menguruskan data diklasifikasikan dengan cekap

Artikel ini akan meneroka API Direktori Klasifikasi WordPress secara mendalam dan menerangkan bagaimana untuk mendapatkan dan mengurus data yang diklasifikasikan dengan cekap. Kami akan memperkenalkan fungsi teras dan menunjukkan cara mendapatkan kategori tunggal, pelbagai kategori, dan maklumat khusus seperti ID kategori, nama, penerangan, slug, dan bilangan artikel yang berkaitan. Kami juga akan memperkenalkan operasi berkaitan klasifikasi secara ringkas dalam API REST WordPress.

Konsep teras

Katalog Klasifikasi WordPress API menyediakan satu siri fungsi untuk mendapatkan data asal klasifikasi, termasuk objek yang kembali yang mengandungi semua data yang berkaitan dengan klasifikasi.

Dapatkan objek klasifikasi tunggal

Fungsi

get_category() membolehkan untuk mendapatkan objek klasifikasi tunggal oleh ID.

$cat = get_category(14);

Objek ini mengandungi pelbagai sifat, seperti:

• cat_ID: id klasifikasi
• cat_name: Nama Klasifikasi
• category_description: Deskripsi Klasifikasi
• category_nicename atau slug: kategori slug
• category_parent: ID kelas induk (tiada kelas induk ialah 0)
• category_count: bilangan artikel di bawah kategori

anda boleh mengakses sifat -sifat ini seperti yang diperlukan:

<h1><?php echo $cat->cat_name; ?></h1>
<p><?php echo $cat->category_description; ?></p>

get_category() Fungsi juga menyokong array bersekutu yang kembali atau array indeks angka:

// 对象 (默认)
$cat = get_category(15, OBJECT);

// 关联数组
$cat = get_category(15, ARRAY_A);

// 数字索引数组
$cat = get_category(15, ARRAY_N);

Dapatkan kategori melalui slug

Fungsi

get_category_by_slug() membolehkan mendapatkan objek klasifikasi melalui slug.

$cat = get_category_by_slug('my-goldfish');

Fungsi ini hanya mengembalikan objek dan tidak menyokong borang array.

Dapatkan pelbagai kategori

Fungsi

get_categories() mengembalikan array yang mengandungi semua kategori, setiap elemen menjadi objek klasifikasi. Anda boleh menyesuaikan hasil pulangan melalui parameter, contohnya:

• orderby: Sort dengan
• order: menyusun pesanan
• number: Had kuantiti kembali
• hide_empty: Adakah ia termasuk klasifikasi kosong?
• include: Tentukan id klasifikasi yang disertakan
• exclude: Tentukan id klasifikasi yang dikecualikan
• hierarchical: sama ada hendak kembali ke
mengikut struktur hierarki
• pad_counts: sama ada untuk mengisi kiraan
• child_of: Tentukan ID Klasifikasi Ibu Bapa
• parent: tentukan ID klasifikasi induk, dan hanya mengembalikan klasifikasi kanak -kanak langsung

Sebagai contoh, dapatkan semua kategori yang tidak kosong dan susun dengan nama:

$cats = get_categories( array( 'hide_empty' => false, 'orderby' => 'name' ) );

Dapatkan kategori yang berkaitan dengan artikel

Fungsi

get_the_category() mengembalikan array yang mengandungi semua objek klasifikasi yang berkaitan dengan artikel yang ditentukan. Secara lalai, ia mengembalikan kategori artikel semasa anda boleh menentukan artikel dengan lulus dalam ID artikel.

Dapatkan maklumat khusus

Beberapa fungsi digunakan untuk mendapatkan maklumat khusus, seperti:

• get_cat_ID($categoryName): Dapatkan id kategori dengan nama
• get_ancestors($categoryId, 'category'): Dapatkan semua ID nenek moyang dalam kategori
• get_cat_name($categoryId): Dapatkan nama kategori melalui id
• category_description($categoryId): Dapatkan penerangan klasifikasi oleh id
• get_category_link($categoryId): Dapatkan pautan kategori

Gunakan the_category() dan get_the_category_list() untuk memaparkan senarai kategori

Fungsi

the_category() secara langsung mengeluarkan senarai klasifikasi artikel semasa, manakala fungsi get_the_category_list() mengembalikan rentetan senarai klasifikasi untuk output tersuai yang mudah.

Operasi Klasifikasi di WordPress Rest Api

API REST WordPress juga menyediakan fungsi pengurusan untuk klasifikasi:

• /wp/v2/categories: Dapatkan semua senarai kategori
• /wp/v2/categories/<id></id>: Dapatkan maklumat klasifikasi yang ditentukan, kemas kini maklumat klasifikasi atau padamkan klasifikasi
• /wp/v2/posts: Dapatkan senarai artikel di bawah kategori yang ditentukan (menggunakan parameter categories)

Dengan menggunakan fungsi ini secara fleksibel, anda boleh mendapatkan dan mengurus data klasifikasi WordPress dengan cekap dan mengintegrasikannya ke dalam tema atau plug-in anda. Ingatlah untuk berunding dengan WordPress Codex untuk maklumat yang lebih terperinci dan deskripsi parameter.

Atas ialah kandungan terperinci Menguasai Kategori WordPress API. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!