class AmazonFieldFormatter in Amazon Product Advertisement API 8.2
Plugin implementation of the 'amazon_field_formatter' formatter.
Plugin annotation
@FieldFormatter(
id = "amazon_field_formatter",
label = @Translation("Amazon field formatter"),
field_types = {
"amazon_asin_field"
}
)
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\amazon_field\Plugin\Field\FieldFormatter\AmazonFieldFormatter
- 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 AmazonFieldFormatter
File
- modules/
amazon_field/ src/ Plugin/ Field/ FieldFormatter/ AmazonFieldFormatter.php, line 24
Namespace
Drupal\amazon_field\Plugin\Field\FieldFormatterView source
class AmazonFieldFormatter extends FormatterBase {
/**
* Contians a list of display options for this formatter.
*
* @var array
*/
protected $templateOptions = [];
public function __construct($plugin_id, $plugin_definition, \Drupal\Core\Field\FieldDefinitionInterface $field_definition, array $settings, $label, $view_mode, array $third_party_settings) {
parent::__construct($plugin_id, $plugin_definition, $field_definition, $settings, $label, $view_mode, $third_party_settings);
$this->templateOptions = [
'inline' => $this
->t('Item title'),
'image_small' => $this
->t('Small image'),
'image_medium' => $this
->t('Medium image'),
'image_large' => $this
->t('Large image'),
];
}
/**
* {@inheritdoc}
*/
public static function defaultSettings() {
$defaultMaxAge = \Drupal::config('amazon.settings')
->get('default_max_age');
if (is_null($defaultMaxAge)) {
throw new \InvalidArgumentException('Missing Amazon settings: default max age.');
}
return array(
'max_age' => $defaultMaxAge,
'template' => 'image_large',
'advanced' => [
'extraResponseGroups' => '',
],
) + parent::defaultSettings();
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
$defaultMaxAge = \Drupal::config('amazon.settings')
->get('default_max_age');
$form['max_age'] = [
'#type' => 'textfield',
'#title' => $this
->t('Max age for cached results'),
'#description' => $this
->t('The number of seconds that the system should cache the results from Amazon\'s servers. Leave blank to use the default max age set on the <a href=":url">Amazon settings page</a>, currently set at @default_max_age seconds.', [
':url' => Url::fromRoute('amazon.settings_form')
->toString(),
'@default_max_age' => $defaultMaxAge,
]),
'#default_value' => $this
->getSetting('max_age') == $defaultMaxAge ? '' : $this
->getSetting('max_age'),
];
$form['template'] = [
'#type' => 'select',
'#title' => $this
->t('Display item as'),
'#description' => $this
->t('By default, all options will link to the item in the Amazon store tagged with your Associates ID.'),
'#options' => $this->templateOptions,
'#default_value' => $this
->getSetting('template'),
];
$form['advanced'] = [
'#type' => 'details',
'#title' => $this
->t('Advanced options'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
];
$form['advanced']['extraResponseGroups'] = [
'#type' => 'textarea',
'#title' => $this
->t('Additional response groups'),
'#description' => $this
->t('Use this field to add additional <a href="@amazon_link">response groups</a> to the information supplied to templates. This is only needed if you are overwriting the Twig templates and want addition product information. One response group per line, response groups <em>Small</em> and <em>Images</em> are included by default.', [
'@amazon_link' => Url::fromUri('http://docs.aws.amazon.com/AWSECommerceService/latest/DG/CHAP_ResponseGroupsList.html'),
]),
'#default_value' => $this
->getSettings()['advanced']['extraResponseGroups'],
];
return $form + parent::settingsForm($form, $form_state);
}
/**
* {@inheritdoc}
*/
public function settingsSummary() {
$summary = [];
$settings = $this
->getSettings();
$summary[] = $this
->t('Display as: @template', [
'@template' => $this->templateOptions[$settings['template']],
]);
if (!empty($settings['max_age'])) {
$summary[] = $this
->t('Cache max age: @max_age', [
'@max_age' => $settings['max_age'],
]);
}
if (!empty($settings['advanced']['extraResponseGroups'])) {
$summary[] = $this
->t('Includes extra response groups.');
}
return $summary;
}
/**
* {@inheritdoc}
*/
public function viewElements(FieldItemListInterface $items, $langcode) {
$elements = [];
$asins = [];
foreach ($items as $delta => $item) {
if (!$item
->isEmpty()) {
$asins[$item->value] = $item->value;
}
}
// Nothing to render.
if (empty($asins)) {
return $elements;
}
$associatesId = \Drupal::config('amazon.settings')
->get('associates_id');
$amazon = new Amazon($associatesId);
// Include Small and Images response groups along with any specified.
$responseGroups = [
'Small',
'Images',
];
if (!empty($this
->getSettings()['advanced']['extraResponseGroups'])) {
$responseGroups = array_merge($responseGroups, explode("\n", $this
->getSettings()['advanced']['extraResponseGroups']));
}
$results = $amazon
->lookup($asins, $responseGroups);
// No results from Amazon.
if (empty($results[0])) {
return $elements;
}
$max_age = $this
->getSetting('max_age');
$basicBuild = [
'#max_age' => $max_age,
];
// Use the correct Twig template based on the "template" specified.
switch (strtolower($this
->getSetting('template'))) {
case 'inline':
$basicBuild['#theme'] = 'amazon_inline';
break;
case 'image_small':
$basicBuild['#theme'] = 'amazon_image';
$basicBuild['#size'] = 'small';
break;
case 'image_medium':
$basicBuild['#theme'] = 'amazon_image';
$basicBuild['#size'] = 'medium';
break;
case 'image_large':
$basicBuild['#theme'] = 'amazon_image';
$basicBuild['#size'] = 'large';
break;
default:
// Unknown template specified.
return $elements;
}
// Add some template suggestions. Note these won't show up in the template
// debug code until https://www.drupal.org/node/2118743 is fixed.
$basicBuild['#bundle'] = $this->fieldDefinition
->getTargetBundle();
$basicBuild['#field'] = $this->fieldDefinition
->getName();
foreach ($results as $delta => $result) {
$elements[$delta] = $basicBuild + [
'#results' => $result,
];
}
return $elements;
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AmazonFieldFormatter:: |
protected | property | Contians a list of display options for this formatter. | |
AmazonFieldFormatter:: |
public static | function |
Defines the default settings for this plugin. Overrides PluginSettingsBase:: |
|
AmazonFieldFormatter:: |
public | function |
Returns a form to configure settings for the formatter. Overrides FormatterBase:: |
|
AmazonFieldFormatter:: |
public | function |
Returns a short summary for the current formatter settings. Overrides FormatterBase:: |
|
AmazonFieldFormatter:: |
public | function |
Builds a renderable array for a field value. Overrides FormatterInterface:: |
|
AmazonFieldFormatter:: |
public | function |
Constructs a FormatterBase object. Overrides FormatterBase:: |
|
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 | |
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:: |
11 |
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:: |
public | function |
Builds a renderable array for a fully themed field. Overrides FormatterInterface:: |
1 |
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. | |
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. | 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. |