Beherrschen der WordPress -Kategorien -API

eingehende WordPress-Klassifizierungsverzeichnis API: Effizient klassifizierte Daten

erhalten und verwalten

In diesem Artikel wird die API der WordPress -Klassifizierungsverzeichnis eingehend untersucht und erläutert, wie klassifizierte Daten effizient erhalten und verwaltet werden. Wir werden die Kernfunktionen einführen und zeigen, wie Sie eine einzelne Kategorie, mehrere Kategorien und spezifische Informationen wie Kategorie -ID, Name, Beschreibung, Slug und Anzahl der zugehörigen Artikel erhalten. Wir werden auch kurz Klassifizierungsoperationen in der WordPress-REST-API einführen.

Kernkonzepte

Die WordPress-Klassifizierungskatalog-API enthält eine Reihe von Funktionen, um die Originaldaten einer Klassifizierung abzurufen, einschließlich zurückgegebener Objekte, die alle klassifizierungsbezogenen Daten enthalten.

Holen Sie sich ein einzelnes Klassifizierungsobjekt

Die Funktion

get_category() ermöglicht es, ein einzelnes Klassifizierungsobjekt per ID zu erhalten.

$cat = get_category(14);

Dieses Objekt enthält mehrere Eigenschaften wie:

• cat_ID: Klassifizierungs -ID
• cat_name: Klassifizierungsname
• category_description: Klassifizierungsbeschreibung
• category_nicename oder slug: Kategorie Slug
• category_parent: übergeordnete Klassen -ID (keine übergeordnete Klasse ist 0)
• category_count: Anzahl der Artikel unter Kategorie

Sie können nach Bedarf auf diese Eigenschaften zugreifen:

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

get_category() Funktionen unterstützen auch die Rückgabe assoziative Arrays oder numerische Indexarrays:

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

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

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

Kategorien durch Slug

erhalten Die

get_category_by_slug() -Funktion ermöglicht das Erhalten von Klassifizierungsobjekten durch Slug.

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

Diese Funktion gibt nur Objekte zurück und unterstützt das Array -Formular nicht.

Holen Sie sich mehrere Kategorien

Die Funktion

get_categories() gibt ein Array zurück, das alle Kategorien enthält, wobei jedes Element ein Klassifizierungsobjekt ist. Sie können das Rückgabeergebnis durch Parameter anpassen, zum Beispiel:

• orderby: sortieren nach
• order: Reihenfolge
sortieren
• number: Rückgängigkeitsgrenze
• hide_empty: Enthält es leere Klassifizierung?
• include: Geben Sie die enthaltene Klassifizierungs -ID
an
• exclude: Geben Sie die ausgeschlossene Klassifizierungs -ID
an
• hierarchical: ob nach der Hierarchiestruktur zu
zurückkehren soll
• pad_counts: Ob die Zählung
füllen soll
• child_of: Geben Sie die übergeordnete Klassifizierungs -ID
an
• parent: Geben Sie die übergeordnete Klassifizierungs -ID an und geben Sie nur die direkte Unterrichtsklassifizierung
zurück

Holen Sie sich beispielsweise alle nicht leeren Kategorien und sortieren Sie nach Namen:

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

Holen Sie sich die mit dem Artikel verknüpften Kategorien

Die Funktion

get_the_category() gibt ein Array zurück, das alle Klassifizierungsobjekte enthält, die dem angegebenen Artikel zugeordnet sind. Standardmäßig wird die Kategorie des aktuellen Artikels zurückgegeben.

Erhalten Sie spezifische Informationen

Einige Funktionen werden verwendet, um spezifische Informationen zu erhalten, wie z. B.

• get_cat_ID($categoryName): Holen Sie sich die Kategorie -ID mit Namen
• get_ancestors($categoryId, 'category'): Holen Sie sich alle Vorfahren in der Kategorie
• get_cat_name($categoryId): Holen Sie sich den Kategoriennamen über ID
• category_description($categoryId): Erhalten Sie die Klassifizierungsbeschreibung nach ID
• get_category_link($categoryId): Holen Sie sich den Kategorie -Link

Verwenden Sie the_category() und get_the_category_list(), um die Kategorieliste

anzuzeigen Die Funktion

the_category() gibt direkt die Klassifizierungsliste des aktuellen Artikels aus, während die Funktion get_the_category_list() die Klassifizierungslistenzeichenfolge für eine bequeme benutzerdefinierte Ausgabe zurückgibt.

Klassifizierungsoperationen in WordPress Rest API

Die WordPress -REST -API bietet auch Verwaltungsfunktionen für die Klassifizierung:

• /wp/v2/categories: Erhalten Sie alle Kategorienliste
• /wp/v2/categories/<id></id>: Erhalten Sie die angegebenen Klassifizierungsinformationen, aktualisieren Sie die Klassifizierungsinformationen oder löschen Sie die Klassifizierung
• /wp/v2/posts: Erhalten Sie die Liste der Artikel in der angegebenen Kategorie (mit den Parametern categories)

Wenn Sie diese Funktionen flexibel verwenden, können Sie WordPress-Klassifizierungsdaten effizient erhalten und verwalten und in Ihr Thema oder Plug-In integrieren. Denken Sie daran, WordPress Codex für detailliertere Informationen und Parameterbeschreibungen zu konsultieren.

Das obige ist der detaillierte Inhalt vonBeherrschen der WordPress -Kategorien -API. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!