src/Entity/Cvs/AppStoreLink.php line 30

Open in your IDE?
  1. <?php
  3. namespace App\Entity\Cvs;
  5. use Doctrine\ORM\Mapping as ORM;
  7. /**
  8.  * Liens vers les stores (App Store / Google Play) par pays.
  9.  *
  10.  * Affichage :
  11.  *   - Version FR du site → 1 seul lien (countryCode=FR, isPrimary=true)
  12.  *   - Version EN du site → bouton avec dropdown listant tous les pays actifs
  13.  *     (isPrimary=true en haut, puis les autres triés par position)
  14.  *
  15.  * Règle : si une ligne n'existe pas en BDD, le pays ne s'affiche pas.
  16.  *         La table peut être pré-remplie avec ~150 pays (isActive=false par défaut),
  17.  *         puis on active au fur et à mesure que les apps sont publiées.
  18.  *
  19.  * @ORM\Table("cvs_app_store_links", indexes={
  20.  *   @ORM\Index(name="idx_appstore_platform_active", columns={"platform", "is_active"}),
  21.  *   @ORM\Index(name="idx_appstore_country", columns={"country_code"}),
  22.  *   @ORM\Index(name="idx_appstore_position", columns={"position"})
  23.  * },
  24.  * uniqueConstraints={
  25.  *   @ORM\UniqueConstraint(name="uniq_appstore_platform_country", columns={"platform", "country_code"})
  26.  * })
  27.  * @ORM\Entity(repositoryClass="App\Repository\Cvs\AppStoreLinkRepository")
  28.  * @ORM\HasLifecycleCallbacks()
  29.  */
  30. class AppStoreLink
  31. {
  32.     public const PLATFORM_IOS = 'ios';
  33.     public const PLATFORM_ANDROID = 'android';
  35.     /**
  36.      * @ORM\Column(name="id", type="integer")
  37.      * @ORM\Id
  38.      * @ORM\GeneratedValue(strategy="AUTO")
  39.      */
  40.     protected $id;
  42.     /**
  43.      * Plateforme : 'ios' ou 'android'.
  44.      *
  45.      * @ORM\Column(name="platform", type="string", length=16)
  46.      */
  47.     protected $platform;
  49.     /**
  50.      * Code pays ISO 3166-1 alpha-2 (US, FR, GB, DE, ES, IT, CA...).
  51.      *
  52.      * @ORM\Column(name="country_code", type="string", length=2)
  53.      */
  54.     protected $countryCode;
  56.     /**
  57.      * Nom du pays affiché (en anglais par défaut, ex: "United States", "France").
  58.      *
  59.      * @ORM\Column(name="country_label", type="string", length=100)
  60.      */
  61.     protected $countryLabel;
  63.     /**
  64.      * Emoji du drapeau (🇺🇸, 🇫🇷, 🇬🇧...).
  65.      * Optionnel mais sympa pour l'UI.
  66.      *
  67.      * @ORM\Column(name="country_flag", type="string", length=16, nullable=true)
  68.      */
  69.     protected $countryFlag;
  71.     /**
  72.      * URL vers le store du pays.
  73.      * Si null → on n'affiche pas, même si isActive=true.
  74.      *
  75.      * @ORM\Column(name="url", type="string", length=500, nullable=true)
  76.      */
  77.     protected $url;
  79.     /**
  80.      * Si true → le pays est mis en avant (en haut du dropdown, gros bouton sur la version FR).
  81.      *
  82.      * @ORM\Column(name="is_primary", type="boolean", options={"default":false})
  83.      */
  84.     protected $isPrimary = false;
  86.     /**
  87.      * Si true → on affiche ce lien.
  88.      * Permet d'avoir tous les pays en BDD mais d'activer au fur et à mesure.
  89.      *
  90.      * @ORM\Column(name="is_active", type="boolean", options={"default":false})
  91.      */
  92.     protected $isActive = false;
  94.     /**
  95.      * Ordre d'affichage dans le dropdown (croissant).
  96.      *
  97.      * @ORM\Column(name="position", type="integer", options={"default":100})
  98.      */
  99.     protected $position = 100;
  101.     /**
  102.      * @ORM\Column(name="created_at", type="datetime", nullable=true)
  103.      */
  104.     protected $createdAt;
  106.     /**
  107.      * @ORM\Column(name="updated_at", type="datetime", nullable=true)
  108.      */
  109.     protected $updatedAt;
  111.     /**
  112.      * @ORM\PrePersist
  113.      */
  114.     public function onPrePersist(): void
  115.     {
  116.         $now = new \DateTime();
  117.         if (!$this->createdAt) {
  118.             $this->createdAt = $now;
  119.         }
  120.         $this->updatedAt = $now;
  121.     }
  123.     /**
  124.      * @ORM\PreUpdate
  125.      */
  126.     public function onPreUpdate(): void
  127.     {
  128.         $this->updatedAt = new \DateTime();
  129.     }
  131.     public function getId(): ?int { return $this->id; }
  133.     public function getPlatform(): ?string { return $this->platform; }
  134.     public function setPlatform(string $platform): self { $this->platform = $platform; return $this; }
  136.     public function getCountryCode(): ?string { return $this->countryCode; }
  137.     public function setCountryCode(string $code): self { $this->countryCode = strtoupper($code); return $this; }
  139.     public function getCountryLabel(): ?string { return $this->countryLabel; }
  140.     public function setCountryLabel(string $label): self { $this->countryLabel = $label; return $this; }
  142.     public function getCountryFlag(): ?string { return $this->countryFlag; }
  143.     public function setCountryFlag(?string $flag): self { $this->countryFlag = $flag; return $this; }
  145.     public function getUrl(): ?string { return $this->url; }
  146.     public function setUrl(?string $url): self { $this->url = $url; return $this; }
  148.     public function getIsPrimary(): bool { return (bool) $this->isPrimary; }
  149.     public function setIsPrimary(bool $v): self { $this->isPrimary = $v; return $this; }
  151.     public function getIsActive(): bool { return (bool) $this->isActive; }
  152.     public function setIsActive(bool $v): self { $this->isActive = $v; return $this; }
  154.     public function getPosition(): int { return $this->position ?? 100; }
  155.     public function setPosition(int $p): self { $this->position = $p; return $this; }
  157.     public function getCreatedAt(): ?\DateTime { return $this->createdAt; }
  158.     public function setCreatedAt(?\DateTime $d): self { $this->createdAt = $d; return $this; }
  160.     public function getUpdatedAt(): ?\DateTime { return $this->updatedAt; }
  161.     public function setUpdatedAt(?\DateTime $d): self { $this->updatedAt = $d; return $this; }
  163.     /**
  164.      * Helper : un lien est affichable si il est actif ET a une URL.
  165.      */
  166.     public function isDisplayable(): bool
  167.     {
  168.         return $this->getIsActive() && !empty($this->getUrl());
  169.     }
  170. }