interface CKEditorPluginCssInterface implements CKEditorPluginInterface (View source)

Defines an interface for CKEditor plugins with associated CSS.

This allows a CKEditor plugin to add additional CSS in iframe CKEditor instances without needing to implement hook_ckeditor_css_alter().

Methods

string
getPluginId()

Gets the plugin_id of the plugin instance.

array
getPluginDefinition()

Gets the definition of the plugin implementation.

bool
isInternal()

Indicates if this plugin is part of the optimized CKEditor build.

array
getDependencies(Editor $editor)

Returns a list of plugins this plugin requires.

array
getLibraries(Editor $editor)

Returns a list of libraries this plugin requires.

string|false
getFile()

Returns the Drupal root-relative file path to the plugin JavaScript file.

array
getConfig(Editor $editor)

Returns the additions to CKEDITOR.config for a specific CKEditor instance.

string[]
getCssFiles(Editor $editor)

Retrieves enabled plugins' iframe instance CSS files.

Details

string getPluginId()

Gets the plugin_id of the plugin instance.

Return Value

string

The plugin_id of the plugin instance.

array getPluginDefinition()

Gets the definition of the plugin implementation.

Return Value

array

The plugin definition, as returned by the discovery object used by the plugin manager.

bool isInternal()

Indicates if this plugin is part of the optimized CKEditor build.

Plugins marked as internal are implicitly loaded as part of CKEditor.

Return Value

bool

array getDependencies(Editor $editor)

Returns a list of plugins this plugin requires.

Parameters

Editor $editor

A configured text editor object.

Return Value

array

An unindexed array of plugin names this plugin requires. Each plugin is is identified by its annotated ID.

array getLibraries(Editor $editor)

Returns a list of libraries this plugin requires.

These libraries will be attached to the text_format element on which the editor is being loaded.

Parameters

Editor $editor

A configured text editor object.

Return Value

array

An array of libraries suitable for usage in a render API #attached property.

string|false getFile()

Returns the Drupal root-relative file path to the plugin JavaScript file.

Note: this does not use a Drupal library because this uses CKEditor's API.

Return Value

string|false

The Drupal root-relative path to the file, FALSE if an internal plugin.

See also

https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_resourceManager.html#method-addExternal

array getConfig(Editor $editor)

Returns the additions to CKEDITOR.config for a specific CKEditor instance.

The editor's settings can be retrieved via $editor->getSettings(), but be aware that it may not yet contain plugin-specific settings, because the user may not yet have configured the form. If there are plugin-specific settings (verify with isset()), they can be found at

Parameters

Editor $editor

A configured text editor object.

Return Value

array

A keyed array, whose keys will end up as keys under CKEDITOR.config.

string[] getCssFiles(Editor $editor)

Retrieves enabled plugins' iframe instance CSS files.

Note: this does not use a Drupal asset library because this CSS will be loaded by CKEditor, not by Drupal.

Parameters

Editor $editor

A configured text editor object.

Return Value

string[]

An array of CSS files. This is a flat list of file paths relative to the Drupal root.