function AddItemToToolbar::apply

Same name in other branches
  1. 11.x core/modules/ckeditor5/src/Plugin/ConfigAction/AddItemToToolbar.php \Drupal\ckeditor5\Plugin\ConfigAction\AddItemToToolbar::apply()

Overrides ConfigActionPluginInterface::apply

File

core/modules/ckeditor5/src/Plugin/ConfigAction/AddItemToToolbar.php, line 42

Class

AddItemToToolbar

Namespace

Drupal\ckeditor5\Plugin\ConfigAction

Code

public function apply(string $configName, mixed $value) : void {
    $editor = $this->configManager
        ->loadConfigEntityByName($configName);
    assert($editor instanceof EditorInterface);
    if ($editor->getEditor() !== 'ckeditor5') {
        throw new ConfigActionException(sprintf('The %s config action only works with editors that use CKEditor 5.', $this->pluginId));
    }
    $editor_settings = $editor->getSettings();
    if (is_string($value)) {
        $editor_settings['toolbar']['items'][] = $item_name = $value;
    }
    else {
        assert(is_array($value));
        $item_name = $value['item_name'];
        assert(is_string($item_name));
        $replace = $value['replace'] ?? FALSE;
        assert(is_bool($replace));
        $position = $value['position'] ?? NULL;
        if (is_int($position)) {
            // If we want to replace the item at this position, then `replace`
            // should be true. This would be useful if, for example, we wanted to
            // replace the Image button with the Media Library.
            array_splice($editor_settings['toolbar']['items'], $position, $replace ? 1 : 0, $item_name);
        }
        else {
            $editor_settings['toolbar']['items'][] = $item_name;
        }
    }
    // If we're just adding a vertical separator, there's nothing else we need
    // to do at this point.
    if ($item_name === '|') {
        return;
    }
    // If this item is associated with a plugin, ensure that it's configured
    // at the editor level, if necessary.
    
    /** @var \Drupal\ckeditor5\Plugin\CKEditor5PluginDefinition $definition */
    foreach ($this->pluginManager
        ->getDefinitions() as $id => $definition) {
        if (array_key_exists($item_name, $definition->getToolbarItems())) {
            // If plugin settings already exist, don't change them.
            if (array_key_exists($id, $editor_settings['plugins'])) {
                break;
            }
            elseif ($definition->isConfigurable()) {
                
                /** @var \Drupal\ckeditor5\Plugin\CKEditor5PluginConfigurableInterface $plugin */
                $plugin = $this->pluginManager
                    ->getPlugin($id, NULL);
                $editor_settings['plugins'][$id] = $plugin->defaultConfiguration();
            }
            // No need to examine any other plugins.
            break;
        }
    }
    $editor->setSettings($editor_settings)
        ->save();
}

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