You are here

public function OEmbed::getMetadataAttributes in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/media/src/Plugin/media/Source/OEmbed.php \Drupal\media\Plugin\media\Source\OEmbed::getMetadataAttributes()

Gets a list of metadata attributes provided by this plugin.

Most media sources have associated metadata, describing attributes such as:

  • dimensions
  • duration
  • encoding
  • date
  • location
  • permalink
  • licensing information
  • ...

This method should list all metadata attributes that a media source MAY offer. In other words: it is possible that a particular media item does not contain a certain attribute. For example: an oEmbed media source can contain both video and images. Images don't have a duration, but videos do.

(The term 'attributes' was chosen because it cannot be confused with 'fields' and 'properties', both of which are concepts in Drupal's Entity Field API.)

Return value

array Associative array with:

  • keys: metadata attribute names
  • values: human-readable labels for those attribute names

Overrides MediaSourceInterface::getMetadataAttributes

File

core/modules/media/src/Plugin/media/Source/OEmbed.php, line 198

Class

OEmbed
Provides a media source plugin for oEmbed resources.

Namespace

Drupal\media\Plugin\media\Source

Code

public function getMetadataAttributes() {
  return [
    'type' => $this
      ->t('Resource type'),
    'title' => $this
      ->t('Resource title'),
    'author_name' => $this
      ->t('The name of the author/owner'),
    'author_url' => $this
      ->t('The URL of the author/owner'),
    'provider_name' => $this
      ->t("The name of the provider"),
    'provider_url' => $this
      ->t('The URL of the provider'),
    'cache_age' => $this
      ->t('Suggested cache lifetime'),
    'default_name' => $this
      ->t('Default name of the media item'),
    'thumbnail_uri' => $this
      ->t('Local URI of the thumbnail'),
    'thumbnail_width' => $this
      ->t('Thumbnail width'),
    'thumbnail_height' => $this
      ->t('Thumbnail height'),
    'url' => $this
      ->t('The source URL of the resource'),
    'width' => $this
      ->t('The width of the resource'),
    'height' => $this
      ->t('The height of the resource'),
    'html' => $this
      ->t('The HTML representation of the resource'),
  ];
}