描述
一组正则表达式替换符用于标识用换行符格式化的文本，并用HTML段落标签替换双换行符。转换后剩余的换行符将变为<br />标签，除非$br设置为“0”或“false”。
参数
$textstring必填-
必须格式化的文本。
$brbool可选-
如果设置，将会转换替换段落后所有剩余的换行符。
<script>、<style>和<svg>标签内的换行符不受影响。默认：
true
返回
string 已转换为正确段落标签的文本。
更多信息
禁用过滤器
一些人选择在其主题的functions.php中禁用wpautop过滤器：
remove_filter( 'the_content', 'wpautop' );
remove_filter( 'the_excerpt', 'wpautop' );
还有一个插件可供启用/禁用过滤器逐篇文章的使用。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 0.71 | 开始引入 |
使用示例
如果在wpautop添加不需要的段落时遇到问题，可以通过将以下内容添加到子主题的functions.php文件中，在页面内容中禁用wpautop：
// Stop WP adding extra <p> </p> to your pages' content remove_filter( 'the_content', 'wpautop' );
基本用法
<?php $some_long_text = // Start Text Some long text that has many lines and paragraphs in it. // end text echo wpautop( $some_long_text ); ?>
这应该与段落周围带有标签的字符串相呼应，如下所示：
<p>Some long text<br/> that has many lines</p> <p>and paragraphs in it.</p>
使用时发出警告。这将在处理长文章时给PHP增加极大的工作量。