class ViewStorage in Views (for Drupal 7) 8.3
Defines a ViewStorage configuration entity class.
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
- class \Drupal\views\ViewStorage implements ViewStorageInterface
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
Expanded class hierarchy of ViewStorage
3 files declare their use of ViewStorage
- views.module in ./
views.module - Primarily Drupal hooks and global API functions to manipulate views.
- ViewStorageTest.php in lib/
Drupal/ views/ Tests/ ViewStorageTest.php - Definition of Drupal\views\Tests\ViewStorageTest.
- WizardPluginBase.php in lib/
Drupal/ views/ Plugin/ views/ wizard/ WizardPluginBase.php - Definition of Drupal\views\Plugin\views\wizard\WizardPluginBase.
File
- lib/
Drupal/ views/ ViewStorage.php, line 16 - Definition of Drupal\views\ViewStorage.
Namespace
Drupal\viewsView source
class ViewStorage extends ConfigEntityBase implements ViewStorageInterface {
/**
* The name of the base table this view will use.
*
* @var string
*/
public $base_table = 'node';
/**
* The name of the view.
*
* @var string
*/
public $name = '';
/**
* The description of the view, which is used only in the interface.
*
* @var string
*/
public $description = '';
/**
* The "tags" of a view.
*
* The tags are stored as a single string, though it is used as multiple tags
* for example in the views overview.
*
* @var string
*/
public $tag = '';
/**
* The human readable name of the view.
*
* @var string
*/
public $human_name = '';
/**
* The core version the view was created for.
*
* @var int
*/
public $core = DRUPAL_CORE_COMPATIBILITY;
/**
* The views API version this view was created by.
*
* @var string
*/
public $api_version = VIEWS_API_VERSION;
/**
* Stores all display handlers of this view.
*
* An array containing Drupal\views\Plugin\views\display\DisplayPluginBase
* objects.
*
* @var array
*/
public $display;
/**
* The name of the base field to use.
*
* @var string
*/
public $base_field = 'nid';
/**
* Returns whether the view's status is disabled or not.
*
* This value is used for exported view, to provide some default views which
* aren't enabled.
*
* @var bool
*/
public $disabled = FALSE;
/**
* The UUID for this entity.
*
* @var string
*/
public $uuid = NULL;
/**
* Stores a reference to the executable version of this view.
*
* @var Drupal\views\ViewExecutable
*/
protected $executable;
/**
* The module implementing this view.
*
* @var string
*/
public $module = 'views';
/**
* Stores the executable version of this view.
*
* @param Drupal\views\ViewExecutable $executable
* The executable version of this view.
*/
public function setExecutable(ViewExecutable $executable) {
$this->executable = $executable;
}
/**
* Retrieves the executable version of this view.
*
* @param bool $reset
* Get a new Drupal\views\ViewExecutable instance.
* @param bool $ui
* If this should return Drupal\views_ui\ViewUI instead.
*
* @return Drupal\views\ViewExecutable
* The executable version of this view.
*/
public function getExecutable($reset = FALSE, $ui = FALSE) {
if (!isset($this->executable) || $reset) {
// @todo Remove this approach and use proper dependency injection.
if ($ui) {
$executable = new ViewUI($this);
}
else {
$executable = new ViewExecutable($this);
}
$this
->setExecutable($executable);
}
return $this->executable;
}
/**
* Initializes the display.
*
* @todo Inspect calls to this and attempt to clean up.
* @see Drupal\views\ViewExecutable::initDisplay()
*/
public function initDisplay() {
$this
->getExecutable()
->initDisplay();
}
/**
* Returns the name of the module implementing this view.
*/
public function getModule() {
return $this->module;
}
/**
* Overrides Drupal\Core\Entity\EntityInterface::uri().
*/
public function uri() {
$info = $this
->entityInfo();
return array(
'path' => $info['list path'],
);
}
/**
* Overrides Drupal\Core\Entity\EntityInterface::id().
*/
public function id() {
return $this->name;
}
/**
* Implements Drupal\views\ViewStorageInterface::enable().
*/
public function enable() {
$this->disabled = FALSE;
$this
->save();
}
/**
* Implements Drupal\views\ViewStorageInterface::disable().
*/
public function disable() {
$this->disabled = TRUE;
$this
->save();
}
/**
* Implements Drupal\views\ViewStorageInterface::isEnabled().
*/
public function isEnabled() {
return !$this->disabled;
}
/**
* Return the human readable name for a view.
*
* When a certain view doesn't have a human readable name return the machine readable name.
*/
public function getHumanName() {
if (!empty($this->human_name)) {
$human_name = $this->human_name;
}
else {
$human_name = $this->name;
}
return $human_name;
}
/**
* Adds a new display handler to the view, automatically creating an ID.
*
* @param string $plugin_id
* (optional) The plugin type from the Views plugin annotation. Defaults to
* 'page'.
* @param string $title
* (optional) The title of the display. Defaults to NULL.
* @param string $id
* (optional) The ID to use, e.g., 'default', 'page_1', 'block_2'. Defaults
* to NULL.
*
* @return string|false
* The key to the display in $view->display, or FALSE if no plugin ID was
* provided.
*/
public function addDisplay($plugin_id = 'page', $title = NULL, $id = NULL) {
if (empty($plugin_id)) {
return FALSE;
}
$plugin = views_get_plugin_definition('display', $plugin_id);
if (empty($plugin)) {
$plugin['title'] = t('Broken');
}
if (empty($id)) {
$id = $this
->generateDisplayId($plugin_id);
// Generate a unique human-readable name by inspecting the counter at the
// end of the previous display ID, e.g., 'page_1'.
if ($id !== 'default') {
preg_match("/[0-9]+/", $id, $count);
$count = $count[0];
}
else {
$count = '';
}
if (empty($title)) {
// If there is no title provided, use the plugin title, and if there are
// multiple displays, append the count.
$title = $plugin['title'];
if ($count > 1) {
$title .= ' ' . $count;
}
}
}
$display_options = array(
'display_plugin' => $plugin_id,
'id' => $id,
'display_title' => $title,
'position' => NULL,
'display_options' => array(),
);
// Add the display options to the view.
$this->display[$id] = $display_options;
return $id;
}
/**
* Generates a display ID of a certain plugin type.
*
* @param string $plugin_id
* Which plugin should be used for the new display ID.
*/
protected function generateDisplayId($plugin_id) {
// 'default' is singular and is unique, so just go with 'default'
// for it. For all others, start counting.
if ($plugin_id == 'default') {
return 'default';
}
// Initial ID.
$id = $plugin_id . '_1';
$count = 1;
// Loop through IDs based upon our style plugin name until
// we find one that is unused.
while (!empty($this->display[$id])) {
$id = $plugin_id . '_' . ++$count;
}
return $id;
}
/**
* Creates a new display and a display handler for it.
*
* @param string $plugin_id
* (optional) The plugin type from the Views plugin annotation. Defaults to
* 'page'.
* @param string $title
* (optional) The title of the display. Defaults to NULL.
* @param string $id
* (optional) The ID to use, e.g., 'default', 'page_1', 'block_2'. Defaults
* to NULL.
*
* @return Drupal\views\Plugin\views\display\DisplayPluginBase
* A reference to the new handler object.
*/
public function &newDisplay($plugin_id = 'page', $title = NULL, $id = NULL) {
$id = $this
->addDisplay($plugin_id, $title, $id);
return $this
->getExecutable()
->newDisplay($id);
}
/**
* Gets a list of displays included in the view.
*
* @return array
* An array of display types that this view includes.
*/
function getDisplaysList() {
$manager = drupal_container()
->get('plugin.manager.views.display');
$displays = array();
foreach ($this->display as $display) {
$definition = $manager
->getDefinition($display['display_plugin']);
if (!empty($definition['admin'])) {
$displays[$definition['admin']] = TRUE;
}
}
ksort($displays);
return array_keys($displays);
}
/**
* Gets a list of paths assigned to the view.
*
* @return array
* An array of paths for this view.
*/
public function getPaths() {
$all_paths = array();
if (empty($this->display)) {
$all_paths[] = t('Edit this view to add a display.');
}
else {
foreach ($this->display as $display) {
if (!empty($display['display_options']['path'])) {
$path = $display['display_options']['path'];
if ($this
->isEnabled() && strpos($path, '%') === FALSE) {
$all_paths[] = l('/' . $path, $path);
}
else {
$all_paths[] = check_plain('/' . $path);
}
}
}
}
return array_unique($all_paths);
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CacheableDependencyTrait:: |
protected | property | Cache contexts. | |
CacheableDependencyTrait:: |
protected | property | Cache max-age. | |
CacheableDependencyTrait:: |
protected | property | Cache tags. | |
CacheableDependencyTrait:: |
protected | function | Sets cacheability; useful for value object constructors. | |
ConfigEntityBase:: |
private | property | Whether the config is being deleted by the uninstall process. | |
ConfigEntityBase:: |
protected | property | The language code of the entity's default language. | |
ConfigEntityBase:: |
protected | property | The original ID of the configuration entity. | |
ConfigEntityBase:: |
protected | property | The enabled/disabled status of the configuration entity. | 4 |
ConfigEntityBase:: |
protected | property | Third party entity settings. | |
ConfigEntityBase:: |
protected | property | Trust supplied data and not use configuration schema on save. | |
ConfigEntityBase:: |
protected | property | Information maintained by Drupal core about configuration. | |
ConfigEntityBase:: |
protected | function | Overrides \Drupal\Core\Entity\DependencyTrait:addDependency(). | |
ConfigEntityBase:: |
public | function |
Calculates dependencies and stores them in the dependency property. Overrides ConfigEntityInterface:: |
13 |
ConfigEntityBase:: |
public | function |
Creates a duplicate of the entity. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Returns the value of a property. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns the cache tags that should be used to invalidate caches. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Gets the configuration dependency name. Overrides EntityBase:: |
|
ConfigEntityBase:: |
protected static | function | Gets the configuration manager. | |
ConfigEntityBase:: |
public | function |
Gets the configuration target identifier for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the configuration dependencies. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the original ID. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the list of third parties that store information. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets all third-party settings of a given module. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
protected | function | Gets the typed config manager. | |
ConfigEntityBase:: |
public | function |
Gets whether on not the data is trusted. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
protected static | function |
Override to never invalidate the individual entities' cache tags; the
config system already invalidates them. Overrides EntityBase:: |
|
ConfigEntityBase:: |
protected | function |
Override to never invalidate the entity's cache tag; the config system
already invalidates it. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Checks whether this entity is installable. Overrides ConfigEntityInterface:: |
2 |
ConfigEntityBase:: |
public | function |
Overrides Entity::isNew(). Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Returns whether this entity is being changed during the uninstall process. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Deprecated way of generating a link to the entity. See toLink(). Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Informs the entity that entities it depends on will be deleted. Overrides ConfigEntityInterface:: |
7 |
ConfigEntityBase:: |
public static | function |
Acts on entities before they are deleted and before hooks are invoked. Overrides EntityBase:: |
8 |
ConfigEntityBase:: |
public | function |
Acts on an entity before the presave hook is invoked. Overrides EntityBase:: |
13 |
ConfigEntityBase:: |
public | function |
Saves an entity permanently. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Sets the value of a property. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Sets the original ID. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Sets the status of the configuration entity. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Sets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function | ||
ConfigEntityBase:: |
public static | function | Helper callback for uasort() to sort configuration entities by weight and label. | 6 |
ConfigEntityBase:: |
public | function |
Returns whether the configuration entity is enabled. Overrides ConfigEntityInterface:: |
4 |
ConfigEntityBase:: |
public | function |
Gets an array of all property values. Overrides EntityBase:: |
2 |
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Sets that the data should be trusted. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Unsets a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the public URL for this entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityBase:: |
|
ConfigEntityBase:: |
public | function |
Constructs an Entity object. Overrides EntityBase:: |
10 |
ConfigEntityBase:: |
public | function |
Overrides EntityBase:: |
4 |
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 | Aliased as: traitSleep | 1 |
DependencySerializationTrait:: |
public | function | 2 | |
DependencyTrait:: |
protected | property | The object's dependencies. | |
DependencyTrait:: |
protected | function | Adds multiple dependencies. | |
DependencyTrait:: |
protected | function | Adds a dependency. Aliased as: addDependencyTrait | |
EntityBase:: |
protected | property | Boolean indicating whether the entity should be forced to be new. | |
EntityBase:: |
protected | property | The entity type. | |
EntityBase:: |
protected | property | A typed data object wrapping this entity. | |
EntityBase:: |
public | function |
Checks data value access. Overrides AccessibleInterface:: |
1 |
EntityBase:: |
public | function |
Gets the bundle of the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
public static | function |
Constructs a new entity object, without permanently saving it. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Deletes an entity permanently. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Enforces an entity to be new. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | Gets the entity manager. | |
EntityBase:: |
protected | function | Gets the entity type bundle info service. | |
EntityBase:: |
protected | function | Gets the entity type manager. | |
EntityBase:: |
public | function |
The cache contexts associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The maximum age for which this object may be cached. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The cache tags associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
Gets the key that is used to store configuration dependencies. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the entity type definition. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the ID of the type of the entity. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | The list cache tags to invalidate for this entity. | |
EntityBase:: |
public | function |
Gets a typed data object for this entity object. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Indicates if a link template exists for a given key. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the label of the entity. Overrides EntityInterface:: |
6 |
EntityBase:: |
public | function |
Gets the language of the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets the language manager. | |
EntityBase:: |
protected | function | Gets an array link templates. | 1 |
EntityBase:: |
public static | function |
Loads an entity. Overrides EntityInterface:: |
|
EntityBase:: |
public static | function |
Loads one or more entities. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Acts on a created entity before hooks are invoked. Overrides EntityInterface:: |
4 |
EntityBase:: |
public static | function |
Acts on deleted entities before the delete hook is invoked. Overrides EntityInterface:: |
16 |
EntityBase:: |
public static | function |
Acts on loaded entities. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Acts on a saved entity before the insert or update hook is invoked. Overrides EntityInterface:: |
14 |
EntityBase:: |
public static | function |
Changes the values of an entity before it is created. Overrides EntityInterface:: |
5 |
EntityBase:: |
public | function |
Gets a list of entities referenced by this entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Generates the HTML for a link to this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets a list of URI relationships supported by this entity. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | Gets an array of placeholders for this entity. | 2 |
EntityBase:: |
public | function |
Gets the entity UUID (Universally Unique Identifier). Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets the UUID generator. | |
PluginDependencyTrait:: |
protected | function | Calculates and adds dependencies of a specific plugin instance. | 1 |
PluginDependencyTrait:: |
protected | function | Calculates and returns dependencies of a specific plugin instance. | |
PluginDependencyTrait:: |
protected | function | Wraps the module handler. | 1 |
PluginDependencyTrait:: |
protected | function | Wraps the theme handler. | 1 |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
protected | property | Whether this entity is being created, updated or deleted through a synchronization process. | |
SynchronizableEntityTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
public | function | ||
ViewStorage:: |
public | property | The views API version this view was created by. | |
ViewStorage:: |
public | property | The name of the base field to use. | |
ViewStorage:: |
public | property | The name of the base table this view will use. | |
ViewStorage:: |
public | property | The core version the view was created for. | |
ViewStorage:: |
public | property | The description of the view, which is used only in the interface. | |
ViewStorage:: |
public | property | Returns whether the view's status is disabled or not. | |
ViewStorage:: |
public | property | Stores all display handlers of this view. | |
ViewStorage:: |
protected | property | Stores a reference to the executable version of this view. | |
ViewStorage:: |
public | property | The human readable name of the view. | |
ViewStorage:: |
public | property | The module implementing this view. | |
ViewStorage:: |
public | property | The name of the view. | |
ViewStorage:: |
public | property | The "tags" of a view. | |
ViewStorage:: |
public | property |
The UUID for this entity. Overrides ConfigEntityBase:: |
|
ViewStorage:: |
public | function | Adds a new display handler to the view, automatically creating an ID. | |
ViewStorage:: |
public | function |
Implements Drupal\views\ViewStorageInterface::disable(). Overrides ConfigEntityBase:: |
|
ViewStorage:: |
public | function |
Implements Drupal\views\ViewStorageInterface::enable(). Overrides ConfigEntityBase:: |
|
ViewStorage:: |
protected | function | Generates a display ID of a certain plugin type. | |
ViewStorage:: |
function | Gets a list of displays included in the view. | ||
ViewStorage:: |
public | function | Retrieves the executable version of this view. | |
ViewStorage:: |
public | function | Return the human readable name for a view. | |
ViewStorage:: |
public | function | Returns the name of the module implementing this view. | |
ViewStorage:: |
public | function | Gets a list of paths assigned to the view. | |
ViewStorage:: |
public | function |
Overrides Drupal\Core\Entity\EntityInterface::id(). Overrides EntityBase:: |
|
ViewStorage:: |
public | function | Initializes the display. | |
ViewStorage:: |
public | function |
Implements Drupal\views\ViewStorageInterface::isEnabled(). Overrides ViewStorageInterface:: |
|
ViewStorage:: |
public | function | Creates a new display and a display handler for it. | |
ViewStorage:: |
public | function | Stores the executable version of this view. | |
ViewStorage:: |
public | function | Overrides Drupal\Core\Entity\EntityInterface::uri(). |