class UnpublishByKeywordComment

Same name in this branch
  1. 10 core/modules/comment/src/Plugin/Action/UnpublishByKeywordComment.php \Drupal\comment\Plugin\Action\UnpublishByKeywordComment
Same name in other branches
  1. 9 core/modules/comment/src/Plugin/Action/UnpublishByKeywordComment.php \Drupal\comment\Plugin\Action\UnpublishByKeywordComment
  2. 8.9.x core/modules/comment/src/Plugin/Action/UnpublishByKeywordComment.php \Drupal\comment\Plugin\Action\UnpublishByKeywordComment
  3. 11.x core/modules/comment/src/Plugin/Action/UnpublishByKeywordComment.php \Drupal\comment\Plugin\Action\UnpublishByKeywordComment

Unpublishes a comment containing certain keywords.

Hierarchy

Expanded class hierarchy of UnpublishByKeywordComment

1 file declares its use of UnpublishByKeywordComment
UnpublishByKeywordComment.php in core/modules/comment/src/Plugin/Action/UnpublishByKeywordComment.php

File

core/modules/action/src/Plugin/Action/UnpublishByKeywordComment.php, line 21

Namespace

Drupal\action\Plugin\Action
View source
class UnpublishByKeywordComment extends ConfigurableActionBase implements ContainerFactoryPluginInterface {
    
    /**
     * The comment entity builder handler.
     *
     * @var \Drupal\Core\Entity\EntityViewBuilderInterface
     */
    protected $viewBuilder;
    
    /**
     * The renderer.
     *
     * @var \Drupal\Core\Render\RendererInterface
     */
    protected $renderer;
    
    /**
     * Constructs an UnpublishByKeywordComment object.
     *
     * @param array $configuration
     *   A configuration array containing information about the plugin instance.
     * @param string $plugin_id
     *   The plugin ID for the plugin instance.
     * @param mixed $plugin_definition
     *   The plugin implementation definition.
     * @param \Drupal\Core\Entity\EntityViewBuilderInterface $comment_view_builder
     *   The comment entity builder handler.
     * @param \Drupal\Core\Render\RendererInterface $renderer
     *   The renderer.
     */
    public function __construct(array $configuration, $plugin_id, $plugin_definition, EntityViewBuilderInterface $comment_view_builder, RendererInterface $renderer) {
        parent::__construct($configuration, $plugin_id, $plugin_definition);
        $this->viewBuilder = $comment_view_builder;
        $this->renderer = $renderer;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
        return new static($configuration, $plugin_id, $plugin_definition, $container->get('entity_type.manager')
            ->getViewBuilder('comment'), $container->get('renderer'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function execute($comment = NULL) {
        $build = $this->viewBuilder
            ->view($comment);
        $text = (string) $this->renderer
            ->renderInIsolation($build);
        foreach ($this->configuration['keywords'] as $keyword) {
            if (str_contains($text, $keyword)) {
                $comment->setUnpublished();
                $comment->save();
                break;
            }
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function defaultConfiguration() {
        return [
            'keywords' => [],
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
        $form['keywords'] = [
            '#title' => $this->t('Keywords'),
            '#type' => 'textarea',
            '#description' => $this->t('The comment will be unpublished if it contains any of the phrases above. Use a case-sensitive, comma-separated list of phrases. Example: funny, bungee jumping, "Company, Inc."'),
            '#default_value' => Tags::implode($this->configuration['keywords']),
        ];
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
        $this->configuration['keywords'] = Tags::explode($form_state->getValue('keywords'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function access($object, ?AccountInterface $account = NULL, $return_as_object = FALSE) {
        
        /** @var \Drupal\comment\CommentInterface $object */
        $result = $object->access('update', $account, TRUE)
            ->andIf($object->status
            ->access('edit', $account, TRUE));
        return $return_as_object ? $result : $result->isAllowed();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
ActionBase::executeMultiple public function Executes the plugin for an array of objects. Overrides ActionInterface::executeMultiple 3
ConfigurableActionBase::calculateDependencies public function Calculates dependencies for the configured plugin. Overrides DependentPluginInterface::calculateDependencies 1
ConfigurableActionBase::getConfiguration public function Gets this plugin's configuration. Overrides ConfigurableInterface::getConfiguration
ConfigurableActionBase::setConfiguration public function Sets the configuration for this plugin instance. Overrides ConfigurableInterface::setConfiguration
ConfigurableActionBase::validateConfigurationForm public function Form validation handler. Overrides PluginFormInterface::validateConfigurationForm 2
PluginInspectionInterface::getPluginDefinition public function Gets the definition of the plugin implementation. 6
PluginInspectionInterface::getPluginId public function Gets the plugin ID of the plugin instance. 2
UnpublishByKeywordComment::$renderer protected property The renderer.
UnpublishByKeywordComment::$viewBuilder protected property The comment entity builder handler.
UnpublishByKeywordComment::access public function Checks object access. Overrides ActionInterface::access
UnpublishByKeywordComment::buildConfigurationForm public function Form constructor. Overrides PluginFormInterface::buildConfigurationForm
UnpublishByKeywordComment::create public static function Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface::create
UnpublishByKeywordComment::defaultConfiguration public function Gets default configuration for this plugin. Overrides ConfigurableActionBase::defaultConfiguration
UnpublishByKeywordComment::execute public function Executes the plugin. Overrides ExecutableInterface::execute
UnpublishByKeywordComment::submitConfigurationForm public function Form submission handler. Overrides PluginFormInterface::submitConfigurationForm
UnpublishByKeywordComment::__construct public function Constructs an UnpublishByKeywordComment object. Overrides ConfigurableActionBase::__construct 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.