描述

将文本中的两个换行符转换成 HTML 段落 （<p>…</p>），其余的换行转换成 <br />

WordPress 使用这个函数对日志内容和摘要进行格式化处理。

具体用处可参考：如何让wordpress自定义字段编辑器输出的内容自动换行。

用法

<?php wpautop( $foo, $br ); ?>

参数

$foo
(string) (required) 将格式化的文本。
Default: 无

$br
(boolean or integer) (optional) 保留换行符，当设置为 true ，段落转换完成之后余下的换行符将转换成 <br />
HTML 标签，script 和 style 后面的换行符不受影响。
Default: 1

返回值

已经转换成正确段落标签的文本。

注释

可以使用下面的代码取消 WordPress 使用这个函数过滤日志内容和摘要。

remove_filter( 'the_content', 'wpautop' );

remove_filter( 'the_excerpt', 'wpautop' );

源文件

wp-includes/formatting.php