class FileViewsData
Same name in other branches
- 9 core/modules/file/src/FileViewsData.php \Drupal\file\FileViewsData
- 8.9.x core/modules/file/src/FileViewsData.php \Drupal\file\FileViewsData
- 11.x core/modules/file/src/FileViewsData.php \Drupal\file\FileViewsData
Provides views data for the file entity type.
Hierarchy
- class \Drupal\views\EntityViewsData implements \Drupal\Core\Entity\EntityHandlerInterface, \Drupal\views\EntityViewsDataInterface uses \Drupal\Core\StringTranslation\StringTranslationTrait
- class \Drupal\file\FileViewsData extends \Drupal\views\EntityViewsData
Expanded class hierarchy of FileViewsData
File
-
core/
modules/ file/ src/ FileViewsData.php, line 10
Namespace
Drupal\fileView source
class FileViewsData extends EntityViewsData {
/**
* {@inheritdoc}
*/
public function getViewsData() {
$data = parent::getViewsData();
// @todo There is no corresponding information in entity metadata.
$data['file_managed']['table']['base']['help'] = $this->t('Files maintained by Drupal and various modules.');
$data['file_managed']['table']['base']['defaults']['field'] = 'filename';
$data['file_managed']['table']['wizard_id'] = 'file_managed';
$data['file_managed']['fid']['argument'] = [
'id' => 'file_fid',
// The field to display in the summary.
'name field' => 'filename',
'numeric' => TRUE,
];
$data['file_managed']['fid']['relationship'] = [
'title' => $this->t('File usage'),
'help' => $this->t('Relate file entities to their usage.'),
'id' => 'standard',
'base' => 'file_usage',
'base field' => 'fid',
'field' => 'fid',
'label' => $this->t('File usage'),
];
$data['file_managed']['uri']['field']['default_formatter'] = 'file_uri';
$data['file_managed']['filemime']['field']['default_formatter'] = 'file_filemime';
$data['file_managed']['extension'] = [
'title' => $this->t('Extension'),
'help' => $this->t('The extension of the file.'),
'real field' => 'filename',
'field' => [
'entity_type' => 'file',
'field_name' => 'filename',
'default_formatter' => 'file_extension',
'id' => 'field',
'click sortable' => FALSE,
],
];
$data['file_managed']['filesize']['field']['default_formatter'] = 'file_size';
$data['file_managed']['status']['field']['default_formatter_settings'] = [
'format' => 'custom',
'format_custom_false' => $this->t('Temporary'),
'format_custom_true' => $this->t('Permanent'),
];
$data['file_managed']['status']['filter']['id'] = 'file_status';
$data['file_managed']['uid']['relationship']['title'] = $this->t('User who uploaded');
$data['file_managed']['uid']['relationship']['label'] = $this->t('User who uploaded');
$data['file_usage']['table']['group'] = $this->t('File Usage');
// Provide field-type-things to several base tables; on the core files table
// ("file_managed") so that we can create relationships from files to
// entities, and then on each core entity type base table so that we can
// provide general relationships between entities and files.
$data['file_usage']['table']['join'] = [
'file_managed' => [
'field' => 'fid',
'left_field' => 'fid',
],
// Link ourselves to the {node_field_data} table
// so we can provide node->file relationships.
'node_field_data' => [
'join_id' => 'casted_int_field_join',
'cast' => 'right',
'field' => 'id',
'left_field' => 'nid',
'extra' => [
[
'field' => 'type',
'value' => 'node',
],
],
],
// Link ourselves to the {users_field_data} table
// so we can provide user->file relationships.
'users_field_data' => [
'join_id' => 'casted_int_field_join',
'cast' => 'right',
'field' => 'id',
'left_field' => 'uid',
'extra' => [
[
'field' => 'type',
'value' => 'user',
],
],
],
// Link ourselves to the {comment_field_data} table
// so we can provide comment->file relationships.
'comment' => [
'join_id' => 'casted_int_field_join',
'cast' => 'right',
'field' => 'id',
'left_field' => 'cid',
'extra' => [
[
'field' => 'type',
'value' => 'comment',
],
],
],
// Link ourselves to the {taxonomy_term_field_data} table
// so we can provide taxonomy_term->file relationships.
'taxonomy_term_data' => [
'join_id' => 'casted_int_field_join',
'cast' => 'right',
'field' => 'id',
'left_field' => 'tid',
'extra' => [
[
'field' => 'type',
'value' => 'taxonomy_term',
],
],
],
];
// Provide a relationship between the files table and each entity type,
// and between each entity type and the files table. Entity->file
// relationships are type-restricted in the joins declared above, and
// file->entity relationships are type-restricted in the relationship
// declarations below.
// Describes relationships between files and nodes.
$data['file_usage']['file_to_node'] = [
'title' => $this->t('Content'),
'help' => $this->t('Content that is associated with this file, usually because this file is in a field on the content.'),
// Only provide this field/relationship/etc.,
// when the 'file_managed' base table is present.
'skip base' => [
'node_field_data',
'node_field_revision',
'users_field_data',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'id',
'relationship' => [
'id' => 'standard',
'join_id' => 'casted_int_field_join',
'cast' => 'left',
'title' => $this->t('Content'),
'label' => $this->t('Content'),
'base' => 'node_field_data',
'base field' => 'nid',
'relationship field' => 'id',
'extra' => [
[
'table' => 'file_usage',
'field' => 'type',
'operator' => '=',
'value' => 'node',
],
],
],
];
$data['file_usage']['node_to_file'] = [
'title' => $this->t('File'),
'help' => $this->t('A file that is associated with this node, usually because it is in a field on the node.'),
// Only provide this field/relationship/etc.,
// when the 'node' base table is present.
'skip base' => [
'file_managed',
'users_field_data',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'fid',
'relationship' => [
'id' => 'standard',
'title' => $this->t('File'),
'label' => $this->t('File'),
'base' => 'file_managed',
'base field' => 'fid',
'relationship field' => 'fid',
],
];
// Describes relationships between files and users.
$data['file_usage']['file_to_user'] = [
'title' => $this->t('User'),
'help' => $this->t('A user that is associated with this file, usually because this file is in a field on the user.'),
// Only provide this field/relationship/etc.,
// when the 'file_managed' base table is present.
'skip base' => [
'node_field_data',
'node_field_revision',
'users_field_data',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'id',
'relationship' => [
'id' => 'standard',
'join_id' => 'casted_int_field_join',
'cast' => 'left',
'title' => $this->t('User'),
'label' => $this->t('User'),
'base' => 'users',
'base field' => 'uid',
'relationship field' => 'id',
'extra' => [
[
'table' => 'file_usage',
'field' => 'type',
'operator' => '=',
'value' => 'user',
],
],
],
];
$data['file_usage']['user_to_file'] = [
'title' => $this->t('File'),
'help' => $this->t('A file that is associated with this user, usually because it is in a field on the user.'),
// Only provide this field/relationship/etc.,
// when the 'users' base table is present.
'skip base' => [
'file_managed',
'node_field_data',
'node_field_revision',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'fid',
'relationship' => [
'id' => 'standard',
'join_id' => 'casted_int_field_join',
'cast' => 'left',
'title' => $this->t('File'),
'label' => $this->t('File'),
'base' => 'file_managed',
'base field' => 'fid',
'relationship field' => 'fid',
],
];
// Describes relationships between files and comments.
$data['file_usage']['file_to_comment'] = [
'title' => $this->t('Comment'),
'help' => $this->t('A comment that is associated with this file, usually because this file is in a field on the comment.'),
// Only provide this field/relationship/etc.,
// when the 'file_managed' base table is present.
'skip base' => [
'node_field_data',
'node_field_revision',
'users_field_data',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'id',
'relationship' => [
'id' => 'standard',
'join_id' => 'casted_int_field_join',
'cast' => 'left',
'title' => $this->t('Comment'),
'label' => $this->t('Comment'),
'base' => 'comment_field_data',
'base field' => 'cid',
'relationship field' => 'id',
'extra' => [
[
'table' => 'file_usage',
'field' => 'type',
'operator' => '=',
'value' => 'comment',
],
],
],
];
$data['file_usage']['comment_to_file'] = [
'title' => $this->t('File'),
'help' => $this->t('A file that is associated with this comment, usually because it is in a field on the comment.'),
// Only provide this field/relationship/etc.,
// when the 'comment' base table is present.
'skip base' => [
'file_managed',
'node_field_data',
'node_field_revision',
'users_field_data',
'taxonomy_term_field_data',
],
'real field' => 'fid',
'relationship' => [
'id' => 'standard',
'title' => $this->t('File'),
'label' => $this->t('File'),
'base' => 'file_managed',
'base field' => 'fid',
'relationship field' => 'fid',
],
];
// Describes relationships between files and taxonomy_terms.
$data['file_usage']['file_to_taxonomy_term'] = [
'title' => $this->t('Taxonomy Term'),
'help' => $this->t('A taxonomy term that is associated with this file, usually because this file is in a field on the taxonomy term.'),
// Only provide this field/relationship/etc.,
// when the 'file_managed' base table is present.
'skip base' => [
'node_field_data',
'node_field_revision',
'users_field_data',
'comment_field_data',
'taxonomy_term_field_data',
],
'real field' => 'id',
'relationship' => [
'id' => 'standard',
'join_id' => 'casted_int_field_join',
'cast' => 'left',
'title' => $this->t('Taxonomy Term'),
'label' => $this->t('Taxonomy Term'),
'base' => 'taxonomy_term_data',
'base field' => 'tid',
'relationship field' => 'id',
'extra' => [
[
'table' => 'file_usage',
'field' => 'type',
'operator' => '=',
'value' => 'taxonomy_term',
],
],
],
];
$data['file_usage']['taxonomy_term_to_file'] = [
'title' => $this->t('File'),
'help' => $this->t('A file that is associated with this taxonomy term, usually because it is in a field on the taxonomy term.'),
// Only provide this field/relationship/etc.,
// when the 'taxonomy_term_data' base table is present.
'skip base' => [
'file_managed',
'node_field_data',
'node_field_revision',
'users_field_data',
'comment_field_data',
],
'real field' => 'fid',
'relationship' => [
'id' => 'standard',
'title' => $this->t('File'),
'label' => $this->t('File'),
'base' => 'file_managed',
'base field' => 'fid',
'relationship field' => 'fid',
],
];
// Provide basic fields from the {file_usage} table to all of the base tables
// we've declared joins to, because there is no 'skip base' property on these
// fields.
$data['file_usage']['module'] = [
'title' => $this->t('Module'),
'help' => $this->t('The module managing this file relationship.'),
'field' => [
'id' => 'standard',
],
'filter' => [
'id' => 'string',
],
'argument' => [
'id' => 'string',
],
'sort' => [
'id' => 'standard',
],
];
$data['file_usage']['type'] = [
'title' => $this->t('Entity type'),
'help' => $this->t('The type of entity that is related to the file.'),
'field' => [
'id' => 'standard',
],
'filter' => [
'id' => 'string',
],
'argument' => [
'id' => 'string',
],
'sort' => [
'id' => 'standard',
],
];
$data['file_usage']['id'] = [
'title' => $this->t('Entity ID'),
'help' => $this->t('The ID of the entity that is related to the file.'),
'field' => [
'id' => 'numeric',
],
'argument' => [
'id' => 'numeric',
],
'filter' => [
'id' => 'numeric',
],
'sort' => [
'id' => 'standard',
],
];
$data['file_usage']['count'] = [
'title' => $this->t('Use count'),
'help' => $this->t('The number of times the file is used by this entity.'),
'field' => [
'id' => 'numeric',
],
'filter' => [
'id' => 'numeric',
],
'sort' => [
'id' => 'standard',
],
];
$data['file_usage']['entity_label'] = [
'title' => $this->t('Entity label'),
'help' => $this->t('The label of the entity that is related to the file.'),
'real field' => 'id',
'field' => [
'id' => 'entity_label',
'entity type field' => 'type',
],
];
return $data;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
EntityViewsData::$entityFieldManager | protected | property | The entity field manager. | ||
EntityViewsData::$entityType | protected | property | Entity type for this views data handler instance. | ||
EntityViewsData::$entityTypeManager | protected | property | The entity type manager. | ||
EntityViewsData::$fieldStorageDefinitions | protected | property | The field storage definitions for all base fields of the entity type. | ||
EntityViewsData::$moduleHandler | protected | property | The module handler. | ||
EntityViewsData::$storage | protected | property | The storage used for this entity type. | ||
EntityViewsData::$translationManager | protected | property | The translation manager. | ||
EntityViewsData::addEntityLinks | protected | function | Sets the entity links in case corresponding link templates exist. | ||
EntityViewsData::createInstance | public static | function | Instantiates a new instance of this entity handler. | Overrides EntityHandlerInterface::createInstance | |
EntityViewsData::getFieldStorageDefinitions | protected | function | Gets the field storage definitions. | ||
EntityViewsData::getViewsTableForEntityType | public | function | Gets the table of an entity type to be used as base table in views. | Overrides EntityViewsDataInterface::getViewsTableForEntityType | |
EntityViewsData::mapFieldDefinition | protected | function | Puts the views data for a single field onto the views data. | ||
EntityViewsData::mapSingleFieldViewsData | protected | function | Provides the views data for a given data type and schema field. | ||
EntityViewsData::processViewsDataForEntityReference | protected | function | Processes the views data for an entity reference field. | ||
EntityViewsData::processViewsDataForLanguage | protected | function | Processes the views data for a language field. | ||
EntityViewsData::processViewsDataForTextLong | protected | function | Processes the views data for a text field with formatting. | ||
EntityViewsData::processViewsDataForUuid | protected | function | Processes the views data for a UUID field. | ||
EntityViewsData::__construct | public | function | Constructs an EntityViewsData object. | ||
FileViewsData::getViewsData | public | function | Returns views data for the entity type. | Overrides EntityViewsData::getViewsData | |
StringTranslationTrait::$stringTranslation | protected | property | The string translation service. | 3 | |
StringTranslationTrait::formatPlural | protected | function | Formats a string containing a count of items. | ||
StringTranslationTrait::getNumberOfPlurals | protected | function | Returns the number of plurals supported by a given language. | ||
StringTranslationTrait::getStringTranslation | protected | function | Gets the string translation service. | ||
StringTranslationTrait::setStringTranslation | public | function | Sets the string translation service to use. | 2 | |
StringTranslationTrait::t | protected | function | Translates a string to the current language or to a given language. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.