Создайте действие для пользовательских массовых обновлений с Drupal 8

1. Как выделить определенные термины таксономии
2. Создание административного представления
3. Создать пользовательское действие массового обновления
4. Представление администрирования для пользовательских массовых обновлений
5. Идем дальше с настраиваемыми действиями

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

Чтобы упростить управление этим содержимым, мы можем создать настраиваемые действия, которые будут опираться на плагин Action, предоставляемый ядром Drupal, действия, которые можно массово запускать из представления, например, предложенного Массовая операция просмотра модуль для Drupal 7, чья миграция на Drupal 8 некоторых его функций находится под обсуждение ,

Как выделить определенные термины таксономии

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

Мы можем просто создать логическое поле (назовем его field_push ) в словаре Ключевые слова, и тогда мы сможем определить, какие ключевые слова мы хотим выдвинуть в этом блоке, просто установив этот флажок в каждом термине таксономии, и, конечно, отфильтровать ключевые слова в этом поле в конкретном представлении, чтобы получить их.

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

Создание административного представления

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

Поэтому мы создаем представление на основе терминов таксономии и ограничиваем это представление словарем ключевых слов.

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

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

Если у нас нет этого поля Массовое обновление в представлениях для терминов таксономии, то это просто потому, что по умолчанию для этого типа сущности еще не определено никаких действий. Но создать индивидуальное действие благодаря системе плагинов Drupal 8 можно очень просто.

Создать пользовательское действие массового обновления

Мы создадим модуль, который назовем My BO (имя машины: my_bo), который предоставит нам эти пользовательские действия. Структура этого модуля показана ниже. Вы можете найти весь код этого примера модуля на этом GitHub репозиторий ,

В папке config модуля мы предоставляем схему (my_bo.schema.yml) реализованной конфигурации, а именно конфигурации двух наших пользовательских действий: system.action.term_push_front.yml и system.action.term_unpush_front.yml.

Папка src / Plugin / Action будет содержать классы двух созданных плагинов Action.

Давайте посмотрим на содержимое файла system.action.term_push_front.yml

# Файл system.action.term_push_front.yml langcode: en статус: true зависимости: модуль: - идентификатор таксономии: term_push_front метка: тип «push term in front» тип: плагин таксономии_term: конфигурация term_push_front: {}

Ключевые элементы конфигурации плагина:

• Его зависимости: мы объявляем модуль таксономии, чтобы иметь возможность использовать термины таксономии
• Идентификатор конфигурации (id), который должен соответствовать идентификатору, включенному в имя файла
• Тип сущности, с которой будет работать плагин (здесь сущности taxonomy_term)
• И, наконец, идентификатор класса плагинов (ключевой плагин). Именно этот идентификатор мы объявляем в нашем классе

Давайте просмотрим файл этого плагина, файл src / Plugin / Action / TermPushFront.php

<? php namespace Drupal \ my_bo \ Plugin \ Action; использовать Drupal \ Core \ Action \ ActionBase; использовать Drupal \ Core \ Session \ AccountInterface; / ** * Нажимаем термин впереди. * * @Action (* id = "term_push_front", * label = @Translation ("Push term in front"), * type = "taxonomy_term" *) * / class TermPushFront extends ActionBase {/ ** * {@inheritdoc} * / public function execute ($ entity = NULL) {/ ** @var \ Drupal \ taxonomy \ TermInterface $ entity * / if ($ entity-> hasField ('field_push')) {$ entity-> field_push-> value = 1 ; $ Entity-> Save (); }} / ** * {@inheritdoc} * / доступ к публичной функции ($ object, AccountInterface $ account = NULL, $ return_as_object = FALSE) {/ ** @var \ Drupal \ taxonomy \ TermInterface $ object * / $ result = $ object-> access ('update', $ account, TRUE) -> andIf ($ object-> field_push-> access ('edit', $ account, TRUE)); вернуть $ return_as_object? $ result: $ result-> isAllowed (); }}

Этот плагин Action просто расширяет класс ActionBase и переопределяет его два основных метода.

• Метод execute (), который выполнит желаемую операцию, здесь меняет значение нашего логического поля field_push
• Метод access (), который проверяет, имеет ли пользователь, инициирующий операцию обновления, право изменять рассматриваемый объект и это конкретное поле.

В примечаниях к плагину вы увидите тот же идентификатор, который объявлен в файле конфигурации плагина, а также тип сущности, к которой применяется наш плагин действия.

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

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

Представление администрирования для пользовательских массовых обновлений

Затем у нас есть представление, позволяющее некоторым пользователям массово обновлять ключевые слова сайта в определенном поле. Мы также можем отметить, что создание определенного действия может позволить нам позволить некоторым пользователям обновлять свойство объекта, такое как условия таксономии, без прав на сам объект. Все, что вам нужно сделать, это настроить метод access () плагина для модуляции этих прав.

Идем дальше с настраиваемыми действиями

В этом посте мы создали простые действия для изменения значения поля заданным способом. Булевы поля поддаются довольно хорошо. Но мы также можем легко создавать настраиваемые действия, которые позволяют массово изменять значение текстового поля, например, вводя или выбирая новое значение при запуске обновления. Для этого достаточно, чтобы плагин расширял не класс ActionBase , а класс ConfigurableActionBase , который позволит нам реализовать форму, позволяющую это взаимодействие. Но это может быть тема другого поста.

Похожие

Комментарии