ElggMetadata.php

Go to the documentation of this file.

<?php

class ElggMetadata extends ElggExtender {

    protected function initializeAttributes() {
        parent::initializeAttributes();

        $this->attributes['type'] = "metadata";
    }

    public function __construct($row = null) {
        $this->initializeAttributes();

        if (!empty($row)) {
            // Create from db row
            if ($row instanceof stdClass) {
                $metadata = $row;

                $objarray = (array) $metadata;
                foreach ($objarray as $key => $value) {
                    $this->attributes[$key] = $value;
                }
            } else {
                // get an ElggMetadata object and copy its attributes
                elgg_deprecated_notice('Passing an ID to constructor is deprecated. Use elgg_get_metadata_from_id()', 1.9);
                $metadata = elgg_get_metadata_from_id($row);
                $this->attributes = $metadata->attributes;
            }
        }
    }

    public function canEdit($user_guid = 0) {
        if ($entity = get_entity($this->entity_guid)) {
            return $entity->canEditMetadata($this, $user_guid);
        }
        return false;
    }

    public function save() {
        if ($this->id > 0) {
            return update_metadata($this->id, $this->name, $this->value,
                $this->value_type, $this->owner_guid, $this->access_id);
        } else {
            $this->id = create_metadata($this->entity_guid, $this->name, $this->value,
                $this->value_type, $this->owner_guid, $this->access_id);

            if (!$this->id) {
                throw new IOException("Unable to save new " . get_class());
            }
            return $this->id;
        }
    }

    public function delete() {
        $success = _elgg_delete_metastring_based_object_by_id($this->id, 'metadata');
        if ($success) {
            // we mark unknown here because this deletes only one value
            // under this name, and there may be others remaining.
            _elgg_get_metadata_cache()->markUnknown($this->entity_guid, $this->name);
        }
        return $success;
    }

    public function disable() {
        $success = _elgg_set_metastring_based_object_enabled_by_id($this->id, 'no', 'metadata');
        if ($success) {
            // we mark unknown here because this disables only one value
            // under this name, and there may be others remaining.
            _elgg_get_metadata_cache()->markUnknown($this->entity_guid, $this->name);
        }
        return $success;
    }

    public function enable() {
        $success = _elgg_set_metastring_based_object_enabled_by_id($this->id, 'yes', 'metadata');
        if ($success) {
            _elgg_get_metadata_cache()->markUnknown($this->entity_guid, $this->name);
        }
        return $success;
    }

    // SYSTEM LOG INTERFACE ////////////////////////////////////////////////////////////

    public function getObjectFromID($id) {
        return elgg_get_metadata_from_id($id);
    }
}