wp_delete_category()

wp_delete_category() 関数の概要

wp_delete_category()関数は、WordPressのデータベースからカテゴリを削除するための関数です。この関数を使用することで、指定したカテゴリIDのカテゴリをデータベースから完全に削除することができます。ただし、削除したカテゴリに含まれていた投稿は「未分類」カテゴリに移動されるため、投稿が失われることはありません。この関数は、カテゴリを整理したり不要なカテゴリを削除する際に便利です。

パラメータの説明

wp_delete_category()関数には、1つの必須パラメータを設定することができます:

  • $cat_id (int) – 必須: 削除するカテゴリのIDを指定します。

使用例

以下は、wp_delete_category()関数を使用してカテゴリを削除する例です:

<?php
$category_id = 123; // 削除したいカテゴリのID

$result = wp_delete_category($category_id);

if ($result) {
    echo 'カテゴリが正常に削除されました。';
} else {
    echo 'カテゴリの削除に失敗しました。';
}
?>

この例では、IDが123のカテゴリを削除し、削除が成功した場合はメッセージを出力します。

関連する関数

  • get_categories(): 既存のカテゴリ一覧を取得するための関数です。
  • wp_create_category(): 新しいカテゴリを作成するための関数です。
  • wp_update_category(): 既存のカテゴリ情報を更新するための関数です。
  • get_category(): 特定のカテゴリ情報を取得するための関数です。