class SimpleSitemap in Simple XML sitemap 4.x
Defines the simple_sitemap entity.
@ConfigEntityType( id = "simple_sitemap", label = @Translation("Sitemap"), label_collection = @Translation("Sitemaps"), label_singular = @Translation("sitemap"), label_plural = @Translation("sitemaps"), label_count = @PluralTranslation( singular = "@count sitemap", plural = "@count sitemaps", ), handlers = { "storage" = "Drupal\simple_sitemap\Entity\SimpleSitemapStorage", "list_builder" = "\Drupal\simple_sitemap\SimpleSitemapListBuilder", "form" = { "default" = "\Drupal\simple_sitemap\Form\SimpleSitemapEntityForm", "add" = "\Drupal\simple_sitemap\Form\SimpleSitemapEntityForm", "edit" = "\Drupal\simple_sitemap\Form\SimpleSitemapEntityForm", "delete" = "\Drupal\Core\Entity\EntityDeleteForm" }, }, config_prefix = "sitemap", admin_permission = "administer sitemap settings", entity_keys = { "id" = "id", "uuid" = "uuid", "label" = "label", "weight" = "weight", }, config_export = { "id", "label", "description", "type", "weight", }, links = { "add-form" = "/admin/config/search/simplesitemap/variants/add", "edit-form" = "/admin/config/search/simplesitemap/variants/{simple_sitemap}", "delete-form" = "/admin/config/search/simplesitemap/variants/{simple_sitemap}/delete", "collection" = "/admin/config/search/simplesitemap", }, )
@todo Implement dependency injection after https://www.drupal.org/project/drupal/issues/2142515 is fixed.
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
- class \Drupal\simple_sitemap\Entity\SimpleSitemap implements SimpleSitemapInterface
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses SynchronizableEntityTrait, PluginDependencyTrait
Expanded class hierarchy of SimpleSitemap
14 files declare their use of SimpleSitemap
- CustomLinksForm.php in src/
Form/ CustomLinksForm.php - FormHelper.php in src/
Form/ FormHelper.php - Generator.php in src/
Manager/ Generator.php - QueueWorker.php in src/
Queue/ QueueWorker.php - SettingsForm.php in src/
Form/ SettingsForm.php
File
- src/
Entity/ SimpleSitemap.php, line 58
Namespace
Drupal\simple_sitemap\EntityView source
class SimpleSitemap extends ConfigEntityBase implements SimpleSitemapInterface {
public const SITEMAP_UNPUBLISHED = 0;
public const SITEMAP_PUBLISHED = 1;
public const SITEMAP_PUBLISHED_GENERATING = 2;
public const FETCH_BY_STATUS_ALL = NULL;
public const FETCH_BY_STATUS_UNPUBLISHED = 0;
public const FETCH_BY_STATUS_PUBLISHED = 1;
/**
* @var int
*/
protected $fetchByStatus;
/**
* @var \Drupal\simple_sitemap\Entity\SimpleSitemapTypeInterface
*/
protected $sitemapType;
public function __toString() : string {
return $this
->toString();
}
/**
* {@inheritdoc}
*/
public function calculateDependencies() {
parent::calculateDependencies();
$this
->addDependency('config', $this
->getType()
->getConfigDependencyName());
return $this;
}
public function fromPublished() : SimpleSitemapInterface {
$this->fetchByStatus = self::FETCH_BY_STATUS_PUBLISHED;
return $this;
}
public function fromUnpublished() : SimpleSitemapInterface {
$this->fetchByStatus = self::FETCH_BY_STATUS_UNPUBLISHED;
return $this;
}
public function fromPublishedAndUnpublished() : SimpleSitemapInterface {
$this->fetchByStatus = self::FETCH_BY_STATUS_ALL;
return $this;
}
public function getType() : SimpleSitemapTypeInterface {
if ($this->sitemapType === NULL) {
$this->sitemapType = \Drupal::entityTypeManager()
->getStorage('simple_sitemap_type')
->load($this
->get('type'));
}
return $this->sitemapType;
}
public function toString(?int $delta = NULL) : string {
$status = $this->fetchByStatus ?? self::FETCH_BY_STATUS_PUBLISHED;
$storage = \Drupal::entityTypeManager()
->getStorage('simple_sitemap');
if ($delta) {
try {
return $storage
->getChunk($this, $status, $delta);
} catch (SitemapNotExistsException $e) {
}
}
if ($storage
->hasIndex($this, $status)) {
return $storage
->getIndex($this, $status);
}
try {
return $storage
->getChunk($this, $status);
} catch (SitemapNotExistsException $e) {
return '';
}
}
public function publish() : SimpleSitemapInterface {
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->publish($this);
return $this;
}
public function deleteContent() : SimpleSitemapInterface {
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->deleteContent($this);
return $this;
}
public function addChunk(array $links) : SimpleSitemapInterface {
$xml = $this
->getType()
->getSitemapGenerator()
->setSitemapVariant($this)
->getChunkXml($links);
//todo automatically set variant
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->addChunk($this, $xml, count($links));
return $this;
}
public function generateIndex() : SimpleSitemapInterface {
if ($this
->isIndexable()) {
$xml = $this
->getType()
->getSitemapGenerator()
->setSitemapVariant($this)
->getIndexXml();
//todo automatically set variant
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->generateIndex($this, $xml);
}
return $this;
}
public function getChunk(int $delta = SimpleSitemapStorage::SITEMAP_CHUNK_FIRST_DELTA) : string {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getChunk($this, $this->fetchByStatus, $delta);
}
public function getChunkCount() : int {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getChunkCount($this, $this->fetchByStatus);
}
public function hasIndex() : bool {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->hasIndex($this, $this->fetchByStatus);
}
protected function isIndexable() : bool {
try {
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getChunk($this, self::FETCH_BY_STATUS_UNPUBLISHED, 2);
return TRUE;
} catch (SitemapNotExistsException $e) {
return FALSE;
}
}
public function getIndex() : string {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getIndex($this, $this->fetchByStatus);
}
public function status() : bool {
return parent::status() && $this
->contentStatus();
}
public function contentStatus() : ?int {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->status($this);
}
public function getCreated() : ?string {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getCreated($this, $this->fetchByStatus);
}
public function getLinkCount() : int {
return \Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->getLinkCount($this, $this->fetchByStatus);
}
public function toUrl($rel = 'canonical', array $options = []) {
if ($rel !== 'canonical') {
return parent::toUrl($rel, $options);
}
$parameters = isset($options['delta']) ? [
'page' => $options['delta'],
] : [];
unset($options['delta']);
$options['base_url'] = $options['base_url'] ?? (\Drupal::service('simple_sitemap.settings')
->get('base_url') ?: $GLOBALS['base_url']);
$options['language'] = \Drupal::languageManager()
->getLanguage(LanguageInterface::LANGCODE_NOT_APPLICABLE);
return $this
->isDefault() ? Url::fromRoute('simple_sitemap.sitemap_default', $parameters, $options) : Url::fromRoute('simple_sitemap.sitemap_variant', $parameters + [
'variant' => $this
->id(),
], $options);
}
public function isDefault() : bool {
return $this
->id() === \Drupal::service('simple_sitemap.settings')
->get('default_variant');
}
/**
* Determines if the sitemap is to be a multilingual sitemap based on several
* factors.
*
* A hreflang/multilingual sitemap is only wanted if there are indexable
* languages available and if there is a language negotiation method enabled
* that is based on URL discovery. Any other language negotiation methods
* should be irrelevant, as a sitemap can only use URLs to guide to the
* correct language.
*
* @see https://www.drupal.org/project/simple_sitemap/issues/3154570#comment-13730522
*
* @return bool
*/
public function isMultilingual() : bool {
if (!\Drupal::service('module_handler')
->moduleExists('language')) {
return FALSE;
}
$url_negotiation_method_enabled = FALSE;
$language_negotiator = \Drupal::service('language_negotiator');
foreach ($language_negotiator
->getNegotiationMethods(LanguageInterface::TYPE_URL) as $method) {
if ($language_negotiator
->isNegotiationMethodEnabled($method['id'])) {
$url_negotiation_method_enabled = TRUE;
break;
}
}
$has_multiple_indexable_languages = count(array_diff_key(\Drupal::languageManager()
->getLanguages(), \Drupal::service('simple_sitemap.settings')
->get('excluded_languages', []))) > 1;
return $url_negotiation_method_enabled && $has_multiple_indexable_languages;
}
public static function purgeContent($variants = NULL, ?bool $status = self::FETCH_BY_STATUS_ALL) {
\Drupal::entityTypeManager()
->getStorage('simple_sitemap')
->purgeContent($variants, $status);
}
/**
* {@inheritdoc}
*/
public function set($property_name, $value) {
if ($property_name === 'type') {
$this->sitemapType = NULL;
}
return parent::set($property_name, $value);
}
}
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 | The UUID for this entity. | |
ConfigEntityBase:: |
protected | property | ||
ConfigEntityBase:: |
protected | function | Overrides \Drupal\Core\Entity\DependencyTrait:addDependency(). | |
ConfigEntityBase:: |
public | function |
Creates a duplicate of the entity. Overrides EntityBase:: |
1 |
ConfigEntityBase:: |
public | function |
Disables the configuration entity. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Enables the configuration entity. Overrides ConfigEntityInterface:: |
|
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 |
Informs the entity that entities it depends on will be deleted. Overrides ConfigEntityInterface:: |
8 |
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 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 |
Gets an array of all property values. Overrides EntityBase:: |
2 |
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 |
Constructs an Entity object. Overrides EntityBase:: |
10 |
ConfigEntityBase:: |
public | function |
Overrides EntityBase:: |
4 |
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | Aliased as: traitSleep | 2 |
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 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 identifier. Overrides EntityInterface:: |
11 |
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:: |
18 |
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:: |
7 |
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 | ||
SimpleSitemap:: |
protected | property | ||
SimpleSitemap:: |
protected | property | ||
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Calculates dependencies and stores them in the dependency property. Overrides ConfigEntityBase:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
protected | function | ||
SimpleSitemap:: |
public | function |
Determines if the sitemap is to be a multilingual sitemap based on several
factors. Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public static | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Sets the value of a property. Overrides ConfigEntityBase:: |
|
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | constant | ||
SimpleSitemap:: |
public | function |
Returns whether the configuration entity is enabled. Overrides ConfigEntityBase:: |
|
SimpleSitemap:: |
public | function |
Overrides SimpleSitemapInterface:: |
|
SimpleSitemap:: |
public | function |
Gets the URL object for the entity. Overrides ConfigEntityBase:: |
|
SimpleSitemap:: |
public | function | ||
SynchronizableEntityTrait:: |
protected | property | Whether this entity is being created, updated or deleted through a synchronization process. | |
SynchronizableEntityTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
public | function |