ElggGroup.php

Go to the documentation of this file.

<?php
 
use Elgg\Groups\Tool;
use Elgg\Traits\Entity\PluginSettings;
 
class ElggGroup extends \ElggEntity {
 
    const CONTENT_ACCESS_MODE_UNRESTRICTED = 'unrestricted';
    const CONTENT_ACCESS_MODE_MEMBERS_ONLY = 'members_only';
 
    const MEMBERSHIP_CLOSED = 0;
    const MEMBERSHIP_INVITE_ONLY = 1;
    const MEMBERSHIP_PUBLIC = 2;
    
    use PluginSettings;
    
    protected function initializeAttributes() {
        parent::initializeAttributes();
        
        $this->attributes['type'] = 'group';
        $this->attributes['subtype'] = 'group';
        $this->attributes['access_id'] = ACCESS_PUBLIC;
    }
 
    public function getMembers(array $options = []) {
        $options['relationship'] = 'member';
        $options['relationship_guid'] = $this->getGUID();
        $options['inverse_relationship'] = true;
        $options['type'] = 'user';
 
        return elgg_get_entities($options);
    }
 
    public function isPublicMembership(): bool {
        return ($this->membership === self::MEMBERSHIP_PUBLIC);
    }
    
    public function isInviteOnlyMembership(): bool {
        return ($this->membership === self::MEMBERSHIP_INVITE_ONLY);
    }
 
    public function getContentAccessMode(): string {
        $mode = $this->content_access_mode;
 
        if (!isset($mode)) {
            if ($this->isPublicMembership()) {
                $mode = self::CONTENT_ACCESS_MODE_UNRESTRICTED;
            } else {
                $mode = self::CONTENT_ACCESS_MODE_MEMBERS_ONLY;
            }
        }
 
        // only support two modes for now
        if ($mode === self::CONTENT_ACCESS_MODE_MEMBERS_ONLY) {
            return $mode;
        }
        
        return self::CONTENT_ACCESS_MODE_UNRESTRICTED;
    }
 
    public function setContentAccessMode(string $mode): void {
        if (!$mode && $this->content_access_mode) {
            return;
        }
 
        // only support two modes for now
        if ($mode !== self::CONTENT_ACCESS_MODE_MEMBERS_ONLY) {
            $mode = self::CONTENT_ACCESS_MODE_UNRESTRICTED;
        }
 
        $this->content_access_mode = $mode;
    }
 
    public function isMember(?\ElggUser $user = null): bool {
        if ($user === null) {
            $user = _elgg_services()->session_manager->getLoggedInUser();
        }
        
        if (!$user instanceof \ElggUser) {
            return false;
        }
 
        return $user->hasRelationship($this->guid, 'member');
    }
 
    public function join(\ElggUser $user, array $params = []): bool {
        if (!$user->addRelationship($this->guid, 'member')) {
            return false;
        }
        
        $params['group'] = $this;
        $params['user'] = $user;
        
        _elgg_services()->events->trigger('join', 'group', $params);
        
        return true;
    }
 
    public function leave(\ElggUser $user): bool {
        // event needs to be triggered while user is still member of group to have access to group acl
        $params = [
            'group' => $this,
            'user' => $user,
        ];
        _elgg_services()->events->trigger('leave', 'group', $params);
 
        return $user->removeRelationship($this->guid, 'member');
    }
 
    protected function prepareObject(\Elgg\Export\Entity $object) {
        $object = parent::prepareObject($object);
        $object->name = $this->getDisplayName();
        $object->description = $this->description;
        unset($object->read_access);
        return $object;
    }
    
    public function isToolEnabled(string $name): bool {
        if (empty($name)) {
            return false;
        }
 
        $tool = $this->getTool($name);
        if (!$tool instanceof Tool) {
            return false;
        }
 
        $md_name = $tool->mapMetadataName();
        $setting = $this->$md_name;
 
        if (!isset($setting)) {
            return $tool->isEnabledByDefault();
        }
 
        return $setting == 'yes';
    }
 
    public function enableTool(string $name): bool {
        $tool = $this->getTool($name);
        if (!$tool instanceof Tool) {
            return false;
        }
 
        $md_name = $tool->mapMetadataName();
        $md_value = $tool->mapMetadataValue('yes');
 
        $this->$md_name = $md_value;
 
        return true;
    }
    
    public function disableTool(string $name): bool {
        $tool = $this->getTool($name);
        if (!$tool instanceof Tool) {
            return false;
        }
 
        $md_name = $tool->mapMetadataName();
        $md_value = $tool->mapMetadataValue('no');
 
        $this->$md_name = $md_value;
 
        return true;
    }
 
    protected function getTool(string $name): ?Tool {
        return _elgg_services()->group_tools->group($this)->get($name);
    }
 
    public function canAccessContent(?\ElggUser $user = null): bool {
        if (!isset($user)) {
            $user = _elgg_services()->session_manager->getLoggedInUser();
        }
 
        if ($this->getContentAccessMode() == self::CONTENT_ACCESS_MODE_MEMBERS_ONLY) {
            if (!$user) {
                return false;
            }
 
            return $this->isMember($user) || $user->isAdmin();
        }
 
        return true;
    }
}