Meta Field Block v1.4.6

Этот одноблочный плагин позволяет отображать метаполе или настраиваемое поле в виде блока во внешнем интерфейсе. Он поддерживает настраиваемые поля для сообщений, условий и пользователей. Его можно вложить в родительский блок, который имеет контекст postId и postType, например блок запроса, коллекцию продуктов WooCommerce, или использовать как отдельный блок.

Вы можете отобразить любое поле, значение которого может быть получено с помощью основного API (get_post_meta, get_term_meta, get_user_meta) и является строкой или может быть преобразовано в строку. Чтобы отобразить значение поля в редакторе блоков, оно должно быть доступно через REST API или иметь динамический тип поля.

Вы также можете явно отображать настраиваемые поля, созданные плагином Advanced Custom Fields или Meta Box. Он поддерживает все типы полей ACF и типы полей Meta Box, значения которых являются строками или могут быть преобразованы в строки. Некоторые другие сложные поля ACF, такие как типы полей "Изображение", "Ссылка", "Ссылка на страницу", "Истина-ложь", "Флажок", "Выбрать", "Радио", "Группа кнопок", "Таксономия", "Пользователь", "Опубликовать объект" и "Отношения", а также поля мета-поля, такие как "Выбрать", "Флажок", "Радио", "Изображение", "Видео", "Таксономия", "Пользователь", "Опубликовать", также поддерживаются в базовых форматах.

Этот плагин также предоставляет удобные для разработчиков API-интерфейсы, которые позволяют легко настраивать вывод блока, отображать поля сложных типов данных или использовать блок в качестве заполнителя для отображения любого типа контента с object_id и object_type в качестве параметров контекста.

Крайний случай, когда этот блок действительно полезен, - это когда вам нужно получить правильный post_id в вашем коротком коде, когда вы используете его в цикле запросов. В этом случае вы можете установить тип поля как динамический и ввести свой короткий код в имя поля. Блок будет правильно отображать его как во внешнем интерфейсе, так и в редакторе. В качестве альтернативы, если вы хотите видеть только предварительный просмотр вашего шорткода в редакторе, вы также можете использовать этот блок как лучшую версию ядра/шорткода.

Чтобы быстро узнать, как этот блок отображает настраиваемые поля, посмотрите краткое руководство (для версии MFB 1.3.4) Пола Чарльтона из WPTuts. Видео посвящено плагину Advanced Custom Fields, но вы можете использовать аналогичный подход для отображения полей из других платформ, таких как Meta Box.

Ссылки

- Веб-сайт

- Как это работает и обучающие материалы

- МФБ ПРО

Каков HTML-вывод настраиваемого поля?

Вывод HTML настраиваемого поля во внешнем интерфейсе зависит от контекста поля. Для получения значения поля он использует одну из следующих основных функций API: get_post_meta, get_term_meta, get_user_meta.

Что такое HTML-вывод полей ACF?

- Поддерживаются все основные типы полей, которые возвращают строки или могут быть преобразованы в строки. Вывод HTML осуществляется функцией get_field.

- Тип ссылки. Вывод HTML:

<a href={url} target={target} rel="noreferrer noopener">{title}</a>

Атрибут rel отсутствует, если цель не _blank.

- Тип изображения - вывод HTML осуществляется функцией wp_get_attachment_image. Размер изображения задается в настройке "Размер предварительного просмотра".

- Тип True/False - вывод HTML имеет значение "Да", если значение истинно, и "Нет", если значение ложно. Ниже приведен фрагмент кода для изменения этих текстовых значений:

add_filter("meta_field_block_true_false_on_text", function ($on_text, $field_name, $field, $post_id, $value) {
вернуть "Да";
}, 10, 5 );

add_filter("meta_field_block_true_false_off_text", function ($off_text, $field_name, $field, $post_id, $value) {
вернуть "Нуп";
}, 10, 5 );

- Флажок/Выбрать тип - HTML-вывод:

<span class="value-item">{item_value</span>, <span class="value-item">{item_value</span>

item_value может быть значением или меткой, в зависимости от возвращаемого формата поля. Несколько выбранных значений разделяются ,. Ниже приведен фрагмент кода для изменения разделителя:

add_filter("meta_field_block_acf_field_choice_item_separator", function ($separator, $field_name, $field, $post_id, $value) {
вернуться " | ";
}, 10, 5 );

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

- Тип ссылки на страницу, тип объекта публикации. HTML-вывод для поля с одним значением:

<a class="post-link" href={url} rel="bookmark">{title}</a>

Для поля с несколькими значениями:

<ул>
<li><a class="post-link" href={url} rel="bookmark">{title}</a></li>
<li><a class="post-link" href={url} rel="bookmark">{title}</a></li>
</ul>

- Тип связи. Вывод HTML:

<ул>
<li><a class="post-link" href={url} rel="bookmark">{title}</a></li>
<li><a class="post-link" href={url} rel="bookmark">{title}</a></li>
</ul>

- Тип таксономии. Вывод HTML:

<ул>
<li><a class="term-link" href={term_url}>{term_name</a></li>
<li><a class="term-link" href={term_url}>{term_name</a></li>
</ul>

- Тип пользователя. HTML-вывод для поля с одним значением:

<a class="user-link" href={author_url}>{display_name</a>

Для поля с несколькими значениями:

<ул>
<li><a class="user-link" href={author_url}>{display_name</a></li>
<li><a class="user-link" href={author_url}>{display_name</a></li>
</ul>

- Ф