WordPressでショートコードをPHPファイルに埋め込む方法（do_shortcode）

2024/01/02 著者:牧野健人

WordPressでショートコードをPHPファイルに埋め込みたい場合は、下記のようにdo_shortcode関数をechoで出力します。

<?php echo do_shortcode('[ショートコード名]'); ?>

例えば「ページIDを指定して、そのページのタイトルを出力するショートコード」をaタグの中で使いたい場合は下記のようになります。

// [show_page_title id="1"]がページタイトルを返すショートコードだとする
<a href="/example/"><?php echo do_shortcode('[show_page_title id="1"]'); ?></a>

以下で、このコードを解説します。

記事の著者牧野健人

株式会社リラクス代表取締役。CRO・SEOを専門とし、デザイン・実装のスキルも活かしながら、クライアントの成果向上のための取組に尽力。
慶應義塾大学卒業後、行政機関を経て、デジタルマーケティングエージェンシーのアイレップにて運用型広告のクリエイティブプランニングに従事。2019年にリラクスを創業。

お問い合わせはフォームよりお願いいたします。

WordPressのショートコードをPHPテンプレートに埋め込むコードの解説

ショートコードはWordPressの管理画面から使う場合は[ショートコード名]の形式で使用します。

しかし、PHPテンプレートの中にこのまま書くだけだと、単なる文字列として処理されてしまいます。

そこで、WordPressが用意している関数であるdo_shortcodeを使います。これにより、指定したショートコードをPHPの中で実際に動かすことができます。

そして、ショートコードが生成した結果をechoによって文字列として出力して、Webページ上に表示します。

以上の理屈により、<?php echo do_shortcode('[ショートコード名]'); ?>という記述によってショートコードをPHPテンプレート内で使用することができます。