vendor/easycorp/easyadmin-bundle/src/Config/Dashboard.php line 73

  1. <?php
  3. namespace EasyCorp\Bundle\EasyAdminBundle\Config;
  5. use EasyCorp\Bundle\EasyAdminBundle\Config\Option\TextDirection;
  6. use EasyCorp\Bundle\EasyAdminBundle\Dto\DashboardDto;
  8. /**
  9.  * @author Javier Eguiluz <javier.eguiluz@gmail.com>
  10.  */
  11. final class Dashboard
  12. {
  13.     private DashboardDto $dto;
  15.     private function __construct(DashboardDto $dashboardDto)
  16.     {
  17.         $this->dto = $dashboardDto;
  18.     }
  20.     public static function new(): self
  21.     {
  22.         $dto = new DashboardDto();
  24.         return new self($dto);
  25.     }
  27.     public function setFaviconPath(string $path): self
  28.     {
  29.         $this->dto->setFaviconPath($path);
  31.         return $this;
  32.     }
  34.     public function setTitle(string $title): self
  35.     {
  36.         $this->dto->setTitle($title);
  38.         return $this;
  39.     }
  41.     public function setTranslationDomain(string $translationDomain): self
  42.     {
  43.         $this->dto->setTranslationDomain($translationDomain);
  45.         return $this;
  46.     }
  48.     public function setTextDirection(string $direction): self
  49.     {
  50.         if (!\in_array($direction, [TextDirection::LTR, TextDirection::RTL], true)) {
  51.             throw new \InvalidArgumentException(sprintf('The "%s" value given to the textDirection option is not valid. It can only be "%s" or "%s"', $direction, TextDirection::LTR, TextDirection::RTL));
  52.         }
  54.         $this->dto->setTextDirection($direction);
  56.         return $this;
  57.     }
  59.     public function renderContentMaximized(bool $maximized = true): self
  60.     {
  61.         $this->dto->setContentWidth($maximized ? Crud::LAYOUT_CONTENT_FULL : Crud::LAYOUT_CONTENT_DEFAULT);
  63.         return $this;
  64.     }
  66.     public function renderSidebarMinimized(bool $minimized = true): self
  67.     {
  68.         $this->dto->setSidebarWidth($minimized ? Crud::LAYOUT_SIDEBAR_COMPACT : Crud::LAYOUT_SIDEBAR_DEFAULT);
  70.         return $this;
  71.     }
  73.     public function disableUrlSignatures(bool $disableSignatures = true): self
  74.     {
  75.         trigger_deprecation(
  76.             'easycorp/easyadmin-bundle',
  77.             '4.1.0',
  78.             'EasyAdmin URLs no longer include signatures because they don\'t provide any additional security. You can stop calling the "%s" method to disable them. This method will be removed in future EasyAdmin versions.',
  79.             __METHOD__,
  80.         );
  82.         $this->dto->setSignedUrls(!$disableSignatures);
  84.         return $this;
  85.     }
  87.     public function generateRelativeUrls(bool $relativeUrls = true): self
  88.     {
  89.         $this->dto->setAbsoluteUrls(!$relativeUrls);
  91.         return $this;
  92.     }
  94.     public function disableDarkMode(bool $disableDarkMode = true): self
  95.     {
  96.         $this->dto->setEnableDarkMode(!$disableDarkMode);
  98.         return $this;
  99.     }
  101.     public function setLocales(array $locales): self
  102.     {
  103.         $localeDtos = [];
  104.         foreach ($locales as $key => $value) {
  105.             $locale = match (true) {
  106.                 $value instanceof Locale => $value,
  107.                 \is_string($key) => Locale::new($key, (string) $value),
  108.                 default => Locale::new((string) $value),
  109.             };
  111.             $localeDtos[] = $locale->getAsDto();
  112.         }
  114.         $this->dto->setLocales($localeDtos);
  116.         return $this;
  117.     }
  119.     public function getAsDto(): DashboardDto
  120.     {
  121.         return $this->dto;
  122.     }
  123. }