14.1. Einen neuen Term erstellen

<?php
function wp_insert_term( $term, $taxonomy, $args = array() ) {
	...
}
?>

Es gilt:

Dieser Inhalt ist nur eingeschränkt verfügbar. Melden Sie sich vorher an.

Die Funktion gibt im Fehlerfall ein WP_Error-Objekt zurück. Im Erfolgsfall ein Array, die neue term_id sowie die term_taxonomy_id enthält (siehe Beispiel).

Beispiel

Dieser Inhalt ist nur eingeschränkt verfügbar. Melden Sie sich vorher an.

Eventuell erhalten Sie folgende Fehlermeldung beim Aktivieren:

Ungültige Taxonomie

Dann liegt das daran, dass die Funktion mm_create_terms bereits ausgeführt wird bevor ein eventuell neues Taxonomie angelegt wurde. In folgendem Beispiel ist das der Fall:

Beispiel 2 erzeugt „Ungültige Taxonomie“-Fehler falls die Taxonomie „Genre“ noch nicht existiert:

Dieser Inhalt ist nur eingeschränkt verfügbar. Melden Sie sich vorher an.

Hinweis

Jeder Term erhält in WordPress eine so genannte „Slug“-Bezeichnung. Dieser Slug muss global einzigartig sein. Das liegt daran, dass Terme hierarchisch angeordnet sein können und der Slug möglicherweise doppelt in der URL vorkommt. Dadurch kann WordPress die beiden Terme nicht mehr unterscheiden.
Falls Sie einen neuen Term mit einem bereits existierenden Slug anlegen wollen, hängt WordPress einfach eine Nummer dran. So wird aus dem Slug sachbuecher einfach suchbuecher-2, falls ersterer denn schon existiert.
Beachten Sie auch, „global einzigartig“ heißt global einzigartig. Das bedeutet, dass auch gleichnamige Terme anderer Taxonomien unterschiedliche Slug-Bezeichnungen haben müssen.