balanceTags

(0.71以降)
balanceTags - タグの付け忘れを調整する

説明

string balanceTags( string $text [ , bool $force = false ] )
タグの付け忘れを調整する。

パラメータ

  • $text
    文字列を指定。
  • $force
    強制的にタグの付け忘れを調整する場合はtrueを指定(省略時はfalse)。

返り値

パラメータ$forceがtrueかオプション'use_balanceTags'の値が1の場合はパラメータ$textについて強制的にタグの付け忘れを調整した文字列を、それ以外の場合は$textの内容をそのまま返す。

注意

本関数は「投稿設定」の「整形」-「不正にネスト化した XHTML を自動的に修正する」の機能そのもの。投稿本文、投稿抜粋、コメント本文について保存(更新)する際にフィルター関数として呼び出される。

なお、実際にタグの付け忘れを調整するのはforce_balance_tags関数である。

使用例

  • 変数$valを調べ、強制的にタグの付け忘れを調整する。
    <?php $val = balanceTags( $val, true ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/formatting.php

関連

お勧めコンテンツ

カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 登録)

カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。

get_postsとquery_postsを使い分け(2011年1月21日 登録)

get_postsquery_postsは、どちらも複数の投稿情報を取得することができる便利な関数である。パラメータとして指定できる内容も共通しているものが多く、query_postsがより詳細なパラメータを指定でき、高機能になっている。

query_posts(WP_Queryクラス)でカスタムフィールドを使う(2011年9月15日 登録)

先週3回にわたってtax_queryパラメータを使ったカテゴリーや投稿タグ、投稿フォーマットの絞り込みを整理したが、その途中で目に付いたのが'meta_query'パラメータ。この'meta_query'パラメータは、カスタムフィールドの絞り込み条件を指定するためのもので、3.2で登場した新しいパラメータのようだ。

ショートコードを含んだページを表示する前に何か処理する(2014年5月28日 登録)

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

全投稿を取得するのはnopaging=1でいい(2011年8月29日 登録)

query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?

最終更新日時 : 2014-02-13 17:21