allowed_tags()

allowed_tags()の用途

allowed_tags() は、WordPressの投稿やコメントで使用できるHTMLタグの一覧を表示する関数です。

allowed_tags()の基本情報

allowed_tags()の機能と用途

この関数は、主にコメント投稿フォームや投稿欄の下部などで、「利用可能なHTMLタグ」の説明を表示するために使われます。

出力例（実際のHTML）

You may use these HTML tags and attributes: <a href="" title=""></a> <abbr title=""></abbr> ...

※出力内容は、wp_kses_allowed_html() によって許可されているHTMLタグと属性に基づいて生成されます。

allowed_tags()の内部処理の簡易構造

function allowed_tags() {
    global $allowedtags;
    echo '<p>' . __('You may use these HTML tags and attributes:') . ' <code>' . htmlentities( implode(' ', array_keys($allowedtags) ) ) . '</code></p>';
}

解説ポイント

• $allowedtags は、WordPress コアが定義する「許可されたタグと属性」の配列（$allowedtags = wp_kses_allowed_html( 'post' ); など）です。
• implode() でタグ名を連結し、<code> タグ内にHTMLエスケープして出力しています。

allowed_tags()の使用シーン

allowed_tags()の注意点

• 出力専用の関数であり、返り値は得られません。
• マルチバイト属性や独自タグなどは出力されません。
• WordPressのHTMLフィルタリング機構（kses）の仕様に依存するため、WordPress本体のバージョンやプラグインによって内容が変わることがあります。

allowed_tags()のカスタマイズ例

より詳細に表示したい場合や、返り値を得たい場合は、wp_kses_allowed_html() を使って自作することが可能です：

$tags = wp_kses_allowed_html( 'post' );
foreach ( $tags as $tag => $attributes ) {
    echo '<' . $tag;
    if ( is_array($attributes) ) {
        foreach ( $attributes as $attr => $value ) {
            echo ' ' . $attr;
        }
    }
    echo '> ';
}

allowed_tags()のまとめ