core/Access/Capability.php

<?php

/**
 * Matomo - free/libre analytics platform
 *
 * @link    https://matomo.org
 * @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
 */

namespace Piwik\Access;

abstract class Capability
{
    abstract public function getId(): string;
    abstract public function getName(): string;
    abstract public function getCategory(): string;
    abstract public function getDescription(): string;

    /**
     * @return string[]
     */
    abstract public function getIncludedInRoles(): array;

    public function getHelpUrl(): string
    {
        return '';
    }

    public function hasRoleCapability(string $idRole): bool
    {
        return \in_array($idRole, $this->getIncludedInRoles(), true);
    }
}