Metadata.php

Go to the documentation of this file.

<?php

namespace Elgg\Traits\Entity;

trait Metadata {
    
    protected array $temp_metadata = [];
    
    public function getMetadata(string $name): mixed {
        $metadata = $this->getAllMetadata();
        return elgg_extract($name, $metadata);
    }
    
    public function getAllMetadata(): array {
        if (!$this->guid) {
            return array_map(function($values) {
                return count($values) > 1 ? $values : $values[0];
            }, $this->temp_metadata);
        }
        
        $metadata = _elgg_services()->metadataCache->load($this->guid);
        if ($metadata === null) {
            $metadata = elgg_extract($this->guid, _elgg_services()->metadataCache->populateFromEntities($this->guid));
        }
        
        if (empty($metadata)) {
            return [];
        }

        $metadata_values = [];
        foreach ($metadata as $md) {
            $metadata_values[$md->name][] = $md->value;
        }

        return array_map(function($values) {
            return count($values) > 1 ? $values : $values[0];
        }, $metadata_values);
    }
    
    public function setMetadata(string $name, mixed $value, string $value_type = '', bool $multiple = false): bool {
        if ($value === null || $value === '') {
            return $this->deleteMetadata($name);
        }
        
        // 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 = [$value];
        }
        
        // strip null values from array
        $value = array_filter($value, function($var) {
            return !is_null($var);
        });
        
        if (empty($this->guid)) {
            // unsaved entity. store in temp array
            return $this->setTempMetadata($name, $value, $multiple);
        }
        
        // saved entity. persist md to db.
        if (!$multiple) {
            $current_metadata = $this->getMetadata($name);
            
            if ((is_array($current_metadata) || count($value) > 1 || $value === []) && isset($current_metadata)) {
                // remove current metadata if needed
                // need to remove access restrictions right now to delete
                // because this is the expected behavior
                $delete_result = elgg_call(ELGG_IGNORE_ACCESS, function() use ($name) {
                    return elgg_delete_metadata([
                        'guid' => $this->guid,
                        'metadata_name' => $name,
                        'limit' => false,
                    ]);
                });
                
                if ($delete_result === false) {
                    return false;
                }
            }
            
            if (count($value) > 1) {
                // new value is a multiple valued metadata
                $multiple = true;
            }
        }
        
        // create new metadata
        foreach ($value as $value_tmp) {
            $metadata = new \ElggMetadata();
            $metadata->entity_guid = $this->guid;
            $metadata->name = $name;
            $metadata->value = $value_tmp;
            
            if (!empty($value_type)) {
                $metadata->value_type = $value_type;
            }
            
            $md_id = _elgg_services()->metadataTable->create($metadata, $multiple);
            if ($md_id === false) {
                return false;
            }
        }
        
        return true;
    }
    
    protected function setTempMetadata(string $name, mixed $value, bool $multiple = false): bool {
        // if overwrite, delete first
        if (!$multiple) {
            unset($this->temp_metadata[$name]);
            if (count($value)) {
                // only save if value array contains data
                $this->temp_metadata[$name] = $value;
            }
            
            return true;
        }
        
        if (!isset($this->temp_metadata[$name])) {
            $this->temp_metadata[$name] = [];
        }
        
        $this->temp_metadata[$name] = array_merge($this->temp_metadata[$name], $value);
        
        return true;
    }
    
    public function deleteMetadata(string $name = null): bool {
        if (!$this->guid) {
            // remove from temp_metadata
            if (isset($name)) {
                if (isset($this->temp_metadata[$name])) {
                    unset($this->temp_metadata[$name]);
                }
            } else {
                $this->temp_metadata = [];
            }
            
            return true;
        }
        
        return elgg_delete_metadata([
            'guid' => $this->guid,
            'limit' => false,
            'metadata_name' => $name,
        ]);
    }
}