• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/wp get post categories」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/wp_get_post_categories 18:40, 30 November 2013 Mistercat 版を和訳。)
 
(パラメータ: $args の指定方法を補足説明。)
 
15行目: 15行目:
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
{{Parameter|$post_id|整数|投稿 ID|オプション|0}}
+
{{Parameter|$post_id|整数|投稿 ID|オプション|0 (現在の投稿)}}
{{Parameter|$args|配列|デフォルトを上書きする引数。|オプション|配列}}
+
{{Parameter|$args|配列|デフォルトを上書きする引数。|オプション|<tt>array()</tt>}}
 +
 
 +
<p class="information"><tt>$args</tt> に指定できるオプションの一覧は [[関数リファレンス/wp_get_object_terms|<tt>wp_get_object_terms()</tt>]] を参照してください。</p>
  
 
$args のデフォルトは次のとおりです:
 
$args のデフォルトは次のとおりです:
65行目: 67行目:
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function Reference/wp_get_post_categories|138726}} <!-- 18:40, 30 November 2013 Mistercat 版 -->
+
{{原文|Function Reference/wp_get_post_categories|145597}} <!-- 12:59, 17 August 2014 Gblsm 版 -->
  
 
{{DEFAULTSORT:Wp_get_post_categories}}
 
{{DEFAULTSORT:Wp_get_post_categories}}

2015年6月27日 (土) 19:13時点における最新版

この関数 wp_get_post_categories() は投稿に付けられたカテゴリーのリストを取得します。

テーマプラグインの内部で使う互換性維持用レイヤーです。 またタクソノミーの複雑さを避けて簡単に使えるようにする抽象化レイヤーでもあります。

使い方

<?php wp_get_post_categories( $post_id, $args ); ?>

パラメータ

$post_id
整数) (オプション) 投稿 ID
初期値: 0 (現在の投稿)
$args
配列) (オプション) デフォルトを上書きする引数。
初期値: array()

$args に指定できるオプションの一覧は wp_get_object_terms() を参照してください。

$args のデフォルトは次のとおりです:

$defaults = array( 'fields' => 'ids' );

戻り値

(配列) 
カテゴリー ID のリストが入った配列。

用例

下記の例はカテゴリーを取得する方法と、各カテゴリーの追加情報を取得する方法を示します。

$post_categories = wp_get_post_categories( $post_id );
$cats = array();
	
foreach( $post_categories as $c ){
	$cat = get_category( $c );
	$cats[] = array( 'name' => $cat->name, 'slug' => $cat->slug );
}

参考

変更履歴

バージョン 2.1.0 にて導入されました。

ソースファイル

wp_get_post_categories()wp-includes/post.php にあります。


カテゴリータグ: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category() , wp_get_object_terms()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/wp_get_post_categories最新版との差分