当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/wp create category」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function_Reference/wp_create_category 18:38, 17 November 2013 Mistercat 版を反映して残りを和訳。)
 
9行目: 9行目:
 
== パラメータ ==
 
== パラメータ ==
  
{{Parameter|$cat_name|string|作成するカテゴリー名}}
+
{{Parameter|$cat_name|文字列|作成するカテゴリー名}}
{{Parameter|$parent|integer|親カテゴリーのカテゴリーID|オプション}}
+
{{Parameter|$parent|整数|親カテゴリーのカテゴリー ID|オプション}}
  
 
== 戻り値 ==
 
== 戻り値 ==
  
; <tt>(boolean)</tt> : カテゴリーの作成に失敗した場合は0(false)を返します。カテゴリーが作成された場合は、作成されたカテゴリーIDを返します。
+
; <tt>(真偽値)</tt> : カテゴリーの作成に失敗した場合は 0 (false) を返します。カテゴリーが作成された場合は、作成されたカテゴリー ID を返します。
  
 
== 用例 ==
 
== 用例 ==
  
簡単にカテゴリーを作成するには :
+
簡単にカテゴリーを作成するには:
  
 
<pre>
 
<pre>
wp_create_category('My category name');
+
wp_create_category( 'My category name' );
 
</pre>
 
</pre>
  
「Uncategorized」カテゴリー(カテゴリーIDが0のカテゴリー)の子カテゴリーとして作成するには :
+
「Uncategorized」カテゴリー(カテゴリー ID が 0 のカテゴリー)の子カテゴリーとして作成するには:
  
 
<pre>
 
<pre>
wp_create_category('Child of Uncategorized', 0);
+
wp_create_category( 'Child of Uncategorized', 0 );
 
</pre>
 
</pre>
  
作成した新規カテゴリーのカテゴリーIDを変数に代入するには :
+
作成した新規カテゴリーのカテゴリー ID を変数に代入するには:
  
 
<pre>
 
<pre>
$id = wp_create_category('Child of Uncategorized', 0);
+
$id = wp_create_category( 'Child of Uncategorized', 0 );
 
</pre>
 
</pre>
  
 
== 注 ==
 
== 注 ==
  
* <tt>wp_create_category()</tt> は、 <tt>[[Function Reference/wp_insert_category|wp_insert_category()]]</tt>に対するラッパー関数です。
+
* <tt>wp_create_category()</tt> <tt>[[関数リファレンス/wp_insert_category|wp_insert_category()]]</tt> に対するラッパー関数です。
 
* シンプルさを目的としたラッパー関数のため、複雑なカスタムのタクソノミー要素を作成するのには向いていません。
 
* シンプルさを目的としたラッパー関数のため、複雑なカスタムのタクソノミー要素を作成するのには向いていません。
 +
* カテゴリーが既にある場合は、複製されず、以前からあったカテゴリーの ID を返します。
  
 
== ソースファイル ==
 
== ソースファイル ==
46行目: 47行目:
  
 
== 関連 ==
 
== 関連 ==
 +
 +
{{Tag Category Tags}}, [[関数リファレンス/wp_insert_category|wp_insert_category()]]
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{原文|Function Reference/wp_create_category|138206}} <!-- 18:38, 17 November 2013 Mistercat 版 -->
 +
 +
{{DEFAULTSORT:Wp_create_category}}
 +
[[Category:関数]]
  
 
[[en:Function_Reference/wp_create_category]]
 
[[en:Function_Reference/wp_create_category]]
 +
[[it:Riferimento funzioni/wp_create_category]]

2014年8月17日 (日) 13:39時点における最新版

説明

この関数は、カテゴリー名と(オプションで)親カテゴリーを指定して「シンプルな」カテゴリーを作成します。

使い方

<?php wp_create_category( $cat_name, $parent ); ?>

パラメータ

$cat_name
文字列) (必須) 作成するカテゴリー名
初期値: なし
$parent
整数) (オプション) 親カテゴリーのカテゴリー ID
初期値: なし

戻り値

(真偽値) 
カテゴリーの作成に失敗した場合は 0 (false) を返します。カテゴリーが作成された場合は、作成されたカテゴリー ID を返します。

用例

簡単にカテゴリーを作成するには:

wp_create_category( 'My category name' );

「Uncategorized」カテゴリー(カテゴリー ID が 0 のカテゴリー)の子カテゴリーとして作成するには:

wp_create_category( 'Child of Uncategorized', 0 );

作成した新規カテゴリーのカテゴリー ID を変数に代入するには:

$id = wp_create_category( 'Child of Uncategorized', 0 );

  • wp_create_category()wp_insert_category() に対するラッパー関数です。
  • シンプルさを目的としたラッパー関数のため、複雑なカスタムのタクソノミー要素を作成するのには向いていません。
  • カテゴリーが既にある場合は、複製されず、以前からあったカテゴリーの ID を返します。

ソースファイル

wp_create_category()wp-admin/includes/taxonomy.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_insert_category()


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


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