*/ protected array $_defaultConfig = [ 'activeClass' => 'active', ]; /** * List of helpers used by this helper * * @var string[] */ protected array $helpers = [ 'Html', 'Url', ]; /** * @param array|string $title * @param array|string|null $url * @param array $options * * @return string */ public function link(array|string $title, array|string|null $url = null, array $options = []): string { $currentUrl = Router::parseRequest($this->getView()->getRequest()); if (!array_key_exists('target', $options) || !$currentUrl) { return $this->Html->link($title, $url, $options); } $target = $options['target']; unset($options['target']); if (is_string($target)) { return $this->_linkFromStringTarget($currentUrl, $target, $title, $url, $options); } if (!is_array($target)) { return $this->Html->link($title, $url, $options); } if (!array_key_exists('plugin', $currentUrl)) { $currentUrl['plugin'] = false; } if (!array_key_exists('prefix', $currentUrl)) { $currentUrl['prefix'] = false; } if (isset($target['or']) && $target['or']) { foreach ($target['or'] as $singleTargetToMatch) { if ($this->_matchesUrlFromArrayTarget($currentUrl, $singleTargetToMatch)) { $options['class'] = $this->_addClass($options); return $this->Html->link($title, $url, $options); } } return $this->Html->link($title, $url, $options); } if (!$this->_matchesUrlFromArrayTarget($currentUrl, $target)) { return $this->Html->link($title, $url, $options); } $options['class'] = $this->_addClass($options); return $this->Html->link($title, $url, $options); } /** * @param array $providedOptions * * @return string */ protected function _addClass(array $providedOptions): string { $activeClass = array_key_exists('activeClass', $providedOptions) ? $providedOptions['activeClass'] : $this->getConfig('activeClass'); return array_key_exists('class', $providedOptions) ? $providedOptions['class'] . ' ' . $activeClass : $activeClass; } protected function _linkFromStringTarget(array $current, string $targetString, string $title, array|string|null $url, array $options) { if (Router::normalize($current) == Router::normalize($targetString)) { $options['class'] = $this->_addClass($options); return $this->Html->link($title, $url, $options); } return $this->Html->link($title, $url, $options); } protected function _matchesUrlFromArrayTarget(array $current, array $targetUrl) { foreach ($targetUrl as $targetKey => $targetValue) { if (is_array($targetValue)) { if (!in_array($current[$targetKey], $targetValue)) { return false; } continue; } if (!array_key_exists($targetKey, $current) || $targetValue != $current[$targetKey]) { return false; } } return true; } }