function CKEditor5PluginManagerTest::testEnabledPlugins

Same name in other branches
  1. 9 core/modules/ckeditor5/tests/src/Kernel/CKEditor5PluginManagerTest.php \Drupal\Tests\ckeditor5\Kernel\CKEditor5PluginManagerTest::testEnabledPlugins()
  2. 11.x core/modules/ckeditor5/tests/src/Kernel/CKEditor5PluginManagerTest.php \Drupal\Tests\ckeditor5\Kernel\CKEditor5PluginManagerTest::testEnabledPlugins()

Tests the enabling of plugins.

File

core/modules/ckeditor5/tests/src/Kernel/CKEditor5PluginManagerTest.php, line 1115

Class

CKEditor5PluginManagerTest
Tests different ways of enabling CKEditor 5 plugins.

Namespace

Drupal\Tests\ckeditor5\Kernel

Code

public function testEnabledPlugins() : void {
    $editor = Editor::load('basic_html');
    // Case 1: no extra CKEditor 5 plugins.
    $definitions = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $default_plugins = [
        'ckeditor5_autoformat',
        'ckeditor5_bold',
        'ckeditor5_emphasis',
        'ckeditor5_essentials',
        'ckeditor5_globalAttributeDir',
        'ckeditor5_globalAttributeLang',
        'ckeditor5_heading',
        'ckeditor5_htmlComments',
        'ckeditor5_paragraph',
        'ckeditor5_pasteFromOffice',
    ];
    $this->assertSame($default_plugins, $definitions, 'No CKEditor 5 plugins found besides the built-in ones.');
    $default_libraries = [
        'ckeditor5/internal.drupal.ckeditor5',
        'ckeditor5/internal.drupal.ckeditor5.emphasis',
        'ckeditor5/internal.drupal.ckeditor5.htmlEngine',
        'core/ckeditor5.autoformat',
        'core/ckeditor5.basic',
        'core/ckeditor5.essentials',
        'core/ckeditor5.htmlSupport',
        'core/ckeditor5.pasteFromOffice',
    ];
    $this->assertSame($default_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Enable the CKEditor 5 Test module, which has the layercake plugin and
    // clear the editor manager's static cache so that it is picked up.
    $this->enableModules([
        'ckeditor5_test',
    ]);
    $this->manager = $this->container
        ->get('plugin.manager.ckeditor5.plugin');
    $this->manager
        ->clearCachedDefinitions();
    // Case 2: The CKEditor 5 layercake plugin is available and library should
    // NOT be loaded if its toolbar items are not enabled.
    $this->assertSame($default_plugins, array_keys($this->manager
        ->getEnabledDefinitions($editor)));
    $this->assertSame($default_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Case 3: The CKEditor 5 layercake plugin is available and library should
    // be loaded without having to enable plugins.
    $settings = $editor->getSettings();
    $settings['toolbar']['items'][] = 'simpleBox';
    $editor->setSettings($settings);
    $plugin_ids = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $default_plugins_with_layercake = array_merge($default_plugins, [
        'ckeditor5_test_layercake',
    ]);
    // Sort on plugin id.
    asort($default_plugins_with_layercake);
    $this->assertSame(array_values($default_plugins_with_layercake), $plugin_ids);
    $default_libraries_with_layercake = array_merge($default_libraries, [
        'ckeditor5_test/layercake',
    ]);
    sort($default_libraries_with_layercake);
    $this->assertSame($default_libraries_with_layercake, $this->manager
        ->getEnabledLibraries($editor));
    // Enable media embed filter which the CKEditor 5 media plugin requires.
    $editor->getFilterFormat()
        ->setFilterConfig('media_embed', [
        'status' => TRUE,
    ])
        ->save();
    // Case 4: The CKEditor 5 media plugin should be enabled and the library
    // should be available now that the media_embed is enabled.
    $plugin_ids = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $expected_plugins = array_merge($default_plugins, [
        'ckeditor5_drupalMediaCaption',
        'ckeditor5_test_layercake',
        'media_media',
        'media_mediaAlign',
    ]);
    sort($expected_plugins);
    $this->assertSame($expected_plugins, $plugin_ids);
    $expected_libraries = array_merge($default_libraries, [
        'ckeditor5/internal.drupal.ckeditor5.media',
        'ckeditor5/internal.drupal.ckeditor5.mediaAlign',
        'ckeditor5_test/layercake',
    ]);
    sort($expected_libraries);
    $this->assertSame($expected_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Enable the CKEditor 5 Plugin Conditions Test module, which has the
    // ckeditor5_plugin_conditions_test_plugins_condition plugin which is
    // conditionally enabled. Clear the editor manager's static cache so that it
    // is picked up.
    $this->enableModules([
        'ckeditor5_plugin_conditions_test',
    ]);
    $this->manager = $this->container
        ->get('plugin.manager.ckeditor5.plugin');
    $this->manager
        ->clearCachedDefinitions();
    // Case 5: just installing the ckeditor5_plugin_conditions_test module does
    // not enable its conditionally enabled plugin.
    $this->assertSame($expected_plugins, $plugin_ids);
    $this->assertSame($expected_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Case 6: placing the table plugin's button enables the table plugin, but
    // also implicitly enables the conditionally enabled plugin.
    $settings['toolbar']['items'][] = 'insertTable';
    $editor->setSettings($settings);
    $plugin_ids = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $expected_plugins = array_merge($expected_plugins, [
        'ckeditor5_table',
        'ckeditor5_plugin_conditions_test_plugins_condition',
    ]);
    sort($expected_plugins);
    $this->assertSame(array_values($expected_plugins), $plugin_ids);
    $expected_libraries = array_merge($default_libraries, [
        'ckeditor5/internal.drupal.ckeditor5.media',
        'ckeditor5/internal.drupal.ckeditor5.mediaAlign',
        'ckeditor5_test/layercake',
        'core/ckeditor5.table',
    ]);
    sort($expected_libraries);
    $this->assertSame($expected_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Case 7: GHS is enabled for other text editors if they are using a
    // CKEditor 5 plugin that uses wildcard tags.
    $settings['toolbar']['items'][] = 'alignment';
    $editor->setSettings($settings);
    $plugin_ids = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $expected_plugins = array_merge($expected_plugins, [
        'ckeditor5_alignment',
        'ckeditor5_wildcardHtmlSupport',
    ]);
    sort($expected_plugins);
    $this->assertSame(array_values($expected_plugins), $plugin_ids);
    $expected_libraries = array_merge($expected_libraries, [
        'core/ckeditor5.alignment',
    ]);
    sort($expected_libraries);
    $this->assertSame($expected_libraries, $this->manager
        ->getEnabledLibraries($editor));
    // Case 8: GHS is enabled for Full HTML (or any other text format that has
    // no TYPE_HTML_RESTRICTOR filters).
    $editor = Editor::load('full_html');
    $definitions = array_keys($this->manager
        ->getEnabledDefinitions($editor));
    $default_plugins = [
        'ckeditor5_arbitraryHtmlSupport',
        'ckeditor5_autoformat',
        'ckeditor5_bold',
        'ckeditor5_emphasis',
        'ckeditor5_essentials',
        'ckeditor5_heading',
        'ckeditor5_htmlComments',
        'ckeditor5_paragraph',
        'ckeditor5_pasteFromOffice',
    ];
    $this->assertSame($default_plugins, $definitions, 'No CKEditor 5 plugins found besides the built-in ones.');
    $default_libraries = [
        'ckeditor5/internal.drupal.ckeditor5',
        'ckeditor5/internal.drupal.ckeditor5.emphasis',
        'ckeditor5/internal.drupal.ckeditor5.htmlEngine',
        'core/ckeditor5.autoformat',
        'core/ckeditor5.basic',
        'core/ckeditor5.essentials',
        'core/ckeditor5.htmlSupport',
        'core/ckeditor5.pasteFromOffice',
    ];
    $this->assertSame($default_libraries, $this->manager
        ->getEnabledLibraries($editor));
}

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