Tool.php

Go to the documentation of this file.

<?php
 
namespace Elgg\Groups;
 
use Elgg\Collections\CollectionItemInterface;
 
class Tool implements CollectionItemInterface {
 
    protected array $options;
 
    public function __construct(public string $name, array $options = []) {
        $defaults = [
            'label' => null,
            'default_on' => true,
            'priority' => 500,
        ];
 
        $this->options = array_merge($defaults, $options);
    }
 
    public function __get($name) {
        switch ($name) {
            case 'label':
                return $this->getLabel();
 
            case 'default_on':
                return $this->isEnabledByDefault();
        }
 
        return elgg_extract($name, $this->options);
    }
 
    public function __set($name, $value) {
        $this->options[$name] = $value;
    }
 
    public function getID() {
        return $this->name;
    }
 
    public function getPriority() {
        return $this->priority;
    }
 
    public function getLabel(): string {
        $label = elgg_extract('label', $this->options);
        if (isset($label)) {
            return $label;
        }
 
        return elgg_echo("groups:tool:{$this->name}");
    }
 
    public function getDescription(): ?string {
        $lan_key = "groups:tool:{$this->name}:description";
        if (!elgg_language_key_exists($lan_key)) {
            return null;
        }
        
        return elgg_echo($lan_key);
    }
 
    public function isEnabledByDefault(): bool {
        $default_on = elgg_extract('default_on', $this->options, true);
 
        if ($default_on === true || $default_on === 'yes') {
            return true;
        }
 
        return false;
    }
 
    public function mapMetadataName(): string {
        return "{$this->name}_enable";
    }
 
    public function mapMetadataValue($value = null): string {
        if (!isset($value)) {
            $value = $this->default_on;
        }
 
        if ($value === 'yes' || $value === true) {
            return 'yes';
        }
 
        return 'no';
    }
}