Ubuntu

contains($cacheId)) { $capabilities = []; /** * Triggered to add new capabilities. * * **Example** * * public function addCapabilities(&$capabilities) * { * $capabilities[] = new MyNewCapability(); * } * * @param Capability[] $reports An array of reports * @internal */ Piwik::postEvent('Access.Capability.addCapabilities', array(&$capabilities)); /** * Triggered to filter / restrict capabilities. * * **Example** * * public function filterCapabilities(&$capabilities) * { * foreach ($capabilities as $index => $capability) { * if ($capability->getId() === 'tagmanager_write') {} * unset($capabilities[$index]); // remove the given capability * } * } * } * * @param Capability[] $reports An array of reports * @internal */ Piwik::postEvent('Access.Capability.filterCapabilities', array(&$capabilities)); $capabilities = \array_values($capabilities); $this->checkCapabilityIds($capabilities); $cache->save($cacheId, $capabilities); return $capabilities; } return $cache->fetch($cacheId); } /** * @param $capabilityId * @return Capability|null * @throws Exception */ public function getCapability(string $capabilityId): ?Capability { foreach ($this->getAllCapabilities() as $capability) { if ($capabilityId === $capability->getId()) { return $capability; } } return null; } /** * @return string[] * @throws Exception */ public function getAllCapabilityIds(): array { $ids = array(); foreach ($this->getAllCapabilities() as $capability) { $ids[] = $capability->getId(); } return $ids; } /** * @param $capabilityId * @return bool * @throws Exception */ public function isValidCapability($capabilityId): bool { $capabilities = $this->getAllCapabilityIds(); return \in_array($capabilityId, $capabilities, true); } /** * @param $capabilityId * @throws Exception */ public function checkValidCapability($capabilityId): void { if (!$this->isValidCapability($capabilityId)) { $capabilities = $this->getAllCapabilityIds(); throw new \Exception(Piwik::translate("UsersManager_ExceptionAccessValues", implode(", ", $capabilities))); } } /** * @param Capability[] $capabilities * @throws Exception */ private function checkCapabilityIds(array $capabilities): void { foreach ($capabilities as $capability) { $id = $capability->getId(); if (preg_match('/[^a-zA-Z0-9_-]/', $id)) { throw new \Exception("Capability with invalid ID found: '$id'. Valid characters are 'a-zA-Z0-9_-'."); } } } }