1. <?php
2. namespace App\Entity;
4. use Doctrine\ORM\Mapping as ORM,
5.     Doctrine\DBAL\Types\Types,
6.     Doctrine\Common\Collections\Collection,
7.     Doctrine\Common\Collections\ArrayCollection;
9. use Gedmo\Sluggable\Util\Urlizer;
10. use Symfony\Component\Serializer\Annotation\Groups,
11.     Symfony\Component\Validator\Constraints as Assert;
13. use ApiPlatform\Metadata\ApiResource,
14.     ApiPlatform\Metadata\ApiProperty,
15.     ApiPlatform\Metadata\Get,
16.     ApiPlatform\Metadata\GetCollection,
17.     ApiPlatform\Metadata\Post,
18.     ApiPlatform\Metadata\Put,
19.     ApiPlatform\Metadata\Delete,
20.     ApiPlatform\Metadata\ApiFilter,
21.     ApiPlatform\Doctrine\Orm\Filter\SearchFilter,
22.     ApiPlatform\Doctrine\Orm\Filter\OrderFilter,
23.     ApiPlatform\Doctrine\Orm\Filter\BooleanFilter;
25. use App\Entity\Trait\IdTrait,
26.     App\Entity\Trait\UuidTrait,
27.     App\Entity\Trait\OrdStatTrait,
28.     App\Entity\Trait\TimestampableTrait,
29.     App\Entity\Trait\TranslatableTrait,
30.     App\Entity\Trait\Languages\LanguageableChildTrait,
31.     App\Entity\Trait\ArchivedTrait,
32.     App\Entity\Trait\EditorialGroupableTrait,
33.     App\Entity\Trait\ImportIdTrait,
34.     App\Entity\Interface\TranslatableInterface,
35.     App\Entity\Interface\OrdStatableInterface,
36.     App\Entity\Interface\LanguageableChildInterface,
37.     App\Entity\Interface\ArchivableInterface,
38.     App\Entity\Interface\EditorialGroupableInterface,
39.     App\Entity\Interface\CloneableInterface;
41. use App\Enum\JournalLicence,
42.     App\Enum\JournalDateFormat,
43.     App\Enum\AuthorProperty,
44.     App\Enum\JournalIssueState,
45.     App\Doctrine\DBAL\Types\AuthorPropertiesType,
46.     App\Repository\JournalIssueRepository,
47.     App\Lib\Actions,
48.     App\DTO\CloneDTO,
49.     App\Security\Voter\ArchivableVoter,
50.     App\StateProcessor\CloneProcessor,
51.     App\Security\Voter\CloneVoter;
53. use App\Util\ClassUtils,
54.     App\Filter\IriFilter;
56. use App\Controller\Export\JournalIssue\JournalIssueCrossrefExporter,
57.     App\Controller\Export\JournalIssue\JournalIssueArticlesCrossrefExporter,
58.     App\Controller\Export\JournalIssue\JournalIssueSimcheckCrossrefExporter,
59.     App\Controller\Export\JournalIssue\JournalIssueFundingCrossrefExporter,
60.     App\Controller\Export\JournalIssue\JournalIssueLicenceFulltextCrossrefExporter,
61.     App\Controller\Export\JournalIssue\JournalIssueArticlesCopernicusExporter,
62.     App\Controller\Export\JournalIssue\JournalIssueArticlesPubMedExporter;
64. use App\Enum\Language;
65. use App\StateProcessor\JournalIssueProcessor;
66. use App\Util\RomanNumber;
67. use Symfony\Component\Serializer\Annotation\MaxDepth;
69. #[ApiResource(
70.     description: 'Journal issues',
71.     normalizationContext: ['groups' => [
72.         'read',
73.         'read:' . self::class,
74.         'read:' . self::class . 'Translation'
75.     ]],
76.     denormalizationContext: ['groups' => ['write']],
77.     security: 'is_granted("' . Journal::class . '")',
78.     order: ['ord' => 'desc'],
79.     operations: [
80.         new GetCollection(),
81.         new Post(
82.             uriTemplate: '/journal_issues/clone',
83.             input: CloneDTO::class,
84.             processor: CloneProcessor::class,
85.             security: 'is_granted("' . Actions::CLONE .'")',
86.             securityMessage: CloneVoter::MESSAGE
87.         ),
88.         new Post(
89.             processor: JournalIssueProcessor::class,
90.             denormalizationContext: ['groups' => ['write',  'post']],
91.         ),
92.         new Get(),
93.         new Get(
94.             name: 'get_journal_issue_crossref',
95.             uriTemplate: '/journal_issues/{uuid}/export/crossref',
96.             controller: JournalIssueCrossrefExporter::class
97.         ),
98.         new Get(
99.             name: 'get_journal_issue_articles_crossref',
100.             uriTemplate: '/journal_issues/{uuid}/articles/export/crossref',
101.             controller: JournalIssueArticlesCrossrefExporter::class
102.         ),
103.         new Get(
104.             name: 'get_journal_issue_articles_copernicus',
105.             uriTemplate: '/journal_issues/{uuid}/articles/export/copernicus',
106.             controller: JournalIssueArticlesCopernicusExporter::class
107.         ),
108.         new Get(
109.             name: 'get_journal_issue_articles_pubmed',
110.             uriTemplate: '/journal_issues/{uuid}/articles/export/pubmed',
111.             controller: JournalIssueArticlesPubMedExporter::class
112.         ),
113.         new Get(
114.             name: 'get_journal_issue_simcheck_crossref',
115.             uriTemplate: '/journal_issues/{uuid}/export/simcheck_crossref',
116.             controller: JournalIssueSimcheckCrossrefExporter::class
117.         ),
118.         new Get(
119.             name: 'get_journal_issue_funding_crossref',
120.             uriTemplate: '/journal_issues/{uuid}/export/funding_crossref',
121.             controller: JournalIssueFundingCrossrefExporter::class
122.         ),
123.         new Get(
124.             name: 'get_journal_issue_licence_fulltext_crossref',
125.             uriTemplate: '/journal_issues/{uuid}/export/licence_fulltext_crossref',
126.             controller: JournalIssueLicenceFulltextCrossrefExporter::class
127.         ),
128.         new Put(
129.             processor: JournalIssueProcessor::class,
130.         ),
131.         new Delete(
132.             processor: JournalIssueProcessor::class,
133.             securityPostDenormalize: 'is_granted("' . Actions::DELETE . '", object)',
134.             securityPostDenormalizeMessage: ArchivableVoter::MESSAGE
135.         ),
136.     ],
137.     extraProperties: ['standard_put' => false],
138. )]
139. #[ApiFilter(SearchFilter::class, properties: [
140.     'translations.title' => 'partial',
141. ])]
142. #[ApiFilter(IriFilter::class, properties: ['parent', 'volume'])]
143. #[ApiFilter(BooleanFilter::class, properties: ['isArchived', 'stat'])]
144. #[ApiFilter(OrderFilter::class, properties: ['ord'])]
145. #[ORM\Entity(repositoryClass: JournalIssueRepository::class)]
146. class JournalIssue implements
147.     TranslatableInterface,
148.     OrdStatableInterface,
149.     LanguageableChildInterface,
150.     EditorialGroupableInterface,
151.     ArchivableInterface,
152.     CloneableInterface
153. {
154.     use IdTrait,
155.         UuidTrait,
156.         OrdStatTrait,
157.         TimestampableTrait,
158.         TranslatableTrait,
159.         LanguageableChildTrait,
160.         ArchivedTrait,
161.         EditorialGroupableTrait,
162.         ImportIdTrait;
164.     #[ApiProperty(description: 'Parent', writableLink: false)]
165.     #[Groups(['read', 'post'])]
166.     #[MaxDepth(1)]
167.     #[ORM\ManyToOne(targetEntity: Journal::class, inversedBy: 'issues')]
168.     #[ORM\JoinColumn(onDelete: 'cascade', nullable: false)]
169.     private Journal $parent;
171.     private bool $isNotifiable = false;
173.     #[ApiProperty(description: 'Volume', writableLink: false)]
174.     #[Groups(['read', 'write'])]
175.     #[MaxDepth(1)]
176.     #[Assert\Expression(
177.         expression: '!value || value.getParent() === this.getParent()',
178.         message: 'Cannot assign volume from the outside of current journal.'
179.     )]
180.     #[ORM\ManyToOne(targetEntity: JournalVolume::class, inversedBy: 'issues')]
181.     #[ORM\JoinColumn(onDelete: 'cascade', nullable: false)]
182.     private JournalVolume $volume;
184.     #[ApiProperty(description: 'Is archived')]
185.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class, 'read:list', 'write'])]
186.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
187.     protected bool $isArchived = false;
189.     #[ApiProperty(description: 'Planned articles amount')]
190.     #[Groups(['read:' . self::class, 'write'])]
191.     #[Assert\Positive]
192.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 1])]
193.     private int $plannedArticlesAmount = 1;
195.     #[ApiProperty(description: 'Is new')]
196.     #[Groups(['read:' . self::class, 'write'])]
197.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => true])]
198.     private bool $isNew = true;
200.     #[ApiProperty(description: 'Is newest issue')]
201.     #[Groups(['read:' . self::class, 'write'])]
202.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => true])]
203.     private bool $isNewestIssue = true;
205.     #[ApiProperty(description: 'Is first view')]
206.     #[Groups(['read:' . self::class, 'write'])]
207.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
208.     private bool $isFirstView = false;
210.     #[ApiProperty(description: 'State', writableLink: false)]
211.     #[Groups(['read:' . self::class, 'write'])]
212.     #[ORM\Column(
213.         type: Types::STRING,
214.         enumType: JournalIssueState::class,
215.         length: 255,
216.         options: ['default' => JournalIssueState::LIST]
217.     )]
218.     private JournalIssueState $state = JournalIssueState::LIST;
220.     #[ApiProperty(description: 'Is continous accession')]
221.     #[Groups(['read:' . self::class, 'write'])]
222.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
223.     private bool $isContinousAccession = false;
225.     #[ApiProperty(description: 'Number in year')]
226.     #[Groups(['read:' . self::class, 'write'])]
227.     #[Assert\Positive]
228.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 1])]
229.     private int $numberInYear = 1;
231.     #[ApiProperty(description: 'Is special issue')]
232.     #[Groups(['read:' . self::class, 'write'])]
233.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
234.     private bool $isSpecialIssue = false;
236.     #[ApiProperty(description: 'Is crossmark button visible')]
237.     #[Groups(['read:' . self::class, 'write'])]
238.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
239.     private bool $isCrossmarkButtonVisible = false;
241.     #[ApiProperty(description: 'Is open')]
242.     #[Groups(['read:' . self::class, 'write'])]
243.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => true])]
244.     private bool $isOpen = true;
246.     #[ApiProperty(description: 'Price')]
247.     #[Groups(['read:' . self::class])]
248.     #[Assert\PositiveOrZero]
249.     #[ORM\Column(type: Types::INTEGER, nullable: true)]
250.     private ?int $price = null;
252.     #[ApiProperty(description: 'Grace date')]
253.     #[Groups(['read:' . self::class, 'write'])]
254.     #[ORM\Column(type: Types::DATE_IMMUTABLE, nullable: true)]
255.     private ?\DateTimeImmutable $graceDate = null;
257.     #[ApiProperty(description: 'Is open access granted after newest issue expired')]
258.     #[Groups(['read:' . self::class, 'write'])]
259.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
260.     private bool $isOpenAccessGrantedAfterNewestIssueExpired = false;
262.     #[ApiProperty(description: 'Published at')]
263.     #[Groups(['read:' . self::class, 'write'])]
264.     #[ORM\Column(type: Types::DATE_IMMUTABLE, nullable: true)]
265.     private ?\DateTimeImmutable $publishedAt = null;
267.     #[ApiProperty(description: 'Published at format', writableLink: false)]
268.     #[Groups(['read:' . self::class, 'write'])]
269.     #[ORM\Column(
270.         type: Types::STRING,
271.         enumType: JournalDateFormat::class,
272.         length: 255,
273.         options: ['default' => JournalDateFormat::COMPLETE]
274.     )]
275.     private JournalDateFormat $publishedAtFormat = JournalDateFormat::COMPLETE;
277.     #[ApiProperty(description: 'DOI')]
278.     #[Groups(['read:' . self::class, 'write'])]
279.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
280.     private ?string $doi = null;
282.     #[ApiProperty(description: 'Licence', writableLink: false)]
283.     #[Groups(['read:' . self::class, 'write'])]
284.     #[ORM\Column(
285.         type: Types::STRING,
286.         enumType: JournalLicence::class,
287.         length: 255,
288.         options: ['default' => JournalLicence::CC_BY]
289.     )]
290.     private JournalLicence $licence = JournalLicence::CC_BY;
292.     #[ApiProperty(description: 'Suggested citation type', writableLink: false)]
293.     #[Groups(['read:' . Journal::class, 'write'])]
294.     #[ORM\ManyToOne(targetEntity: CitationType::class)]
295.     #[ORM\JoinColumn(onDelete: 'set null')]
296.     private ?CitationType $suggestedCitationType = null;
298.     #[ApiProperty(description: 'Funding number')]
299.     #[Groups(['read:' . self::class, 'write'])]
300.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
301.     private ?string $fundingNumber = null;
303.     #[ApiProperty(description: 'Meta link')]
304.     #[Groups(['read:' . self::class, 'write'])]
305.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
306.     private ?string $metaLink = null;
308.     #[ApiProperty(description: 'Visible editorial group member properties', writableLink: false)]
309.     #[Groups(['read:' . self::class, 'write'])]
310.     #[Assert\Choice(callback: [AuthorProperty::class, 'cases'], multiple: true)]
311.     #[Assert\Unique]
312.     #[Assert\Count(min: 1)]
313.     #[ORM\Column(type: AuthorPropertiesType::NAME)]
314.     private array $visibleEditorialGroupMemberProperties = [
315.         AuthorProperty::PREFIX,
316.         AuthorProperty::NAME,
317.         AuthorProperty::SURNAME,
318.         AuthorProperty::AFFILIATION
319.     ];
321.     #[ApiProperty(description: 'Files')]
322.     #[ORM\OneToMany(targetEntity: JournalIssueFile::class, mappedBy: 'parent', cascade: ['persist'])]
323.     #[ORM\OrderBy(['ord' => 'desc'])]
324.     private Collection $files;
326.     #[ApiProperty(description: 'Sponsors')]
327.     #[ORM\OneToMany(targetEntity: JournalIssueSponsor::class, mappedBy: 'parent', cascade: ['persist'])]
328.     #[ORM\OrderBy(['ord' => 'desc'])]
329.     private Collection $sponsors;
331.     #[ApiProperty(description: 'Blocks')]
332.     #[ORM\OneToMany(targetEntity: JournalIssueBlock::class, mappedBy: 'parent', cascade: ['persist'])]
333.     #[ORM\OrderBy(['ord' => 'desc'])]
334.     private Collection $blocks;
336.     #[ApiProperty(description: 'Sections')]
337.     #[ORM\OneToMany(targetEntity: JournalIssueSection::class, mappedBy: 'parent', cascade: ['persist'])]
338.     #[ORM\OrderBy(['ord' => 'desc'])]
339.     private Collection $sections;
341.     //#[ApiProperty(description: 'Articles', writableLink: false)]
342.     //#[Groups(['read:' . self::class])]
343.     #[MaxDepth(1)]
344.     #[ORM\OneToMany(targetEntity: JournalArticle::class, mappedBy: 'issue', cascade: ['persist'])]
345.     #[ORM\OrderBy(['pageFrom' => 'asc'])]
346.     private Collection $articles;
348.     private ?array $sortedArticles = null;
350.     #[ORM\OneToMany(mappedBy: 'issue', targetEntity: CartProduct::class)]
351.     private Collection $cartProducts;
353.     public function __construct(Journal $parent)
354.     {
355.         $this->setUuid();
357.         $this->parent = $parent;
359.         $this->translations = new ArrayCollection();
360.         $this->files = new ArrayCollection();
361.         $this->sponsors = new ArrayCollection();
362.         $this->blocks = new ArrayCollection();
363.         $this->sections = new ArrayCollection();
364.         $this->articles = new ArrayCollection();
365.         $this->editorialGroups = new ArrayCollection();
367.         foreach ($this->parent->getLanguages() as $lang) {
368.             new JournalIssueTranslation($this, $lang);
369.         }
371.         foreach($this->parent->getEditorialGroups() as $editorialGroup) {
372.             $copied = JournalIssueEditorialGroup::constructFrom(parent: $this, template: $editorialGroup);
373.             $this->addEditorialGroup($copied);
374.         }
376.         $this->isOpen = $parent->getData()->getIsOpen();
377.         $this->price = $parent->getData()->getIssuePrice();
378.         $this->isOpenAccessGrantedAfterNewestIssueExpired = $parent->getData()->getIsOpenAccessGrantedAfterNewestIssueExpired();
379.         $this->visibleEditorialGroupMemberProperties = $parent->getView()->getVisibleEditorialGroupMemberProperties();
381.         $this->suggestedCitationType = $parent->getData()->getSuggestedCitationType();
383.         $this->licence = $parent->getData()->getLicence();
385.         $this->createdAt = new \DateTimeImmutable();
386.         $this->updatedAt = new \DateTimeImmutable();
388.         $this->stat = false;
390.         $parent->addIssue($this);
391.         $this->cartProducts = new ArrayCollection();
392.     }
394.     public function getParent(): Journal
395.     {
396.         return $this->parent;
397.     }
399.     public function setStat(bool $stat): self
400.     {
401.         if (! $this->stat && $stat && $this->isNew) {
402.             $this->isNotifiable = true;
403.         }
405.         $this->stat = $stat;
407.         return $this;
408.     }
410.     public function getIsNotifiable(): bool
411.     {
412.         return $this->isNotifiable;
413.     }
415.     public function getVolume(): JournalVolume
416.     {
417.         return $this->volume;
418.     }
420.     public function setVolume(JournalVolume $volume): self
421.     {
422.         $this->volume = $volume;
424.         return $this;
425.     }
427.     public function getPlannedArticlesAmount(): int
428.     {
429.         return $this->plannedArticlesAmount;
430.     }
432.     public function setPlannedArticlesAmount(int $plannedArticlesAmount): self
433.     {
434.         $this->plannedArticlesAmount = $plannedArticlesAmount;
436.         return $this;
437.     }
439.     #[Groups(['read:' . self::class])]
440.     public function getArticlesRatio(): string
441.     {
442.         $articles = count($this->articles);
444.         return "{$articles}/{$this->plannedArticlesAmount}";
445.     }
447.     public function getIsNew(): bool
448.     {
449.         return $this->isNew;
450.     }
452.     public function setIsNew(bool $isNew): self
453.     {
454.         if ($this->isFirstView) {
455.             return $this;
456.         }
458.         $this->isNew = $isNew;
460.         return $this;
461.     }
463.     public function getIsNewestIssue(): bool
464.     {
465.         return $this->isNewestIssue;
466.     }
468.     public function setIsNewestIssue(bool $isNewestIssue): self
469.     {
470.         $wasNewestIssue = $this->isNewestIssue;
472.         $this->isNewestIssue = $isNewestIssue;
474.         if (
475.             $this->isOpenAccessGrantedAfterNewestIssueExpired
476.             && $wasNewestIssue
477.             && ! $isNewestIssue
478.         ) {
479.             $this->isOpen = true;
480.         }
482.         return $this;
483.     }
485.     public function getIsFirstView(): bool
486.     {
487.         return $this->isFirstView;
488.     }
490.     public function setIsFirstView(bool $isFirstView): self
491.     {
492.         if ($isFirstView) {
493.             $this->isNew = false;
494.         }
496.         $this->isFirstView = $isFirstView;
498.         return $this;
499.     }
501.     public function getState(): JournalIssueState
502.     {
503.         return $this->state;
504.     }
506.     public function setState(JournalIssueState $state): self
507.     {
508.         $this->state = $state;
510.         return $this;
511.     }
513.     public function getIsContinousAccession(): bool
514.     {
515.         return $this->isContinousAccession;
516.     }
518.     public function setIsContinousAccession(bool $isContinousAccession): self
519.     {
520.         $this->isContinousAccession = $isContinousAccession;
522.         return $this;
523.     }
525.     public function getNumberInYear(): int
526.     {
527.         return $this->numberInYear;
528.     }
530.     public function setNumberInYear(int $numberInYear): self
531.     {
532.         $this->numberInYear = $numberInYear;
534.         return $this;
535.     }
537.     public function getIsSpecialIssue(): bool
538.     {
539.         return $this->isSpecialIssue;
540.     }
542.     public function setIsSpecialIssue(bool $isSpecialIssue): self
543.     {
544.         $this->isSpecialIssue = $isSpecialIssue;
546.         return $this;
547.     }
549.     public function getIsCrossmarkButtonVisible(): bool
550.     {
551.         return $this->isCrossmarkButtonVisible;
552.     }
554.     public function setIsCrossmarkButtonVisible(bool $isCrossmarkButtonVisible): self
555.     {
556.         $this->isCrossmarkButtonVisible = $isCrossmarkButtonVisible;
558.         return $this;
559.     }
561.     public function getIsOpen(): bool
562.     {
563.         return $this->isOpen;
564.     }
566.     public function setIsOpen(bool $isOpen): self
567.     {
568.         $this->isOpen = $isOpen;
570.         return $this;
571.     }
573.     public function getPrice(): ?int
574.     {
575.         return $this->price;
576.     }
578.     #[Groups(['read:' . self::class, 'read:' . Journal::class])]
579.     public function getPriceReal(): ?float
580.     {
581.         return $this->price ? round($this->price / 1000, 2) : null;
582.     }
584.     public function setPrice(?int $price): self
585.     {
586.         $this->price = $price;
588.         return $this;
589.     }
591.     #[Groups(['write'])]
592.     public function setPriceReal(?float $priceReal): self
593.     {
594.         $this->price = (int) ($priceReal * 1000);
596.         return $this;
597.     }
599.     public function getGraceDate(): ?\DateTimeImmutable
600.     {
601.         return $this->graceDate;
602.     }
604.     public function setGraceDate(?\DateTimeImmutable $graceDate): self
605.     {
606.         $this->graceDate = $graceDate;
608.         return $this;
609.     }
611.     public function getIsOpenAccessGrantedAfterNewestIssueExpired(): bool
612.     {
613.         return $this->isOpenAccessGrantedAfterNewestIssueExpired;
614.     }
616.     public function setIsOpenAccessGrantedAfterNewestIssueExpired(bool $isOpenAccessGrantedAfterNewestIssueExpired): self
617.     {
618.         $this->isOpenAccessGrantedAfterNewestIssueExpired = $isOpenAccessGrantedAfterNewestIssueExpired;
620.         return $this;
621.     }
623.     public function getPublishedAt(): ?\DateTimeImmutable
624.     {
625.         return $this->publishedAt;
626.     }
628.     public function setPublishedAt(?\DateTimeImmutable $publishedAt): self
629.     {
630.         if ($this->publishedAt === $publishedAt) {
631.             return $this;
632.         }
634.         $this->publishedAt = $publishedAt;
636.         if (! $publishedAt) {
637.             $this->isNew = false;
639.             return $this;
640.         }
643.         $period = $this->parent->getData()->getOpenAccessGrantedAfterPeriod();
645.         if (! $period) {
646.             return $this;
647.         }
649.         $graceDate = new \DateTime("@{$this->publishedAt->getTimestamp()}");
650.         $graceDate->modify($period);
652.         $this->graceDate = new \DateTimeImmutable("@{$graceDate->getTimestamp()}");
654.         return $this;
655.     }
657.     public function getPublishedAtFormat(): JournalDateFormat
658.     {
659.         return $this->publishedAtFormat;
660.     }
662.     public function setPublishedAtFormat(JournalDateFormat $publishedAtFormat): self
663.     {
664.         $this->publishedAtFormat = $publishedAtFormat;
666.         return $this;
667.     }
669.     public function getDoi(): ?string
670.     {
671.         return $this->doi;
672.     }
674.     public function setDoi(?string $doi): self
675.     {
676.         $this->doi = $doi;
678.         return $this;
679.     }
681.     public function getLicence(): JournalLicence
682.     {
683.         return $this->licence;
684.     }
686.     public function setLicence(JournalLicence $licence): self
687.     {
688.         if ($this->licence !== $licence) {
689.             foreach($this->articles as $article) {
690.                 $article->setLicence($licence);
691.             }
692.         }
694.         $this->licence = $licence;
696.         return $this;
697.     }
699.     public function getSuggestedCitationType(): ?CitationType
700.     {
701.         return $this->suggestedCitationType;
702.     }
704.     public function setSuggestedCitationType(?CitationType $suggestedCitationType): self
705.     {
706.         $this->suggestedCitationType = $suggestedCitationType;
708.         return $this;
709.     }
711.     public function getFundingNumber(): ?string
712.     {
713.         return $this->fundingNumber;
714.     }
716.     public function setFundingNumber(?string $fundingNumber): self
717.     {
718.         $this->fundingNumber = $fundingNumber;
720.         return $this;
721.     }
723.     public function getMetaLink(): ?string
724.     {
725.         return $this->metaLink;
726.     }
728.     public function setMetaLink(?string $metaLink): self
729.     {
730.         $this->metaLink = $metaLink;
732.         return $this;
733.     }
735.     public function getVisibleEditorialGroupMemberProperties(): array
736.     {
737.         return $this->visibleEditorialGroupMemberProperties;
738.     }
740.     public function setVisibleEditorialGroupMemberProperties(array $visibleEditorialGroupMemberProperties): self
741.     {
742.         $this->visibleEditorialGroupMemberProperties = $visibleEditorialGroupMemberProperties;
744.         return $this;
745.     }
747.     /**
748.      * @return Collection|JournalIssueFile[]
749.      */
750.     public function getFiles(): Collection
751.     {
752.         return $this->files;
753.     }
755.     public function addFile(JournalIssueFile $file): self
756.     {
757.         if ($this->files->contains($file)) {
758.             return $this;
759.         }
761.         $this->files[] = $file;
763.         return $this;
764.     }
766.     public function removeFile(JournalIssueFile $file): self
767.     {
768.         $this->files->removeElement($file);
770.         return $this;
771.     }
773.     public function resetFiles(): self
774.     {
775.         $this->files = new ArrayCollection();
777.         return $this;
778.     }
780.     public function getVisibleFiles(string $lang): Collection
781.     {
782.         return $this->files->filter(
783.             fn (JournalIssueFile $file) =>
784.                 $file->getStat() === true &&
785.                 $file->readAvailableTranslation($lang, 'media')
786.         );
787.     }
789.     /**
790.      * @return Collection|JournalIssueSponsor[]
791.      */
792.     public function getSponsors(): Collection
793.     {
794.         return $this->sponsors;
795.     }
797.     public function addSponsor(JournalIssueSponsor $sponsor): self
798.     {
799.         if ($this->sponsors->contains($sponsor)) {
800.             return $this;
801.         }
803.         $this->sponsors[] = $sponsor;
805.         return $this;
806.     }
808.     public function removeSponsor(JournalIssueSponsor $sponsor): self
809.     {
810.         $this->sponsors->removeElement($sponsor);
812.         return $this;
813.     }
815.     public function resetSponsors(): self
816.     {
817.         $this->sponsors = new ArrayCollection();
819.         return $this;
820.     }
822.     /**
823.      * @return Collection|JournalIssueBlock[]
824.      */
825.     public function getBlocks(): Collection
826.     {
827.         return $this->blocks;
828.     }
830.     public function addBlock(JournalIssueBlock $block): self
831.     {
832.         if ($this->blocks->contains($block)) {
833.             return $this;
834.         }
836.         $this->blocks[] = $block;
838.         return $this;
839.     }
841.     public function removeBlock(JournalIssueBlock $block): self
842.     {
843.         $this->blocks->removeElement($block);
845.         return $this;
846.     }
848.     public function resetBlocks(): self
849.     {
850.         $this->blocks = new ArrayCollection();
852.         return $this;
853.     }
855.     /**
856.      * @return Collection|JournalIssueSection[]
857.      */
858.     public function getSections(): Collection
859.     {
860.         return $this->sections;
861.     }
863.     public function addSection(JournalIssueSection $section): self
864.     {
865.         if ($this->sections->contains($section)) {
866.             return $this;
867.         }
869.         $this->sections[] = $section;
871.         return $this;
872.     }
874.     public function removeSection(JournalIssueSection $section): self
875.     {
876.         $this->sections->removeElement($section);
878.         return $this;
879.     }
881.     public function resetSections(): self
882.     {
883.         $this->sections = new ArrayCollection();
885.         return $this;
886.     }
888.     /**
889.      * @return array|JournalArticle[]
890.      */
891.     public function getArticles(): array
892.     {
893.         if (null === $this->sortedArticles) {
894.             $this->sortedArticles = $this->articles->toArray();
896.             if ($this->getParent()->isSortArticlesByOrd()) {
897.                 usort(
898.                     $this->sortedArticles,
899.                     function(JournalArticle $a, JournalArticle $b) {
900.                         return $b->getOrd() > $a->getOrd();
901.                     }
902.                 );
903.             } else {
904.                 usort(
905.                     $this->sortedArticles,
906.                     function(JournalArticle $a, JournalArticle $b) {
907.                         $aPageFrom = RomanNumber::isRoman($a->getPageFrom())
908.                             ? RomanNumber::convertToInt($a->getPageFrom())
909.                             : (int) $a->getPageFrom();
911.                         $bPageFrom = RomanNumber::isRoman($b->getPageFrom())
912.                             ? RomanNumber::convertToInt($b->getPageFrom())
913.                             : (int) $b->getPageFrom();
915.                         return $aPageFrom > $bPageFrom;
916.                     }
917.                 );
918.             }
919.         }
921.         return $this->sortedArticles;
922.     }
924.     public function addArticle(JournalArticle $article): self
925.     {
926.         if ($this->articles->contains($article)) {
927.             return $this;
928.         }
930.         $this->articles[] = $article;
932.         return $this;
933.     }
935.     public function removeArticle(JournalArticle $article): self
936.     {
937.         $this->articles->removeElement($article);
939.         return $this;
940.     }
942.     public function resetArticles(): self
943.     {
944.         $this->articles = new ArrayCollection();
946.         return $this;
947.     }
949.     public function getArticlesVisible(bool $sectionable = false): array
950.     {
951.         $articles = [];
953.         /** @var JournalArticle $article */
954.         foreach ($this->getArticles() as $article) {
955.             if (! $article->getStat()) {
956.                 continue;
957.             }
959.             if (
960.                 ($sectionable && ! $article->getSection()) ||
961.                 (! $sectionable && $article->getSection())
962.             ) {
963.                 continue;
964.             }
966.             $articles[] = $article;
967.         }
969.         return $articles;
970.     }
972.     public function getArticlesVisibleIgnoreSections(): array
973.     {
974.         $articles = [];
976.         foreach ($this->getArticles() as $article) {
977.             if (! $article->getStat()) {
978.                 continue;
979.             }
981.             $articles[] = $article;
982.         }
984.         return $articles;
985.     }
987.     public function getSectionGroupedArticles(): array
988.     {
989.         $articles = [];
991.         /** @var JournalArticle $article */
992.         foreach ($this->getArticles() as $article) {
993.             if (! $article->getStat() || ! $article->getSection()?->getStat()) {
994.                 continue;
995.             }
997.             $sectionOrd = $this->getSectionOrd($article->getSection());
999.             if (! isset($result[$sectionOrd])) {
1000.                 $result[$sectionOrd] = [];
1001.             }
1003.             $articles[$sectionOrd][] = $article;
1004.         }
1006.         return $articles;
1007.     }
1009.     private function getSectionOrd(JournalSection $search): ?int
1010.     {
1011.         foreach($this->sections as $section) {
1012.             if ($search === $section->getSection()) {
1013.                 return $section->getOrd();
1014.             }
1015.         }
1017.         return null;
1018.     }
1020.     public function getArticlesKeywords(string|Language $lang): array
1021.     {
1022.         $results = [];
1024.         /** @var JournalArticle $article */
1025.         foreach ($this->getArticles() as $article) {
1026.             if (! $article->getStat()) {
1027.                 continue;
1028.             }
1030.             $keywords = $article->readAvailableMetadataTranslation($lang, 'keywords');
1032.             if (! $keywords) {
1033.                 continue;
1034.             }
1036.             $results = array_merge($results, $keywords->toArray());
1037.         }
1039.         return $results;
1040.     }
1042.     public function getVisibleEditorialGroups(): Collection
1043.     {
1044.         return $this->editorialGroups;
1045.     }
1047.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class])]
1048.     public function getParentNativeLanguage(): Language
1049.     {
1050.         return $this->getLanguageableParent()->getNativeLanguage();
1051.     }
1053.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class])]
1054.     public function getParentLanguages(): array
1055.     {
1056.         return $this->getLanguageableParent()->getLanguages();
1057.     }
1059.     #[Groups(['read:' . self::class])]
1060.     public function getNativeTitle(): ?string
1061.     {
1062.         return $this->getTranslation($this->parent->getNativeLanguage())?->getTitle();
1063.     }
1065.     public function getOaiId(): string
1066.     {
1067.         return Urlizer::urlize($this->getNativeTitle());
1068.     }
1070.     #[Groups(['read:' . self::class])]
1071.     public function getJournalSlug(): ?string
1072.     {
1073.         return $this->parent->getSlug();
1074.     }
1076.     /**
1077.      * @return Collection<int, CartProduct>
1078.      */
1079.     public function getCartProducts(): Collection
1080.     {
1081.         return $this->cartProducts;
1082.     }
1084.     public function addCartProduct(CartProduct $cartProduct): self
1085.     {
1086.         if (!$this->cartProducts->contains($cartProduct)) {
1087.             $this->cartProducts->add($cartProduct);
1088.             $cartProduct->setIssue($this);
1089.         }
1091.         return $this;
1092.     }
1094.     public function removeCartProduct(CartProduct $cartProduct): self
1095.     {
1096.         if ($this->cartProducts->removeElement($cartProduct)) {
1097.             // set the owning side to null (unless already changed)
1098.             if ($cartProduct->getIssue() === $this) {
1099.                 $cartProduct->setIssue(null);
1100.             }
1101.         }
1103.         return $this;
1104.     }
1106.     public function getFullTextExtensions(): array
1107.     {
1108.         $extensions = [];
1109.         /** @var JournalArticle $article */
1110.         foreach ($this->getArticlesVisible() as $article) {
1111.             $extensions = array_merge($extensions, $article->getFullTextExtensions());
1112.         }
1114.         return array_unique($extensions);
1115.     }
1117.     public function isForSale(): bool
1118.     {
1119.         if ($this->getIsOpen()) {
1120.             return false;
1121.         }
1123.         if (!$this->getPriceReal()) {
1124.             return false;
1125.         }
1127.         return true;
1128.     }
1130.     public function clone(?Journal $parent = null): self
1131.     {
1132.         $clone = clone $this;
1134.         $clone->id = null;
1135.         $clone->setUuid();
1137.         $clone->importId = null;
1139.         ClassUtils::cloneCollection($this, $clone, 'translations');
1140.         $clone->synchronizeTranslations();
1142.         if (! $parent) {
1143.             $nativeLanguage = $clone->parent->getNativeLanguage();
1144.             $nativeTranslation = $clone->getTranslation($nativeLanguage);
1145.             $nativeTranslation->setTitle($nativeTranslation->getTitle() . ' [KOPIA]');
1147.             $clone->ord = 0;
1148.             $clone->stat = false;
1149.         } else {
1150.             $clone->parent = $parent;
1151.             $clone->parent->addIssue($clone);
1152.         }
1154.         ClassUtils::cloneCollection($this, $clone, 'sponsors');
1155.         ClassUtils::cloneCollection($this, $clone, 'blocks');
1156.         ClassUtils::cloneCollection($this, $clone, 'editorialGroups');
1157.         ClassUtils::cloneCollection($this, $clone, 'sections');
1159.         $this
1160.             ->resetFiles()
1161.             ->resetArticles();
1163.         $clone->createdAt = new \DateTimeImmutable();
1164.         $clone->updatedAt = new \DateTimeImmutable();
1166.         return $clone;
1167.     }
1168. }