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. }