class GutenbergFilter in Gutenberg 8.2
Provides a filter for Gutenberg blocks.
Plugin annotation
@Filter(
id = "gutenberg",
title = @Translation("Gutenberg"),
description = @Translation("Compulsory filter in order to work with Gutenberg formats."),
type = Drupal\filter\Plugin\FilterInterface::TYPE_TRANSFORM_REVERSIBLE,
settings = {
"processor_settings" = {},
}
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\gutenberg\Plugin\Filter\GutenbergFilter implements ContainerFactoryPluginInterface
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of GutenbergFilter
File
- src/
Plugin/ Filter/ GutenbergFilter.php, line 32
Namespace
Drupal\gutenberg\Plugin\FilterView source
class GutenbergFilter extends FilterBase implements ContainerFactoryPluginInterface {
/**
* The Gutenberg block processor manager.
*
* @var \Drupal\gutenberg\BlockProcessor\GutenbergBlockProcessorManager
*/
protected $blockProcessorManager;
/**
* The Gutenberg library manager.
*
* @var \Drupal\gutenberg\GutenbergLibraryManagerInterface
*/
protected $libraryManager;
/**
* The configuration factory.
*
* @var \Drupal\Core\Config\ConfigFactoryInterface
*/
protected $configFactory;
/**
* Constructs a GutenbergFilter 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\gutenberg\BlockProcessor\GutenbergBlockProcessorManager $block_processor_manager
* The block processor manager instance.
* @param \Drupal\gutenberg\GutenbergLibraryManagerInterface $library_manager
* The library manager instance.
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The configuration factory.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, GutenbergBlockProcessorManager $block_processor_manager, GutenbergLibraryManagerInterface $library_manager, ConfigFactoryInterface $config_factory) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->blockProcessorManager = $block_processor_manager;
$this->libraryManager = $library_manager;
$this->configFactory = $config_factory;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('gutenberg.block_processor_manager'), $container
->get('plugin.manager.gutenberg.library'), $container
->get('config.factory'));
}
/**
* {@inheritdoc}
*
* @see https://github.com/WordPress/gutenberg/blob/master/post-content.php
*/
public function process($text, $langcode) {
$result = new FilterProcessResult($text);
$this
->setProviderSettings();
// Use a bubbleable metadata.
$bubbleable_metadata = new BubbleableMetadata();
$block_parser = new BlockParser();
$blocks = $block_parser
->parse($text);
$output = '';
foreach ($blocks as $block) {
$output .= $this
->renderBlock($block, $bubbleable_metadata);
}
$result
->setProcessedText($output);
// Add the module/theme libraries.
$this
->addAttachments($result);
// Add the processed blocks bubbleable metadata.
$result
->addCacheableDependency($bubbleable_metadata);
return $result;
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
$processors_settings = [];
$this
->setProviderSettings();
$processors = $this->blockProcessorManager
->getSortedProcessors();
foreach ($processors as $processor) {
if ($processor instanceof GutenbergConfigurableBlockProcessorInterface) {
$processors_settings += $processor
->provideSettings($form, $form_state);
}
}
if ($processors_settings) {
$form['processor_settings'] = $processors_settings;
return $form;
}
// Empty array to signify that there is no configuration.
return [];
}
/**
* {@inheritdoc}
*/
public function defaultConfiguration() {
$default_configuration = parent::defaultConfiguration();
$processors = $this->blockProcessorManager
->getSortedProcessors();
foreach ($processors as $processor) {
if ($processor instanceof GutenbergConfigurableBlockProcessorInterface) {
$default_configuration['settings']['processor_settings'] += $processor
->defaultConfiguration();
}
}
return $default_configuration;
}
/**
* Render a Gutenberg block.
*
* @param array $block
* The Gutenberg block.
* @param \Drupal\Core\Cache\RefinableCacheableDependencyInterface $bubbleable_metadata
* The bubbleable metadata.
*
* @return string
* The block content.
*/
protected function renderBlock(array $block, RefinableCacheableDependencyInterface $bubbleable_metadata) {
$index = 0;
$block_content = '';
foreach ($block['innerContent'] as $chunk) {
if (is_string($chunk)) {
$block_content .= $chunk;
}
else {
$block_content .= $this
->renderBlock($block['innerBlocks'][$index++], $bubbleable_metadata);
}
}
$processors = $this->blockProcessorManager
->getSortedProcessors();
foreach ($processors as $processor) {
if ($processor
->isSupported($block, $block_content)) {
$result = $processor
->processBlock($block, $block_content, $bubbleable_metadata);
if ($result === FALSE) {
// Stop further processing of the block.
break;
}
}
}
return $block_content;
}
/**
* Attach Gutenberg frontend libraries to the result.
*
* @param \Drupal\filter\FilterProcessResult $result
* The resulting markup.
*/
protected function addAttachments(FilterProcessResult $result) {
$module_definitions = $this->libraryManager
->getModuleDefinitions();
$attachments = [];
foreach ($module_definitions as $module_definition) {
foreach ($module_definition['libraries-view'] as $library) {
$attachments['library'][] = $library;
}
}
$theme_definition = $this->libraryManager
->getActiveThemeMergedDefinition();
foreach ($theme_definition['libraries-view'] as $library) {
$attachments['library'][] = $library;
}
$default_theme = $this->configFactory
->get('system.theme')
->get('default');
if ($default_theme === 'bartik') {
$attachments['library'][] = 'gutenberg/bartik';
}
if ($attachments) {
// Add the frontend attachments.
$result
->addAttachments($attachments);
}
}
/**
* Set the current provider settings.
*/
protected function setProviderSettings() {
$processors = $this->blockProcessorManager
->getSortedProcessors();
foreach ($processors as $processor) {
if ($processor instanceof GutenbergConfigurableBlockProcessorInterface) {
$processor
->setSettings($this->settings['processor_settings'] + $processor
->defaultConfiguration());
}
}
}
/**
* {@inheritDoc}
*/
public function tips($long = FALSE) {
if ($long) {
return $this
->t('Displays and renders Gutenberg HTML markup. The Gutenberg HTML attribute comments are automatically stripped.');
}
return $this
->t('Displays and renders Gutenberg HTML markup.');
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
FilterBase:: |
public | property | The name of the provider that owns this filter. | |
FilterBase:: |
public | property | An associative array containing the configured settings of this filter. | |
FilterBase:: |
public | property | A Boolean indicating whether this filter is enabled. | |
FilterBase:: |
public | property | The weight of this filter compared to others in a filter collection. | |
FilterBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
1 |
FilterBase:: |
public | function |
Gets this plugin's configuration. Overrides ConfigurableInterface:: |
|
FilterBase:: |
public | function |
Returns the administrative description for this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Returns HTML allowed by this filter's configuration. Overrides FilterInterface:: |
4 |
FilterBase:: |
public | function |
Returns the administrative label for this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Returns the processing type of this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Prepares the text for processing. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Sets the configuration for this plugin instance. Overrides ConfigurableInterface:: |
1 |
FilterInterface:: |
constant | HTML tag and attribute restricting filters to prevent XSS attacks. | ||
FilterInterface:: |
constant | Non-HTML markup language filters that generate HTML. | ||
FilterInterface:: |
constant | Irreversible transformation filters. | ||
FilterInterface:: |
constant | Reversible transformation filters. | ||
GutenbergFilter:: |
protected | property | The Gutenberg block processor manager. | |
GutenbergFilter:: |
protected | property | The configuration factory. | |
GutenbergFilter:: |
protected | property | The Gutenberg library manager. | |
GutenbergFilter:: |
protected | function | Attach Gutenberg frontend libraries to the result. | |
GutenbergFilter:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
GutenbergFilter:: |
public | function |
Gets default configuration for this plugin. Overrides FilterBase:: |
|
GutenbergFilter:: |
public | function |
Overrides FilterInterface:: |
|
GutenbergFilter:: |
protected | function | Render a Gutenberg block. | |
GutenbergFilter:: |
protected | function | Set the current provider settings. | |
GutenbergFilter:: |
public | function |
Generates a filter's settings form. Overrides FilterBase:: |
|
GutenbergFilter:: |
public | function |
Generates a filter's tip. Overrides FilterBase:: |
|
GutenbergFilter:: |
public | function |
Constructs a GutenbergFilter object. Overrides FilterBase:: |
|
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |