class User

Same name in this branch
  1. 9 core/modules/user/src/Plugin/views/argument_validator/User.php \Drupal\user\Plugin\views\argument_validator\User
  2. 9 core/modules/user/src/Plugin/views/argument_default/User.php \Drupal\user\Plugin\views\argument_default\User
  3. 9 core/modules/user/src/Plugin/migrate/source/d6/User.php \Drupal\user\Plugin\migrate\source\d6\User
  4. 9 core/modules/user/src/Plugin/migrate/source/d7/User.php \Drupal\user\Plugin\migrate\source\d7\User
  5. 9 core/modules/user/src/Plugin/migrate/User.php \Drupal\user\Plugin\migrate\User
Same name in other branches
  1. 8.9.x core/modules/user/src/Entity/User.php \Drupal\user\Entity\User
  2. 8.9.x core/modules/user/src/Plugin/views/argument_validator/User.php \Drupal\user\Plugin\views\argument_validator\User
  3. 8.9.x core/modules/user/src/Plugin/views/argument_default/User.php \Drupal\user\Plugin\views\argument_default\User
  4. 8.9.x core/modules/user/src/Plugin/migrate/source/d6/User.php \Drupal\user\Plugin\migrate\source\d6\User
  5. 8.9.x core/modules/user/src/Plugin/migrate/source/d7/User.php \Drupal\user\Plugin\migrate\source\d7\User
  6. 8.9.x core/modules/user/src/Plugin/migrate/User.php \Drupal\user\Plugin\migrate\User
  7. 10 core/modules/user/src/Entity/User.php \Drupal\user\Entity\User
  8. 10 core/modules/user/src/Plugin/views/argument_validator/User.php \Drupal\user\Plugin\views\argument_validator\User
  9. 10 core/modules/user/src/Plugin/views/argument_default/User.php \Drupal\user\Plugin\views\argument_default\User
  10. 10 core/modules/user/src/Plugin/migrate/source/d6/User.php \Drupal\user\Plugin\migrate\source\d6\User
  11. 10 core/modules/user/src/Plugin/migrate/source/d7/User.php \Drupal\user\Plugin\migrate\source\d7\User
  12. 10 core/modules/user/src/Plugin/migrate/User.php \Drupal\user\Plugin\migrate\User
  13. 11.x core/modules/user/src/Entity/User.php \Drupal\user\Entity\User
  14. 11.x core/modules/user/src/Plugin/views/argument_validator/User.php \Drupal\user\Plugin\views\argument_validator\User
  15. 11.x core/modules/user/src/Plugin/views/argument_default/User.php \Drupal\user\Plugin\views\argument_default\User
  16. 11.x core/modules/user/src/Plugin/migrate/source/d6/User.php \Drupal\user\Plugin\migrate\source\d6\User
  17. 11.x core/modules/user/src/Plugin/migrate/source/d7/User.php \Drupal\user\Plugin\migrate\source\d7\User
  18. 11.x core/modules/user/src/Plugin/migrate/User.php \Drupal\user\Plugin\migrate\User

Defines the user entity class.

The base table name here is plural, despite Drupal table naming standards, because "user" is a reserved word in many databases.

Plugin annotation


@ContentEntityType(
  id = "user",
  label = @Translation("User"),
  label_collection = @Translation("Users"),
  label_singular = @Translation("user"),
  label_plural = @Translation("users"),
  label_count = @PluralTranslation(
    singular = "@count user",
    plural = "@count users",
  ),
  handlers = {
    "storage" = "Drupal\user\UserStorage",
    "storage_schema" = "Drupal\user\UserStorageSchema",
    "access" = "Drupal\user\UserAccessControlHandler",
    "list_builder" = "Drupal\user\UserListBuilder",
    "views_data" = "Drupal\user\UserViewsData",
    "route_provider" = {
      "html" = "Drupal\user\Entity\UserRouteProvider",
    },
    "form" = {
      "default" = "Drupal\user\ProfileForm",
      "cancel" = "Drupal\user\Form\UserCancelForm",
      "register" = "Drupal\user\RegisterForm"
    },
    "translation" = "Drupal\user\ProfileTranslationHandler"
  },
  admin_permission = "administer users",
  base_table = "users",
  data_table = "users_field_data",
  translatable = TRUE,
  entity_keys = {
    "id" = "uid",
    "langcode" = "langcode",
    "uuid" = "uuid"
  },
  links = {
    "canonical" = "/user/{user}",
    "edit-form" = "/user/{user}/edit",
    "cancel-form" = "/user/{user}/cancel",
    "collection" = "/admin/people",
  },
  field_ui_base_route = "entity.user.admin_form",
  common_reference_target = TRUE
)

Hierarchy

Expanded class hierarchy of User

172 files declare their use of User
AccessTest.php in core/modules/file/tests/src/Kernel/AccessTest.php
AssignOwnerNode.php in core/modules/node/src/Plugin/Action/AssignOwnerNode.php
BlockContentAccessHandlerTest.php in core/modules/block_content/tests/src/Kernel/BlockContentAccessHandlerTest.php
BulkFormAccessTest.php in core/modules/user/tests/src/Functional/Views/BulkFormAccessTest.php
BulkFormTest.php in core/modules/user/tests/src/Functional/Views/BulkFormTest.php

... See full list

927 string references to 'User'
AccessPermissionTest::setUp in core/modules/user/tests/src/Kernel/Views/AccessPermissionTest.php
AccessResult::cachePerUser in core/lib/Drupal/Core/Access/AccessResult.php
Convenience method, adds the "user" cache context.
AccessResultTest::testCacheContexts in core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
@covers ::addCacheContexts @covers ::resetCacheContexts @covers ::getCacheContexts @covers ::cachePerPermissions @covers ::cachePerUser @covers ::allowedIfHasPermission
AccessResultTest::testCacheTags in core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
@covers ::addCacheTags @covers ::addCacheableDependency @covers ::getCacheTags @covers ::resetCacheTags
AccessResultTest::testInheritCacheability in core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
@covers ::inheritCacheability

... See full list

File

core/modules/user/src/Entity/User.php, line 67

Namespace

Drupal\user\Entity
View source
class User extends ContentEntityBase implements UserInterface {
    use EntityChangedTrait;
    
    /**
     * Stores a reference for a reusable anonymous user entity.
     *
     * @var \Drupal\user\UserInterface
     */
    protected static $anonymousUser;
    
    /**
     * {@inheritdoc}
     */
    public function isNew() {
        return !empty($this->enforceIsNew) || $this->id() === NULL;
    }
    
    /**
     * {@inheritdoc}
     */
    public function label() {
        return $this->getDisplayName();
    }
    
    /**
     * {@inheritdoc}
     */
    public function preSave(EntityStorageInterface $storage) {
        parent::preSave($storage);
        // Make sure that the authenticated/anonymous roles are not persisted.
        foreach ($this->get('roles') as $index => $item) {
            if (in_array($item->target_id, [
                RoleInterface::ANONYMOUS_ID,
                RoleInterface::AUTHENTICATED_ID,
            ])) {
                $this->get('roles')
                    ->offsetUnset($index);
            }
        }
        // Store account cancellation information.
        foreach ([
            'user_cancel_method',
            'user_cancel_notify',
        ] as $key) {
            if (isset($this->{$key})) {
                \Drupal::service('user.data')->set('user', $this->id(), substr($key, 5), $this->{$key});
            }
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function postSave(EntityStorageInterface $storage, $update = TRUE) {
        parent::postSave($storage, $update);
        if ($update) {
            $session_manager = \Drupal::service('session_manager');
            // If the password has been changed, delete all open sessions for the
            // user and recreate the current one.
            if ($this->pass->value != $this->original->pass->value) {
                $session_manager->delete($this->id());
                if ($this->id() == \Drupal::currentUser()->id()) {
                    \Drupal::service('session')->migrate();
                }
            }
            // If the user was blocked, delete the user's sessions to force a logout.
            if ($this->original->status->value != $this->status->value && $this->status->value == 0) {
                $session_manager->delete($this->id());
            }
            // Send emails after we have the new user object.
            if ($this->status->value != $this->original->status->value) {
                // The user's status is changing; conditionally send notification email.
                $op = $this->status->value == 1 ? 'status_activated' : 'status_blocked';
                _user_mail_notify($op, $this);
            }
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public static function postDelete(EntityStorageInterface $storage, array $entities) {
        parent::postDelete($storage, $entities);
        $uids = array_keys($entities);
        \Drupal::service('user.data')->delete(NULL, $uids);
    }
    
    /**
     * {@inheritdoc}
     */
    public function getRoles($exclude_locked_roles = FALSE) {
        $roles = [];
        // Users with an ID always have the authenticated user role.
        if (!$exclude_locked_roles) {
            if ($this->isAuthenticated()) {
                $roles[] = RoleInterface::AUTHENTICATED_ID;
            }
            else {
                $roles[] = RoleInterface::ANONYMOUS_ID;
            }
        }
        foreach ($this->get('roles') as $role) {
            if ($role->target_id) {
                $roles[] = $role->target_id;
            }
        }
        return $roles;
    }
    
    /**
     * {@inheritdoc}
     */
    public function hasRole($rid) {
        return in_array($rid, $this->getRoles());
    }
    
    /**
     * {@inheritdoc}
     */
    public function addRole($rid) {
        if (in_array($rid, [
            RoleInterface::AUTHENTICATED_ID,
            RoleInterface::ANONYMOUS_ID,
        ])) {
            throw new \InvalidArgumentException('Anonymous or authenticated role ID must not be assigned manually.');
        }
        $roles = $this->getRoles(TRUE);
        $roles[] = $rid;
        $this->set('roles', array_unique($roles));
    }
    
    /**
     * {@inheritdoc}
     */
    public function removeRole($rid) {
        $this->set('roles', array_diff($this->getRoles(TRUE), [
            $rid,
        ]));
    }
    
    /**
     * {@inheritdoc}
     */
    public function hasPermission($permission) {
        // User #1 has all privileges.
        if ((int) $this->id() === 1) {
            return TRUE;
        }
        return $this->getRoleStorage()
            ->isPermissionInRoles($permission, $this->getRoles());
    }
    
    /**
     * {@inheritdoc}
     */
    public function getPassword() {
        return $this->get('pass')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setPassword($password) {
        $this->get('pass')->value = $password;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getEmail() {
        return $this->get('mail')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setEmail($mail) {
        $this->get('mail')->value = $mail;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getCreatedTime() {
        return $this->get('created')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getLastAccessedTime() {
        return $this->get('access')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setLastAccessTime($timestamp) {
        $this->get('access')->value = $timestamp;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getLastLoginTime() {
        return $this->get('login')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setLastLoginTime($timestamp) {
        $this->get('login')->value = $timestamp;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isActive() {
        return $this->get('status')->value == 1;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isBlocked() {
        return $this->get('status')->value == 0;
    }
    
    /**
     * {@inheritdoc}
     */
    public function activate() {
        $this->get('status')->value = 1;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function block() {
        $this->get('status')->value = 0;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getTimeZone() {
        return $this->get('timezone')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getPreferredLangcode($fallback_to_default = TRUE) {
        $language_list = $this->languageManager()
            ->getLanguages();
        $preferred_langcode = $this->get('preferred_langcode')->value;
        if (!empty($preferred_langcode) && isset($language_list[$preferred_langcode])) {
            return $language_list[$preferred_langcode]->getId();
        }
        else {
            return $fallback_to_default ? $this->languageManager()
                ->getDefaultLanguage()
                ->getId() : '';
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function getPreferredAdminLangcode($fallback_to_default = TRUE) {
        $language_list = $this->languageManager()
            ->getLanguages();
        $preferred_langcode = $this->get('preferred_admin_langcode')->value;
        if (!empty($preferred_langcode) && isset($language_list[$preferred_langcode])) {
            return $language_list[$preferred_langcode]->getId();
        }
        else {
            return $fallback_to_default ? $this->languageManager()
                ->getDefaultLanguage()
                ->getId() : '';
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function getInitialEmail() {
        return $this->get('init')->value;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isAuthenticated() {
        return $this->id() > 0;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isAnonymous() {
        return $this->id() == 0;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getAccountName() {
        return $this->get('name')->value ?: '';
    }
    
    /**
     * {@inheritdoc}
     */
    public function getDisplayName() {
        $name = $this->getAccountName() ?: \Drupal::config('user.settings')->get('anonymous');
        \Drupal::moduleHandler()->alter('user_format_name', $name, $this);
        return $name;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setUsername($username) {
        $this->set('name', $username);
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setExistingPassword($password) {
        $this->get('pass')->existing = $password;
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function checkExistingPassword(UserInterface $account_unchanged) {
        $existing = $this->get('pass')->existing;
        return $existing !== NULL && strlen($existing) > 0 && \Drupal::service('password')->check(trim($existing), $account_unchanged->getPassword());
    }
    
    /**
     * Returns an anonymous user entity.
     *
     * @return \Drupal\user\UserInterface
     *   An anonymous user entity.
     */
    public static function getAnonymousUser() {
        if (!isset(static::$anonymousUser)) {
            // @todo Use the entity factory once available, see
            //   https://www.drupal.org/node/1867228.
            $entity_type_manager = \Drupal::entityTypeManager();
            $entity_type = $entity_type_manager->getDefinition('user');
            $class = $entity_type->getClass();
            static::$anonymousUser = new $class([
                'uid' => [
                    LanguageInterface::LANGCODE_DEFAULT => 0,
                ],
                'name' => [
                    LanguageInterface::LANGCODE_DEFAULT => '',
                ],
                // Explicitly set the langcode to ensure that field definitions do not
                // need to be fetched to figure out a default.
'langcode' => [
                    LanguageInterface::LANGCODE_DEFAULT => LanguageInterface::LANGCODE_NOT_SPECIFIED,
                ],
            ], $entity_type->id());
        }
        return clone static::$anonymousUser;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function baseFieldDefinitions(EntityTypeInterface $entity_type) {
        
        /** @var \Drupal\Core\Field\BaseFieldDefinition[] $fields */
        $fields = parent::baseFieldDefinitions($entity_type);
        $fields['uid']->setLabel(t('User ID'))
            ->setDescription(t('The user ID.'));
        $fields['uuid']->setDescription(t('The user UUID.'));
        $fields['langcode']->setLabel(t('Language code'))
            ->setDescription(t('The user language code.'))
            ->setDisplayOptions('form', [
            'region' => 'hidden',
        ]);
        $fields['preferred_langcode'] = BaseFieldDefinition::create('language')->setLabel(t('Preferred language code'))
            ->setDescription(t("The user's preferred language code for receiving emails and viewing the site."))
            ->addPropertyConstraints('value', [
            'AllowedValues' => [
                'callback' => __CLASS__ . '::getAllowedConfigurableLanguageCodes',
            ],
        ]);
        $fields['preferred_admin_langcode'] = BaseFieldDefinition::create('language')->setLabel(t('Preferred admin language code'))
            ->setDescription(t("The user's preferred language code for viewing administration pages."))
            ->setDefaultValue([
            0 => [
                'value' => NULL,
            ],
        ])
            ->addPropertyConstraints('value', [
            'AllowedValues' => [
                'callback' => __CLASS__ . '::getAllowedConfigurableLanguageCodes',
            ],
        ]);
        // The name should not vary per language. The username is the visual
        // identifier for a user and needs to be consistent in all languages.
        $fields['name'] = BaseFieldDefinition::create('string')->setLabel(t('Name'))
            ->setDescription(t('The name of this user.'))
            ->setRequired(TRUE)
            ->setConstraints([
            // No Length constraint here because the UserName constraint also covers
            // that.
'UserName' => [],
            'UserNameUnique' => [],
        ]);
        $fields['name']->getItemDefinition()
            ->setClass('\\Drupal\\user\\UserNameItem');
        $fields['pass'] = BaseFieldDefinition::create('password')->setLabel(t('Password'))
            ->setDescription(t('The password of this user (hashed).'))
            ->addConstraint('ProtectedUserField');
        $fields['mail'] = BaseFieldDefinition::create('email')->setLabel(t('Email'))
            ->setDescription(t('The email of this user.'))
            ->setDefaultValue('')
            ->addConstraint('UserMailUnique')
            ->addConstraint('UserMailRequired')
            ->addConstraint('ProtectedUserField');
        $fields['timezone'] = BaseFieldDefinition::create('string')->setLabel(t('Timezone'))
            ->setDescription(t('The timezone of this user.'))
            ->setSetting('max_length', 32)
            ->addPropertyConstraints('value', [
            'AllowedValues' => [
                'callback' => __CLASS__ . '::getAllowedTimezones',
            ],
        ]);
        $fields['timezone']->getItemDefinition()
            ->setClass(TimeZoneItem::class);
        $fields['status'] = BaseFieldDefinition::create('boolean')->setLabel(t('User status'))
            ->setDescription(t('Whether the user is active or blocked.'))
            ->setDefaultValue(FALSE);
        $fields['status']->getItemDefinition()
            ->setClass(StatusItem::class);
        $fields['created'] = BaseFieldDefinition::create('created')->setLabel(t('Created'))
            ->setDescription(t('The time that the user was created.'));
        $fields['changed'] = BaseFieldDefinition::create('changed')->setLabel(t('Changed'))
            ->setDescription(t('The time that the user was last edited.'))
            ->setTranslatable(TRUE);
        $fields['access'] = BaseFieldDefinition::create('timestamp')->setLabel(t('Last access'))
            ->setDescription(t('The time that the user last accessed the site.'))
            ->setDefaultValue(0);
        $fields['login'] = BaseFieldDefinition::create('timestamp')->setLabel(t('Last login'))
            ->setDescription(t('The time that the user last logged in.'))
            ->setDefaultValue(0);
        $fields['init'] = BaseFieldDefinition::create('email')->setLabel(t('Initial email'))
            ->setDescription(t('The email address used for initial account creation.'))
            ->setDefaultValue('');
        $fields['roles'] = BaseFieldDefinition::create('entity_reference')->setLabel(t('Roles'))
            ->setCardinality(BaseFieldDefinition::CARDINALITY_UNLIMITED)
            ->setDescription(t('The roles the user has.'))
            ->setSetting('target_type', 'user_role');
        return $fields;
    }
    
    /**
     * Returns the role storage object.
     *
     * @return \Drupal\user\RoleStorageInterface
     *   The role storage object.
     */
    protected function getRoleStorage() {
        return \Drupal::entityTypeManager()->getStorage('user_role');
    }
    
    /**
     * Defines allowed timezones for the field's AllowedValues constraint.
     *
     * @return string[]
     *   The allowed values.
     */
    public static function getAllowedTimezones() {
        return array_keys(system_time_zones());
    }
    
    /**
     * Defines allowed configurable language codes for AllowedValues constraints.
     *
     * @return string[]
     *   The allowed values.
     */
    public static function getAllowedConfigurableLanguageCodes() {
        return array_keys(\Drupal::languageManager()->getLanguages(LanguageInterface::STATE_CONFIGURABLE));
    }

}

Members

Title Sort descending Modifiers Object type Summary Member alias Overriden Title Overrides
AccountInterface::ANONYMOUS_ROLE constant Role ID for anonymous users.
AccountInterface::AUTHENTICATED_ROLE constant Role ID for authenticated users.
CacheableDependencyTrait::$cacheContexts protected property Cache contexts.
CacheableDependencyTrait::$cacheMaxAge protected property Cache max-age.
CacheableDependencyTrait::$cacheTags protected property Cache tags.
CacheableDependencyTrait::setCacheability protected function Sets cacheability; useful for value object constructors.
ContentEntityBase::$activeLangcode protected property Language code identifying the entity active language.
ContentEntityBase::$defaultLangcode protected property Local cache for the default language code.
ContentEntityBase::$defaultLangcodeKey protected property The default langcode entity key.
ContentEntityBase::$enforceRevisionTranslationAffected protected property Whether the revision translation affected flag has been enforced.
ContentEntityBase::$entityKeys protected property Holds untranslatable entity keys such as the ID, bundle, and revision ID.
ContentEntityBase::$fieldDefinitions protected property Local cache for field definitions.
ContentEntityBase::$fields protected property The array of fields, each being an instance of FieldItemListInterface.
ContentEntityBase::$fieldsToSkipFromTranslationChangesCheck protected static property Local cache for fields to skip from the checking for translation changes.
ContentEntityBase::$isDefaultRevision protected property Indicates whether this is the default revision.
ContentEntityBase::$langcodeKey protected property The language entity key.
ContentEntityBase::$languages protected property Local cache for the available language objects.
ContentEntityBase::$loadedRevisionId protected property The loaded revision ID before the new revision was set.
ContentEntityBase::$newRevision protected property Boolean indicating whether a new revision should be created on save.
ContentEntityBase::$revisionTranslationAffectedKey protected property The revision translation affected entity key.
ContentEntityBase::$translatableEntityKeys protected property Holds translatable entity keys such as the label.
ContentEntityBase::$translationInitialize protected property A flag indicating whether a translation object is being initialized.
ContentEntityBase::$translations protected property An array of entity translation metadata.
ContentEntityBase::$validated protected property Whether entity validation was performed.
ContentEntityBase::$validationRequired protected property Whether entity validation is required before saving the entity.
ContentEntityBase::$values protected property The plain data values of the contained fields.
ContentEntityBase::access public function Checks data value access. Overrides EntityBase::access 1
ContentEntityBase::addTranslation public function
ContentEntityBase::bundle public function Gets the bundle of the entity. Overrides EntityBase::bundle
ContentEntityBase::bundleFieldDefinitions public static function 4
ContentEntityBase::clearTranslationCache protected function Clear entity translation object cache to remove stale references.
ContentEntityBase::create public static function Constructs a new entity object, without permanently saving it. Overrides EntityBase::create
ContentEntityBase::createDuplicate public function Creates a duplicate of the entity. Overrides EntityBase::createDuplicate 1
ContentEntityBase::get public function
ContentEntityBase::getEntityKey protected function Gets the value of the given entity key, if defined. 1
ContentEntityBase::getFieldDefinition public function
ContentEntityBase::getFieldDefinitions public function
ContentEntityBase::getFields public function
ContentEntityBase::getFieldsToSkipFromTranslationChangesCheck protected function Returns an array of field names to skip in ::hasTranslationChanges. 1
ContentEntityBase::getIterator public function
ContentEntityBase::getLanguages protected function
ContentEntityBase::getLoadedRevisionId public function
ContentEntityBase::getRevisionId public function
ContentEntityBase::getTranslatableFields public function
ContentEntityBase::getTranslatedField protected function Gets a translated field.
ContentEntityBase::getTranslation public function
ContentEntityBase::getTranslationLanguages public function
ContentEntityBase::getTranslationStatus public function Returns the translation status. Overrides TranslationStatusInterface::getTranslationStatus
ContentEntityBase::getUntranslated public function
ContentEntityBase::hasField public function
ContentEntityBase::hasTranslation public function
ContentEntityBase::hasTranslationChanges public function
ContentEntityBase::id public function Gets the identifier. Overrides EntityBase::id
ContentEntityBase::initializeTranslation protected function Instantiates a translation object for an existing translation.
ContentEntityBase::isDefaultRevision public function
ContentEntityBase::isDefaultTranslation public function
ContentEntityBase::isDefaultTranslationAffectedOnly public function
ContentEntityBase::isLatestRevision public function
ContentEntityBase::isLatestTranslationAffectedRevision public function
ContentEntityBase::isNewRevision public function
ContentEntityBase::isNewTranslation public function
ContentEntityBase::isRevisionTranslationAffected public function
ContentEntityBase::isRevisionTranslationAffectedEnforced public function
ContentEntityBase::isTranslatable public function
ContentEntityBase::isValidationRequired public function
ContentEntityBase::language public function Gets the language of the entity. Overrides EntityBase::language
ContentEntityBase::onChange public function
ContentEntityBase::postCreate public function Acts on a created entity before hooks are invoked. Overrides EntityBase::postCreate 1
ContentEntityBase::preSaveRevision public function 3
ContentEntityBase::referencedEntities public function Gets a list of entities referenced by this entity. Overrides EntityBase::referencedEntities 1
ContentEntityBase::removeTranslation public function
ContentEntityBase::set public function
ContentEntityBase::setDefaultLangcode protected function Populates the local cache for the default language code.
ContentEntityBase::setNewRevision public function
ContentEntityBase::setRevisionTranslationAffected public function
ContentEntityBase::setRevisionTranslationAffectedEnforced public function
ContentEntityBase::setValidationRequired public function
ContentEntityBase::toArray public function Gets an array of all property values. Overrides EntityBase::toArray
ContentEntityBase::updateFieldLangcodes protected function Updates language for already instantiated fields.
ContentEntityBase::updateLoadedRevisionId public function
ContentEntityBase::updateOriginalValues public function Updates the original values with the interim changes.
ContentEntityBase::uuid public function Gets the entity UUID (Universally Unique Identifier). Overrides EntityBase::uuid
ContentEntityBase::validate public function 1
ContentEntityBase::wasDefaultRevision public function
ContentEntityBase::__clone public function Magic method: Implements a deep clone.
ContentEntityBase::__construct public function Constructs an Entity object. Overrides EntityBase::__construct
ContentEntityBase::__get public function Implements the magic method for getting object properties.
ContentEntityBase::__isset public function Implements the magic method for isset().
ContentEntityBase::__set public function Implements the magic method for setting object properties.
ContentEntityBase::__sleep public function Overrides EntityBase::__sleep
ContentEntityBase::__unset public function Implements the magic method for unset().
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function Aliased as: traitSleep 1
DependencySerializationTrait::__wakeup public function 2
EntityBase::$enforceIsNew protected property Boolean indicating whether the entity should be forced to be new.
EntityBase::$entityTypeId protected property The entity type.
EntityBase::$typedData protected property A typed data object wrapping this entity.
EntityBase::delete public function Deletes an entity permanently. Overrides EntityInterface::delete 1
EntityBase::enforceIsNew public function Enforces an entity to be new. Overrides EntityInterface::enforceIsNew
EntityBase::entityTypeBundleInfo protected function Gets the entity type bundle info service.
EntityBase::entityTypeManager protected function Gets the entity type manager.
EntityBase::getCacheContexts public function The cache contexts associated with this object. Overrides CacheableDependencyTrait::getCacheContexts
EntityBase::getCacheMaxAge public function The maximum age for which this object may be cached. Overrides CacheableDependencyTrait::getCacheMaxAge
EntityBase::getCacheTags public function The cache tags associated with this object. Overrides CacheableDependencyTrait::getCacheTags
EntityBase::getCacheTagsToInvalidate public function Returns the cache tags that should be used to invalidate caches. Overrides EntityInterface::getCacheTagsToInvalidate 4
EntityBase::getConfigDependencyKey public function Gets the key that is used to store configuration dependencies. Overrides EntityInterface::getConfigDependencyKey
EntityBase::getConfigDependencyName public function Gets the configuration dependency name. Overrides EntityInterface::getConfigDependencyName 1
EntityBase::getConfigTarget public function Gets the configuration target identifier for the entity. Overrides EntityInterface::getConfigTarget 1
EntityBase::getEntityType public function Gets the entity type definition. Overrides EntityInterface::getEntityType
EntityBase::getEntityTypeId public function Gets the ID of the type of the entity. Overrides EntityInterface::getEntityTypeId
EntityBase::getListCacheTagsToInvalidate protected function The list cache tags to invalidate for this entity.
EntityBase::getOriginalId public function Gets the original ID. Overrides EntityInterface::getOriginalId 1
EntityBase::getTypedData public function Gets a typed data object for this entity object. Overrides EntityInterface::getTypedData
EntityBase::getTypedDataClass private function Returns the typed data class name for this entity.
EntityBase::hasLinkTemplate public function Indicates if a link template exists for a given key. Overrides EntityInterface::hasLinkTemplate
EntityBase::invalidateTagsOnDelete protected static function Invalidates an entity's cache tags upon delete. 1
EntityBase::invalidateTagsOnSave protected function Invalidates an entity's cache tags upon save. 2
EntityBase::languageManager protected function Gets the language manager.
EntityBase::linkTemplates protected function Gets an array link templates. 1
EntityBase::load public static function Loads an entity. Overrides EntityInterface::load
EntityBase::loadMultiple public static function Loads one or more entities. Overrides EntityInterface::loadMultiple
EntityBase::postLoad public static function Acts on loaded entities. Overrides EntityInterface::postLoad 3
EntityBase::preCreate public static function Changes the values of an entity before it is created. Overrides EntityInterface::preCreate 7
EntityBase::preDelete public static function Acts on entities before they are deleted and before hooks are invoked. Overrides EntityInterface::preDelete 8
EntityBase::save public function Saves an entity permanently. Overrides EntityInterface::save 3
EntityBase::setOriginalId public function Sets the original ID. Overrides EntityInterface::setOriginalId 1
EntityBase::toLink public function Generates the HTML for a link to this entity. Overrides EntityInterface::toLink
EntityBase::toUrl public function Gets the URL object for the entity. Overrides EntityInterface::toUrl 2
EntityBase::uriRelationships public function Gets a list of URI relationships supported by this entity. Overrides EntityInterface::uriRelationships
EntityBase::urlRouteParameters protected function Gets an array of placeholders for this entity. 2
EntityBase::uuidGenerator protected function Gets the UUID generator.
EntityChangedTrait::getChangedTime public function Gets the timestamp of the last entity change for the current translation.
EntityChangedTrait::getChangedTimeAcrossTranslations public function Returns the timestamp of the last entity change across all translations.
EntityChangedTrait::setChangedTime public function Sets the timestamp of the last entity change for the current translation.
EntityChangesDetectionTrait::getFieldsToSkipFromTranslationChangesCheck protected function Returns an array of field names to skip when checking for changes. Aliased as: traitGetFieldsToSkipFromTranslationChangesCheck
RefinableCacheableDependencyTrait::addCacheableDependency public function 1
RefinableCacheableDependencyTrait::addCacheContexts public function
RefinableCacheableDependencyTrait::addCacheTags public function
RefinableCacheableDependencyTrait::mergeCacheMaxAge public function
SynchronizableEntityTrait::$isSyncing protected property Is entity being created updated or deleted through synchronization process.
SynchronizableEntityTrait::isSyncing public function
SynchronizableEntityTrait::setSyncing public function
TranslationStatusInterface::TRANSLATION_CREATED constant Status code identifying a newly created translation.
TranslationStatusInterface::TRANSLATION_EXISTING constant Status code identifying an existing translation.
TranslationStatusInterface::TRANSLATION_REMOVED constant Status code identifying a removed translation.
User::$anonymousUser protected static property Stores a reference for a reusable anonymous user entity.
User::activate public function Activates the user. Overrides UserInterface::activate
User::addRole public function Add a role to a user. Overrides UserInterface::addRole
User::baseFieldDefinitions public static function Overrides ContentEntityBase::baseFieldDefinitions
User::block public function Blocks the user. Overrides UserInterface::block
User::checkExistingPassword public function Checks the existing password if set. Overrides UserInterface::checkExistingPassword
User::getAccountName public function Returns the unaltered login name of this account. Overrides AccountInterface::getAccountName
User::getAllowedConfigurableLanguageCodes public static function Defines allowed configurable language codes for AllowedValues constraints.
User::getAllowedTimezones public static function Defines allowed timezones for the field's AllowedValues constraint.
User::getAnonymousUser public static function Returns an anonymous user entity.
User::getCreatedTime public function Returns the creation time of the user as a UNIX timestamp. Overrides UserInterface::getCreatedTime
User::getDisplayName public function Returns the display name of this account. Overrides AccountInterface::getDisplayName
User::getEmail public function Returns the email address of this account. Overrides AccountInterface::getEmail
User::getInitialEmail public function Returns the email that was used when the user was registered. Overrides UserInterface::getInitialEmail
User::getLastAccessedTime public function The timestamp when the account last accessed the site. Overrides AccountInterface::getLastAccessedTime
User::getLastLoginTime public function Returns the UNIX timestamp when the user last logged in. Overrides UserInterface::getLastLoginTime
User::getPassword public function Returns the hashed password. Overrides UserInterface::getPassword
User::getPreferredAdminLangcode public function Returns the preferred administrative language code of the account. Overrides AccountInterface::getPreferredAdminLangcode
User::getPreferredLangcode public function Returns the preferred language code of the account. Overrides AccountInterface::getPreferredLangcode
User::getRoles public function Returns a list of roles. Overrides AccountInterface::getRoles
User::getRoleStorage protected function Returns the role storage object.
User::getTimeZone public function Returns the timezone of this account. Overrides AccountInterface::getTimeZone
User::hasPermission public function Checks whether a user has a certain permission. Overrides AccountInterface::hasPermission
User::hasRole public function Whether a user has a certain role. Overrides UserInterface::hasRole
User::isActive public function Returns TRUE if the user is active. Overrides UserInterface::isActive
User::isAnonymous public function Returns TRUE if the account is anonymous. Overrides AccountInterface::isAnonymous
User::isAuthenticated public function Returns TRUE if the account is authenticated. Overrides AccountInterface::isAuthenticated
User::isBlocked public function Returns TRUE if the user is blocked. Overrides UserInterface::isBlocked
User::isNew public function Determines whether the entity is new. Overrides EntityBase::isNew
User::label public function Gets the label of the entity. Overrides ContentEntityBase::label
User::postDelete public static function Acts on deleted entities before the delete hook is invoked. Overrides EntityBase::postDelete
User::postSave public function Acts on a saved entity before the insert or update hook is invoked. Overrides ContentEntityBase::postSave
User::preSave public function Acts on an entity before the presave hook is invoked. Overrides ContentEntityBase::preSave
User::removeRole public function Remove a role from a user. Overrides UserInterface::removeRole
User::setEmail public function Sets the email address of the user. Overrides UserInterface::setEmail
User::setExistingPassword public function Sets the existing plain text password. Overrides UserInterface::setExistingPassword
User::setLastAccessTime public function Sets the UNIX timestamp when the user last accessed the site.. Overrides UserInterface::setLastAccessTime
User::setLastLoginTime public function Sets the UNIX timestamp when the user last logged in. Overrides UserInterface::setLastLoginTime
User::setPassword public function Sets the user password. Overrides UserInterface::setPassword
User::setUsername public function Sets the username of this account. Overrides UserInterface::setUsername
UserInterface::REGISTER_ADMINISTRATORS_ONLY constant Only administrators can create user accounts.
UserInterface::REGISTER_VISITORS constant Visitors can create their own accounts.
UserInterface::REGISTER_VISITORS_ADMINISTRATIVE_APPROVAL constant Visitors can create accounts that only become active with admin approval.
UserInterface::TIMEZONE_DEFAULT constant New users will be set to the default time zone at registration.
UserInterface::TIMEZONE_EMPTY constant New users will get an empty time zone at registration.
UserInterface::TIMEZONE_SELECT constant New users will select their own timezone at registration.
UserInterface::USERNAME_MAX_LENGTH constant Maximum length of username text field.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.