{"id":97,"date":"2018-02-11T00:56:00","date_gmt":"2018-02-10T23:56:00","guid":{"rendered":"https:\/\/schoppe.it\/wiki\/?p=97"},"modified":"2024-09-03T08:51:24","modified_gmt":"2024-09-03T06:51:24","slug":"wordpress-custom-taxonomy-erstellen","status":"publish","type":"post","link":"https:\/\/schoppe.it\/wiki\/wordpress-custom-taxonomy-erstellen\/","title":{"rendered":"WordPress Custom Taxonomy erstellen"},"content":{"rendered":"\n

Beispiel:<\/strong> Ich m\u00f6chte zus\u00e4tzlich zum Autor des Beitrags die mitwirkenden Autoren nennen. Hierzu m\u00f6chte ich eine Schlagwortliste (tags) nutzen, damit ich sp\u00e4ter eine Liste alle genannten mitwirkenden Autoren erstellen kann.<\/p>\n\n\n\n

Zu jedem WordPress-Befehl habe ich den Link zum WordPress Kodex eingef\u00fcgt. Dort werden alle Parameter und deren Einstellungsm\u00f6glichkeiten vollst\u00e4ndig beschrieben.<\/p>\n\n\n\n

functions.php<\/h2>\n\n\n\n

In die functions.php folgenden Code einf\u00fcgen.<\/p>\n\n\n

\nadd_action( 'init', 'create_post_taxonomies', 0 );\n\nfunction create_post_taxonomies() {\n\n $labels = array(\n 'name' => _x( 'Liste der mitwirkenden Autoren', 'taxonomy general name', 'textdomain' ),\n 'singular_name' => _x( 'Mitwirkender Autor', 'taxonomy singular name', 'textdomain' ),\n 'search_items' => __( 'Autor suchen', 'textdomain' ),\n 'popular_items' => __( 'Meistgenannte Autoren', 'textdomain' ),\n 'all_items' => __( 'Alle Autoren', 'textdomain' ),\n 'parent_item' => null,\n 'parent_item_colon' => null,\n 'edit_item' => __( 'Autor bearbeiten', 'textdomain' ),\n 'update_item' => __( 'Autor aktualisieren', 'textdomain' ),\n 'add_new_item' => __( 'Neuen Autor hinzuf\u00fcgen', 'textdomain' ),\n 'new_item_name' => __( 'Name des neuen Autors', 'textdomain' ),\n 'separate_items_with_commas' => __( 'Autoren mit Kommas trennen', 'textdomain' ),\n 'add_or_remove_items' => __( 'Hinzuf\u00fcgen oder Entfernen von Autoren', 'textdomain' ),\n 'choose_from_most_used' => __( 'W\u00e4hle aus den meistgenannten Autoren', 'textdomain' ),\n 'not_found' => __( 'Keinen Autor gefunden.', 'textdomain' ),\n 'menu_name' => __( 'Mitwirk. Autoren', 'textdomain' ),\n );\n\n$args = array(\n 'hierarchical' => false,\n 'public' => true,\n 'labels' => $labels,\n 'show_ui' => true,\n 'show_admin_column' => true,\n 'show_tagcloud' => true,\n 'update_count_callback' => '_update_post_term_count',\n 'query_var' => true,\n \/\/'rewrite' => array( 'slug' => 'mitwirk-autor' ),\n );\n\n<strong>register_taxonomy<\/strong>( 'mitwirk_autor', 'post', $args );\n}\n<\/pre><\/div>\n\n\n
Erkl\u00e4rung:<\/strong><\/p>\n\n\n\n
Der erste Block ($labels<\/em>) enth\u00e4lt die Beschriftungen f\u00fcr die GUI. Daher empfehle ich hier aussagekr\u00e4ftige und eindeutige Bezeichnungen zu w\u00e4hlen.<\/p>\n\n\n\n
Der zweite Block ($args<\/em>) enth\u00e4lt die weiteren Parameter des Befehls register_taxonomy<\/em>. Die Variable $labels<\/em> wird hier \u00fcbrigens in den Parameter labels<\/em> eingebunden.<\/p>\n\n\n\n
Wichtig ist der Parameter hierachical<\/em>. Der Wert false<\/em> erstellt eine Taxonomy analog einer Schlagwortliste. Der Wert true<\/em> erstellt eine Taxonomy analog einer Kategorienliste, in der auch untergeordnete Kategorien erstellt werden k\u00f6nnen.<\/p>\n\n\n\n
Abschlie\u00dfend folgt der eigentlich Befehl register_taxonomy<\/em>, der die neue Taxonomy erstellt<\/p>\n\n\n
\n<em>register_taxonomy( 'mitwirk-autor', 'post', $args );<\/em>\n<\/pre><\/div>\n\n\n
Der erste Wert in den Klammern (hier: ‚mitwirk-autor‘<\/em>) enth\u00e4lt die technische Bezeichnung der Taxonomy. Dieser Wert muss eindeutig sein und wird sp\u00e4ter noch ben\u00f6tigt. Er sollte nur Kleinbuchstaben und den Unterstrich enth\u00e4lten und nicht l\u00e4nger als 32 Zeichen sein.<\/p>\n\n\n\n
Der zweite Wert (hier: ‚post‘<\/em>) legt fest, f\u00fcr welchen Objekttypen die neue Taxonomy genutzt werden kann. Dies kann jeder Standard-Post Type (bspw. ‚post‘<\/em> und ‚page‘<\/em>) und jeder registrierte Custom Post Type sein.<\/p>\n\n\n\n
https:\/\/codex.wordpress.org\/Function_Reference\/register_taxonomy<\/a><\/p>\n\n\n\n
Permalinks aktualisieren<\/h2>\n\n\n\n
Nachdem die neue Taxonomy registriert wurde, am besten einmal die Permalinks aktualisieren. Hierzu im Dashboard unter Einstellungen > Permalinks<\/em> auf den Button „\u00c4nderungen \u00fcbernehmen“ klicken. Es m\u00fcssen keine Einstellungen ge\u00e4ndert werden. Nur auf den Button klicken.<\/p>\n\n\n\n
Darstellung der Taxonomy zu einem Beitrag<\/h2>\n\n\n\n
Der folgende Code k\u00f6nnte bspw. in der content.php<\/strong> und der content-single.php<\/strong> eingef\u00fcgt werden und erstellt eine Liste der zum jeweiligen Beitrag eingetragenen mitwirkenden Autoren.<\/p>\n\n\n
\n<?php\necho <strong>get_the_term_list<\/strong>( $post->ID, 'mitwirk_autor', '<strong>Mitwirkende Autoren: <\/strong>', ', ', '<\/p>');\n?>\n<\/pre><\/div>\n\n\n
https:\/\/codex.wordpress.org\/Function_Reference\/get_the_term_list<\/a><\/p>\n\n\n\n
Darstellung einer \u00dcbersicht aller verwendeten Eintr\u00e4ge der Taxonomy<\/h2>\n\n\n\n
Zur Darstellung einer kompletten Liste aller Eintr\u00e4ge der erstellten Taxonomy kann der folgende Code bspw. in einer eigenen Template-PHP eingef\u00fcgt werden.<\/p>\n\n\n\n
In diesem Beispiel habe ich einen eigenen <div>-Block erstellt, damit ich die Liste mittels style.css separat gestalten kann.<\/p>\n\n\n
\n<div id="liste_mitwirk_autoren">\n\n\t<h2>Mitwirkende Autoren<\/h2>\n\n\t<ul>\n\t\t<?php wp_list_categories( array(\n\t\t\t'child_of'            => 0,\n\t\t\t'current_category'    => 0,\n\t\t\t'depth'               => 0,\n\t\t\t'echo'                => 1,\n\t\t\t'exclude'             => '',\n\t\t\t'exclude_tree'        => '',\n\t\t\t'feed'                => '',\n\t\t\t'feed_image'          => '',\n\t\t\t'feed_type'           => '',\n\t\t\t'hide_empty'          => 1,\n\t\t\t'hide_title_if_empty' => false,\n\t\t\t'hierarchical'        => false,\n\t\t\t'order'               => 'ASC',\n\t\t\t'orderby'             => 'name',\n\t\t\t'separator'           => '',\n\t\t\t'show_count'          => 0,\n\t\t\t'show_option_all'     => '',\n\t\t\t'show_option_none'    => __( 'No categories' ),\n\t\t\t'style'               => 'list',\n\t\t\t'taxonomy'            => 'mitwirk-autor',\n\t\t\t'title_li'            => __( '' ),\n\t\t\t'use_desc_for_title'  => 1,\n\t\t) ); ?>\n\t<\/ul>\n<\/div><!-- Ende liste_mitwirk_autoren -->\n<\/pre><\/div>\n\n\n
Der Parameter ‚format‘<\/em> mit dem Wert ‚list‘<\/em> erstellt eine Liste mit der entsprechenden HTML-Formatierung (<ul><li><\/li><\/ul>).<\/p>\n\n\n\n
https:\/\/codex.wordpress.org\/Function_Reference\/wp_tag_cloud<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Beispiel: Ich m\u00f6chte zus\u00e4tzlich zum Autor des Beitrags die mitwirkenden Autoren nennen. Hierzu m\u00f6chte ich eine Schlagwortliste (tags) nutzen, damit ich sp\u00e4ter eine Liste alle genannten mitwirkenden Autoren erstellen kann. Zu jedem WordPress-Befehl habe ich den Link zum WordPress Kodex eingef\u00fcgt. Dort werden alle Parameter und deren Einstellungsm\u00f6glichkeiten vollst\u00e4ndig beschrieben. functions.php In die functions.php folgenden… WordPress Custom Taxonomy erstellen<\/span> weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[14],"tags":[],"powershell":[],"wordpress":[42,43,44],"exchange":[],"linux":[],"class_list":["post-97","post","type-post","status-publish","format-standard","hentry","category-wordpress","wordpress-get_the_term_list","wordpress-register_taxonomy","wordpress-wp_tag_cloud","entry"],"_links":{"self":[{"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/posts\/97","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/comments?post=97"}],"version-history":[{"count":3,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/posts\/97\/revisions"}],"predecessor-version":[{"id":103,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/posts\/97\/revisions\/103"}],"wp:attachment":[{"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/media?parent=97"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/categories?post=97"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/tags?post=97"},{"taxonomy":"powershell","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/powershell?post=97"},{"taxonomy":"wordpress","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/wordpress?post=97"},{"taxonomy":"exchange","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/exchange?post=97"},{"taxonomy":"linux","embeddable":true,"href":"https:\/\/schoppe.it\/wiki\/wp-json\/wp\/v2\/linux?post=97"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}