class AggregatorFeedBlock in Zircon Profile 8
Same name and namespace in other branches
- 8.0 core/modules/aggregator/src/Plugin/Block/AggregatorFeedBlock.php \Drupal\aggregator\Plugin\Block\AggregatorFeedBlock
Provides an 'Aggregator feed' block with the latest items from the feed.
Plugin annotation
@Block(
id = "aggregator_feed_block",
admin_label = @Translation("Aggregator feed"),
category = @Translation("Lists (Views)")
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Component\Plugin\ContextAwarePluginBase implements ContextAwarePluginInterface
- class \Drupal\Core\Plugin\ContextAwarePluginBase implements ContextAwarePluginInterface uses DependencySerializationTrait, StringTranslationTrait, TypedDataTrait
- class \Drupal\Core\Block\BlockBase implements BlockPluginInterface uses ContextAwarePluginAssignmentTrait
- class \Drupal\aggregator\Plugin\Block\AggregatorFeedBlock implements ContainerFactoryPluginInterface
- class \Drupal\Core\Block\BlockBase implements BlockPluginInterface uses ContextAwarePluginAssignmentTrait
- class \Drupal\Core\Plugin\ContextAwarePluginBase implements ContextAwarePluginInterface uses DependencySerializationTrait, StringTranslationTrait, TypedDataTrait
- class \Drupal\Component\Plugin\ContextAwarePluginBase implements ContextAwarePluginInterface
Expanded class hierarchy of AggregatorFeedBlock
File
- core/
modules/ aggregator/ src/ Plugin/ Block/ AggregatorFeedBlock.php, line 30 - Contains \Drupal\aggregator\Plugin\Block\AggregatorFeedBlock.
Namespace
Drupal\aggregator\Plugin\BlockView source
class AggregatorFeedBlock extends BlockBase implements ContainerFactoryPluginInterface {
/**
* The entity storage for feeds.
*
* @var \Drupal\aggregator\FeedStorageInterface
*/
protected $feedStorage;
/**
* The entity storage for items.
*
* @var \Drupal\aggregator\ItemStorageInterface
*/
protected $itemStorage;
/**
* The entity query object for feed items.
*
* @var \Drupal\Core\Entity\Query\QueryInterface
*/
protected $itemQuery;
/**
* Constructs an AggregatorFeedBlock 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\aggregator\FeedStorageInterface $feed_storage
* The entity storage for feeds.
* @param \Drupal\aggregator\ItemStorageInterface $item_storage
* The entity storage for feed items.
* @param \Drupal\Core\Entity\Query\QueryInterface $item_query
* The entity query object for feed items.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, FeedStorageInterface $feed_storage, ItemStorageInterface $item_storage, QueryInterface $item_query) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->feedStorage = $feed_storage;
$this->itemStorage = $item_storage;
$this->itemQuery = $item_query;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('entity.manager')
->getStorage('aggregator_feed'), $container
->get('entity.manager')
->getStorage('aggregator_item'), $container
->get('entity.query')
->get('aggregator_item'));
}
/**
* {@inheritdoc}
*/
public function defaultConfiguration() {
// By default, the block will contain 10 feed items.
return array(
'block_count' => 10,
'feed' => NULL,
);
}
/**
* {@inheritdoc}
*/
protected function blockAccess(AccountInterface $account) {
// Only grant access to users with the 'access news feeds' permission.
return AccessResult::allowedIfHasPermission($account, 'access news feeds');
}
/**
* {@inheritdoc}
*/
public function blockForm($form, FormStateInterface $form_state) {
$feeds = $this->feedStorage
->loadMultiple();
$options = array();
foreach ($feeds as $feed) {
$options[$feed
->id()] = $feed
->label();
}
$form['feed'] = array(
'#type' => 'select',
'#title' => $this
->t('Select the feed that should be displayed'),
'#default_value' => $this->configuration['feed'],
'#options' => $options,
);
$range = range(2, 20);
$form['block_count'] = array(
'#type' => 'select',
'#title' => $this
->t('Number of news items in block'),
'#default_value' => $this->configuration['block_count'],
'#options' => array_combine($range, $range),
);
return $form;
}
/**
* {@inheritdoc}
*/
public function blockSubmit($form, FormStateInterface $form_state) {
$this->configuration['block_count'] = $form_state
->getValue('block_count');
$this->configuration['feed'] = $form_state
->getValue('feed');
}
/**
* {@inheritdoc}
*/
public function build() {
// Load the selected feed.
if ($feed = $this->feedStorage
->load($this->configuration['feed'])) {
$result = $this->itemQuery
->condition('fid', $feed
->id())
->range(0, $this->configuration['block_count'])
->sort('timestamp', 'DESC')
->sort('iid', 'DESC')
->execute();
if ($result) {
// Only display the block if there are items to show.
$items = $this->itemStorage
->loadMultiple($result);
$build['list'] = [
'#theme' => 'item_list',
'#items' => [],
];
foreach ($items as $item) {
$build['list']['#items'][$item
->id()] = [
'#type' => 'link',
'#url' => $item
->urlInfo(),
'#title' => $item
->label(),
];
}
$build['more_link'] = [
'#type' => 'more_link',
'#url' => $feed
->urlInfo(),
'#attributes' => [
'title' => $this
->t("View this feed's recent news."),
],
];
return $build;
}
}
}
/**
* {@inheritdoc}
*/
public function getCacheTags() {
$cache_tags = parent::getCacheTags();
$feed = $this->feedStorage
->load($this->configuration['feed']);
return Cache::mergeTags($cache_tags, $feed
->getCacheTags());
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AggregatorFeedBlock:: |
protected | property | The entity storage for feeds. | |
AggregatorFeedBlock:: |
protected | property | The entity query object for feed items. | |
AggregatorFeedBlock:: |
protected | property | The entity storage for items. | |
AggregatorFeedBlock:: |
protected | function |
Indicates whether the block should be shown. Overrides BlockBase:: |
|
AggregatorFeedBlock:: |
public | function |
Returns the configuration form elements specific to this block plugin. Overrides BlockBase:: |
|
AggregatorFeedBlock:: |
public | function |
Adds block type-specific submission handling for the block form. Overrides BlockBase:: |
|
AggregatorFeedBlock:: |
public | function |
Builds and returns the renderable array for this block plugin. Overrides BlockPluginInterface:: |
|
AggregatorFeedBlock:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
AggregatorFeedBlock:: |
public | function |
Gets default configuration for this plugin. Overrides BlockBase:: |
|
AggregatorFeedBlock:: |
public | function |
Overrides ContextAwarePluginBase:: |
|
AggregatorFeedBlock:: |
public | function |
Constructs an AggregatorFeedBlock object. Overrides BlockBase:: |
|
BlockBase:: |
protected | property | The transliteration service. | |
BlockBase:: |
public | function |
Indicates whether the block should be shown. Overrides BlockPluginInterface:: |
|
BlockBase:: |
protected | function | Returns generic default configuration for block plugins. | |
BlockBase:: |
public | function |
Adds block type-specific validation for the block form. Overrides BlockPluginInterface:: |
1 |
BlockBase:: |
public | function |
Creates a generic configuration form for all block types. Individual
block plugins can add elements to this form by overriding
BlockBase::blockForm(). Most block plugins should not override this
method unless they need to alter the generic form elements. Overrides PluginFormInterface:: |
1 |
BlockBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
|
BlockBase:: |
public | function |
Gets this plugin's configuration. Overrides ConfigurablePluginInterface:: |
1 |
BlockBase:: |
public | function |
Suggests a machine name to identify an instance of this block. Overrides BlockPluginInterface:: |
1 |
BlockBase:: |
public | function |
Returns the user-facing block label. Overrides BlockPluginInterface:: |
|
BlockBase:: |
public | function |
Sets the configuration for this plugin instance. Overrides ConfigurablePluginInterface:: |
|
BlockBase:: |
public | function |
Sets a particular value in the block settings. Overrides BlockPluginInterface:: |
|
BlockBase:: |
public | function | Sets the transliteration service. | |
BlockBase:: |
public | function |
Most block plugins should not override this method. To add submission
handling for a specific block type, override BlockBase::blockSubmit(). Overrides PluginFormInterface:: |
|
BlockBase:: |
protected | function | Wraps the transliteration service. | |
BlockBase:: |
public | function |
Most block plugins should not override this method. To add validation
for a specific block type, override BlockBase::blockValidate(). Overrides PluginFormInterface:: |
|
ContextAwarePluginAssignmentTrait:: |
protected | function | Builds a form element for assigning a context to a given slot. | |
ContextAwarePluginAssignmentTrait:: |
protected | function | Wraps the context handler. | |
ContextAwarePluginAssignmentTrait:: |
abstract protected | function | Ensures the t() method is available. | |
ContextAwarePluginBase:: |
protected | property | The data objects representing the context of this plugin. | |
ContextAwarePluginBase:: |
protected | function |
Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function | 9 | |
ContextAwarePluginBase:: |
public | function | 7 | |
ContextAwarePluginBase:: |
public | function |
Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function |
Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function |
Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function |
Gets a mapping of the expected assignment names to their context names. Overrides ContextAwarePluginInterface:: |
|
ContextAwarePluginBase:: |
public | function |
Gets the defined contexts. Overrides ContextAwarePluginInterface:: |
|
ContextAwarePluginBase:: |
public | function |
Gets the value for a defined context. Overrides ContextAwarePluginInterface:: |
|
ContextAwarePluginBase:: |
public | function |
Gets the values for all defined contexts. Overrides ContextAwarePluginInterface:: |
|
ContextAwarePluginBase:: |
public | function |
Set a context on this plugin. Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function |
Sets a mapping of the expected assignment names to their context names. Overrides ContextAwarePluginInterface:: |
|
ContextAwarePluginBase:: |
public | function |
Sets the value for a defined context. Overrides ContextAwarePluginBase:: |
|
ContextAwarePluginBase:: |
public | function |
Validates the set values for the defined contexts. Overrides ContextAwarePluginInterface:: |
|
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 2 |
PluginBase:: |
protected | property | The plugin implementation definition. | |
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:: |
|
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
StringTranslationTrait:: |
protected | property | The string translation service. | |
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 |
TypedDataTrait:: |
protected | property | The typed data manager used for creating the data types. | |
TypedDataTrait:: |
public | function | Gets the typed data manager. | 1 |
TypedDataTrait:: |
public | function | Sets the typed data manager. | 1 |