🚀 Автоматизируйте задачи WordPress с новым Gato GraphQL v2.1

Мы рады сообщить, что Gato GraphQL v2.1 выпущен!

С этой новой версией и PRO-расширениями вы можете использовать GraphQL как автоматизатор, задействуя GraphQL persisted queries для автоматизации задач, связанных с данными, на вашем сайте WordPress.

Ниже перечислены все изменения, добавленные в v2.1 (краткая версия доступна в примечаниях к релизу на GitHub).

​

Поддержка передачи конфигурации схемы при вызове внутреннего GraphQL-сервера

Теперь можно указывать, какую конфигурацию схемы применять при выполнении запроса через внутренний GraphQL-сервер (то есть непосредственно в PHP-приложении, а не через endpoint).

Эта новая возможность расширяет расширение Internal GraphQL Server: теперь оно принимает параметр $schemaConfigurationIDOrSlug в методах executeQuery и executeQueryInFile класса GraphQLServer, а также уже извлекает конфигурацию схемы, используемую persisted query, в executePersistedQuery:

class GraphQLServer {
  
  public static function executeQuery(
    string $query,
    array $variables = [],
    ?string $operationName = null,
+   // Accept parameter 
+   int|string|null $schemaConfigurationIDOrSlug = null,
  ): Response {
    // ...
  }
 
  public static function executeQueryInFile(
    string $file,
    array $variables = [],
    ?string $operationName = null,
+   // Accept parameter 
+   int|string|null $schemaConfigurationIDOrSlug = null,
  ): Response {
    // ...
  }
 
  public static function executePersistedQuery(
    WP_Post|string|int $persistedQuery,
    array $variables = [],
    ?string $operationName = null,
+   // Schema Configuration is taken directly from the Persisted Query
  ): Response {
    // ...
  }Copy

​

GraphQL как автоматизатор [PRO]

Описанная выше функциональность также создаёт основу для улучшения расширения Automation.

Расширение Automation теперь предоставляет пользовательский интерфейс «автоматизатора» (непосредственно через редактор WordPress) под названием Automation Configurator. Триггером автоматизации служит любой action hook WordPress, а действием — выполнение GraphQL persisted query.

Например, при создании новой записи правило автоматизации Add comments block to new post (выполняющее persisted query с тем же именем) проверяет наличие блока core/comments и, если он отсутствует, добавляет его в конец записи:

Вот некоторые способы использования автоматизатора:

• Создание (и оптимизация) изображения-обложки для новых записей с помощью ИИ
• Добавление обязательного блока к записи при её публикации
• Замена http на https во всех источниках изображений и ссылках при обновлении записи
• Отправка письма администратору при появлении новой записи
• Отправка письма пользователю, чей комментарий получил новый ответ
• [Мультисайт] Перевод новой записи на разные языки и добавление переведённых записей на каждый сайт
• Выполнение действия во внешнем сервисе (например: автоматическая публикация новых записей в Facebook)

Поскольку GraphQL persisted queries и правила автоматизации можно составлять прямо в wp-admin, создать полностью настроенный конвейер автоматизации, адаптированный под ваши нужды, не составит труда.

А поскольку ограничений на входные данные нет (GraphQL-запрос может взаимодействовать со всеми данными WordPress и подключаться к любому внешнему сервису через HTTP-клиент), вы сможете удовлетворить 100% своих требований.

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

Плагин уже создаёт несколько правил автоматизации (со статусом draft, поэтому их необходимо перевести в publish, чтобы они вступили в силу). Вы уже можете их использовать, а также рассматривать как примеры для создания собственных автоматизаций (этот список будет расширяться в следующих релизах):

• Add comments block to new post
• Insert block in new post
• Send notification email to admin when there is a new post
• Generate a post's featured image using AI (and optimize it) if a new post has none

​

Предустановленная persisted query «Insert block in post»

Новая предустановленная GraphQL persisted query «Insert block in post» позволяет вставить блок в запись. Она находит n-й блок заданного типа (wp:paragraph по умолчанию) в записи и помещает HTML-содержимое предоставленного пользовательского блока сразу после него.

При использовании совместно с расширением Automation эта persisted query может применяться для автоматической вставки обязательных блоков в только что опубликованную запись (например: блок CTA для продвижения текущей кампании).

​

Улучшения

• Если инициализация контейнера сервисов из кэша завершается ошибкой, выполняется откат к инициализации PHP-объекта из памяти (#2638)
• Назначить уникальный operationName всем предустановленным persisted queries (#2644)
• Улучшено сообщение об ошибке при получении блоков из записи, когда содержимое блока содержит ошибки
• Завершена документация для расширения Automation (#2651)
• В предустановленной persisted query «Generate a post's featured image using AI and optimize it» логика выполняется только в том случае, если заголовок записи не пустой (#ec931dd)

​

Исправлено

• Ошибка в JS-компоненте с несколькими элементами управления, используемом расширениями (Access Control, Cache Control и Field Deprecation), из-за которой в блоке конфигурации схемы отображалось «undefined» (#2639)
• Ошибка в заменах с использованием regex в предустановленных persisted queries (#2649)
• Предотвращена повторная установка данных настройки плагина при деактивации/повторной активации плагина (#2641)
• Обработка ошибки при передаче WP_Post в качестве переменной GraphQL внутреннему GraphQL-серверу (#2652)