WordPress Terms mit PHP erstellen, aktualisieren, löschen und bearbeiten.

Terms lassen sich über PHP erstellen, abfragen und bearbeiten. Hierfür stellt WordPress Funktionen zur Verfügung.

Abfragen eines WordPress Terms mit PHP #

Um einen Term abzufragen, kannst du die Funktion get_term($term_id, $taxonomy) verwenden. Hierfür benötigst du lediglich die ID und die Taxonomie.

$term_id = 10;
$taxonomy = "post_tag";

/**
 * @var \WP_Term $Term
 */
$Term = get_term($term_id, $taxonomy);

Abfragen eines WordPress Terms bei Slug, Name oder Term ID #

Über get_term_by($field, $value, $taxonomy, $output = OBJECT, $filter = ‘raw’) kannst du einen Term auch über den Slug, den Namen oder die ID abfragen.

/**
 * WordPress Term abfragen mit dem Slug
 * @var \WP_Term|array|false $Term
 */
$Term = get_term_by("slug", "ich-bin-ein-slug", "post_tag");

/**
 * WordPress Term abfragen mit dem Namen
 * @var \WP_Term|array|false $Term
 */
$Term = get_term_by("name", "Ich bin ein Slug", "post_tag");

/**
 * WordPress Term abfragen mit dem Namen
 * @var \WP_Term|array|false $Term
 */
$Term = get_term_by("term_id", 10, "post_tag");

Abfragen aller WordPress Terms von einer Taxonomie #

Mithilfe von get_terms($args) kannst du alle Terms einer Taxonomie abfragen.

$args = array(
   'taxonomy' => 'post_tag',
   'hide_empty' => false
);

/**
 * @var array<\WP_Term> $Terms
 */
$Terms = get_terms($args);

Einfügen eines neuen WordPress Terms bei einer Taxonomie #

Neue Terms lassen sich über wp_insert_term($term, $taxonomy, $args = array()) hinzufügen. Falls der Term bereits existiert, wird dieser aktualisiert.

/**
 * Argumente können optional angegeben werden
 */
$args = array(
   'description' => 'Beschreibung',
   'parent' => 0,
   'slug' => ''
);

/**
 * Neuen Term erstellen in der Taxonomie post_tag
 */
$term_id = wp_insert_term('Ich bin ein neuer Term', 'post_tag', $args);

Löschen eines Terms in WordPress über PHP #

Terms lassen sich auch über PHP schnell und unkompliziert entfernen. Hierzu existiert die Funktion wp_delete_term($term_id,$taxonomy).

/**
 * Löscht den Term mit der Term ID 10 in der Taxonomie post_tag
 */
$result = wp_delete_term(10, 'post_tag');

Abfragen von Metadaten eines Terms #

Auch Terms können wie Posts Metadaten enthalten. Diese lassen sich über get_term_meta($term_id, $meta_key, $single) abfragen.

/**
 * Gibt einen einzelnen Wert zurück
 * @var string|int|mixed $meine_meta_daten
 */
$meine_meta_daten = get_term_meta(10,'meine_meta_daten', true);

/**
 * Gibt ein Array zurück 
 * @var array $meine_meta_daten
 */
$meine_meta_daten = get_term_meta(10,'meine_meta_daten');

Löschen von Metadaten eines Terms in WordPress #

Metadaten von Terms lassen sich in WordPress über delete_term_meta($term_id, $meta_key, $meta_value = ”) löschen.

$result = delete_term_meta(10, 'meine_meta_daten');

Metadaten eines Terms aktualisieren/anlegen über PHP #

Um bereits existierende Metadaten eines Terms zu aktualisieren, wird die Funktion update_term_meta($term_id, $meta_key, $meta_value, $prev_value = ”) verwendet. Falls die Daten noch nicht exisiteren, werden diese angelegt.

$result = update_term_meta(10, 'meine_meta_daten', 'das wird ausgegeben');