ElggEntity.php

Go to the documentation of this file.

<?php
 
abstract class ElggEntity extends \ElggData implements
    Locatable, // Geocoding interface
    Importable, // Allow import of data (deprecated 1.9)
    \Elgg\EntityIcon // Icon interface
{
    
    protected $url_override;
 
    protected $temp_metadata = array();
 
    protected $temp_annotations = array();
 
    protected $temp_private_settings = array();
 
    protected $volatile = array();
 
    protected $orig_attributes = array();
    
    protected function initializeAttributes() {
        parent::initializeAttributes();
 
        $this->attributes['guid'] = null;
        $this->attributes['type'] = null;
        $this->attributes['subtype'] = null;
 
        $this->attributes['owner_guid'] = _elgg_services()->session->getLoggedInUserGuid();
        $this->attributes['container_guid'] = _elgg_services()->session->getLoggedInUserGuid();
 
        $this->attributes['site_guid'] = null;
        $this->attributes['access_id'] = ACCESS_PRIVATE;
        $this->attributes['time_updated'] = null;
        $this->attributes['last_action'] = null;
        $this->attributes['enabled'] = "yes";
    }
 
    public function __clone() {
        $orig_entity = get_entity($this->guid);
        if (!$orig_entity) {
            _elgg_services()->logger->error("Failed to clone entity with GUID $this->guid");
            return;
        }
 
        $metadata_array = elgg_get_metadata(array(
            'guid' => $this->guid,
            'limit' => 0
        ));
 
        $this->attributes['guid'] = "";
 
        $this->attributes['subtype'] = $orig_entity->getSubtype();
 
        // copy metadata over to new entity - slightly convoluted due to
        // handling of metadata arrays
        if (is_array($metadata_array)) {
            // create list of metadata names
            $metadata_names = array();
            foreach ($metadata_array as $metadata) {
                $metadata_names[] = $metadata['name'];
            }
            // arrays are stored with multiple enties per name
            $metadata_names = array_unique($metadata_names);
 
            // move the metadata over
            foreach ($metadata_names as $name) {
                $this->__set($name, $orig_entity->$name);
            }
        }
    }
 
    public function __set($name, $value) {
        if ($this->$name === $value) {
            // quick return if value is not changing
            return;
        }
 
        if (array_key_exists($name, $this->attributes)) {
            // if an attribute is 1 (integer) and it's set to "1" (string), don't consider that a change.
            if (is_int($this->attributes[$name])
                    && is_string($value)
                    && ((string)$this->attributes[$name] === $value)) {
                return;
            }
 
            // Due to https://github.com/Elgg/Elgg/pull/5456#issuecomment-17785173, certain attributes
            // will store empty strings as null in the DB. In the somewhat common case that we're re-setting
            // the value to empty string, don't consider this a change.
            if (in_array($name, ['title', 'name', 'description'])
                    && $this->attributes[$name] === null
                    && $value === "") {
                return;
            }
 
            // keep original values
            if ($this->guid && !array_key_exists($name, $this->orig_attributes)) {
                $this->orig_attributes[$name] = $this->attributes[$name];
            }
 
            // Certain properties should not be manually changed!
            switch ($name) {
                case 'guid':
                case 'time_updated':
                case 'last_action':
                    return;
                    break;
                case 'access_id':
                case 'owner_guid':
                case 'container_guid':
                    if ($value !== null) {
                        $this->attributes[$name] = (int)$value;
                    } else {
                        $this->attributes[$name] = null;
                    }
                    break;
                default:
                    $this->attributes[$name] = $value;
                    break;
            }
            return;
        }
 
        if ($name === 'tables_split' || $name === 'tables_loaded') {
            elgg_deprecated_notice("Do not read/write ->tables_split or ->tables_loaded.", "2.1");
            return;
        }
 
        $this->setMetadata($name, $value);
    }
 
    public function set($name, $value) {
        elgg_deprecated_notice("Use -> instead of set()", 1.9);
        $this->__set($name, $value);
 
        return true;
    }
 
    public function getOriginalAttributes() {
        return $this->orig_attributes;
    }
 
    public function __get($name) {
        if (array_key_exists($name, $this->attributes)) {
            if ($name === 'subtype' && $this->attributes['guid']) {
                // note: only show deprecation notice if user reads ->subtype after save/load
                elgg_deprecated_notice("Use getSubtype()", 1.9);
            }
            return $this->attributes[$name];
        }
 
        if ($name === 'tables_split' || $name === 'tables_loaded') {
            elgg_deprecated_notice("Do not read/write ->tables_split or ->tables_loaded.", "2.1");
            return 2;
        }
 
        return $this->getMetadata($name);
    }
 
    public function get($name) {
        elgg_deprecated_notice("Use -> instead of get()", 1.9);
        return $this->__get($name);
    }
 
    abstract public function getDisplayName();
 
    abstract public function setDisplayName($displayName);
 
    public function getMetadata($name) {
        $guid = $this->getGUID();
 
        if (!$guid) {
            if (isset($this->temp_metadata[$name])) {
                // md is returned as an array only if more than 1 entry
                if (count($this->temp_metadata[$name]) == 1) {
                    return $this->temp_metadata[$name][0];
                } else {
                    return $this->temp_metadata[$name];
                }
            } else {
                return null;
            }
        }
 
        // upon first cache miss, just load/cache all the metadata and retry.
        // if this works, the rest of this function may not be needed!
        $cache = _elgg_services()->metadataCache;
        if ($cache->isLoaded($guid)) {
            return $cache->getSingle($guid, $name);
        } else {
            $cache->populateFromEntities(array($guid));
            // in case ignore_access was on, we have to check again...
            if ($cache->isLoaded($guid)) {
                return $cache->getSingle($guid, $name);
            }
        }
 
        $md = elgg_get_metadata(array(
            'guid' => $guid,
            'metadata_name' => $name,
            'limit' => 0,
            'distinct' => false,
        ));
 
        $value = null;
 
        if ($md && !is_array($md)) {
            $value = $md->value;
        } elseif (count($md) == 1) {
            $value = $md[0]->value;
        } else if ($md && is_array($md)) {
            $value = metadata_array_to_values($md);
        }
 
        return $value;
    }
 
    public function __unset($name) {
        if (array_key_exists($name, $this->attributes)) {
            $this->attributes[$name] = "";
        } else {
            $this->deleteMetadata($name);
        }
    }
 
    public function setMetadata($name, $value, $value_type = '', $multiple = false, $owner_guid = 0, $access_id = null) {
 
        // normalize value to an array that we will loop over
        // remove indexes if value already an array.
        if (is_array($value)) {
            $value = array_values($value);
        } else {
            $value = array($value);
        }
 
        // saved entity. persist md to db.
        if ($this->guid) {
            // if overwriting, delete first.
            if (!$multiple) {
                $options = array(
                    'guid' => $this->getGUID(),
                    'metadata_name' => $name,
                    'limit' => 0
                );
                // @todo in 1.9 make this return false if can't add metadata
                // https://github.com/elgg/elgg/issues/4520
                //
                // need to remove access restrictions right now to delete
                // because this is the expected behavior
                $ia = elgg_set_ignore_access(true);
                if (false === elgg_delete_metadata($options)) {
                    return false;
                }
                elgg_set_ignore_access($ia);
            }
 
            $owner_guid = $owner_guid ? (int)$owner_guid : $this->owner_guid;
 
            if ($access_id === null) {
                $access_id = $this->access_id;
            } elseif ($access_id != ACCESS_PUBLIC) {
                $access_id = (int)$access_id;
                elgg_deprecated_notice('Setting $access_id to a value other than ACCESS_PUBLIC is deprecated. '
                    . 'All metadata will be public in 3.0.', '2.3');
            }
 
            // add new md
            $result = true;
            foreach ($value as $value_tmp) {
                // at this point $value is appended because it was cleared above if needed.
                $md_id = _elgg_services()->metadataTable->create($this->guid, $name, $value_tmp, $value_type,
                        $owner_guid, $access_id, true);
                if (!$md_id) {
                    return false;
                }
            }
 
            return $result;
        } else {
            // unsaved entity. store in temp array
 
            // returning single entries instead of an array of 1 element is decided in
            // getMetaData(), just like pulling from the db.
 
            if ($owner_guid != 0 || $access_id !== null) {
                $msg = "owner guid and access id cannot be used in \ElggEntity::setMetadata() until entity is saved.";
                throw new \InvalidArgumentException($msg);
            }
 
            // if overwrite, delete first
            if (!$multiple || !isset($this->temp_metadata[$name])) {
                $this->temp_metadata[$name] = array();
            }
 
            // add new md
            $this->temp_metadata[$name] = array_merge($this->temp_metadata[$name], $value);
            return true;
        }
    }
 
    public function deleteMetadata($name = null) {
 
        if (!$this->guid) {
            return false;
        }
 
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['metadata_name'] = $name;
        }
 
        return elgg_delete_metadata($options);
    }
 
    public function deleteOwnedMetadata($name = null) {
        // access is turned off for this because they might
        // no longer have access to an entity they created metadata on.
        $ia = elgg_set_ignore_access(true);
        $options = array(
            'metadata_owner_guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['metadata_name'] = $name;
        }
 
        $r = elgg_delete_metadata($options);
        elgg_set_ignore_access($ia);
        return $r;
    }
 
    public function disableMetadata($name = '') {
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['metadata_name'] = $name;
        }
 
        return elgg_disable_metadata($options);
    }
 
    public function enableMetadata($name = '') {
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['metadata_name'] = $name;
        }
 
        return elgg_enable_metadata($options);
    }
 
    public function getVolatileData($name) {
        return array_key_exists($name, $this->volatile) ? $this->volatile[$name] : null;
    }
 
    public function setVolatileData($name, $value) {
        $this->volatile[$name] = $value;
    }
 
    public function storeInPersistedCache(\ElggSharedMemoryCache $cache, $last_action = 0) {
        $tmp = $this->volatile;
 
        // don't store volatile data
        $this->volatile = [];
        if ($last_action) {
            $this->attributes['last_action'] = (int)$last_action;
        }
        $cache->save($this->guid, $this);
 
        $this->volatile = $tmp;
    }
 
    public function deleteRelationships($relationship = null) {
        $relationship = (string)$relationship;
        $result = remove_entity_relationships($this->getGUID(), $relationship);
        return $result && remove_entity_relationships($this->getGUID(), $relationship, true);
    }
 
    public function addRelationship($guid_two, $relationship) {
        return add_entity_relationship($this->getGUID(), $relationship, $guid_two);
    }
 
    public function removeRelationship($guid_two, $relationship) {
        return remove_entity_relationship($this->getGUID(), $relationship, $guid_two);
    }
 
    public function setPrivateSetting($name, $value) {
        if ((int) $this->guid > 0) {
            return set_private_setting($this->getGUID(), $name, $value);
        } else {
            $this->temp_private_settings[$name] = $value;
            return true;
        }
    }
 
    public function getPrivateSetting($name) {
        if ((int) ($this->guid) > 0) {
            return get_private_setting($this->getGUID(), $name);
        } else {
            if (isset($this->temp_private_settings[$name])) {
                return $this->temp_private_settings[$name];
            }
        }
        return null;
    }
 
    public function removePrivateSetting($name) {
        return remove_private_setting($this->getGUID(), $name);
    }
 
    public function deleteAnnotations($name = null) {
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['annotation_name'] = $name;
        }
 
        return elgg_delete_annotations($options);
    }
 
    public function deleteOwnedAnnotations($name = null) {
        // access is turned off for this because they might
        // no longer have access to an entity they created annotations on.
        $ia = elgg_set_ignore_access(true);
        $options = array(
            'annotation_owner_guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['annotation_name'] = $name;
        }
 
        $r = elgg_delete_annotations($options);
        elgg_set_ignore_access($ia);
        return $r;
    }
 
    public function disableAnnotations($name = '') {
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['annotation_name'] = $name;
        }
 
        return elgg_disable_annotations($options);
    }
 
    public function enableAnnotations($name = '') {
        $options = array(
            'guid' => $this->guid,
            'limit' => 0
        );
        if ($name) {
            $options['annotation_name'] = $name;
        }
 
        return elgg_enable_annotations($options);
    }
 
    private function getAnnotationCalculation($name, $calculation) {
        $options = array(
            'guid' => $this->getGUID(),
            'distinct' => false,
            'annotation_name' => $name,
            'annotation_calculation' => $calculation
        );
 
        return elgg_get_annotations($options);
    }
 
    public function annotate($name, $value, $access_id = ACCESS_PRIVATE, $owner_guid = 0, $vartype = "") {
        if ((int) $this->guid > 0) {
            return create_annotation($this->getGUID(), $name, $value, $vartype, $owner_guid, $access_id);
        } else {
            $this->temp_annotations[$name] = $value;
        }
        return true;
    }
 
    public function getAnnotations($options = array(), $limit = 50, $offset = 0, $order = "asc") {
        if (!is_array($options)) {
            elgg_deprecated_notice("\ElggEntity::getAnnotations() takes an array of options.", 1.9);
        }
 
        if ((int) ($this->guid) > 0) {
            if (!is_array($options)) {
                $options = array(
                    'guid' => $this->guid,
                    'annotation_name' => $options,
                    'limit' => $limit,
                    'offset' => $offset,
                );
 
                if ($order != 'asc') {
                    $options['reverse_order_by'] = true;
                }
            } else {
                $options['guid'] = $this->guid;
            }
 
            return elgg_get_annotations($options);
        } else {
            if (!is_array($options)) {
                $name = $options;
            } else {
                $name = elgg_extract('annotation_name', $options, '');
            }
 
            if (isset($this->temp_annotations[$name])) {
                return array($this->temp_annotations[$name]);
            }
        }
 
        return array();
    }
 
    public function countAnnotations($name = "") {
        return $this->getAnnotationCalculation($name, 'count');
    }
 
    public function getAnnotationsAvg($name) {
        return $this->getAnnotationCalculation($name, 'avg');
    }
 
    public function getAnnotationsSum($name) {
        return $this->getAnnotationCalculation($name, 'sum');
    }
 
    public function getAnnotationsMin($name) {
        return $this->getAnnotationCalculation($name, 'min');
    }
 
    public function getAnnotationsMax($name) {
        return $this->getAnnotationCalculation($name, 'max');
    }
 
    public function countComments() {
        $params = array('entity' => $this);
        $num = _elgg_services()->hooks->trigger('comments:count', $this->getType(), $params);
 
        if (is_int($num)) {
            return $num;
        } else {
            return elgg_get_entities(array(
                'type' => 'object',
                'subtype' => 'comment',
                'container_guid' => $this->getGUID(),
                'count' => true,
                'distinct' => false,
            ));
        }
    }
 
    public function getEntitiesFromRelationship($options = array(), $inverse = false, $limit = 50, $offset = 0) {
        if (is_array($options)) {
            $options['relationship_guid'] = $this->getGUID();
            return elgg_get_entities_from_relationship($options);
        } else {
            elgg_deprecated_notice("\ElggEntity::getEntitiesFromRelationship takes an options array", 1.9);
            return elgg_get_entities_from_relationship(array(
                'relationship' => $options,
                'relationship_guid' => $this->getGUID(),
                'inverse_relationship' => $inverse,
                'limit' => $limit,
                'offset' => $offset
            ));
        }
    }
 
    public function countEntitiesFromRelationship($relationship, $inverse_relationship = false) {
        return elgg_get_entities_from_relationship(array(
            'relationship' => $relationship,
            'relationship_guid' => $this->getGUID(),
            'inverse_relationship' => $inverse_relationship,
            'count' => true
        ));
    }
 
    public function canEdit($user_guid = 0) {
        return _elgg_services()->userCapabilities->canEdit($this, $user_guid);
    }
 
    public function canDelete($user_guid = 0) {
        return _elgg_services()->userCapabilities->canDelete($this, $user_guid);
    }
 
    public function canEditMetadata($metadata = null, $user_guid = 0) {
        return _elgg_services()->userCapabilities->canEditMetadata($this, $user_guid, $metadata);
    }
 
    public function canWriteToContainer($user_guid = 0, $type = 'all', $subtype = 'all') {
        return _elgg_services()->userCapabilities->canWriteToContainer($this, $user_guid, $type, $subtype);
    }
 
    public function canComment($user_guid = 0, $default = null) {
        return _elgg_services()->userCapabilities->canComment($this, $user_guid, $default);
    }
 
    public function canAnnotate($user_guid = 0, $annotation_name = '') {
        return _elgg_services()->userCapabilities->canAnnotate($this, $user_guid, $annotation_name);
    }
 
    public function getAccessID() {
        return $this->access_id;
    }
 
    public function getGUID() {
        return $this->guid;
    }
 
    public function getType() {
        return $this->type;
    }
 
    public function getSubtype() {
        // If this object hasn't been saved, then return the subtype string.
        if ($this->attributes['guid']) {
            return get_subtype_from_id($this->attributes['subtype']);
        }
        return $this->attributes['subtype'];
    }
 
    public function getOwnerGUID() {
        return (int)$this->owner_guid;
    }
 
    public function getOwnerEntity() {
        return get_entity($this->owner_guid);
    }
 
    public function setContainerGUID($container_guid) {
        return $this->container_guid = (int)$container_guid;
    }
 
    public function getContainerGUID() {
        return (int)$this->container_guid;
    }
 
    public function getContainerEntity() {
        return get_entity($this->getContainerGUID());
    }
 
    public function getTimeUpdated() {
        return $this->time_updated;
    }
 
    public function getURL() {
        
        $url = "";
 
        // @todo remove when elgg_register_entity_url_handler() has been removed
        if ($this->guid) {
            global $CONFIG;
            if (isset($CONFIG->entity_url_handler[$this->getType()][$this->getSubtype()])) {
                $function = $CONFIG->entity_url_handler[$this->getType()][$this->getSubtype()];
                if (is_callable($function)) {
                    $url = call_user_func($function, $this);
                }
            } elseif (isset($CONFIG->entity_url_handler[$this->getType()]['all'])) {
                $function = $CONFIG->entity_url_handler[$this->getType()]['all'];
                if (is_callable($function)) {
                    $url = call_user_func($function, $this);
                }
            } elseif (isset($CONFIG->entity_url_handler['all']['all'])) {
                $function = $CONFIG->entity_url_handler['all']['all'];
                if (is_callable($function)) {
                    $url = call_user_func($function, $this);
                }
            }
 
            if ($url) {
                $url = elgg_normalize_url($url);
            }
        }
 
        $type = $this->getType();
        $params = array('entity' => $this);
        $url = _elgg_services()->hooks->trigger('entity:url', $type, $params, $url);
 
        // @todo remove when \ElggEntity::setURL() has been removed
        if (!empty($this->url_override)) {
            $url = $this->url_override;
        }
 
        return elgg_normalize_url($url);
    }
 
    public function setURL($url) {
        elgg_deprecated_notice('\ElggEntity::setURL() has been replaced by the "entity:url" plugin hook', 1.9);
        $this->url_override = $url;
        return $url;
    }
 
    public function saveIconFromUploadedFile($input_name, $type = 'icon', array $coords = array()) {
        return _elgg_services()->iconService->saveIconFromUploadedFile($this, $input_name, $type, $coords);
    }
 
    public function saveIconFromLocalFile($filename, $type = 'icon', array $coords = array()) {
        return _elgg_services()->iconService->saveIconFromLocalFile($this, $filename, $type, $coords);
    }
 
    public function saveIconFromElggFile(\ElggFile $file, $type = 'icon', array $coords = array()) {
        return _elgg_services()->iconService->saveIconFromElggFile($this, $file, $type, $coords);
    }
    
    public function getIcon($size, $type = 'icon') {
        return _elgg_services()->iconService->getIcon($this, $size, $type);
    }
 
    public function deleteIcon($type = 'icon') {
        return _elgg_services()->iconService->deleteIcon($this, $type);
    }
    
    public function getIconLastChange($size, $type = 'icon') {
        return _elgg_services()->iconService->getIconLastChange($this, $size, $type);
    }
    
    public function hasIcon($size, $type = 'icon') {
        return _elgg_services()->iconService->hasIcon($this, $size, $type);
    }
 
    public function getIconURL($params = array()) {
        return _elgg_services()->iconService->getIconURL($this, $params);
    }
 
    public function addToSite($site) {
        if (!elgg_instanceof($site, 'site')) {
            return false;
        }
 
        return $site->addEntity($this);
    }
 
    public function removeFromSite($site) {
        if (!elgg_instanceof($site, 'site')) {
            return false;
        }
 
        return $site->removeEntity($this);
    }
 
    public function getSites($options = array()) {
        $options['relationship'] = 'member_of_site';
        $options['relationship_guid'] = $this->guid;
        $options['inverse_relationship'] = false;
        if (!isset($options['site_guid']) || !isset($options['site_guids'])) {
            $options['site_guids'] = ELGG_ENTITIES_ANY_VALUE;
        }
 
        return elgg_get_entities_from_relationship($options);
    }
 
    public function isFullyLoaded() {
        return (bool)$this->guid;
    }
 
    public function save() {
        $guid = $this->guid;
        if ($guid > 0) {
            $guid = $this->update();
        } else {
            $guid = $this->create();
            if ($guid && !_elgg_services()->events->trigger('create', $this->type, $this)) {
                // plugins that return false to event don't need to override the access system
                $ia = elgg_set_ignore_access(true);
                $this->delete();
                elgg_set_ignore_access($ia);
                return false;
            }
        }
 
        if ($guid) {
            _elgg_services()->entityCache->set($this);
            $this->storeInPersistedCache(_elgg_get_memcache('new_entity_cache'));
        }
 
        return $guid;
    }
    
    protected function create() {
 
        $allowed_types = elgg_get_config('entity_types');
        $type = $this->getDatabase()->sanitizeString($this->attributes['type']);
        if (!in_array($type, $allowed_types)) {
            throw new \InvalidParameterException('Entity type must be one of the allowed types: '
                    . implode(', ', $allowed_types));
        }
        
        $subtype = $this->attributes['subtype'];
        $subtype_id = add_subtype($type, $subtype);
        $owner_guid = (int)$this->attributes['owner_guid'];
        $access_id = (int)$this->attributes['access_id'];
        $now = $this->getCurrentTime()->getTimestamp();
        $time_created = isset($this->attributes['time_created']) ? (int)$this->attributes['time_created'] : $now;
 
        $site_guid = $this->attributes['site_guid'];
        if ($site_guid == 0) {
            $site_guid = elgg_get_config('site_guid');
        }
        $site_guid = (int)$site_guid;
        
        $container_guid = $this->attributes['container_guid'];
        if ($container_guid == 0) {
            $container_guid = $owner_guid;
            $this->attributes['container_guid'] = $container_guid;
        }
        $container_guid = (int)$container_guid;
 
        if ($access_id == ACCESS_DEFAULT) {
            throw new \InvalidParameterException('ACCESS_DEFAULT is not a valid access level. See its documentation in elgglib.h');
        }
 
        $user_guid = elgg_get_logged_in_user_guid();
 
        // If given an owner, verify it can be loaded
        if ($owner_guid) {
            $owner = $this->getOwnerEntity();
            if (!$owner) {
                _elgg_services()->logger->error("User $user_guid tried to create a ($type, $subtype), but the given"
                    . " owner $owner_guid could not be loaded.");
                return false;
            }
 
            // If different owner than logged in, verify can write to container.
 
            if ($user_guid != $owner_guid && !$owner->canWriteToContainer(0, $type, $subtype)) {
                _elgg_services()->logger->error("User $user_guid tried to create a ($type, $subtype) with owner"
                    . " $owner_guid, but the user wasn't permitted to write to the owner's container.");
                return false;
            }
        }
 
        // If given a container, verify it can be loaded and that the current user can write to it
        if ($container_guid) {
            $container = $this->getContainerEntity();
            if (!$container) {
                _elgg_services()->logger->error("User $user_guid tried to create a ($type, $subtype), but the given"
                    . " container $container_guid could not be loaded.");
                return false;
            }
 
            if (!$container->canWriteToContainer(0, $type, $subtype)) {
                _elgg_services()->logger->error("User $user_guid tried to create a ($type, $subtype), but was not"
                    . " permitted to write to container $container_guid.");
                return false;
            }
        }
 
        $result = _elgg_services()->entityTable->insertRow((object) [
            'type' => $type,
            'subtype_id' => $subtype_id,
            'owner_guid' => $owner_guid,
            'container_guid' => $container_guid,
            'site_guid' => $site_guid,
            'access_id' => $access_id,
            'time_created' => $time_created,
            'time_updated' => $now,
            'last_action' => $now,
        ]);
 
        if (!$result) {
            throw new \IOException("Unable to save new object's base entity information!");
        }
    
        // for BC with 1.8, ->subtype always returns ID, ->getSubtype() the string
        $this->attributes['subtype'] = (int)$subtype_id;
        $this->attributes['guid'] = (int)$result;
        $this->attributes['time_created'] = (int)$time_created;
        $this->attributes['time_updated'] = (int)$now;
        $this->attributes['last_action'] = (int)$now;
        $this->attributes['site_guid'] = (int)$site_guid;
        $this->attributes['container_guid'] = (int)$container_guid;
 
        // We are writing this new entity to cache to make sure subsequent calls
        // to get_entity() load entity from cache and not from the DB
        // At this point, secondary attributes have not yet been written to the DB,
        // but metadata and annotation event handlers may be calling get_entity()
        _elgg_services()->entityCache->set($this);
 
        // Save any unsaved metadata
        if (sizeof($this->temp_metadata) > 0) {
            foreach ($this->temp_metadata as $name => $value) {
                $this->$name = $value;
            }
            
            $this->temp_metadata = array();
        }
 
        // Save any unsaved annotations.
        if (sizeof($this->temp_annotations) > 0) {
            foreach ($this->temp_annotations as $name => $value) {
                $this->annotate($name, $value);
            }
            
            $this->temp_annotations = array();
        }
 
        // Save any unsaved private settings.
        if (sizeof($this->temp_private_settings) > 0) {
            foreach ($this->temp_private_settings as $name => $value) {
                $this->setPrivateSetting($name, $value);
            }
            
            $this->temp_private_settings = array();
        }
        
        return $result;
    }
 
    protected function update() {
        
        _elgg_services()->boot->invalidateCache($this->guid);
 
        if (!$this->canEdit()) {
            return false;
        }
 
        // give old update event a chance to stop the update
        if (!_elgg_services()->events->trigger('update', $this->type, $this)) {
            return false;
        }
 
        // See #6225. We copy these after the update event in case a handler changed one of them.
        $guid = (int)$this->guid;
        $owner_guid = (int)$this->owner_guid;
        $access_id = (int)$this->access_id;
        $container_guid = (int)$this->container_guid;
        $time_created = (int)$this->time_created;
        $time = $this->getCurrentTime()->getTimestamp();
 
        if ($access_id == ACCESS_DEFAULT) {
            throw new \InvalidParameterException('ACCESS_DEFAULT is not a valid access level. See its documentation in elgglib.php');
        }
 
        $ret = _elgg_services()->entityTable->updateRow($guid, (object) [
            'owner_guid' => $owner_guid,
            'container_guid' => $container_guid,
            'access_id' => $access_id,
            'time_created' => $time_created,
            'time_updated' => $time,
            'guid' => $guid,
        ]);
 
        elgg_trigger_after_event('update', $this->type, $this);
 
        // TODO(evan): Move this to \ElggObject?
        if ($this instanceof \ElggObject) {
            update_river_access_by_object($guid, $access_id);
        }
 
        if ($ret !== false) {
            $this->attributes['time_updated'] = $time;
        }
 
        $this->orig_attributes = [];
 
        // Handle cases where there was no error BUT no rows were updated!
        return $ret !== false;
    }
 
    protected function load($guid) {
        if ($guid instanceof \stdClass) {
            $row = $guid;
        } else {
            $row = get_entity_as_row($guid);
        }
 
        if ($row) {
            // Create the array if necessary - all subclasses should test before creating
            if (!is_array($this->attributes)) {
                $this->attributes = array();
            }
 
            // Now put these into the attributes array as core values
            $objarray = (array) $row;
            foreach ($objarray as $key => $value) {
                $this->attributes[$key] = $value;
            }
 
            // guid needs to be an int  https://github.com/elgg/elgg/issues/4111
            $this->attributes['guid'] = (int)$this->attributes['guid'];
 
            // for BC with 1.8, ->subtype always returns ID, ->getSubtype() the string
            $this->attributes['subtype'] = (int)$this->attributes['subtype'];
 
            // Cache object handle
            if ($this->attributes['guid']) {
                _elgg_services()->entityCache->set($this);
            }
 
            return true;
        }
 
        return false;
    }
 
    protected function loadAdditionalSelectValues(array $data) {
        foreach ($data as $name => $value) {
            $this->setVolatileData("select:$name", $value);
        }
    }
    
    public function refresh(\stdClass $row) {
        if ($row instanceof \stdClass) {
            return $this->load($row);
        }
        return false;
    }
 
    public function disable($reason = "", $recursive = true) {
        if (!$this->guid) {
            return false;
        }
        
        if (!_elgg_services()->events->trigger('disable', $this->type, $this)) {
            return false;
        }
        
        if (!$this->canEdit()) {
            return false;
        }
 
        if ($this instanceof ElggUser && $this->banned === 'no') {
            // temporarily ban to prevent using the site during disable
            _elgg_services()->usersTable->markBanned($this->guid, true);
            $unban_after = true;
        } else {
            $unban_after = false;
        }
 
        if ($reason) {
            $this->disable_reason = $reason;
        }
 
        $dbprefix = elgg_get_config('dbprefix');
        
        $guid = (int) $this->guid;
        
        if ($recursive) {
            // Only disable enabled subentities
            $hidden = access_get_show_hidden_status();
            access_show_hidden_entities(false);
 
            $ia = elgg_set_ignore_access(true);
 
            $base_options = [
                'wheres' => [
                    "e.guid != $guid",
                ],
                'limit' => false,
            ];
            
            foreach (['owner_guid', 'container_guid', 'site_guid'] as $db_column) {
                $options = $base_options;
                $options[$db_column] = $guid;
                
                $subentities = new \ElggBatch('elgg_get_entities', $options);
                $subentities->setIncrementOffset(false);
                
                foreach ($subentities as $subentity) {
                    /* @var $subentity \ElggEntity */
                    if (!$subentity->isEnabled()) {
                        continue;
                    }
                    add_entity_relationship($subentity->guid, 'disabled_with', $guid);
                    $subentity->disable($reason);
                }
            }
 
            access_show_hidden_entities($hidden);
            elgg_set_ignore_access($ia);
        }
 
        $this->disableMetadata();
        $this->disableAnnotations();
 
        _elgg_services()->entityCache->remove($guid);
        
        $sql = "
            UPDATE {$dbprefix}entities
            SET enabled = 'no'
            WHERE guid = :guid
        ";
        $params = [
            ':guid' => $guid,
        ];
        $disabled = $this->getDatabase()->updateData($sql, false, $params);
 
        if ($unban_after) {
            _elgg_services()->usersTable->markBanned($this->guid, false);
        }
 
        if ($disabled) {
            $this->attributes['enabled'] = 'no';
            _elgg_services()->events->trigger('disable:after', $this->type, $this);
        }
 
        return (bool) $disabled;
    }
 
    public function enable($recursive = true) {
        $guid = (int)$this->guid;
        if (!$guid) {
            return false;
        }
        
        if (!_elgg_services()->events->trigger('enable', $this->type, $this)) {
            return false;
        }
        
        if (!$this->canEdit()) {
            return false;
        }
        
        global $CONFIG;
    
        // Override access only visible entities
        $old_access_status = access_get_show_hidden_status();
        access_show_hidden_entities(true);
    
        $result = $this->getDatabase()->updateData("UPDATE {$CONFIG->dbprefix}entities
            SET enabled = 'yes'
            WHERE guid = $guid");
 
        $this->deleteMetadata('disable_reason');
        $this->enableMetadata();
        $this->enableAnnotations();
 
        if ($recursive) {
            $disabled_with_it = elgg_get_entities_from_relationship(array(
                'relationship' => 'disabled_with',
                'relationship_guid' => $guid,
                'inverse_relationship' => true,
                'limit' => 0,
            ));
 
            foreach ($disabled_with_it as $e) {
                $e->enable();
                remove_entity_relationship($e->guid, 'disabled_with', $guid);
            }
        }
    
        access_show_hidden_entities($old_access_status);
    
        if ($result) {
            $this->attributes['enabled'] = 'yes';
            _elgg_services()->events->trigger('enable:after', $this->type, $this);
        }
 
        return $result;
    }
 
    public function isEnabled() {
        return $this->enabled == 'yes';
    }
 
    public function delete($recursive = true) {
 
        $guid = $this->guid;
        if (!$guid) {
            return false;
        }
        
        // first check if we can delete this entity
        // NOTE: in Elgg <= 1.10.3 this was after the delete event,
        // which could potentially remove some content if the user didn't have access
        if (!$this->canDelete()) {
            return false;
        }
 
        // now trigger an event to let others know this entity is about to be deleted
        // so they can prevent it or take their own actions
        if (!_elgg_services()->events->trigger('delete', $this->type, $this)) {
            return false;
        }
 
        if ($this instanceof ElggUser) {
            // ban to prevent using the site during delete
            _elgg_services()->usersTable->markBanned($this->guid, true);
        }
 
        // Delete contained owned and otherwise releated objects (depth first)
        if ($recursive) {
            // Temporarily overriding access controls
            $entity_disable_override = access_get_show_hidden_status();
            access_show_hidden_entities(true);
            $ia = elgg_set_ignore_access(true);
 
            // @todo there was logic in the original code that ignored
            // entities with owner or container guids of themselves.
            // this should probably be prevented in \ElggEntity instead of checked for here
            $base_options = [
                'wheres' => [
                    "e.guid != $guid",
                ],
                'limit' => false,
            ];
            
            foreach (['owner_guid', 'container_guid', 'site_guid'] as $db_column) {
                $options = $base_options;
                $options[$db_column] = $guid;
                
                $batch = new \ElggBatch('elgg_get_entities', $options);
                $batch->setIncrementOffset(false);
                
                /* @var $e \ElggEntity */
                foreach ($batch as $e) {
                    $e->delete(true);
                }
            }
            
            access_show_hidden_entities($entity_disable_override);
            elgg_set_ignore_access($ia);
        }
 
        $entity_disable_override = access_get_show_hidden_status();
        access_show_hidden_entities(true);
        $ia = elgg_set_ignore_access(true);
        
        // Now delete the entity itself
        $this->deleteMetadata();
        $this->deleteOwnedMetadata();
        $this->deleteAnnotations();
        $this->deleteOwnedAnnotations();
        $this->deleteRelationships();
        $this->deleteAccessCollectionMemberships();
        $this->deleteOwnedAccessCollections();
 
        access_show_hidden_entities($entity_disable_override);
        elgg_set_ignore_access($ia);
 
        _elgg_delete_river(array('subject_guid' => $guid));
        _elgg_delete_river(array('object_guid' => $guid));
        _elgg_delete_river(array('target_guid' => $guid));
        remove_all_private_settings($guid);
 
        _elgg_invalidate_cache_for_entity($guid);
        _elgg_invalidate_memcache_for_entity($guid);
 
        $dbprefix = elgg_get_config('dbprefix');
        
        $sql = "
            DELETE FROM {$dbprefix}entities
            WHERE guid = :guid
        ";
        $params = [
            ':guid' => $guid,
        ];
 
        $deleted = $this->getDatabase()->deleteData($sql, $params);
 
        if ($deleted && in_array($this->type, ['object', 'user', 'group', 'site'])) {
            // delete from type-specific subtable
            $sql = "
                DELETE FROM {$dbprefix}{$this->type}s_entity
                WHERE guid = :guid
            ";
            $this->getDatabase()->deleteData($sql, $params);
        }
        
        _elgg_clear_entity_files($this);
 
        return (bool)$deleted;
    }
 
    public function toObject() {
        $object = $this->prepareObject(new \stdClass());
        $params = array('entity' => $this);
        $object = _elgg_services()->hooks->trigger('to:object', 'entity', $params, $object);
        return $object;
    }
 
    protected function prepareObject($object) {
        $object->guid = $this->guid;
        $object->type = $this->getType();
        $object->subtype = $this->getSubtype();
        $object->owner_guid = $this->getOwnerGUID();
        $object->container_guid = $this->getContainerGUID();
        $object->site_guid = (int)$this->site_guid;
        $object->time_created = date('c', $this->getTimeCreated());
        $object->time_updated = date('c', $this->getTimeUpdated());
        $object->url = $this->getURL();
        $object->read_access = (int)$this->access_id;
        return $object;
    }
 
    /*
     * LOCATABLE INTERFACE
     */
 
    public function getLocation() {
        return $this->location;
    }
 
    public function setLocation($location) {
        $this->location = $location;
    }
 
    public function setLatLong($lat, $long) {
        $this->{"geo:lat"} = $lat;
        $this->{"geo:long"} = $long;
    }
 
    public function getLatitude() {
        return (float)$this->{"geo:lat"};
    }
 
    public function getLongitude() {
        return (float)$this->{"geo:long"};
    }
 
    /*
     * EXPORTABLE INTERFACE
     */
 
    public function getExportableValues() {
        elgg_deprecated_notice(__METHOD__ . ' has been deprecated by toObject()', 1.9);
        return array(
            'guid',
            'type',
            'subtype',
            'time_created',
            'time_updated',
            'container_guid',
            'owner_guid',
            'site_guid'
        );
    }
 
    public function export() {
        elgg_deprecated_notice(__METHOD__ . ' has been deprecated', 1.9);
        $tmp = array();
 
        // Generate uuid
        $uuid = guid_to_uuid($this->getGUID());
 
        // Create entity
        $odd = new ODDEntity(
            $uuid,
            $this->attributes['type'],
            get_subtype_from_id($this->attributes['subtype'])
        );
 
        $tmp[] = $odd;
 
        $exportable_values = $this->getExportableValues();
 
        // Now add its attributes
        foreach ($this->attributes as $k => $v) {
            $meta = null;
 
            if (in_array($k, $exportable_values)) {
                switch ($k) {
                    case 'guid':            // Dont use guid in OpenDD
                    case 'type':            // Type and subtype already taken care of
                    case 'subtype':
                        break;
 
                    case 'time_created':    // Created = published
                        $odd->setAttribute('published', date("r", $v));
                        break;
 
                    case 'site_guid':   // Container
                        $k = 'site_uuid';
                        $v = guid_to_uuid($v);
                        $meta = new ODDMetaData($uuid . "attr/$k/", $uuid, $k, $v);
                        break;
 
                    case 'container_guid':  // Container
                        $k = 'container_uuid';
                        $v = guid_to_uuid($v);
                        $meta = new ODDMetaData($uuid . "attr/$k/", $uuid, $k, $v);
                        break;
 
                    case 'owner_guid':          // Convert owner guid to uuid, this will be stored in metadata
                        $k = 'owner_uuid';
                        $v = guid_to_uuid($v);
                        $meta = new ODDMetaData($uuid . "attr/$k/", $uuid, $k, $v);
                        break;
 
                    default:
                        $meta = new ODDMetaData($uuid . "attr/$k/", $uuid, $k, $v);
                }
 
                // set the time of any metadata created
                if ($meta) {
                    $meta->setAttribute('published', date("r", $this->time_created));
                    $tmp[] = $meta;
                }
            }
        }
 
        // Now we do something a bit special.
        /*
         * This provides a rendered view of the entity to foreign sites.
         */
 
        elgg_set_viewtype('default');
        $view = elgg_view_entity($this, array('full_view' => true));
        elgg_set_viewtype();
 
        $tmp[] = new ODDMetaData($uuid . "volatile/renderedentity/", $uuid,
            'renderedentity', $view, 'volatile');
 
        return $tmp;
    }
 
    /*
     * IMPORTABLE INTERFACE
     */
 
    public function import(ODD $data) {
        elgg_deprecated_notice(__METHOD__ . ' has been deprecated', 1.9);
        if (!($data instanceof ODDEntity)) {
            throw new \InvalidParameterException("import() passed an unexpected ODD class");
        }
 
        // Set type and subtype
        $this->attributes['type'] = $data->getAttribute('class');
        $this->attributes['subtype'] = $data->getAttribute('subclass');
 
        // Set owner
        $this->attributes['owner_guid'] = _elgg_services()->session->getLoggedInUserGuid(); // Import as belonging to importer.
 
        // Set time
        $this->attributes['time_created'] = strtotime($data->getAttribute('published'));
        $this->attributes['time_updated'] = $this->getCurrentTime()->getTimestamp();
 
        return true;
    }
 
    /*
     * SYSTEM LOG INTERFACE
     */
 
    public function getSystemLogID() {
        return $this->getGUID();
    }
 
    public function getObjectFromID($id) {
        return get_entity($id);
    }
 
    public function getTags($tag_names = null) {
        if ($tag_names && !is_array($tag_names)) {
            $tag_names = array($tag_names);
        }
 
        $valid_tags = elgg_get_registered_tag_metadata_names();
        $entity_tags = array();
 
        foreach ($valid_tags as $tag_name) {
            if (is_array($tag_names) && !in_array($tag_name, $tag_names)) {
                continue;
            }
 
            if ($tags = $this->$tag_name) {
                // if a single tag, metadata returns a string.
                // if multiple tags, metadata returns an array.
                if (is_array($tags)) {
                    $entity_tags = array_merge($entity_tags, $tags);
                } else {
                    $entity_tags[] = $tags;
                }
            }
        }
 
        return $entity_tags;
    }
    
    public function deleteAccessCollectionMemberships() {
    
        if (!$this->guid) {
            return false;
        }
        
        if ($this->type !== 'user') {
            return true;
        }
        
        $ac = _elgg_services()->accessCollections;
        
        $collections = $ac->getCollectionsByMember($this->guid);
        if (empty($collections)) {
            return true;
        }
        
        $result = true;
        foreach ($collections as $collection) {
            $result = $result & $ac->removeUser($this->guid, $collection->id);
        }
        
        return $result;
    }
    
    public function deleteOwnedAccessCollections() {
        
        if (!$this->guid) {
            return false;
        }
        
        $ac = _elgg_services()->accessCollections;
        
        $collections = $ac->getEntityCollections($this->guid);
        if (empty($collections)) {
            return true;
        }
        
        $result = true;
        foreach ($collections as $collection) {
            $result = $result & $ac->delete($collection->id);
        }
        
        return $result;
    }
 
    public function updateLastAction($posted = null) {
        $posted = _elgg_services()->entityTable->updateLastAction($this, $posted);
        if ($posted) {
            $this->attributes['last_action'] = $posted;
            _elgg_services()->entityCache->set($this);
            $this->storeInPersistedCache(_elgg_get_memcache('new_entity_cache'));
        }
        return $posted;
    }
}