remove_filter

説明

bool remove_filter( $tag, mixed $function_to_remove [ , int $priority = 10 [ , int $accepted_args = 1 ] ] )
WordPressタグに登録されているフィルターを削除する。

パラメータ

  • $tag
    WordPressタグ名
  • $function_to_remove
    フィルター関数を示す名前(文字列)または配列
  • $priority
    フィルター関数のプライオリティ値(省略時は10)
  • $accepted_args
    フィルター関数のパラメータ数(省略時は1)

返り値

フィルター関数を削除できた場合はtrue、削除できなかった(登録されていなかった)場合はfalseを返す。

注意

パラメータ$priorityを省略した場合は10となる。フィルターを削除する際、プライオリティ値が一致しないと削除されない。

[3.5.0]パラメータ$accepted_argsは、使用されなくなった。


使用例

  • WordPressタグ'the_title'に登録されているフィルター'trim'を削除する。
    <?php remove_filter( 'the_title', 'trim' ); ;>
  • 'comment_text'フィルターの'convert_smilies'を削除する。
    <?php remove_filter( 'comment_text', 'convert_smilies', 20 ); ;>

フィルター

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

アクション

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

ソースファイル

/wp-includes/plugin.php

最終更新 : 2016年06月01日 08:59



お勧め

LevelとCapability(2011年4月14日 更新)

プラグインやテーマの管理ページを作成する際など、ユーザのレベルと権限を確認することがある。ここでは、権限グループ別のレベルと権限の有無を整理してみた。

プラグインのヘッダー情報を国際化対応しよう(2017年8月4日 更新)

バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。

投稿一覧に独自リンクを追加する(2013年10月16日 更新)

管理者ページの「投稿一覧」や「固定ページ一覧」の各投稿記事はマウスポインタを移動すると、「編集」や「クイック編集」といったリンクが表示される。このリンクに独自のリンクを追加する方法を調べてみた。

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

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

canvasタグを投稿したい(2013年12月27日 更新)

以前「投稿内容のid属性などを保存するための対策」で取り上げたように、WordPressでは投稿に記述できるHTMLタグが制限されている。同コラムでこの制限を調整する対策を紹介しているが、3.5以降ではフィルター関数を登録して対応できるようだ。