ElggAnnotation.php

Go to the documentation of this file.

<?php

use Elgg\Database\EntityTable\UserFetchFailureException;

class ElggAnnotation extends \ElggExtender {

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

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

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

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

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

    public function save() {
        if ($this->id > 0) {
            return update_annotation($this->id, $this->name, $this->value, $this->value_type,
                $this->owner_guid, $this->access_id);
        } else {
            $this->id = create_annotation($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() {
        $result = _elgg_delete_metastring_based_object_by_id($this->id, 'annotation');
        if ($result) {
            _elgg_delete_river(array('annotation_id' => $this->id));
        }

        return $result;
    }

    public function disable() {
        return _elgg_set_metastring_based_object_enabled_by_id($this->id, 'no', 'annotations');
    }

    public function enable() {
        return _elgg_set_metastring_based_object_enabled_by_id($this->id, 'yes', 'annotations');
    }

    public function canEdit($user_guid = 0) {
        $entity = $this->getEntity();
        return _elgg_services()->userCapabilities->canEditAnnotation($entity, $user_guid, $this);
    }

    // SYSTEM LOG INTERFACE

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