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()
: 特定のカテゴリ情報を取得するための関数です。