Как использовать плагин Advanced Custom Fields (ACF)

Плагин Advanced Custom Fields (ACF) пользуется огромной популярностью у пользователей сайтов на WordPress — более чем миллион активных установок!

Плагин ACF предоставляет возможность создать расширенный пользовательский интерфейс для добавления пользовательских полей в WordPress. Его главное преимущество заключается в том, что расширенные настраиваемые поля имеют более 20 различных предустановок, что делает их создание намного быстрее и проще.

Пресеты включают:

Text-однострочное текстовое поле с дополнительной поддержкой HTML и ограничением символов.

Text Area — как текст, но с несколькими строками.

Number – числовое поле, которое может иметь необязательные значения min / max

Email — настраиваемое поле для ввода электронной почты, включая валидацию.

Password — ввод пароля с текстовой маскировкой.

WYSIWYG Editor — WordPress редактор ввода с опциями для вставки медиа и кнопки редактора.

Image — загрузить изображение или выбрать его из медиа-библиотеки. Возвращает объект, URL или ID.

File — то же, что и изображение, но для файлов в целом.

Select — выпадающее меню с поддержкой множественного выбора.

Checkbox — флажок для одного или нескольких элементов.

Radio Button — выбор одного элемента с помощью переключателя.

True / False — базовый селектор true или false.

Page Link — возвращает URL-адрес любой записи или страницы.

Post Object — возвращает WordPress объект любого поста или страницы, типа поста или таксономии.

Taxonomy — возвращает объект или идентификатор для одной или нескольких таксономий. Может быть ограничено тегами, категориями или пользовательскими терминами таксономии.

User — выберите одного или нескольких пользователей. Возможность ограничить выбор ролью пользователя.

Google Map — установка центра, уровня масштабирования и ширины.

Date Picker — выбирает дату в календаре и возвращает отформатированную строку даты.

Color Picker — выбор шестнадцатеричного цвета.

Message — оставить сообщение.

Tab — объединить поля в интерфейс с вкладками.

Помимо этих удобных пресетов, плагин также позволяет создать правила, чтобы определить, где они будут отображаться внутри WordPress.

Таким образом, вы можете показывать только настраиваемые поля в определенных категориях сообщений.

Ряд доступных расширений добавляет еще больше функциональности. Некоторые из них:

Advanced Custom Fields: Nav Menu Field: поле меню навигации-добавляет поле для настройки настраиваемых меню для сообщений и страниц.

ACF: Sidebar Selector — позволяет выбрать зарегистрированную боковую панель WordPress.

Другие решения премиум-класса:

Repeater Field — позволяет пользователям создавать сложные макеты с любым количеством полей.

Gallery Field — предоставляет интерфейс для управления коллекцией изображений.

Options Page — создайте страницу пользовательских параметров для панели управления WordPress, хорош для сбора данных по всему сайту.

Flexible Content — настройка нескольких макетов с несколькими полями, которые можно использовать в любом порядке на странице.

Теперь мы подробно рассмотрим, как установить и использовать плагин для реализации пользовательских полей WordPress на вашем сайте WordPress.

Как Установить Advanced Custom Fields

Advanced Custom Fields устанавливается также, как и любой другой плагин WordPress. Перейдите в раздел Плагины > Добавить новые и найдите Advanced Custom Fields.

Нажмите кнопку «Установить», а затем активируйте плагин.

Кроме того, можно также загрузить Advanced Custom Fields из каталога WordPress, а затем загрузить их на свой сайт
через FTP.

В любом случае, новый пункт под названием «Группы полей» теперь должен появиться в вашей админ-панели WordPress.

Как Использовать Плагин ACF

Теперь начинается настоящая работа. Но ничего сложного в ней нет. Создание пользовательских полей с помощью плагина — это очень просто.

Для этого урока я создам группу настраиваемых полей для типа post под названием books.

В частности, я хочу добавить следующие данные:

Год выхода книги
Автор книги
Рейтинг книги (из десяти)

Давайте начнем.

Создание Новой Группы Полей

Группа полей — это группа настраиваемых полей, которые локально принадлежат друг другу.

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

Создание групп полей является основной функцией Advanced Custom Fields. Конечно, группа может содержать только одно поле, но это терминология, которую они выбрали.

Чтобы создать его, нажмите «группы полей» в админ-панели WordPress. В меню, в которое вы попадаете, отображаются все созданные Вами группы полей. Сначала он будет полностью пуст. Чтобы изменить это, найдите кнопку «Добавить» вверху и нажмите ее. Появятся следующие поля:

Выглядит немного сложно, но как только вы прошли через процесс один раз, вы поймете все, что нужно.

Пока что, просто введите имя для вашей группы полей вверху. После этого мы можем перейти к добавлению полей в группу.

Добавление И Настройка Полей

Чтобы начать добавлять поля в свою группу, просто нажмите большую синюю кнопку Добавить поле.

Откроется следующая форма:

Вот что означает каждое из полей в форме:

Ярлык поля — имя, отображаемое в меню.

Имя поля — имя, используемое внутри шаблонов и кода. Должен автоматически заполняться меткой. Между словами не должно быть пробелов, только дефисы и подчеркивания.

Тип поля — можно выбрать из выпадающего списка (текст, число, изображение и т.д.).

Инструкции — оставьте инструкции по использованию поля.

Обязательное — требуется определить, является ли это поле обязательным для заполнения. Если да, авторы не смогут сохранять записи или страницы, связанные с настраиваемым полем, если они пусты.

Значение по умолчанию — это значение будет автоматически заполнять поле при создании записи.

Текст заглушки — отображается в полях ввода на экране редактирования.

Текст перед/после полем— определяет текст, отображаемый до и после ввода текста.

Ограничение на количество символов — при необходимости поставить ограничение на количество символов, которое можно ввести.

Условная логика -правила для отображения полей.

Минимальное и максимальное значение — минимальное и максимальное число, разрешенное внутри поля.

Шаг изменения — определяет шаг, на который нужно уменьшить или увеличить число при нажатии на стрелки.

Закрыть поле — свернуть просматриваемое поле для настройки других .

Атрибуты — класс, ширина или id поля.

Имейте в виду, что не все из этих вариантов могут отображаться. Например, минимальное и максимальное значение, а также размер шага доступны только для числовых полей.

Есть и другие варианты для других типов полей, но мы не будем вдаваться в них в этот момент.

Моя собственная настройка выглядит так:

Я делаю это поле обязательным, потому что хочу, чтобы авторы заполнили его обязательно.

Добавлю еще одно поле в группу

Как видите, я даю четкие инструкции о том, как использовать это поле.

И еще одно поле

Поскольку шкала рейтинга от одного до десяти, имеет смысл ограничить поле этими числами, чтобы никто не мог вводить что-либо еще.

Теперь вы можете закрыть поля, чтобы увидеть всю группу.

Условия отображения И Настройки

Прежде чем мы закончим здесь, нам нужно настроить, где и как будут отображаться вновь созданные поля, и мы делаем это с помощью панели » Условия отображения» и «Настройки».

В разделе «Условия отображения» можно добавить правила, определяющие, при каких обстоятельствах будут отображаться поля.

В моем случае я хочу ограничить свою группу полей типом публикации книги, поэтому выберите тип публикации > равно > запись.

После этого перейдем к вариантам. Здесь все интуитивно понятно, «Скрыть на экране» — флажки, которые позволяют скрыть другие панели, которые вам не понадобятся, такие как теги, категории, комментарии и многое другое.

Выберите то, что подходит для вашего случая. Когда закончите, нажмите кнопку «Опубликовать» сверху справа .

После этого вы можете перейти к записи, чтобы увидеть, появляются ли новые мета-поля.

Теперь все, что осталось, это отобразить ваши пользовательские поля на странице. Для этого добавьте немного тестовых данных и опубликуйте свой пост — пришло время покопаться в коде и отредактировать некоторые файлы темы.

Как Отобразить Произвольные Поля ACF В WordPress

Для отображения настраиваемых полей на сайте необходимо вызвать их в файле шаблона. Проверьте иерархию шаблонов WordPress, если вы не уверены, какой из них подходит именно вам.

Мы добавляли поля к записям, поэтому нам нужен файл single.php. Откроем его с помощью FTP.

Теперь пришло время вызвать наши новые метаданные, это можно сделать с помощью get_post_meta (), но рекомендуется использовать собственные функции ACF, с которыми можно познакомиться на сайте https://www.advancedcustomfields.com
/resources/#functions.

Здесь мы видим примеры вывода для каждого произвольного поля.

В этом случае я буду использовать текстовое поле (text) — функция the_field () позволяет мне отображать пользовательские поля для текущей записи.

Создадим свой собственный div и добавим разметку, код будет выходит так:

<div class="book-meta">
<ul>
                    <li><strong>Author:</strong> <?php the_field('автор'); ?></li>
                    <li><strong>Release Year:</strong> <?php the_field('release_year'); ?></li>
                    <li><strong>Book Rating:</strong> <?php the_field('book_rating'); ?>/10</li>
</ul>
</div>

Добавляем код в то место записи, где хотим видеть наши поля .

Видим, что все получилось.

Как Использовать Advanced Custom Fields?

Настраиваемые поля позволяют легко расширять содержимое любым возможным способом.

В сочетании с пользовательскими типами записей они позволяют создавать именно тот сайт, который вам нужен, с точными данными, которые вы хотите отобразить.

Плагины, такие как Advanced Custom Fields, позволяют даже новичкам использовать эту мощную функцию на своем сайте и сделать это не сложнее, чем заполнить форму.

Хотя есть и другие плагины с аналогичной функциональностью, Advanced Custom Fields является любимым среди разработчиков.

Если вы хотите начать работу с пользовательскими полями, приведенной выше информации более чем достаточно, чтобы начать работу и настроить свои собственные и веб-сайты ваших клиентов новыми и мощными способами.

Конфликты плагинов WordPress