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年02月13日 17:21



お勧め

初期状態で「抜粋」ウィジェットを表示する(2014年1月7日 更新)

投稿編集ページのウィジェットは標準で表示されるものとされないものがある。フォーラムに『投稿の編集画面にデフォルトで抜粋を表示させたい』という投稿があったので、ちょっと調べてみた。

親子の固定ページで同じテンプレートを使う(2013年3月20日 更新)

固定ページのテンプレートファイルは「page.php」か、ページ名(スラッグ)または投稿IDを指定したテンプレートファイルになる。固定ページでページデザインが数パターンある場合、通常は「page.php」で振り分けることになるが、もう少しスマートにできないか考えてみた。

全投稿を取得するのはnopaging=1でいい(2011年8月31日 更新)

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

HTML entities button:プラグイン作ってみました(2017年12月17日 更新)

以前投稿した「HTML編集モードに定型文ボタンを追加する」をアレンジして、HTML編集モードに特殊文字(HTMLエンティティ)を挿入できるボタン、顔文字を挿入できるボタン、過去の投稿ページのリンクを挿入できるボタンを追加するプラグインを作ってみました。HTML編集モードの作業効率を向上させるプラグインです。2.1.0では「Dashiconsの挿入」を追加しました。HTML編集モードをメインに使用されている方は、お試しあれ。

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目(2011年7月6日 更新)

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。