shortcode_exists()


WordPress関数shortcode_exists()は、指定されたショートコードが登録されているかを確認するために使用されます。

シンタックス

shortcode_exists( string $shortcode );

引数の説明:

  • $shortcode (string) — チェックするショートコードの名前。

例1: ショートコードの存在を確認

特定のショートコードが登録されているかを確認するシンプルな例です。

<?php
if ( shortcode_exists( 'gallery' ) ) {
    echo 'ショートコードが存在します。';
}
?>

例2: ショートコードが存在する場合に動作を実行

ショートコードが存在する場合にのみ、特定の処理を実行します。

<?php
if ( shortcode_exists( 'contact-form-7' ) ) {
    echo do_shortcode( '[contact-form-7 id="123" title="コンタクトフォーム"]' );
}
?>

例3: 条件付きでカスタムショートコードを登録

ショートコードが未登録の場合にのみ新しいショートコードを登録します。

<?php
if ( ! shortcode_exists( 'custom_shortcode' ) ) {
    add_shortcode( 'custom_shortcode', function() {
        return 'カスタムショートコードの内容';
    } );
}
?>

例4: サイドバーウィジェットの登録状況に応じて動作を変える

ショートコードの有無をチェックし、登録されている場合にのみ特定のウィジェットを表示します。

<?php
if ( shortcode_exists( 'sidebar-widget' ) ) {
    dynamic_sidebar( 'sidebar-widget' );
}
?>

例5: ショートコードのリストを確認

登録済みのショートコードリストに特定のショートコードが含まれているかを確認します。

<?php
global $shortcode_tags;
if ( array_key_exists( 'example_shortcode', $shortcode_tags ) ) {
    echo 'ショートコードがリストに存在します。';
}
?>

注意事項:

  • この関数はショートコードの登録を確認するだけで、ショートコードの動作や正確な実行内容を保証するものではありません。
  • ショートコードが未登録の場合にのみ新しいショートコードを追加したい場合、条件付きでadd_shortcode()を使用することを検討してください。

関連機能：