class CurrencyExchange in Currency 8.3
Provides a filter to exchange currencies.
Plugin annotation
@Filter(
id = "currency_exchange",
module = "currency",
title = @Translation("Currency exchange"),
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\currency\Plugin\Filter\CurrencyExchange implements ContainerFactoryPluginInterface
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of CurrencyExchange
1 file declares its use of CurrencyExchange
- CurrencyExchangeTest.php in tests/
src/ Unit/ Plugin/ Filter/ CurrencyExchangeTest.php
File
- src/
Plugin/ Filter/ CurrencyExchange.php, line 23
Namespace
Drupal\currency\Plugin\FilterView source
class CurrencyExchange extends FilterBase implements ContainerFactoryPluginInterface {
/**
* The current static::process() filter process result.
*
* @var \Drupal\filter\FilterProcessResult|null
*/
protected $currentFilterProcessResult;
/**
* The exchange rate provider.
*
* @var \Drupal\currency\Plugin\Currency\ExchangeRateProvider\ExchangeRateProviderInterface
*/
protected $exchangeRateProvider;
/**
* The input parser.
*
* @var \Commercie\Currency\InputInterface
*/
protected $input;
/**
* Constructs a new class instance
*
* @param mixed[] $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\StringTranslation\TranslationInterface
* The string translator.
* @param \Drupal\currency\Plugin\Currency\ExchangeRateProvider\ExchangeRateProviderInterface $exchange_rate_provider
* The exchange rate provider.
* @param \Commercie\Currency\InputInterface $input
* The input parser.
*/
public function __construct(array $configuration, $plugin_id, array $plugin_definition, TranslationInterface $string_translation, ExchangeRateProviderInterface $exchange_rate_provider, InputInterface $input) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->exchangeRateProvider = $exchange_rate_provider;
$this->input = $input;
$this->stringTranslation = $string_translation;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('string_translation'), $container
->get('currency.exchange_rate_provider'), $container
->get('currency.input'));
}
/**
* {@inheritdoc}
*/
public function process($text, $langcode) {
$this->currentFilterProcessResult = new FilterProcessResult($text);
$this->currentFilterProcessResult
->setProcessedText(preg_replace_callback('/\\[currency:([a-z]{3}):([a-z]{3})(.*?)\\]/i', [
$this,
'processCallback',
], $text));
$result = $this->currentFilterProcessResult;
unset($this->currentFilterProcessResult);
return $result;
}
/**
* Implements preg_replace_callback() callback.
*
* @see self::process()
*/
function processCallback(array $matches) {
$currency_code_from = $matches[1];
$currency_code_to = $matches[2];
$amount = str_replace(':', '', $matches[3]);
if (strlen($amount) !== 0) {
$amount = $this->input
->parseAmount($amount);
// The amount is invalid, so return the token.
if (!$amount) {
return $matches[0];
}
}
else {
$amount = 1;
}
$exchange_rate = $this->exchangeRateProvider
->load($currency_code_from, $currency_code_to);
$this->currentFilterProcessResult
->addCacheableDependency($exchange_rate);
if ($exchange_rate) {
return bcmul($amount, $exchange_rate
->getRate(), 6);
}
// No exchange rate could be loaded, so return the token.
return $matches[0];
}
/**
* {@inheritdoc}
*/
public function tips($long = FALSE) {
return $this
->t('Use <code>[currency:from:to:amount]</code> to convert an amount of money from one currency to another. The <code>amount</code> parameter is optional and defaults to <code>1</code>. Example: <code>[currency:EUR:USD:100]</code>.');
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CurrencyExchange:: |
protected | property | The current static::process() filter process result. | |
CurrencyExchange:: |
protected | property | The exchange rate provider. | |
CurrencyExchange:: |
protected | property | The input parser. | |
CurrencyExchange:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
CurrencyExchange:: |
public | function |
Performs the filter processing. Overrides FilterInterface:: |
|
CurrencyExchange:: |
function | Implements preg_replace_callback() callback. | ||
CurrencyExchange:: |
public | function |
Generates a filter's tip. Overrides FilterBase:: |
|
CurrencyExchange:: |
public | function |
Constructs a new class instance Overrides FilterBase:: |
|
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 | |
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 |
Generates a filter's settings form. Overrides FilterInterface:: |
3 |
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. | 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. |