category_exists()


WordPressのcategory_exists()関数は、指定したカテゴリーが既に存在するかどうかを確認するために使用されます。

構文

category_exists( string|int $cat_name_or_id );
  • $cat_name_or_id (string|int) — チェックするカテゴリーの名前またはID。

例1: カテゴリーが存在するかを確認する

以下のコードは、特定のカテゴリーが存在するかを確認します。

<?php
if ( category_exists( 'ニュース' ) ) {
    echo 'カテゴリー「ニュース」は存在します。';
} else {
    echo 'カテゴリー「ニュース」は存在しません。';
}
?>

例2: カテゴリーIDでの確認

カテゴリーIDを使用して存在を確認する方法。

<?php
if ( category_exists(3) ) {
    echo 'カテゴリーID 3は存在します。';
} else {
    echo 'カテゴリーID 3は存在しません。';
}
?>

例3: カテゴリーの登録を条件に投稿を追加

指定されたカテゴリーが存在する場合に投稿を追加する例。

<?php
if ( category_exists( 'イベント' ) ) {
    wp_insert_post( array(
        'post_title'  => '新しいイベント',
        'post_content'=> '詳細情報',
        'post_status' => 'publish',
        'post_category' => array( get_cat_ID( 'イベント' ) )
    ));
}
?>

例4: カテゴリーが存在しない場合の作成

カテゴリーが存在しない場合に新しいカテゴリーを作成するコード。

<?php
if ( ! category_exists( 'ブログ' ) ) {
    wp_create_category( 'ブログ' );
}
?>

例5: 条件に応じたカテゴリーの表示

指定したカテゴリーが存在する場合に表示する例。

<?php
if ( category_exists( 'お知らせ' ) ) {
    echo '<a href="' . get_category_link( get_cat_ID( 'お知らせ' ) ) . '">お知らせを表示</a>';
}
?>

注意点:

  • カテゴリーが存在しない場合は、falseを返します。

関連機能：