wpautop()


WordPressのwpautop()関数は、テキスト内の改行を自動的にHTMLの段落タグ<p>に変換するために使用されます。これにより、テキストの整形が容易になります。

構文

wpautop( string $text, bool $br = true );

引数の説明:

  • $text (string) — 変換するテキスト。
  • $br (bool) — 改行を<br>タグに変換するかどうか。デフォルトはtrue。

例1: 基本的な使用例

この例では、テキストを自動的に段落に変換します。

<?php echo wpautop('これはテストテキストです。\nこれは新しい段落です。'); ?>

例2: 改行を無効にする

この例では、改行を<br>タグに変換しないようにします。

<?php echo wpautop('これはテストテキストです。\nこれは新しい段落です。', false); ?>

例3: 投稿内容を自動整形

投稿内容を自動的に整形して表示します。

<?php echo wpautop(get_the_content()); ?>

例4: カスタムフィールドの内容を整形

カスタムフィールドの内容を自動的に段落に変換します。

<?php echo wpautop(get_post_meta(get_the_ID(), 'custom_field_key', true)); ?>

例5: コメントの内容を整形

コメントの内容を自動的に段落に変換します。

<?php echo wpautop(get_comment_text()); ?>

例6: ショートコード内での使用

ショートコード内でwpautop()を使用してテキストを整形します。

function custom_shortcode() { return wpautop('これはショートコード内のテキストです。'); } add_shortcode('custom', 'custom_shortcode');

例7: フィルターフックでの使用

フィルターフックを使用して、投稿内容を自動的に整形します。

add_filter('the_content', 'wpautop');

例8: 特定の条件で整形を無効にする

特定の条件下でwpautop()の自動整形を無効にします。

remove_filter('the_content', 'wpautop');

注意点

  • wpautop()は、HTMLタグが正しく閉じられていない場合に予期しない結果を引き起こすことがあります。
  • ショートコードや特定のHTML要素内で使用する場合、意図しない整形が行われることがあるため、注意が必要です。

関連機能：