_doing_it_wrong

説明

void _doing_it_wrong( string $function, string $message, string $version )
不適切な関数などの呼び出しをマークする。

パラメータ

  • $function
    呼び出し元(__FUNCTION__、__METHOD__、__CLASS__)を指定。
  • $message
    メッセージを指定。
  • $version
    WordPressバージョンで指定。

返り値

返り値はありません。

注意

WordPressの仕様変更にともなって使い方が変わった関数やメソッドなどが呼び出された場合、デバッグモード時(定数WP_DEBUGと'doing_it_wrong_trigger_error'フィルターがともにtrueの場合)ならPHPのtrigger_error関数を使って通知メッセージを生成する。

[5.4.0](システム内部向けの)プライベート関数から一般の関数へ変更された。


使用例

  • 不適切な関数の呼び出しをマークする
    <?php _doing_it_wrong( __FUNCTION__, $message, '5.4.0' ); ?>

フィルター

[3.1.0]WP_DEBUGがtrueで定義されている場合、'doing_it_wrong_trigger_error'フィルターを呼び出す。パラメータ$triggerにはtrueが格納されている。[5.1.0]本関数が受け取った$function$message$versionが追加された。
apply_filters( 'doing_it_wrong_trigger_error', $trigger, $function, $message, $version )

アクション

[3.1.0]はじめに'doing_it_wrong_run'アクションを呼び出す。パラメータには本関数が受け取った内容が格納されている。
do_action( 'doing_it_wrong_run', $function, $message, $version );

ソースファイル

/wp-includes/functions.php

最終更新 : 2020年07月24日 12:51


お勧め

query_posts(WP_Queryクラス)でカテゴリーを絞り込む(2011年9月14日 更新)

久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。

「順序」をtextからnumberに変更してみた(2018年5月27日 更新)

固定ページの編集画面の「投稿の属性」ウィジェットには、ページの並び替えに使用できる「順序」のinput要素がある。この「順序」のinput要素はtype属性が'text'となっており、編集の際にIMEが有効になってしまう場合がある。ページの編集頻度が多くなると、その都度IMEをオフにするのがやや面倒になってくる。

投稿内容のid属性などを保存するための対策(2012年6月15日 更新)

WordPress 3.4にアップデートしたとある環境で投稿記事を保存すると、divタグなどのid属性がクリアされて保存するようになった(id属性が保存できなくなった)。ここでは、その対策方法の1つを紹介しておく。

oEmbedについて考えてみた(2018年5月27日 更新)

本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。

Google Mapsブロックを作る過程で悩んだ件(2022年8月23日 更新)

自分なりのGoogle Mapsブロックを作るべく、カスタムHTMLブロックをベースにいくつかのパラメータ要素をサイドバーに追加していく。Google Maps用のAPIキーについてはオプションデータ(wp_optionsテーブル)に格納して利用していこうと思ったのだが、その方法がさっぱりわからなかった。