vendor/terminal42/contao-changelanguage/src/Helper/AlternateLinks.php line 41

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. namespace Terminal42\ChangeLanguage\Helper;
  7. use Contao\Environment;
  8. use Contao\FrontendTemplate;
  9. use Terminal42\ChangeLanguage\Language;
  10. use Terminal42\ChangeLanguage\Navigation\NavigationItem;
  11. use Terminal42\ChangeLanguage\Navigation\UrlParameterBag;
  13. /**
  14.  * AlternateLinks is a helper class to handle <link rel="alternate"> in the page header.
  15.  */
  16. class AlternateLinks
  17. {
  18.     private array $links = [];
  20.     /**
  21.      * Returns whether a link already exists for a language.
  22.      */
  23.     public function has(string $language): bool
  24.     {
  25.         return \array_key_exists(Language::toLanguageTag($language), $this->links);
  26.     }
  28.     /**
  29.      * Adds or replaces a link for a language.
  30.      */
  31.     public function add(string $language, string $href, string $title = ''): void
  32.     {
  33.         $language = Language::toLanguageTag($language);
  35.         $this->store($language, $href, $title);
  36.     }
  38.     /**
  39.      * Adds a link from a NavigationItem instance.
  40.      */
  41.     public function addFromNavigationItem(NavigationItem $item, UrlParameterBag $urlParameterBag): void
  42.     {
  43.         $this->add($item->getLanguageTag(), $item->getHref($urlParameterBag), $item->getTitle());
  44.     }
  46.     /**
  47.      * Removes link for a language if it exists.
  48.      */
  49.     public function remove(string $language): void
  50.     {
  51.         unset($this->links[Language::toLanguageTag($language)]);
  52.     }
  54.     /**
  55.      * Sets link for the x-default language.
  56.      */
  57.     public function setDefault(string $href, string $title = ''): void
  58.     {
  59.         $this->store('x-default', $href, $title);
  60.     }
  62.     /**
  63.      * Generates template markup of links for the page header.
  64.      */
  65.     public function generate(string $templateName = 'block_alternate_links'): string
  66.     {
  67.         if (0 === \count($this->links)) {
  68.             return '';
  69.         }
  71.         $template = new FrontendTemplate($templateName);
  73.         $template->links = $this->links;
  75.         return $template->parse();
  76.     }
  78.     private function store(string $language, string $href, string $title): void
  79.     {
  80.         // URLs must always be absolute
  81.         if (0 !== strpos($href, 'http://') && 0 !== strpos($href, 'https://')) {
  82.             $href = Environment::get('base').$href;
  83.         }
  85.         $this->links[$language] = ['language' => $language, 'href' => $href, 'title' => $title];
  86.     }
  87. }