Текстовые поля в ACF: настраиваем Text и Textarea, выводим в шаблоне и применяем на практике
Если вы занимаетесь разработкой сайтов на WordPress и хотите сделать редактирование контента по-настоящему удобным — без «костылей» и лишнего HTML в редакторе, — плагин Advanced Custom Fields (ACF) становится одним из главных инструментов в арсенале. Текстовые поля — первый кластер, с которым вы столкнётесь в любой практической задаче: подзаголовок услуги, телефон в шапке, описание товара, SEO-описание страницы.
В этой статье разберём два базовых текстовых поля — Text и Textarea: их настройки, безопасный вывод в шаблонах и главное — правила выбора: какое поле в какой ситуации применять и почему.
Text или Textarea: как выбрать поле
Оба поля хранят чистый текст без HTML, но предназначены для разных типов данных. Разница укладывается в один вопрос: значение занимает одну строку или несколько?
| Критерий | Text | Textarea |
|---|---|---|
| Что хранит | Однострочное значение | Многострочный текст |
| Переносы строк | Нет | Сохраняются как \n |
| Типовые данные | Подзаголовок, телефон, артикул, промокод, теглайн | Описание товара, SEO-description, технические заметки, блок «Важная информация» |
| Куда чаще всего выводится | В заголовки, атрибуты, meta-теги, микроразметку | В абзацы контента, метатеги, JSON-LD |
| Обработка переносов | Не нужна | Нужна: wpautop(), nl2br() или CSS |
Практические правила выбора:
- Точное короткое значение без переносов — Text. Артикул, номер телефона, промокод, слоган, подзаголовок. Такие данные важно защитить от «творчества» редактора: одна строка, никаких стилей, легко валидировать по длине.
- Многострочный текст без форматирования — Textarea. Описания, комментарии, заметки. Редактор пишет текст с переносами, а вы решаете в коде, как их отобразить.
- Текст с форматированием (жирный, списки, ссылки) — ни то, ни другое. Для контента, которым редактор управляет сам, нужен WYSIWYG или Gutenberg-блоки. Text и Textarea — про данные, а не про вёрстку.
- Значение вставляется в атрибут, метатег или JSON — Text или Textarea с чистым текстом. Именно за это их ценят в микроразметке и SEO: в JSON-LD не должно оказаться случайного
<p>из WYSIWYG.
Короткая проверка перед созданием поля: если редактор не должен управлять внешним видом значения — берите Text или Textarea; если текст — часть контента, который он верстает, — это уже WYSIWYG.
Поле Text: что это и зачем нужно
Text в ACF — однострочное текстовое поле. В отличие от Textarea (многострочный текст) или WYSIWYG (редактор с форматированием), оно предназначено для коротких значений, где важна точность и отсутствие форматирования:
- подзаголовок или слоган;
- артикул, SKU, код товара;
- номер телефона, e-mail;
- короткое описание для микроразметки.
Почему это удобно:
- Чистота данных. Нет лишнего HTML, переносов строк и стилей.
- Простота вывода. Достаточно одной строки кода.
- Гибкость. Значение можно использовать в заголовках, meta-тегах, микроразметке Schema.
Настройки поля Text
- Field Name — машинное имя (латиница, без пробелов, например
service_subtitle). - Label — название для редактора (например, «Подзаголовок услуги»).
- Instructions — подсказка для редактора (например, «Введите короткий подзаголовок до 60 символов»).
- Required — включите, если поле обязательно.
- Default Value — значение по умолчанию (если уместно).
- Placeholder — текст-подсказка внутри поля (например, «Например: Быстро, качественно, надёжно»).
- Character Limit — жёсткий лимит символов прямо в интерфейсе ACF. Полезно для полей, которые попадут в метатеги: там лимит фактически задаётся поисковой выдачей.
Практический пример: подзаголовок услуги
Поле: service_subtitle. Вывод в шаблоне:
<?php $subtitle = get_field('service_subtitle') ?>
<?php if(!empty($subtitle)): ?>
<h2 class="service-subtitle"><?php echo esc_html($subtitle) ?></h2>
<?php endif ?>Разбор по строкам:
- Значение поля записываем в переменную
$subtitle— к ней можно обратиться несколько раз без повторных вызововget_field(). - Конструкция
if(!empty($subtitle))проверяет, заполнено ли поле, — иначе в HTML попадёт пустой тег<h2></h2>. - Функция
esc_html($subtitle)экранирует данные и защищает от XSS-уязвимостей.
Остальные сценарии применения строятся по этой же схеме — меняется только контекст экранирования: для телефонной ссылки в шапке используйте esc_attr() в атрибуте href="tel:..." и esc_html() в тексте ссылки, для значений в JSON-LD — esc_js(). Суть вывода поля Text всегда одна: получили значение, проверили на пустоту, экранировали под контекстом.
Поле Textarea: что это и зачем нужно
Textarea в ACF — многострочное текстовое поле. Оно сохраняет переносы строк как символы \n и не добавляет автоматически HTML-теги. В отличие от WYSIWYG, здесь нет встроенного редактора форматирования — и это плюс для предсказуемости данных.
Типовые кейсы использования:
- Развёрнутое описание товара. Для блока «Характеристики» или «Детали», где важен чистый текст без лишних стилей.
- Технические заметки для редактора. Поле только для внутреннего использования: комментарии к странице, задачи на доработку, ссылки на задачи в трекере.
- SEO-описание (meta description). Когда нужно вручную задать описание под конкретный запрос, без риска, что редактор добавит туда лишние теги.
- Блок «Важная информация» или «Как добраться». Текст с переносами строк, который удобно верстать через
wpautop()или CSSwhite-space. - Текст для микроразметки Schema.org. Чистый текст без HTML лучше ложится в свойства типа
description,reviewBodyи т. п.
Преимущества Textarea:
- Чистый вывод. Нет «мусорного» HTML, как в WYSIWYG.
- Контроль над форматированием. Вы сами решаете, как отображать переносы строк.
- Безопасность. Проще экранировать и валидировать.
- Совместимость с фильтрами. Удобно применять
wpautop(),wptexturize(),nl2br(). - Гибкость хранения. Можно сохранять длинные тексты, не раздувая базу лишними тегами.
Настройки поля Textarea
- Field Name — машинное имя (латиница, без пробелов, например
product_long_description). - Label — название для редактора (например, «Развёрнутое описание»).
- Instructions — подсказка для редактора: «Введите текст без HTML. Переносы строк сохраняются. Лимит 800 символов».
- Required — включите, если поле обязательно к заполнению.
- Default Value — значение по умолчанию (если уместно).
- Placeholder — текст-подсказка внутри поля: «Например: Подробно опишите преимущества и особенности…».
- Rows — количество строк в интерфейсе (обычно 4–8, чтобы было удобно читать).
- New Lines — как обрабатывать переносы:
- Automatically add paragraphs — при выводе применится
wpautop()(аналог<p>); - Convert line breaks — переносы заменятся на
<br>; - No formatting — без автоматического форматирования (полный контроль в коде).
- Automatically add paragraphs — при выводе применится
Практический пример: блок «Важная информация» с сохранением переносов
Поле: important_notes. Задача — показать текст с явными переносами строк:
<?php $notes = get_field('important_notes') ?>
<?php if($notes): ?>
<div class="important-notes">
<?php echo nl2br(esc_html($notes)) ?>
// Заменяет \n на <br>, экранирует спецсимволы
</div>
<?php endif ?>Разбор по строкам:
- Значение поля записываем в переменную
$notesи проверяем на пустоту — как и в примере с Text. esc_html($notes)экранирует спецсимволы и защищает от XSS.nl2br()превращает переносы строк\nв теги<br>— редактор видит текст абзацами, как писал его в админке.
Обратите внимание на порядок: сначала экранирование, потом nl2br(). Если сделать наоборот, экранирование затронет уже добавленные теги <br> и на странице появятся их экранированные сущности вместо переносов.
Если нужен полноценный вывод абзацами, а не <br> после каждой строки — используйте wp_kses_post(wpautop($desc)): wpautop() автоматически добавит теги <p>, а wp_kses_post() оставит только безопасный набор HTML. Тот же чистый текст можно отдать в метатег description (там переносов и wpautop() быть не должно — метатег обязан быть одной строкой) или в JSON-LD через esc_js() — схема вывода не изменится.
Частые ошибки и как их избежать
| Ошибка | Как исправить |
|---|---|
| Вывод без экранирования | Всегда используйте esc_html() для текста, esc_attr() для атрибутов, esc_js() для JSON |
| Хранение длинных текстов в Text | Используйте Textarea или WYSIWYG |
| Хранение HTML-тегов в Textarea | Для форматирования — WYSIWYG или Gutenberg-блоки; Textarea — только чистый текст |
| Полагаться на настройку «New Lines» в сложных шаблонах | Управляйте переносами явно в коде: wpautop(), nl2br() или CSS |
| Неинформативные имена полей | Делайте понятные machine names: seo_title, promo_code, а не field_123 |
| Отсутствие инструкций для редактора | Пишите понятные подсказки в Instructions и прописывайте лимиты символов |
| Отсутствие проверки значения | Используйте if(!empty()), не выводите пустые теги и контейнеры |
Чек-лист перед публикацией
- Поле выбрано по правилу «одна строка — Text, многострочный текст — Textarea, форматирование — WYSIWYG».
- Field Name — латиница без пробелов, отражает смысл значения.
- Instructions содержат подсказку и лимит символов для редактора.
- Вывод в шаблоне: проверка на пустоту + экранирование под контекстом.
- Для Textarea выбрана осознанная стратегия переносов (настройка New Lines или явная обработка в коде).
Заключение
Текстовые поля Text и Textarea в ACF PRO — простые, но мощные инструменты, которые делают работу с контентом на WordPress предсказуемой и безопасной. Text закрывает короткие точные значения, Textarea — многострочный текст с полным контролем над переносами. Главное — соблюдать базовые практики: понятные названия полей, чёткие инструкции для редакторов и обязательное экранирование при выводе.
Тема ACF PRO очень обширна, и текстовые поля — только начало: впереди ещё много интересного — поля Email, URL и Password, поля выбора, Repeater для повторяющихся блоков, ACF Blocks для интеграции с Gutenberg и многое другое. В следующей публикации мы разберём числовые поля Number и Range: диапазоны, шаги и валидацию значений — с такими же подробными примерами и готовыми решениями. Подписывайтесь и следите за обновлениями, чтобы не пропустить новые гайды.
коментарии