WPGraphQL for ACF v2.4.1

WPGraphQL для расширенных настраиваемых полей - это бесплатный плагин WordPress с открытым исходным кодом, который добавляет поля и группы полей ACF в схему WPGraphQL.

Создание групп полей ACF

Создавайте группы полей и поля ACF с помощью пользовательского интерфейса ACF, регистрируйте их с помощью PHP или используйте локальный JSON ACF. Каждую группу полей и поля внутри нее можно настроить на "Показать в GraphQL".

Запрашивайте поля с помощью GraphQL

Как только ваши группы полей и поля настроены на "Показать в GraphQL", они станут доступны в схеме GraphQL для запросов.

Поддерживаемые типы полей

WPGraphQL для ACF обеспечивает поддержку большинства встроенных типов полей ACF (бесплатно и PRO) и расширяет поддержку большинства типов полей из ACF Extended (бесплатно и PRO).

Обновление

Если вы обновляете WPGraphQL для ACF версии 0.6.* или старше, ознакомьтесь с Руководством по обновлению.

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

Прежде чем обновлять WPGraphQL для ACF, просмотрите примечания к выпуску на GitHub.

Мы следуем семантическому управлению версиями (Semver) для значимых выпусков:

- ОСНОВНАЯ версия для несовместимых изменений API,

- MINOR-версия для расширения функциональных возможностей с обратной совместимостью,

- Версия PATCH для исправления ошибок с обратной совместимостью.

Узнайте больше о Semver на semver.org.

Поддержка

- Общие запросы на помощь: для общих вопросов и запросов на помощь создайте новую тему в обсуждениях Github.

- Сообщество Slack: WPGraphQL Slack - отличное место для общения в режиме реального времени. Задавайте вопросы, обсуждайте функции, знакомьтесь с другими людьми, использующими WPGraphQL.

- Отчеты об ошибках: сообщите об ошибке в WPGraphQL.

- Запросы на добавление функций: предложите идею, функцию или улучшение для WPGraphQL.

- Сообщить об уязвимости безопасности: сообщить об уязвимости безопасности.

Часто задаваемые вопросы

Работает ли это с ACF Extended?

Да! WPGraphQL для ACF позволяет запрашивать (большинство) полей, созданных с помощью ACF Extended.

Могу ли я фильтровать и сортировать запросы по полям ACF, используя WPGraphQL для ACF?

В настоящее время WPGraphQL для ACF не поддерживает фильтрацию или сортировку запросов по полям ACF. Выполнение "Мета-запросов" зачастую очень затратно, поэтому в настоящее время мы не поддерживаем фильтрацию по полям ACF "из коробки", но изучаем варианты ее поддержки без снижения производительности.

Мне кажется, я нашел ошибку, куда мне о ней сообщить?

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

Могу ли я использовать ACF Free или Pro с WPGraphQL для ACF?

Да! WPGraphQL для ACF отлично работает с ACF Free и Pro. Pro-версия ACF имеет некоторые дополнительные функции, такие как гибкие поля контента, поля-повторители и страницы параметров, которые поддерживаются WPGraphQL для ACF.

Нужно ли мне использовать Faust.js для использования WPGraphQL для ACF?

Нет! Хотя wpgraphql.com и acf.wpgraphql.com созданы с использованием Faust.js и Next.js, вы можете использовать WPGraphQL для ACF с любым клиентом GraphQL, включая Apollo, Relay, Urql и т. д.

У меня есть расширение ACF, которое добавляет новый тип поля. Будет ли оно работать с WPGraphQL для ACF?

WPGraphQL для ACF поддерживает типы полей, входящие в состав ACF (Free и PRO), а также типы полей в ACF Extended (Free и PRO). Поддержка дополнительных типов полей может быть добавлена с помощью API "register_graphql_acf_field_type".

Нужно ли мне, чтобы WPGraphQL и ACF были активны, чтобы использовать это?

Этот плагин представляет собой "мост", который переносит функциональность ACF в WPGraphQL. Чтобы этот плагин работал, оба WPGraphQL и ACF должны быть установлены и активны в вашей установке WordPress.

Сколько стоит WPGraphQL для ACF?

WPGraphQL для ACF - БЕСПЛАТНЫЙ плагин с открытым исходным кодом. Разработку спонсирует WP Engine Atlas.

Поддерживает ли WPGraphQL для ACF мутации GraphQL?

Мутации GraphQL пока не поддерживаются. Мы работаем над добавлением поддержки мутаций в будущем. Мы ждем, пока директива GraphQL "@oneOf" будет объединена со спецификацией GraphQL, прежде чем мы добавим поддержку мутаций.

Работает ли это с группами полей, зарегистрированными в PHP или JSON?

Да! Вы можете зарегистрировать группы полей и поля ACF с помощью пользовательского интерфейса администратора, PHP или JSON. WPGraphQL для ACF обнаружит группы полей и поля и добавит их в схему GraphQL. Если вы используете PHP или JSON, вам нужно будет установить для параметра "show_in_graphql" значение "true", чтобы предоставить группу полей и поля схеме GraphQL. Могут существовать другие параметры, требующие внимания на уровне группы полей или поля, которые могут повлиять на схему или разрешение поля.

Политика конфиденциальности

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

Appsero SDK не собирает данные по умолчанию и начинает собирать основные данные телеметрии только тогда, когда пользователь разрешает это через уведомление администратора. Никакие данные не собираются без согласия пользователя.

Узнайте больше о том, как Appsero собирает и использует данные.