class Shortcode in Shortcode 2.0.x
Same name in this branch
- 2.0.x src/Annotation/Shortcode.php \Drupal\shortcode\Annotation\Shortcode
- 2.0.x src/Plugin/Filter/Shortcode.php \Drupal\shortcode\Plugin\Filter\Shortcode
Same name and namespace in other branches
- 8 src/Plugin/Filter/Shortcode.php \Drupal\shortcode\Plugin\Filter\Shortcode
Provides a filter for insert view.
Plugin annotation
@Filter(
id = "shortcode",
module = "shortcode",
title = @Translation("Shortcodes"),
description = @Translation("Provides WP like shortcodes to text formats."),
type = Drupal\filter\Plugin\FilterInterface::TYPE_MARKUP_LANGUAGE,
)
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\shortcode\Plugin\Filter\Shortcode
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of Shortcode
1 string reference to 'Shortcode'
File
- src/
Plugin/ Filter/ Shortcode.php, line 20
Namespace
Drupal\shortcode\Plugin\FilterView source
class Shortcode extends FilterBase {
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
/** @var \Drupal\shortcode\ShortcodeService $shortcodeService */
$shortcodeService = \Drupal::service('shortcode');
$shortcodes = $shortcodeService
->loadShortcodePlugins();
$shortcodes_by_provider = [];
// Group shortcodes by provider.
foreach ($shortcodes as $shortcode_id => $shortcode_info) {
$provider_id = $shortcode_info['provider'];
if (!isset($shortcodes_by_provider[$provider_id])) {
$shortcodes_by_provider[$provider_id] = [];
}
$shortcodes_by_provider[$provider_id][$shortcode_id] = $shortcode_info;
}
// Generate form elements.
$settings = [];
foreach ($shortcodes_by_provider as $provider_id => $shortcodes) {
// Add section header.
// todo: add Translate markup.
$settings['header-' . $provider_id] = [
'#markup' => '<b class="shortcodeSectionHeader">Shortcodes provided by ' . $provider_id . '</b>',
];
// Sort definitions by weight property.
$sorted_shortcodes = $shortcodes;
uasort($sorted_shortcodes, function ($a, $b) {
return $b['weight'] - $a['weight'];
});
/** @var \Drupal\shortcode\Plugin\ShortcodeInterface $shortcode */
foreach ($sorted_shortcodes as $shortcode_id => $shortcode_info) {
$settings[$shortcode_id] = [
'#type' => 'checkbox',
'#title' => $this
->t('Enable %name shortcode', [
'%name' => $shortcode_info['title'],
]),
'#default_value' => isset($this->settings[$shortcode_id]) ? $this->settings[$shortcode_id] : TRUE,
'#description' => isset($shortcode_info['description']) ? $shortcode_info['description'] : $this
->t('Enable or disable this shortcode in this input format'),
];
}
}
return $settings;
}
/**
* {@inheritdoc}
*/
public function process($text, $langcode) {
if (!empty($text)) {
/** @var \Drupal\shortcode\ShortcodeService $shortcodeEngine */
$shortcodeEngine = \Drupal::service('shortcode');
$text = $shortcodeEngine
->process($text, $langcode, $this);
}
return new FilterProcessResult($text);
}
/**
* {@inheritdoc}
*/
public function tips($long = FALSE) {
/** @var \Drupal\shortcode\ShortcodeService $type */
$type = \Drupal::service('shortcode');
// todo: it duplicates the tips section.
// Get enabled shortcodes for this text format.
$shortcodes = $type
->getShortcodePlugins($this);
/** @var \Drupal\shortcode\ShortcodePluginManager $type */
$type = \Drupal::service('plugin.manager.shortcode');
// Gather tips defined in all enabled plugins.
$tips = [];
foreach ($shortcodes as $shortcode_info) {
/** @var \Drupal\shortcode\Plugin\ShortcodeInterface $shortcode */
$shortcode = $type
->createInstance($shortcode_info['id']);
$tips[] = $shortcode
->tips($long);
}
$output = '';
foreach ($tips as $tip) {
$output .= '<li>' . $tip . '</li>';
}
// todo: add render array instead of li/ul markup.
// todo: add Translate markup.
return '<p>You can use wp-like shortcodes such as: </p><ul>' . $output . '</ul>';
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
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 default configuration for this plugin. Overrides ConfigurableInterface:: |
|
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 |
FilterBase:: |
public | function |
Constructs a \Drupal\Component\Plugin\PluginBase object. Overrides PluginBase:: |
4 |
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. | ||
MessengerTrait:: |
protected | property | The messenger. | 27 |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
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:: |
2 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
Shortcode:: |
public | function |
Performs the filter processing. Overrides FilterInterface:: |
|
Shortcode:: |
public | function |
Generates a filter's settings form. Overrides FilterBase:: |
|
Shortcode:: |
public | function |
Generates a filter's tip. Overrides FilterBase:: |
|
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
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. |