yandex

ACF Pro: кастомные поля

Кастомные поля, типы записей, таксономии и блоки

VS Code с кодом WordPress и ACF PRO на ноутбуке (стиль лофт

Текстовые поля в ACF: настраиваем Text и Textarea, выводим в шаблоне и применяем на практике

70
0
VS Code с кодом WordPress и ACF PRO на ноутбуке (стиль лофт)

Если вы занимаетесь разработкой сайтов на WordPress и хотите сделать редактирование контента по-настоящему удобным — без «костылей» и лишнего HTML в редакторе, — плагин Advanced Custom Fields (ACF) становится одним из главных инструментов в арсенале. Текстовые поля — первый кластер, с которым вы столкнётесь в любой практической задаче: подзаголовок услуги, телефон в шапке, описание товара, SEO-описание страницы.

В этой статье разберём два базовых текстовых поля — Text и Textarea: их настройки, безопасный вывод в шаблонах и главное — правила выбора: какое поле в какой ситуации применять и почему.

Text или Textarea: как выбрать поле

Оба поля хранят чистый текст без HTML, но предназначены для разных типов данных. Разница укладывается в один вопрос: значение занимает одну строку или несколько?

КритерийTextTextarea
Что хранитОднострочное значениеМногострочный текст
Переносы строкНетСохраняются как \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 ?>
Разбор по строкам:
  1. Значение поля записываем в переменную $subtitle — к ней можно обратиться несколько раз без повторных вызовов get_field().
  2. Конструкция if(!empty($subtitle)) проверяет, заполнено ли поле, — иначе в HTML попадёт пустой тег <h2></h2>.
  3. Функция 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() или CSS white-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 — без автоматического форматирования (полный контроль в коде).

Практический пример: блок «Важная информация» с сохранением переносов

Поле: 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 ?>
Разбор по строкам:
  1. Значение поля записываем в переменную $notes и проверяем на пустоту — как и в примере с Text.
  2. esc_html($notes) экранирует спецсимволы и защищает от XSS.
  3. 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: диапазоны, шаги и валидацию значений — с такими же подробными примерами и готовыми решениями. Подписывайтесь и следите за обновлениями, чтобы не пропустить новые гайды.

VS Code с кодом WordPress и ACF PRO на ноутбуке (стиль лофт
следующая

Числовые поля в ACF PRO: работаем с Number и Range — настройка диапазонов, валидация и практические кейсы

коментарии
0 0 голоса
Рейтинг статьи
Подписаться
Уведомить о
guest
0 комментариев
Старые
Новые Популярные