Документация WordPress

wpautop

Q: wpautop

Функция wpautop() предназначена для автоматического добавления HTML-тегов в текст, который передается в качестве параметра. Она полезна в случаях, когда контент выводится без форматирования, а ручное добавление тегов абзацев неудобно.

Функция wpautop() предназначена для автоматического добавления HTML-тегов  в текст, который передается в качестве параметра. Она полезна в случаях, когда контент выводится без форматирования, а ручное добавление тегов абзацев неудобно.

Как работает `wpautop`

Когда функция получает текст в виде строки, она анализирует его на наличие разрывов строк и вставляет теги . Если в тексте встречаются двойные переводы строк, они интерпретируются как начало нового абзаца. Одинарные переводы строк преобразуются в тег  , если это не противоречит структуре HTML.

Аргументы функции

Функция принимает два параметра:

$pee (string) — текст, который требует автоматического форматирования.
$br (bool) — логическое значение, указывающее, следует ли вставлять теги   вместо одинарных переносов строк (по умолчанию true).

Использование в шаблонах WordPress

Обычно wpautop применяется при выводе контента, полученного из пользовательских полей (get_post_meta), настроек темы или кастомных опций. Например, если в админ-панели есть поле с текстом без HTML-разметки, можно использовать wpautop, чтобы отобразить его в виде удобного форматированного контента.

Таким образом, даже если администратор сайта введет текст без HTML, wpautop автоматически преобразует его в удобочитаемый формат с абзацами и переносами строк.

Когда следует отключать `wpautop`

В некоторых случаях функция может мешать правильному отображению контента, например, при использовании шорткодов или сложной HTML-структуры. Чтобы предотвратить автоматическое добавление тегов , можно использовать remove_filter:

remove_filter('the_content', 'wpautop');

Однако этот метод полностью отключит обработку wpautop для основного контента постов. Если необходимо удалить форматирование только в определенных местах, лучше использовать wpautop вручную, передавая в нее нужные строки.

Функция wpautop значительно упрощает работу с текстами в WordPress, автоматически добавляя разметку абзацев и переносов строк. Ее удобно использовать при выводе пользовательского контента, но следует учитывать случаи, когда она может мешать корректному рендерингу сложных HTML-структур. В таких ситуациях стоит либо отключать wpautop частично, либо контролировать ее применение с помощью фильтров.

theme