関数の概要
get_the_taxonomies()
は、現在の投稿に関連付けられているすべてのタクソノミーとそれぞれのタームを取得するための関数です。この関数を使用することで、特定の投稿にどのタクソノミーが関連付けられているかを一覧表示し、それぞれのターム名を取得することができます。
パラメータの説明
- $post (int|WP_Post): タクソノミーを取得したい投稿のIDまたは投稿オブジェクト。省略した場合、現在の投稿が使用されます。
- $args (array): タクソノミーの出力をカスタマイズするための引数の配列。デフォルトの引数には
format
,before
,sep
,after
などがあります。
戻り値
現在の投稿に関連付けられたすべてのタクソノミーとそれぞれのタームを含む連想配列を返します。配列のキーはタクソノミー名で、値はそれぞれのタクソノミーに関連付けられたタームのリストです。
使用例
// 現在の投稿に関連付けられたすべてのタクソノミーとタームを取得
$taxonomies = get_the_taxonomies();
if ( !empty( $taxonomies ) ) {
echo '<h2>Taxonomies and Terms:</h2>';
foreach ( $taxonomies as $taxonomy => $terms ) {
echo '<h2>' . $taxonomy . '</h2>';
echo '<p>' . $terms . '</p>';
}
} else {
echo '<p>No taxonomies found for this post.</p>';
}
// 投稿ID 123 のタクソノミーとタームを取得
$post_taxonomies = get_the_taxonomies( 123 );
if ( !empty( $post_taxonomies ) ) {
echo '<h2>Taxonomies and Terms for Post 123:</h2>';
foreach ( $post_taxonomies as $taxonomy => $terms ) {
echo '<h2>' . $taxonomy . '</h2>';
echo '<p>' . $terms . '</p>';
}
} else {
echo '<p>No taxonomies found for post 123.</p>';
}
// カスタム引数を使用してタクソノミーとタームを取得
$custom_args = array(
'format' => 'list',
'before' => '<div>',
'sep' => ', ',
'after' => '</div>',
);
$custom_taxonomies = get_the_taxonomies( null, $custom_args );
if ( !empty( $custom_taxonomies ) ) {
echo '<h2>Custom Taxonomies and Terms:</h2>';
foreach ( $custom_taxonomies as $taxonomy => $terms ) {
echo '<h2>' . $taxonomy . '</h2>';
echo $terms;
}
} else {
echo '<p>No custom taxonomies found for this post.</p>';
}
関連する関数
get_the_terms()
: 特定の投稿に関連付けられたタームを取得するための関数。指定したタクソノミーに関連するタームを取得します。the_taxonomies()
: 現在の投稿に関連付けられたタクソノミーとタームを出力するための関数。出力形式をカスタマイズできます。get_post_taxonomies()
: 特定の投稿に関連付けられたタクソノミーを取得するための関数。タクソノミーの名前の配列を返します。register_taxonomy()
: 新しいタクソノミーを登録するための関数。この関数を使用して、新たなタクソノミーをカスタム投稿タイプや既存の投稿タイプに関連付けることができます。get_taxonomies()
: 登録されているすべてのタクソノミーを取得するための関数。全タクソノミーを一覧表示する場合に使用します。