class InteractiveFormatter in Facebook Instant Articles 3.x
Same name and namespace in other branches
- 8.2 src/Plugin/Field/FieldFormatter/InteractiveFormatter.php \Drupal\fb_instant_articles\Plugin\Field\FieldFormatter\InteractiveFormatter
Plugin implementation of the 'fbia_interactive' formatter.
Plugin annotation
@FieldFormatter(
id = "fbia_interactive",
label = @Translation("FBIA Interactive"),
field_types = {
"string",
"string_long"
}
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Field\FormatterBase implements FormatterInterface, ContainerFactoryPluginInterface
- class \Drupal\fb_instant_articles\Plugin\Field\FieldFormatter\FormatterBase implements InstantArticleFormatterInterface
- class \Drupal\fb_instant_articles\Plugin\Field\FieldFormatter\InteractiveFormatter
- class \Drupal\fb_instant_articles\Plugin\Field\FieldFormatter\FormatterBase implements InstantArticleFormatterInterface
- class \Drupal\Core\Field\FormatterBase implements FormatterInterface, ContainerFactoryPluginInterface
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of InteractiveFormatter
File
- src/
Plugin/ Field/ FieldFormatter/ InteractiveFormatter.php, line 24
Namespace
Drupal\fb_instant_articles\Plugin\Field\FieldFormatterView source
class InteractiveFormatter extends FormatterBase {
/**
* {@inheritdoc}
*/
public static function defaultSettings() {
return [
'source_type' => self::SOURCE_TYPE_URL,
'width' => NULL,
'height' => NULL,
'margin' => Interactive::NO_MARGIN,
] + parent::defaultSettings();
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
$element['source_type'] = [
'#type' => 'select',
'#title' => $this
->t('Source type'),
'#description' => $this
->t('Add your tracker specifying the URL or embed the full unescaped HTML'),
'#default_value' => $this
->getSetting('source_type'),
'#options' => [
self::SOURCE_TYPE_URL => $this
->t('URL'),
self::SOURCE_TYPE_HTML => $this
->t('Embedded HTML'),
],
];
$element['width'] = [
'#type' => 'number',
'#title' => $this
->t('Width'),
'#description' => $this
->t('The width of your interactive graphic.'),
'#default_value' => $this
->getSetting('width'),
];
$element['height'] = [
'#type' => 'number',
'#title' => $this
->t('Height'),
'#description' => $this
->t('The height of your interactive graphic.'),
'#default_value' => $this
->getSetting('height'),
];
$element['margin'] = [
'#type' => 'select',
'#title' => t('Margin'),
'#description' => t('The margin setting of your intereactive graphic.'),
'#default_value' => $this
->getSetting('margin'),
'#options' => [
Interactive::NO_MARGIN => $this
->t('No margin'),
Interactive::COLUMN_WIDTH => t('Column width'),
],
];
return $element;
}
/**
* {@inheritdoc}
*/
public function settingsSummary() {
$summary = [];
if ($source_type = $this
->getSetting('source_type')) {
$summary[] = $source_type === self::SOURCE_TYPE_URL ? $this
->t('URL') : $this
->t('Embedded HTML');
}
if ($width = $this
->getSetting('width')) {
$summary[] = $this
->t('Width: @width', [
'@width' => $width,
]);
}
if ($height = $this
->getSetting('height')) {
$summary[] = $this
->t('Height: @height', [
'@height' => $height,
]);
}
$margin = $this
->getSetting('margin');
$summary[] = $this
->t('Margin setting: @margin', [
'@margin' => $margin === Interactive::NO_MARGIN ? $this
->t('No margin') : $this
->t('Column width'),
]);
return $summary;
}
/**
* {@inheritdoc}
*/
public function viewInstantArticle(FieldItemListInterface $items, InstantArticle $article, $region, NormalizerInterface $normalizer, $langcode = NULL) {
foreach ($items as $delta => $item) {
// Create the interactive object per the field settings.
$interactive = Interactive::create();
if ($width = $this
->getSetting('width')) {
$interactive
->withWidth((int) $width);
}
if ($height = $this
->getSetting('height')) {
$interactive
->withHeight((int) $height);
}
if ($this
->getSetting('source_type') === self::SOURCE_TYPE_HTML) {
$interactive
->withHTML($this
->getItemValue($item));
}
else {
$interactive
->withSource($this
->getItemValue($item));
}
// Interactive elements can only be added to the content of the article,
// ignore $region setting and add to the Body.
$article
->addChild($interactive);
}
}
/**
* Return the value for the interactive embed that we are interested in.
*
* @param \Drupal\Core\Field\FieldItemInterface $item
* Field item.
*
* @return mixed
* The value of the given field item that stores the Ad value we're
* interested in.
*/
protected function getItemValue(FieldItemInterface $item) {
return $item->value;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
FormatterBase:: |
protected | property | The field definition. | |
FormatterBase:: |
protected | property | The label display setting. | |
FormatterBase:: |
protected | property |
The formatter settings. Overrides PluginSettingsBase:: |
|
FormatterBase:: |
protected | property | The view mode. | |
FormatterBase:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
12 |
FormatterBase:: |
protected | function | Returns the value of a field setting. | |
FormatterBase:: |
protected | function | Returns the array of field settings. | |
FormatterBase:: |
public static | function |
Returns if the formatter can be used for the provided field. Overrides FormatterInterface:: |
14 |
FormatterBase:: |
public | function |
Allows formatters to load information for field values being displayed. Overrides FormatterInterface:: |
2 |
FormatterBase:: |
constant | |||
FormatterBase:: |
constant | |||
FormatterBase:: |
public | function |
Builds a renderable array for a fully themed field. Overrides FormatterInterface:: |
1 |
FormatterBase:: |
public | function |
Builds a renderable array for a field value. Overrides FormatterInterface:: |
|
FormatterBase:: |
public | function |
Constructs a FormatterBase object. Overrides PluginBase:: |
12 |
InteractiveFormatter:: |
public static | function |
Defines the default settings for this plugin. Overrides PluginSettingsBase:: |
1 |
InteractiveFormatter:: |
protected | function | Return the value for the interactive embed that we are interested in. | 1 |
InteractiveFormatter:: |
public | function |
Returns a form to configure settings for the formatter. Overrides FormatterBase:: |
1 |
InteractiveFormatter:: |
public | function |
Returns a short summary for the current formatter settings. Overrides FormatterBase:: |
1 |
InteractiveFormatter:: |
public | function |
Modifies the given instant article with the contents of this field. Overrides InstantArticleFormatterInterface:: |
|
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. | |
PluginSettingsBase:: |
protected | property | Whether default settings have been merged into the current $settings. | |
PluginSettingsBase:: |
protected | property | The plugin settings injected by third party modules. | |
PluginSettingsBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
6 |
PluginSettingsBase:: |
public | function |
Returns the value of a setting, or its default value if absent. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Returns the array of settings, including defaults for missing settings. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets the list of third parties that store information. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets all third-party settings of a given module. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
protected | function | Merges default settings values into $settings. | |
PluginSettingsBase:: |
public | function |
Informs the plugin that some configuration it depends on will be deleted. Overrides PluginSettingsInterface:: |
3 |
PluginSettingsBase:: |
public | function |
Sets the value of a setting for the plugin. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Sets the settings for the plugin. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Sets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Unsets a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
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. |