do_shortcode()


WordPressのdo_shortcode()関数は、ショートコードを処理して実行するために使用されます。この関数を使用することで、コンテンツ内で定義されたショートコードを動的に展開できます。

構文

do_shortcode( string $content );

引数の説明:

  • $content (string) — 処理するショートコードを含むコンテンツ。

例 1: ショートコードの出力を表示する

ショートコードを使用して定義されたコンテンツを表示します。

<?php echo do_shortcode( '[example_shortcode]' ); ?>

例 2: 動的にショートコードを生成して実行する

ショートコードを動的に作成して出力します。

<?php
$content = '[example_shortcode attr="value"]';
echo do_shortcode( $content );
?>

例 3: 関数内でショートコードを使用する

テーマやプラグイン内でショートコードを処理します。

<?php
function display_custom_content() {
    return do_shortcode( '[custom_shortcode]' );
}
echo display_custom_content();
?>

例 4: 投稿のカスタムフィールドでショートコードを処理する

投稿のカスタムフィールドからショートコードを取得し、展開します。

<?php
$field_content = get_post_meta( get_the_ID(), 'custom_field_key', true );
echo do_shortcode( $field_content );
?>

例 5: ショートコードをウィジェット内で処理する

ウィジェットのタイトルやコンテンツでショートコードを使用します。

<?php
$widget_content = '[widget_shortcode]';
echo do_shortcode( $widget_content );
?>

注意事項

  • do_shortcode()関数は、必ず信頼できるデータのみを処理するようにしてください。
  • ユーザー入力を直接do_shortcode()に渡すことは避けるべきです。
  • ショートコードの数が多い場合、パフォーマンスに影響を与える可能性があります。

関連機能：