この記事は最後に更新してから1年以上経過しています。

「投稿に挿入」時のタグをちょっとカスタマイズ

説明

投稿画面において、画像をアップロードし投稿に挿入するすると、imgタグをaタグで囲んだものが挿入される(キャプションを指定した場合はタグも)。それらの画像をLightBox(JavaScriptライブラリ)で表示する場合、aタグにrel属性を追加するのだが、その作業を毎回投稿に挿入した後で行うのがちょっと面倒。というわけで、自動的にrel属性を追加するようにしてみました。
まず投稿にアップロードした画像のHTMLコードを挿入している仕組みを調べた。 画像のアップロードしている部分はiframeタグで「/wp-admin/media-upload.php」で行っており、目的のHTMLコードを挿入しているのは「/wp-admin/includes/media.php」のimage_send_to_editorフィルターであり、そのフィルターとして登録されているのが同media.phpで定義されているimage_add_caption関数だった。
aタグにrel属性を追加するには、このimage_add_caption関数と同じようなフィルター関数を定義すればいい。具体的には、自身のテーマのfunctions.phpに次の内容を記述する。
add_filter( 'image_send_to_editor', 'mytheme_image_send_to_editor' );

function mytheme_image_send_to_editor( $html, $id = '', $caption = '', $title = '', $align = '', $url = '', $size = '', $alt = '' ) {
	return ( strpos( $html, 'rel=' ) === false )? str_replace( '><img src', ' rel="lightbox"<>img src', $html ): $html;
}
アップロードするファイルは画像以外の添付ファイル以外の場合は、aタグにrel属性が指定されているので、挿入される$htmlにrel属性が含まれているかを調べ、含まれていない場合のみLightBox用のrel属性を追加するようにしている。また、ここではrel属性を追加しているが、aタグにclass属性を指定する場合にも利用できるだろう。
管理者向けのカスタマイズは、まだまだいろいろできそうですね。

最終更新 : 2011年07月29日 16:21


お勧め

convert_invalid_entities(2018年5月27日 更新)

string convert_invalid_entities( string $content )
コンテントに含まれる無効なHTMLエンティティを変換する。

wp_die(2019年5月10日 更新)

void wp_die( string | WP_Error $message [ , string | int $title = '' [ , mixed $args = array() ] ] )
エラーメッセージ(ページ)を表示する。

remove_meta_box(2011年8月25日 更新)

void remove_meta_box( string $id, string $page, string $context )
投稿ページのメタボックスを削除(非表示)する。

get_header_image_tag(2018年5月27日 更新)

string get_header_image_tag( array $attr = array() )
カスタムヘッダーのimg要素を取得する。

wp_schedule_single_event(2019年3月20日 更新)

void bool wp_schedule_single_event( int $timestamp, string $hook [ , array $args = array() ] )
一度だけ実行するアクションをスケジュールに登録する。