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

投稿内容に応じてwpautopを制御する

説明

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

制御方法について検討したのは、

  • a) いくつかのカテゴリを限定する
  • b) カスタムフィールドを使う
  • c) 投稿内容に特定のコメントを入れる

といった感じ。これらの選択肢の中で最終的に決定したのは、「特定のコメントを入れる」方法になる。この方法を選択した理由は、コメントの場合は投稿内容の文字列だけで処理を判断できるためだ。

自テーマのfunctions.phpに追加するコードは次の通り。

function noautop( $content ) {
	if ( strpos( $content, '<!--noautop-->' ) !== false ) {
		remove_filter( 'the_content', 'wpautop' );
		$content = preg_replace( "/\s*\<!--noautop-->\s*(\r\n|\n|\r)?/u", "", $content );
	}
	return $content;
}
add_filter( 'the_content', 'noautop', 1 );

ポイントは add_filter関数の第3パラメータに1を指定しているところ。これにより、the_content関数のフィルター関数として、最優先に実行することができる。noautop関数では、投稿内容に特定のコメント(ここでは'<!--noautop-->')の有無を調べ、あった場合にはwpautop関数をフィルターから外し、そのコメント自身を消去している。

さて制御方法の検討段階では、投稿内容にショートコードを含めることも検討した。ショートコードで制御できるかを調べる段階で、wpautop関数の実行直後にショートコードが実行されることがわかった。これまでショートコードの実行タイミングをあまり意識していなかったが、この点は押さえておいたほうがいいだろう。


最終更新 : 2013年08月13日 15:07


お勧め

get_the_post_thumbnail_caption(2018年5月27日 更新)

string get_the_post_thumbnail_caption( mixed $post = null )
投稿ページのサムネイル(アイキャッチ画像)キャプションを取得する。

wp_enqueue_style(2019年11月25日 更新)

void wp_enqueue_style( string $handle [ , string $src = false [ , array $deps = array() [ , string $ver = false [ , string $media = 'all' ] ] ] ] )
使用するスタイルシート(CSS)を出力用のキューに入れる。パラメータ$srcが指定された場合は、グローバル変数$wp_stylesに登録してから出力用のキューに入れる。

post_class(2018年5月27日 更新)

void post_class( [ string $class = '' [ , int $post_id = null ] ] )
投稿情報の種別に応じたクラス属性(class="post-?? post ...")を表示する。具体的なクラス名は、投稿ID(post-番号)、投稿種別(postやpage)、カテゴリー(category-名前)、タグ(tag-名前)などがある。これらクラス名に合わせたCSSを準備することで、投稿ページのユニークなデザインが表現可能になる。

get_header(2020年8月18日 更新)

void | false get_header( [ string $name = null [ , array $args = array() ] ] )
ヘッダパーツを記述したメインヘッダファイルheader.php(またはサブヘッダファイルheader-???.php)を読み込む。

get_the_excerpt(2018年5月27日 更新)

string get_the_excerpt( [ mixed $post = null$deprecated = '' ] )
投稿情報の抜粋記事を取得する。