概要
wp_kses_split関数は、コンテンツから無効なタグを分離するために使用されます。この関数は、WordPressのコンテンツフィルタリング機能に関連しており、特に不正なHTMLタグや属性を取り除く際によく利用されます。一般的には、ユーザーが投稿する内容を検証し、安全性を確保する目的で使用されます。以下は、wp_kses_split関数がよく使われるシナリオの例です：
- 投稿内容のフィルタリング
- コメントの投稿の際のセキュリティ対策
- カスタムフィールドの sanitization
- ユーザーがアップロードする画像の説明文の検証
- ウィジェット内のHTMLエディタの検証
- ショートコードの効果を保証するためのサニタイズ
- テーマやプラグインからのセキュリティ強化
- AJAXリクエストに対する入力値の検証
構文
wp_kses_split( string $string, array $allowed_html )
パラメータ
- $string: 検証する文字列
- $allowed_html: 許可するHTMLタグと属性の配列
戻り値
この関数は、検証結果を含む配列を返します。
関連する関数
使用可能なバージョン
この関数はWordPress 4.0以降で使用可能です。
コアファイルのパス
wp-includes/kses.php
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | 〇 |
| template_redirect | |
| get_header | |
| wp_head |
非推奨または削除されたバージョン
wp_kses_split関数は、特定のバージョンで非推奨または削除されていません。