質問: 関数呼び出しを文書化する方法 wordpress phpドキュメンテーション標準 を読んでも、add_action( 'foo', 'bar' );のような関数呼び出しを文書化する方法について言及しているところが見当たりません。私は関数呼び出しを文書化するべきです、そして、もしそうなら、どのように?
回答: そのような関数呼び出しのために特別なwordpressコア標準があるならば、それはこのファイルで使われることを期待するでしょう:/wp-includes/default-filters.php フック設定のマザーはを呼び出します。そのファイルを読み飛ばすと、関数呼び出しごとに1行のコメント行しかないことがわかります。// slugs add_filter( 'pre_term_slug', 'sanitize_title' ); いくつかの呼び出しはコメントの下にまとめられています:// mime types add_filter( 'pre_post_mime_type', 'sanitize_mime_type' ); add_filter( 'post_mime_type', 'sanitize_mime_type' ); あるいはこのようにさえ:// format text area for display. foreach ( array( 'term_description' ) as $filter ) { add_filter( $filter, 'wptexturize' ); add_filter( $filter, 'convert_chars' ); add_filter( $filter, 'wpautop' ); add_filter( $filter, 'shortcode_unautop'); } だから私はあなたにあなたのコードのために理にかなっているそしてそれをより読みやすくするのを助けることをするようにあなたに勧めます。また、記述的コールバックを使用して読みやすさを向上させることもできます。例えば:// bad: add_filter( 'the_title', 'wpse_11' ); // better: add_filter( 'the_title', 'wpse_remove_blacklisted_words' );