sanitize_term()


WordPressのsanitize_term()関数は、ターム（カテゴリーやタグなど）のデータをサニタイズするために使用されます。この関数は、データベースに保存される前にタームのフィールドをクリーンアップし、セキュリティを強化します。

構文

sanitize_term( mixed $term, string $taxonomy, string $context = 'display' );

引数の説明:

  • $term (mixed) — サニタイズするタームのオブジェクトまたは配列。
  • $taxonomy (string) — タームが属するタクソノミーの名前。
  • $context (string) — サニタイズのコンテキスト。デフォルトは’display’。

例1: タームの名前をサニタイズする

この例では、特定のタームの名前をサニタイズします。

$term = get_term( get_query_var('cat'), 'category' ); $sanitized_term = sanitize_term( $term, 'category' ); echo $sanitized_term->name;

例2: タームの説明をサニタイズする

この例では、タームの説明をサニタイズして表示します。

$term = get_term_by( 'slug', 'news', 'category' ); $sanitized_term = sanitize_term( $term, 'category' ); echo $sanitized_term->description;

例3: タームのスラッグをサニタイズする

この例では、タームのスラッグをサニタイズします。

$term = get_term_by( 'name', 'Technology', 'post_tag' ); $sanitized_term = sanitize_term( $term, 'post_tag' ); echo $sanitized_term->slug;

例4: タームのメタデータをサニタイズする

この例では、タームのメタデータをサニタイズします。

$term = get_term( 5, 'category' ); $sanitized_term = sanitize_term( $term, 'category' ); print_r( $sanitized_term );

例5: タームの親IDをサニタイズする

この例では、タームの親IDをサニタイズします。

$term = get_term( 10, 'category' ); $sanitized_term = sanitize_term( $term, 'category' ); echo $sanitized_term->parent;

例6: タームのカウントをサニタイズする

この例では、タームのカウント（関連する投稿数）をサニタイズします。

$term = get_term( 15, 'post_tag' ); $sanitized_term = sanitize_term( $term, 'post_tag' ); echo $sanitized_term->count;

例7: タームのフィールドを個別にサニタイズする

この例では、タームの特定のフィールドを個別にサニタイズします。

$term = get_term( 20, 'category' ); $sanitized_name = sanitize_term_field( 'name', $term->name, $term->term_id, 'category', 'display' ); echo $sanitized_name;

例8: タームの全フィールドをサニタイズする

この例では、タームの全フィールドをサニタイズします。

$term = get_term( 25, 'post_tag' ); $sanitized_term = sanitize_term( $term, 'post_tag' ); print_r( $sanitized_term );

注意点

  • サニタイズはデータベースに保存される前に行われるため、表示時に再度サニタイズする必要はありません。
  • コンテキストを適切に設定することで、表示用または編集用のサニタイズを行えます。
  • タームのデータを直接操作する場合は、必ずサニタイズを行ってください。

関連機能：