ショートコードを使ってテーマ内の画像URLを簡単に指定する

説明

投稿記事の中で画像パーツを使いたいときがある。画像パーツの配置場所は、/imgディレクトリのようなテーマ外の場合と、/wp-content/themes/mytheme/imagesディレクトリのようなテーマ内の場合があり、今回は後者のケース。ショートコードを使って投稿記事の画像ファイルのURLを記述する方法を紹介したい。 通常、投稿記事にテーマ内の画像ファイルを入れる場合、
<img src="/wp-content/themes/mytheme/images/logo.gif" />
だったり、プロトコルやドメインを含んだ
<img src="http://localhost/wp-content/themes/mytheme/images/logo.gif" />
となる。 WordPressでは、 get_template_directory_uri get_bloginfo( 'template_url' )を使うことで、自テーマのURI部分(上記の「~/mytheme」までの部分)を取得できる。ショートコードを使った投稿記事の記述例は、
<img src="[tp /]/images/logo.gif" />
または
<img src="[tp]/images/logo.gif[/tp]" />
となる。だいぶ短くなりますよね。 テーマ内のfunctions.phpに記述するPHPのコードは次の通り。
add_shortcode( 'tp', 'shortcode_tp' );
function shortcode_tp( $atts, $content = '' ) {
	return get_template_directory_uri().$content;
}
add_shortcodeを使ってショートコードに対応する関数を指定するだけのシンプルなもの。すごく簡単ですよね。

最終更新 : 2018年05月27日 10:53


お勧め

restore_previous_locale(2018年11月21日 更新)

string | bool restore_previous_locale()
直前のロケールへ戻す。

is_email(2017年11月28日 更新)

mixed is_email( string $email [, bool $deprecated = false ] )
文字列がメールアドレス形式か調べる。

is_rtl(2015年8月26日 更新)

bool is_rtl( )
現在のロケールが右書き(文字を右から左へ書き進めること)か調べる。

get_parent_theme_file_path(2018年5月27日 更新)

string get_parent_theme_file_path( string $file = '' )
親テーマ内にあるファイルのパス名を取得する。

is_page(2018年7月4日 更新)

bool is_page( [ mixed $page = '' ] )
要求されているページが、ページか調べる。