- Вывод произвольных полей ACF
- Типы полей — текст, число, область текста, файл, медиа
- Тип поля — «Изображение»
- Ссылка на изображение (URL)
- ID изображения
- Массив изображения
- Тип поля — «Галерея»
- Тип поля — «Повторитель»
- Тип поля — «Объект записи»
- Тип поля — «Группа»
- Вывод поля ACF только при условии, что оно заполнено
- Вывод полей ACF с другой страницы
- Вывод полей ACF из терминов таксономии
- Вывод полей ACF для профиля пользователя
- Страница опций ACF
- Вывод полей «Страницы опций»
- Вложенные страницы с опциями
- Дополнительные плюшки
- Примеры кода
- Вывести поле
- Вернуть поле в переменную
- Использование условных выражений
- Работа с Массивами
- Работа с Изображениями – Ссылка
- Работа с Изображениями – ID
- Работа с Повторителем
- Выбор случайных значений из Повторителя
- Получение значения с другой страницы
- Query posts со значениями ACF
- Image
- Description
- Screenshots
- Changelog
- Settings
- Template usage
- Display image (ID)
- Display image (array)
- Customized display (array)
- Display image (URL)
- Изображение (Image)
- Обзор
- Скриншоты
- Настройки
- Использование в шаблоне
- Базовый вывод (ID)
- Базовый вывод (массив)
- Продвинутый вывод (массив)
- Базовый вывод (Ссылка на изображение)
Вывод произвольных полей ACF
Рассмотрим вывод произвольных полей, созданных в Advanced Custom Fields для WordPress. А так же, как вывести произвольные поля для терминов таксономии, например, «Рубрики» в шаблоне category.php
Типы полей — текст, число, область текста, файл, медиа
Чтобы вывести текст , область текста , число , файл или медиа , воспользуйтесь кодом ниже.
Тип поля — «Изображение»
Ссылка на изображение (URL)
Данный способ вывода изображения не позволяет вывести дополнительные данные об изображении. Только URL. Используйте следующий код.
ID изображения
При выборе формата вывода — ID изображения , используется функция wp_get_attachment_image() .
Массив изображения
- — вывод URL изображения (полный размер);
- — вывод URL изображения (thumbnail, medium, large или кастомный);
- — вывод alt изображения;
- — вывод заголовка изображения;
- — вывод подписи изображения.
Тип поля — «Галерея»
Рассмотрим возвращаемый формат — массив изображения.
Использование очень похоже на вывод изображений, за исключением использования цикла foreach() .
Тип поля — «Повторитель»
Для вывода повторителя, используйте код ниже.
Тип поля — «Объект записи»
Для вывода нескольких значений «Объекта записи» используйте следующий код.
Тип поля — «Группа»
Пусть вложенное поле будет изображением. Чтобы вывести вложенные поля с типом «Группа», воспользуйтесь следующим кодом.
Вывод поля ACF только при условии, что оно заполнено
Для выполнения проверки заполнено ли поле, используйте get_field() .
Вывод полей ACF с другой страницы
Для вывода полей с другой страницы нужно просто добавить id необходимой страницы/записи.
Вывод поля для родительской страницы.
Вывод полей ACF из терминов таксономии
Если мы создадим произвольное поле для элемента таксономии рубрики.
Оно (поле) у нас благополучно появится в рубриках
Но когда мы захотим его вывести в шаблоне рубрики category.php , то у нас ничего не получится.
Необходимо использовать следующий код.
Вывод полей ACF для профиля пользователя
Выведем ACF поля, созданные для вкладки профиль пользователя страницы «Пользователи».
Получение поля для текущего пользователя.
Вывод поля для пользователя с id = 8 .
Страница опций ACF
Для создания страницы опций ACF добавьте следующий код в functions.php :
Теперь необходимо создать нужные поля. Переходим в «Группы полей». Выбираем «Отображать группу полей, если» — Формы — Страница с опциями равно Настройки темы . И добавляеете поля как обычно.
Вывод полей «Страницы опций»
Для вывода полей, заполненных на странице опций, используйте код:
Вложенные страницы с опциями
Более сложный пример с вложенными страницами:
Дополнительные плюшки
- Шпаргалка по работе с WordPress.
- Шпаргалка по работе с WooCommerce.
- Как скрыть пункты меню в админке WordPress, изменить их порядок — статья.
- Как установить свой логотип при входе в админку WordPress вместо стандартного.
- Подборка лучших плагинов для WordPress на 2021 год.
Надеюсь, вам понравилась данная информация. Если вам интересна тема web-разработки, то можете следить за выходом новых статей в Telegram.
Источник
Примеры кода
Ниже представлены примеры реализации кода с использованием плагине Advanced Custom Fields: Вывести поле, Вернуть поле в переменную, Использование условных выражений, Работа с Массивами, Работа с Изображениями, Работа с Повторителем и т.д.
Вывести поле
Вернуть поле в переменную
Использование условных выражений
get_field вернет false, если (value == “” || value == null || value == false)
Работа с Массивами
для типов полей: чекбокс, выбор, взаимоотношение, повторитель
Работа с Изображениями – Ссылка
Работа с Изображениями – ID
При помощи ID вы можете получить нужный размер изображения и даже имя файла!
Работа с Повторителем
Повторитель может получить get_field или the_repeater_field / the_sub_field
Выбор случайных значений из Повторителя
Получение значения с другой страницы
Query posts со значениями ACF
Для примера, найдем Events (тип записи) в котором находиться location (произвольное поле — выбор) равное Melbourne (значение поля).
Больше информации тут (англ.): codex.wordpress.org/Template_Tags/get_posts .
Интернет-магазин «acfwp.ru», расположенный на доменном имени acfwp.ru, именуемое в дальнейшем «Продавец», публикует Публичную оферту о продаже Товара дистанционным способом.
- ОПРЕДЕЛЕНИЕ ТЕРМИНОВ
1.1. Публичная оферта (далее – «Оферта») — публичное предложение Продавца, адресованное неопределенному кругу лиц, заключить с Продавцом договор купли-продажи товара дистанционным способом (далее — «Договор») на условиях, содержащихся в настоящей Оферте, включая все Приложения.
1.2. Заказ Товара на сайте Интернет-магазина – позиции, указанные Покупателем из ассортимента Товара, предложенного к продаже, при оформлении заявки на приобретение Товара на сайте Интернет-магазина или через Оператора.
- ОБЩИЕ ПОЛОЖЕНИЯ
2.1. Заказ Покупателем Товара, размещенного на сайте Интернет-магазина означает, что Покупатель согласен со всеми условиями настоящей Оферты.
2.2. Администрация сайта Интернет-магазина имеет право вносить изменения в Оферту без уведомления Покупателя.
2.3. Срок действия Оферты не ограничен, если иное не указано на сайте Интернет-магазина.
2.4. Продавец предоставляет Покупателю полную и достоверную информацию о Товаре, включая информацию об основных потребительских свойствах Товара, месте изготовления, а также информацию о гарантийном сроке и сроке годности Товара на сайте Интернет магазина, в разделе Контакты.
3.1. Цена на каждую позицию Товара указана на сайте Интернет-магазина.
3.2. Продавец имеет право в одностороннем порядке изменить цену на любую позицию Товара.
3.3. В случае изменения цены на заказанный Товар Продавец обязуется в течение 10 дней проинформировать Покупателя об изменении цены Товара.
3.4. Покупатель вправе подтвердить либо аннулировать Заказ на приобретение Товара, если цена изменена Продавцом после оформления Заказа.
3.5. Изменение Продавцом цены на оплаченный Покупателем Товар не допускается.
3.6. Продавец указывает стоимость доставки Товара на сайте Интернет-магазина либо сообщает Покупателю при оформлении заказа Оператором.
3.7. Обязательства Покупателя по оплате Товара считаются исполненными с момента поступления Продавцом денежных средств.
3.8. Расчеты между Продавцом и Покупателем за Товар производятся способами, указанными на сайте Интернет-магазина в разделе Контакты
- ОФОРМЛЕНИЕ ЗАКАЗА
4.1. Заказ Товара осуществляется Покупателем сервис сайта Интернет-магазина acf.acfwp.ru.
4.2. При регистрации на сайте Интернет-магазина Покупатель обязуется предоставить следующую регистрационную информацию:
4.2.1. фамилия, имя, отчество Покупателя или указанного им лица (получателя);
4.2.2. адрес, по которому следует доставить Товар (если доставка до адреса Покупателя);
4.2.3. адрес электронной почты;
4.2.4. контактный телефон.
4.3. Наименование, количество, ассортимент, артикул, цена выбранного Покупателем Товара указываются в корзине Покупателя на сайте Интернет-магазина.
4.4. Если Продавцу необходима дополнительная информация, он вправе запросить ее у Покупателя. В случае не предоставления необходимой информации Покупателем, Продавец не несет ответственности за выбранный Покупателем Товар.
4.6. Принятие Покупателем условий настоящей Оферты осуществляется посредством внесения Покупателем соответствующих данных в регистрационную форму на сайте Интернет-магазина или при оформлении Заказа через Оператора. После оформления Заказа через Оператора данные о Покупателе регистрируются в базе данных Продавца. Утвердив Заказ выбранного Товара, Покупатель предоставляет Оператору необходимую информацию в соответствии с порядком, указанном в п. 4.2. настоящей Оферты.
4.7. Продавец не несет ответственности за содержание и достоверность информации, предоставленной Покупателем при оформлении Заказа.
4.8. Покупатель несет ответственность за достоверность предоставленной информации при оформлении Заказа.
4.9. Договор купли-продажи дистанционным способом между Продавцом и Покупателем считается заключенным с момента получения Продавцом сообщения о намерении Покупателя приобрести Товар.
- ДОСТАВКА И ПЕРЕДАЧА ТОВАРА ПОКУПАТЕЛЮ
5.1. Продавец оказывает Покупателю услуги по доставке Товара одним из способов указанных на сайте Интернет-магазина.
5.2. Если Договор купли-продажи товара дистанционным способом (далее – Договор) заключен с условием о доставке Товара Покупателю, Продавец обязан в установленный Договором срок доставить Товар в место, указанное Покупателем, а если место доставки Товара Покупателем не указано, то по месту его жительства или регистрации.
5.3. Место доставки Товара Покупатель указывает при оформлении Заказа на приобретение Товара.
5.4. Срок доставки Товара Покупателю состоит из срока обработки заказа и срока доставки.
5.5. Доставленный Товар передается Покупателю, а при отсутствии Покупателя — любому лицу, предъявившему квитанцию или иной документ, подтверждающий заключение Договора или оформление доставки Товара.
5.7. Информация о Товаре доводится до сведения Покупателя в технической документации, прилагаемой к Товару, на этикетках, путем нанесения маркировки или иным способом, принятым для отдельных видов товаров.
5.8. Сведения об обязательном подтверждении соответствия Товара представляются в порядке и способами, которые установлены законодательством Российской Федерации о техническом регулировании, и включают в себя сведения о номере документа, подтверждающего такое соответствие, о сроке его действия и об организации, его выдавшей.
Внимательно ознакомьтесь с текстом публичной оферты, и если Вы не согласны с каким-либо пунктом оферты, Вы вправе отказаться от покупки Товаров, предоставляемых Продавцом, и не совершать действий, указанный в п. 2.1. настоящей Оферты.
Источник
Image
Description
The Image field allows an image to be uploaded and selected by using the native WordPress media modal.
Screenshots
Changelog
- Added Minimum setting in version 5.1.9.
- Added Maximum setting in version 5.1.9.
- Added Allowed File Types setting in version 5.1.9.
Settings
Return Format
Specifies the format of the returned data. Choose from Object (array), URL (string), or ID (integer).
Preview Size
The WordPress image size displayed when editing values.
Library
Limits file selection to only those that have been uploaded to this post, or the entire library.
Minimum
Adds upload validation for minimum width in pixels (integer), height in pixels (integer) and filesize in MB (integer). The filesize may also be entered as a string containing the unit. eg. ‘400KB’ .
Maximum
Adds upload validation for maximum width, height and filesize.
Allowed File Types
Adds upload validation for specific file types. Enter a comma separated list to specify which file types are allowed or leave blank to accept all types.
Template usage
The Image field will return either an array, a string or an integer value depending on the Return Value set.
Display image (ID)
This example demonstrates how to display the selected image when using the Image ID return type. This example uses the wp_get_attachment_image() function to generate the image HTML.
Display image (array)
This example demonstrates how to display the selected image when using the Image Object return type. This return type provides extra image data such as alt text, caption and sizes.
Customized display (array)
This example demonstrates how to display a custom size of the selected image when using the Image Object return type. This return type allows us to access extra image data such as sizes, width, height and more.
Display image (URL)
This example demonstrates how to display the selected image when using the Image URL return type. This return type allows us to efficiently display a basic image but prevents us from loading any extra data about the image.
Источник
Изображение (Image)
Обзор
Поле «Изображение» позволяет загрузить и выбрать картинку. Это поле использует встроенный загрузчик WordPress, который появляется в виде попапа и позволяет осуществить добавление фото.
Скриншоты
Настройки
Имя | Описание |
---|---|
Возвращаемое значение | Определяет в каком формате должны возвращаться данные. Может быть Массив изображения (массив), Ссылка на изображение (строка) или ID (число). |
Размер изображения | Какой размер изображения показывать при редактировании поля. |
Библиотека | Позволяет выбрать откуда будет доступна картинка: только в текущем посте или во всей медиабиблиотеке. |
Минимум | Устанавливает минимальные значения ширины (px, число), высоты (px, число) и размера файла (mb, число). Размер файла также можно указать строкой. Например, «400 KB». Добавлено в v5.1.9 |
Максимум | Устанавливает максимальное значения ширины, высоты и размера файла. Добавлено в v5.1.9 |
Допустимые типы файлов | Добавляет проверку на тип файла картинки. Введите через запятую нужные типы файлов (.jpg, .png, .gif) для возможности загрузки только их. Оставьте поле пустым, если хотите разрешить загрузку файлов с любым типом. Добавлено в v5.1.9 |
Использование в шаблоне
Поле Изображение будет выводить массив, строку или число в зависимости от выбранной настройки Возвращаемое значение. Ниже примеры как вы можете это использовать. Учитывайте, что все примеры используют в качестве названия поля image и если вы работаете с повторителем, то должны заменить get_field и the_field, на get_sub_field и the_sub_field соответственно.
Базовый вывод (ID)
В этом примере показано как отобразить картинку используя возвращаемое значение ID. Этот пример использует функцию wp_get_attachment_image() для генерации HTML.
Базовый вывод (массив)
В этом примере показано как отобразить картинку используя возвращаемое значение Массив изображения. Этот возвращаемый тип позволяет легко получить доступ к дополнительным свойствам изображения таким как подпись, атрибут alt, описание и различные размеры.
Продвинутый вывод (массив)
В этом примере показано как вывести изображения определенного размера, используя возвращаемое значение Массив изображения. Для того чтобы узнать все доступные данные используйте отладку для переменной $image.
Базовый вывод (Ссылка на изображение)
В этом примере показано как отобразить картинку используя возвращаемое значение Ссылка на изображение. Этот возвращаемый тип позволяет легко получить ссылку на изображение, но мешает получать дополнительные данные о картинках.
Интернет-магазин «acfwp.ru», расположенный на доменном имени acfwp.ru, именуемое в дальнейшем «Продавец», публикует Публичную оферту о продаже Товара дистанционным способом.
- ОПРЕДЕЛЕНИЕ ТЕРМИНОВ
1.1. Публичная оферта (далее – «Оферта») — публичное предложение Продавца, адресованное неопределенному кругу лиц, заключить с Продавцом договор купли-продажи товара дистанционным способом (далее — «Договор») на условиях, содержащихся в настоящей Оферте, включая все Приложения.
1.2. Заказ Товара на сайте Интернет-магазина – позиции, указанные Покупателем из ассортимента Товара, предложенного к продаже, при оформлении заявки на приобретение Товара на сайте Интернет-магазина или через Оператора.
- ОБЩИЕ ПОЛОЖЕНИЯ
2.1. Заказ Покупателем Товара, размещенного на сайте Интернет-магазина означает, что Покупатель согласен со всеми условиями настоящей Оферты.
2.2. Администрация сайта Интернет-магазина имеет право вносить изменения в Оферту без уведомления Покупателя.
2.3. Срок действия Оферты не ограничен, если иное не указано на сайте Интернет-магазина.
2.4. Продавец предоставляет Покупателю полную и достоверную информацию о Товаре, включая информацию об основных потребительских свойствах Товара, месте изготовления, а также информацию о гарантийном сроке и сроке годности Товара на сайте Интернет магазина, в разделе Контакты.
3.1. Цена на каждую позицию Товара указана на сайте Интернет-магазина.
3.2. Продавец имеет право в одностороннем порядке изменить цену на любую позицию Товара.
3.3. В случае изменения цены на заказанный Товар Продавец обязуется в течение 10 дней проинформировать Покупателя об изменении цены Товара.
3.4. Покупатель вправе подтвердить либо аннулировать Заказ на приобретение Товара, если цена изменена Продавцом после оформления Заказа.
3.5. Изменение Продавцом цены на оплаченный Покупателем Товар не допускается.
3.6. Продавец указывает стоимость доставки Товара на сайте Интернет-магазина либо сообщает Покупателю при оформлении заказа Оператором.
3.7. Обязательства Покупателя по оплате Товара считаются исполненными с момента поступления Продавцом денежных средств.
3.8. Расчеты между Продавцом и Покупателем за Товар производятся способами, указанными на сайте Интернет-магазина в разделе Контакты
- ОФОРМЛЕНИЕ ЗАКАЗА
4.1. Заказ Товара осуществляется Покупателем сервис сайта Интернет-магазина acf.acfwp.ru.
4.2. При регистрации на сайте Интернет-магазина Покупатель обязуется предоставить следующую регистрационную информацию:
4.2.1. фамилия, имя, отчество Покупателя или указанного им лица (получателя);
4.2.2. адрес, по которому следует доставить Товар (если доставка до адреса Покупателя);
4.2.3. адрес электронной почты;
4.2.4. контактный телефон.
4.3. Наименование, количество, ассортимент, артикул, цена выбранного Покупателем Товара указываются в корзине Покупателя на сайте Интернет-магазина.
4.4. Если Продавцу необходима дополнительная информация, он вправе запросить ее у Покупателя. В случае не предоставления необходимой информации Покупателем, Продавец не несет ответственности за выбранный Покупателем Товар.
4.6. Принятие Покупателем условий настоящей Оферты осуществляется посредством внесения Покупателем соответствующих данных в регистрационную форму на сайте Интернет-магазина или при оформлении Заказа через Оператора. После оформления Заказа через Оператора данные о Покупателе регистрируются в базе данных Продавца. Утвердив Заказ выбранного Товара, Покупатель предоставляет Оператору необходимую информацию в соответствии с порядком, указанном в п. 4.2. настоящей Оферты.
4.7. Продавец не несет ответственности за содержание и достоверность информации, предоставленной Покупателем при оформлении Заказа.
4.8. Покупатель несет ответственность за достоверность предоставленной информации при оформлении Заказа.
4.9. Договор купли-продажи дистанционным способом между Продавцом и Покупателем считается заключенным с момента получения Продавцом сообщения о намерении Покупателя приобрести Товар.
- ДОСТАВКА И ПЕРЕДАЧА ТОВАРА ПОКУПАТЕЛЮ
5.1. Продавец оказывает Покупателю услуги по доставке Товара одним из способов указанных на сайте Интернет-магазина.
5.2. Если Договор купли-продажи товара дистанционным способом (далее – Договор) заключен с условием о доставке Товара Покупателю, Продавец обязан в установленный Договором срок доставить Товар в место, указанное Покупателем, а если место доставки Товара Покупателем не указано, то по месту его жительства или регистрации.
5.3. Место доставки Товара Покупатель указывает при оформлении Заказа на приобретение Товара.
5.4. Срок доставки Товара Покупателю состоит из срока обработки заказа и срока доставки.
5.5. Доставленный Товар передается Покупателю, а при отсутствии Покупателя — любому лицу, предъявившему квитанцию или иной документ, подтверждающий заключение Договора или оформление доставки Товара.
5.7. Информация о Товаре доводится до сведения Покупателя в технической документации, прилагаемой к Товару, на этикетках, путем нанесения маркировки или иным способом, принятым для отдельных видов товаров.
5.8. Сведения об обязательном подтверждении соответствия Товара представляются в порядке и способами, которые установлены законодательством Российской Федерации о техническом регулировании, и включают в себя сведения о номере документа, подтверждающего такое соответствие, о сроке его действия и об организации, его выдавшей.
Внимательно ознакомьтесь с текстом публичной оферты, и если Вы не согласны с каким-либо пунктом оферты, Вы вправе отказаться от покупки Товаров, предоставляемых Продавцом, и не совершать действий, указанный в п. 2.1. настоящей Оферты.
Источник