class CkeditorTemplates in CKEditor Templates 8
Defines the "Templates" plugin.
Plugin annotation
@CKEditorPlugin(
id = "templates",
label = @Translation("Templates")
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\ckeditor\CKEditorPluginBase implements CKEditorPluginButtonsInterface, CKEditorPluginInterface
- class \Drupal\ckeditor_templates\Plugin\CKEditorPlugin\CkeditorTemplates implements CKEditorPluginConfigurableInterface, ContainerFactoryPluginInterface
- class \Drupal\ckeditor\CKEditorPluginBase implements CKEditorPluginButtonsInterface, CKEditorPluginInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of CkeditorTemplates
File
- src/
Plugin/ CKEditorPlugin/ CkeditorTemplates.php, line 21
Namespace
Drupal\ckeditor_templates\Plugin\CKEditorPluginView source
class CkeditorTemplates extends CKEditorPluginBase implements CKEditorPluginConfigurableInterface, ContainerFactoryPluginInterface {
/**
* Configuration Factory Service.
*
* @var \Drupal\Core\Config\ConfigFactory
*/
private $configFactoryService;
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('config.factory'));
}
/**
* Constructs a Drupal\Component\Plugin\PluginBase 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\Config\ConfigFactory $configFactoryService
* Drupal Configuration Factory Service.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, ConfigFactory $configFactoryService) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->configFactoryService = $configFactoryService;
}
/**
* {@inheritdoc}
*/
public function getFile() {
return $this
->getTemplatesPluginPath() . '/plugin.js';
}
/**
* {@inheritdoc}
*/
public function getLibraries(Editor $editor) {
return [
'ckeditor_templates/ckeditor.templates.dialog',
];
}
/**
* {@inheritdoc}
*/
public function getButtons() {
return [
'Templates' => [
'label' => t('Templates'),
'image' => $this
->getTemplatesPluginPath() . '/icons/templates.png',
],
];
}
/**
* {@inheritdoc}
*/
public function getConfig(Editor $editor) {
$config = [];
$settings = $editor
->getSettings();
// Set replace content default value if set.
if (isset($settings['plugins']['templates']['replace_content'])) {
$config['templates_replaceContent'] = $settings['plugins']['templates']['replace_content'];
}
// Set template files default value if set.
if (isset($settings['plugins']['templates']['template_path']) && !empty($settings['plugins']['templates']['template_path'])) {
$config['templates_files'] = [
$settings['plugins']['templates']['template_path'],
];
}
else {
// Use templates plugin default file.
$config['templates_files'] = $this
->getTemplatesDefaultPath();
}
return $config;
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state, Editor $editor) {
// Defaults.
$config = [
'replace_content' => FALSE,
'template_path' => '',
];
$settings = $editor
->getSettings();
if (isset($settings['plugins']['templates'])) {
$config = $settings['plugins']['templates'];
}
$form['template_path'] = [
'#title' => t('Template definition file'),
'#type' => 'textfield',
'#default_value' => $config['template_path'],
'#description' => t('Path to the javascript file defining the templates, relative to drupal root (starting with "/"). By default, it looks in your default theme directory for a file named "templates/ckeditor_templates.js"'),
];
$form['replace_content'] = [
'#title' => t('Replace content default value'),
'#type' => 'checkbox',
'#default_value' => $config['replace_content'],
'#description' => t('Whether the "Replace actual contents" checkbox is checked by default in the Templates dialog'),
];
$form['#attached']['library'][] = 'ckeditor_templates/ckeditor.templates.admin';
return $form;
}
/**
* Return ckeditor templates plugin path relative to drupal root.
*
* @return string
* Relative path to the ckeditor plugin folder
*/
private function getTemplatesPluginPath() {
$pluginPath = 'libraries/ckeditor/plugins/templates';
if (!file_exists(DRUPAL_ROOT . '/' . $pluginPath)) {
// keep supporting module legacy path to avoid breaking change
// using this path is deprecated
$pluginPath = 'libraries/templates';
}
return $pluginPath;
}
/**
* Generate the path to the template file.
*
* The file will be picked from :
* - the default theme if the file exists
* - the ckeditor template directory otherwise.
*
* @return array
* List of path to the template file
*/
private function getTemplatesDefaultPath() {
// Default to module folder.
$defaultPath = base_path() . $this
->getTemplatesPluginPath() . '/templates/default.js';
// Get site default theme name.
$defaultThemConfig = $this->configFactoryService
->get('system.theme');
$defaultThemeName = $defaultThemConfig
->get('default');
$defaultThemeFileAbsolutePath = DRUPAL_ROOT . '/' . drupal_get_path('theme', $defaultThemeName) . '/templates/ckeditor_templates.js';
if (file_exists($defaultThemeFileAbsolutePath)) {
$defaultPath = base_path() . drupal_get_path('theme', $defaultThemeName) . '/templates/ckeditor_templates.js';
}
return [
$defaultPath,
];
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CKEditorPluginBase:: |
public | function |
Returns a list of plugins this plugin requires. Overrides CKEditorPluginInterface:: |
1 |
CKEditorPluginBase:: |
public | function |
Indicates if this plugin is part of the optimized CKEditor build. Overrides CKEditorPluginInterface:: |
4 |
CkeditorTemplates:: |
private | property | Configuration Factory Service. | |
CkeditorTemplates:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
CkeditorTemplates:: |
public | function |
Returns the buttons that this plugin provides, along with metadata. Overrides CKEditorPluginButtonsInterface:: |
|
CkeditorTemplates:: |
public | function |
Returns the additions to CKEDITOR.config for a specific CKEditor instance. Overrides CKEditorPluginInterface:: |
|
CkeditorTemplates:: |
public | function |
Returns the Drupal root-relative file path to the plugin JavaScript file. Overrides CKEditorPluginInterface:: |
|
CkeditorTemplates:: |
public | function |
Returns a list of libraries this plugin requires. Overrides CKEditorPluginBase:: |
|
CkeditorTemplates:: |
private | function | Generate the path to the template file. | |
CkeditorTemplates:: |
private | function | Return ckeditor templates plugin path relative to drupal root. | |
CkeditorTemplates:: |
public | function |
Returns a settings form to configure this CKEditor plugin. Overrides CKEditorPluginConfigurableInterface:: |
|
CkeditorTemplates:: |
public | function |
Constructs a Drupal\Component\Plugin\PluginBase object. Overrides PluginBase:: |
|
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 | |
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. |