wp_create_category() 関数の概要
wp_create_category()関数は、WordPressのデータベースに新しいカテゴリを作成するための関数です。この関数を使用することで、プログラム的にカテゴリを追加することができます。カテゴリ名だけでなく、スラッグや説明、親カテゴリの設定も行うことができます。主にテーマやプラグイン開発時に、初期設定としてカテゴリを自動生成する場合に便利です。
パラメータの説明
wp_create_category()関数には、以下のパラメータを設定することができます：
$cat_name(string) – 必須: 作成するカテゴリの名前を指定します。$parent(int) – オプション: 親カテゴリのIDを指定します。デフォルトは0で、トップレベルのカテゴリとして作成されます。$slug(string) – オプション: カテゴリのスラッグを指定します。指定しない場合、カテゴリ名から自動生成されます。
使用例
以下は、wp_create_category()関数を使用して新しいカテゴリを作成する例です：
<?php
$category_name = 'New Category';
$parent_category_id = 0; // トップレベルカテゴリとして作成
$category_slug = 'new-category';
$category_id = wp_create_category($category_name, $parent_category_id, $category_slug);
if (!is_wp_error($category_id)) {
echo 'カテゴリが正常に作成されました。ID: ' . $category_id;
} else {
echo 'カテゴリの作成に失敗しました: ' . $category_id->get_error_message();
}
?>この例では、”New Category”という名前のカテゴリを作成し、成功した場合はカテゴリIDを出力します。
関連する関数
get_categories(): 既存のカテゴリ一覧を取得するための関数です。wp_insert_category(): より多くのオプションを指定してカテゴリを作成するための関数です。wp_update_category(): 既存のカテゴリ情報を更新するための関数です。wp_delete_category(): カテゴリを削除するための関数です。
