src/Entity/JournalIssue.php line 138

  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\Util\RomanNumber;
  67. #[ApiResource(
  68.     description: 'Journal issues',
  69.     normalizationContext: ['groups' => [
  70.         'read',
  71.         'read:' . self::class,
  72.         'read:' . self::class . 'Translation'
  73.     ]],
  74.     denormalizationContext: ['groups' => ['write']],
  75.     security: 'is_granted("' . Journal::class . '")',
  76.     order: ['ord' => 'desc'],
  77.     operations: [
  78.         new GetCollection(),
  79.         new Post(
  80.             uriTemplate: '/journal_issues/clone',
  81.             input: CloneDTO::class,
  82.             processor: CloneProcessor::class,
  83.             security: 'is_granted("' . Actions::CLONE .'")',
  84.             securityMessage: CloneVoter::MESSAGE
  85.         ),
  86.         new Post(denormalizationContext: ['groups' => ['write',  'post']]),
  87.         new Get(),
  88.         new Get(
  89.             name: 'get_journal_issue_crossref',
  90.             uriTemplate: '/journal_issues/{uuid}/export/crossref',
  91.             controller: JournalIssueCrossrefExporter::class
  92.         ),
  93.         new Get(
  94.             name: 'get_journal_issue_articles_crossref',
  95.             uriTemplate: '/journal_issues/{uuid}/articles/export/crossref',
  96.             controller: JournalIssueArticlesCrossrefExporter::class
  97.         ),
  98.         new Get(
  99.             name: 'get_journal_issue_articles_copernicus',
  100.             uriTemplate: '/journal_issues/{uuid}/articles/export/copernicus',
  101.             controller: JournalIssueArticlesCopernicusExporter::class
  102.         ),
  103.         new Get(
  104.             name: 'get_journal_issue_articles_pubmed',
  105.             uriTemplate: '/journal_issues/{uuid}/articles/export/pubmed',
  106.             controller: JournalIssueArticlesPubMedExporter::class
  107.         ),
  108.         new Get(
  109.             name: 'get_journal_issue_simcheck_crossref',
  110.             uriTemplate: '/journal_issues/{uuid}/export/simcheck_crossref',
  111.             controller: JournalIssueSimcheckCrossrefExporter::class
  112.         ),
  113.         new Get(
  114.             name: 'get_journal_issue_funding_crossref',
  115.             uriTemplate: '/journal_issues/{uuid}/export/funding_crossref',
  116.             controller: JournalIssueFundingCrossrefExporter::class
  117.         ),
  118.         new Get(
  119.             name: 'get_journal_issue_licence_fulltext_crossref',
  120.             uriTemplate: '/journal_issues/{uuid}/export/licence_fulltext_crossref',
  121.             controller: JournalIssueLicenceFulltextCrossrefExporter::class
  122.         ),
  123.         new Put(),
  124.         new Delete(
  125.             securityPostDenormalize: 'is_granted("' . Actions::DELETE . '", object)',
  126.             securityPostDenormalizeMessage: ArchivableVoter::MESSAGE
  127.         ),
  128.     ],
  129.     extraProperties: ['standard_put' => false],
  130. )]
  131. #[ApiFilter(SearchFilter::class, properties: [
  132.     'translations.title' => 'partial',
  133. ])]
  134. #[ApiFilter(IriFilter::class, properties: ['parent', 'volume'])]
  135. #[ApiFilter(BooleanFilter::class, properties: ['isArchived', 'stat'])]
  136. #[ApiFilter(OrderFilter::class, properties: ['ord'])]
  137. #[ORM\Entity(repositoryClass: JournalIssueRepository::class)]
  138. class JournalIssue implements
  139.     TranslatableInterface,
  140.     OrdStatableInterface,
  141.     LanguageableChildInterface,
  142.     EditorialGroupableInterface,
  143.     ArchivableInterface,
  144.     CloneableInterface
  145. {
  146.     use IdTrait,
  147.         UuidTrait,
  148.         OrdStatTrait,
  149.         TimestampableTrait,
  150.         TranslatableTrait,
  151.         LanguageableChildTrait,
  152.         ArchivedTrait,
  153.         EditorialGroupableTrait,
  154.         ImportIdTrait;
  156.     #[ApiProperty(description: 'Parent', writableLink: false)]
  157.     #[Groups(['read', 'post'])]
  158.     #[ORM\ManyToOne(targetEntity: Journal::class, inversedBy: 'issues')]
  159.     #[ORM\JoinColumn(onDelete: 'cascade', nullable: false)]
  160.     private Journal $parent;
  162.     #[ApiProperty(description: 'Volume', writableLink: false)]
  163.     #[Groups(['read', 'write'])]
  164.     #[Assert\Expression(
  165.         expression: '!value || value.getParent() === this.getParent()',
  166.         message: 'Cannot assign volume from the outside of current journal.'
  167.     )]
  168.     #[ORM\ManyToOne(targetEntity: JournalVolume::class, inversedBy: 'issues')]
  169.     #[ORM\JoinColumn(onDelete: 'cascade', nullable: false)]
  170.     private JournalVolume $volume;
  172.     #[ApiProperty(description: 'Is archived')]
  173.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class, 'read:list', 'write'])]
  174.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  175.     protected bool $isArchived = false;
  177.     #[ApiProperty(description: 'Planned articles amount')]
  178.     #[Groups(['read:' . self::class, 'write'])]
  179.     #[Assert\Positive]
  180.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 1])]
  181.     private int $plannedArticlesAmount = 1;
  183.     #[ApiProperty(description: 'Is new')]
  184.     #[Groups(['read:' . self::class, 'write'])]
  185.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  186.     private bool $isNew = false;
  188.     #[ApiProperty(description: 'Is newest issue')]
  189.     #[Groups(['read:' . self::class, 'write'])]
  190.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => true])]
  191.     private bool $isNewestIssue = true;
  193.     #[ApiProperty(description: 'Is first view')]
  194.     #[Groups(['read:' . self::class, 'write'])]
  195.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  196.     private bool $isFirstView = false;
  198.     #[ApiProperty(description: 'State', writableLink: false)]
  199.     #[Groups(['read:' . self::class, 'write'])]
  200.     #[ORM\Column(
  201.         type: Types::STRING,
  202.         enumType: JournalIssueState::class,
  203.         length: 255,
  204.         options: ['default' => JournalIssueState::LIST]
  205.     )]
  206.     private JournalIssueState $state = JournalIssueState::LIST;
  208.     #[ApiProperty(description: 'Is continous accession')]
  209.     #[Groups(['read:' . self::class, 'write'])]
  210.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  211.     private bool $isContinousAccession = false;
  213.     #[ApiProperty(description: 'Number in year')]
  214.     #[Groups(['read:' . self::class, 'write'])]
  215.     #[Assert\Positive]
  216.     #[ORM\Column(type: Types::INTEGER, options: ['default' => 1])]
  217.     private int $numberInYear = 1;
  219.     #[ApiProperty(description: 'Is special issue')]
  220.     #[Groups(['read:' . self::class, 'write'])]
  221.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  222.     private bool $isSpecialIssue = false;
  224.     #[ApiProperty(description: 'Is crossmark button visible')]
  225.     #[Groups(['read:' . self::class, 'write'])]
  226.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  227.     private bool $isCrossmarkButtonVisible = false;
  229.     #[ApiProperty(description: 'Is open')]
  230.     #[Groups(['read:' . self::class, 'write'])]
  231.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => true])]
  232.     private bool $isOpen = true;
  234.     #[ApiProperty(description: 'Price')]
  235.     #[Groups(['read:' . self::class])]
  236.     #[Assert\PositiveOrZero]
  237.     #[ORM\Column(type: Types::INTEGER, nullable: true)]
  238.     private ?int $price = null;
  240.     #[ApiProperty(description: 'Grace date')]
  241.     #[Groups(['read:' . self::class, 'write'])]
  242.     #[ORM\Column(type: Types::DATE_IMMUTABLE, nullable: true)]
  243.     private ?\DateTimeImmutable $graceDate = null;
  245.     #[ApiProperty(description: 'Is open access granted after newest issue expired')]
  246.     #[Groups(['read:' . self::class, 'write'])]
  247.     #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])]
  248.     private bool $isOpenAccessGrantedAfterNewestIssueExpired = false;
  250.     #[ApiProperty(description: 'Published at')]
  251.     #[Groups(['read:' . self::class, 'write'])]
  252.     #[ORM\Column(type: Types::DATE_IMMUTABLE, nullable: true)]
  253.     private ?\DateTimeImmutable $publishedAt = null;
  255.     #[ApiProperty(description: 'Published at format', writableLink: false)]
  256.     #[Groups(['read:' . self::class, 'write'])]
  257.     #[ORM\Column(
  258.         type: Types::STRING,
  259.         enumType: JournalDateFormat::class,
  260.         length: 255,
  261.         options: ['default' => JournalDateFormat::COMPLETE]
  262.     )]
  263.     private JournalDateFormat $publishedAtFormat = JournalDateFormat::COMPLETE;
  265.     #[ApiProperty(description: 'DOI')]
  266.     #[Groups(['read:' . self::class, 'write'])]
  267.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
  268.     private ?string $doi = null;
  270.     #[ApiProperty(description: 'Licence', writableLink: false)]
  271.     #[Groups(['read:' . self::class, 'write'])]
  272.     #[ORM\Column(
  273.         type: Types::STRING,
  274.         enumType: JournalLicence::class,
  275.         length: 255,
  276.         options: ['default' => JournalLicence::CC_BY]
  277.     )]
  278.     private JournalLicence $licence = JournalLicence::CC_BY;
  280.     #[ApiProperty(description: 'Suggested citation type', writableLink: false)]
  281.     #[Groups(['read:' . Journal::class, 'write'])]
  282.     #[ORM\ManyToOne(targetEntity: CitationType::class)]
  283.     #[ORM\JoinColumn(onDelete: 'set null')]
  284.     private ?CitationType $suggestedCitationType = null;
  286.     #[ApiProperty(description: 'Funding number')]
  287.     #[Groups(['read:' . self::class, 'write'])]
  288.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
  289.     private ?string $fundingNumber = null;
  291.     #[ApiProperty(description: 'Meta link')]
  292.     #[Groups(['read:' . self::class, 'write'])]
  293.     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
  294.     private ?string $metaLink = null;
  296.     #[ApiProperty(description: 'Visible editorial group member properties', writableLink: false)]
  297.     #[Groups(['read:' . self::class, 'write'])]
  298.     #[Assert\Choice(callback: [AuthorProperty::class, 'cases'], multiple: true)]
  299.     #[Assert\Unique]
  300.     #[Assert\Count(min: 1)]
  301.     #[ORM\Column(type: AuthorPropertiesType::NAME)]
  302.     private array $visibleEditorialGroupMemberProperties = [
  303.         AuthorProperty::PREFIX,
  304.         AuthorProperty::NAME,
  305.         AuthorProperty::SURNAME,
  306.         AuthorProperty::AFFILIATION
  307.     ];
  309.     #[ApiProperty(description: 'Files')]
  310.     #[ORM\OneToMany(targetEntity: JournalIssueFile::class, mappedBy: 'parent', cascade: ['persist'])]
  311.     #[ORM\OrderBy(['ord' => 'desc'])]
  312.     private Collection $files;
  314.     #[ApiProperty(description: 'Sponsors')]
  315.     #[ORM\OneToMany(targetEntity: JournalIssueSponsor::class, mappedBy: 'parent', cascade: ['persist'])]
  316.     #[ORM\OrderBy(['ord' => 'desc'])]
  317.     private Collection $sponsors;
  319.     #[ApiProperty(description: 'Blocks')]
  320.     #[ORM\OneToMany(targetEntity: JournalIssueBlock::class, mappedBy: 'parent', cascade: ['persist'])]
  321.     #[ORM\OrderBy(['ord' => 'desc'])]
  322.     private Collection $blocks;
  324.     #[ApiProperty(description: 'Sections')]
  325.     #[ORM\OneToMany(targetEntity: JournalIssueSection::class, mappedBy: 'parent', cascade: ['persist'])]
  326.     #[ORM\OrderBy(['ord' => 'desc'])]
  327.     private Collection $sections;
  329.     #[ApiProperty(description: 'Articles', writableLink: false)]
  330.     #[Groups(['read:' . self::class])]
  331.     #[ORM\OneToMany(targetEntity: JournalArticle::class, mappedBy: 'issue', cascade: ['persist'])]
  332.     #[ORM\OrderBy(['pageFrom' => 'asc'])]
  333.     private Collection $articles;
  335.     private ?array $sortedArticles = null;
  337.     public function __construct(Journal $parent)
  338.     {
  339.         $this->setUuid();
  341.         $this->parent = $parent;
  343.         $this->translations = new ArrayCollection();
  344.         $this->files = new ArrayCollection();
  345.         $this->sponsors = new ArrayCollection();
  346.         $this->blocks = new ArrayCollection();
  347.         $this->sections = new ArrayCollection();
  348.         $this->articles = new ArrayCollection();
  349.         $this->editorialGroups = new ArrayCollection();
  351.         foreach ($this->parent->getLanguages() as $lang) {
  352.             new JournalIssueTranslation($this, $lang);
  353.         }
  355.         foreach($this->parent->getEditorialGroups() as $editorialGroup) {
  356.             $copied = JournalIssueEditorialGroup::constructFrom(parent: $this, template: $editorialGroup);
  357.             $this->addEditorialGroup($copied);
  358.         }
  360.         $this->isOpen = $parent->getData()->getIsOpen();
  361.         $this->price = $parent->getData()->getIssuePrice();
  362.         $this->isOpenAccessGrantedAfterNewestIssueExpired = $parent->getData()->getIsOpenAccessGrantedAfterNewestIssueExpired();
  363.         $this->visibleEditorialGroupMemberProperties = $parent->getView()->getVisibleEditorialGroupMemberProperties();
  365.         $this->suggestedCitationType = $parent->getData()->getSuggestedCitationType();
  367.         $this->licence = $parent->getData()->getLicence();
  369.         $this->createdAt = new \DateTimeImmutable();
  370.         $this->updatedAt = new \DateTimeImmutable();
  372.         $parent->addIssue($this);
  373.     }
  375.     public function getParent(): Journal
  376.     {
  377.         return $this->parent;
  378.     }
  380.     public function getVolume(): JournalVolume
  381.     {
  382.         return $this->volume;
  383.     }
  385.     public function setVolume(JournalVolume $volume): self
  386.     {
  387.         $this->volume = $volume;
  389.         return $this;
  390.     }
  392.     public function getPlannedArticlesAmount(): int
  393.     {
  394.         return $this->plannedArticlesAmount;
  395.     }
  397.     public function setPlannedArticlesAmount(int $plannedArticlesAmount): self
  398.     {
  399.         $this->plannedArticlesAmount = $plannedArticlesAmount;
  401.         return $this;
  402.     }
  404.     #[Groups(['read:' . self::class])]
  405.     public function getArticlesRatio(): string
  406.     {
  407.         $articles = count($this->articles);
  409.         return "{$articles}/{$this->plannedArticlesAmount}";
  410.     }
  412.     public function getIsNew(): bool
  413.     {
  414.         return $this->isNew;
  415.     }
  417.     public function setIsNew(bool $isNew): self
  418.     {
  419.         $this->isNew = $isNew;
  421.         return $this;
  422.     }
  424.     public function getIsNewestIssue(): bool
  425.     {
  426.         return $this->isNewestIssue;
  427.     }
  429.     public function setIsNewestIssue(bool $isNewestIssue): self
  430.     {
  431.         $wasNewestIssue = $this->isNewestIssue;
  433.         $this->isNewestIssue = $isNewestIssue;
  435.         if (
  436.             $this->isOpenAccessGrantedAfterNewestIssueExpired
  437.             && $wasNewestIssue
  438.             && ! $isNewestIssue
  439.         ) {
  440.             $this->isOpen = true;
  441.         }
  443.         return $this;
  444.     }
  446.     public function getIsFirstView(): bool
  447.     {
  448.         return $this->isFirstView;
  449.     }
  451.     public function setIsFirstView(bool $isFirstView): self
  452.     {
  453.         $this->isFirstView = $isFirstView;
  455.         return $this;
  456.     }
  458.     public function getState(): JournalIssueState
  459.     {
  460.         return $this->state;
  461.     }
  463.     public function setState(JournalIssueState $state): self
  464.     {
  465.         $this->state = $state;
  467.         return $this;
  468.     }
  470.     public function getIsContinousAccession(): bool
  471.     {
  472.         return $this->isContinousAccession;
  473.     }
  475.     public function setIsContinousAccession(bool $isContinousAccession): self
  476.     {
  477.         $this->isContinousAccession = $isContinousAccession;
  479.         return $this;
  480.     }
  482.     public function getNumberInYear(): int
  483.     {
  484.         return $this->numberInYear;
  485.     }
  487.     public function setNumberInYear(int $numberInYear): self
  488.     {
  489.         $this->numberInYear = $numberInYear;
  491.         return $this;
  492.     }
  494.     public function getIsSpecialIssue(): bool
  495.     {
  496.         return $this->isSpecialIssue;
  497.     }
  499.     public function setIsSpecialIssue(bool $isSpecialIssue): self
  500.     {
  501.         $this->isSpecialIssue = $isSpecialIssue;
  503.         return $this;
  504.     }
  506.     public function getIsCrossmarkButtonVisible(): bool
  507.     {
  508.         return $this->isCrossmarkButtonVisible;
  509.     }
  511.     public function setIsCrossmarkButtonVisible(bool $isCrossmarkButtonVisible): self
  512.     {
  513.         $this->isCrossmarkButtonVisible = $isCrossmarkButtonVisible;
  515.         return $this;
  516.     }
  518.     public function getIsOpen(): bool
  519.     {
  520.         return $this->isOpen;
  521.     }
  523.     public function setIsOpen(bool $isOpen): self
  524.     {
  525.         $this->isOpen = $isOpen;
  527.         return $this;
  528.     }
  530.     public function getPrice(): ?int
  531.     {
  532.         return $this->price;
  533.     }
  535.     #[Groups(['read:' . self::class, 'read:' . Journal::class])]
  536.     public function getPriceReal(): ?float
  537.     {
  538.         return $this->price ? round($this->price / 1000, 2) : null;
  539.     }
  541.     public function setPrice(?int $price): self
  542.     {
  543.         $this->price = $price;
  545.         return $this;
  546.     }
  548.     #[Groups(['write'])]
  549.     public function setPriceReal(?float $priceReal): self
  550.     {
  551.         $this->price = (int) ($priceReal * 1000);
  553.         return $this;
  554.     }
  556.     public function getGraceDate(): ?\DateTimeImmutable
  557.     {
  558.         return $this->graceDate;
  559.     }
  561.     public function setGraceDate(?\DateTimeImmutable $graceDate): self
  562.     {
  563.         $this->graceDate = $graceDate;
  565.         return $this;
  566.     }
  568.     public function getIsOpenAccessGrantedAfterNewestIssueExpired(): bool
  569.     {
  570.         return $this->isOpenAccessGrantedAfterNewestIssueExpired;
  571.     }
  573.     public function setIsOpenAccessGrantedAfterNewestIssueExpired(bool $isOpenAccessGrantedAfterNewestIssueExpired): self
  574.     {
  575.         $this->isOpenAccessGrantedAfterNewestIssueExpired = $isOpenAccessGrantedAfterNewestIssueExpired;
  577.         return $this;
  578.     }
  580.     public function getPublishedAt(): ?\DateTimeImmutable
  581.     {
  582.         return $this->publishedAt;
  583.     }
  585.     public function setPublishedAt(?\DateTimeImmutable $publishedAt): self
  586.     {
  587.         if ($this->publishedAt === $publishedAt) {
  588.             return $this;
  589.         }
  591.         $this->publishedAt = $publishedAt;
  593.         if (! $publishedAt) {
  594.             return $this;
  595.         }
  597.         $period = $this->parent->getData()->getOpenAccessGrantedAfterPeriod();
  599.         if (! $period) {
  600.             return $this;
  601.         }
  603.         $graceDate = new \DateTime("@{$this->publishedAt->getTimestamp()}");
  604.         $graceDate->modify($period);
  606.         $this->graceDate = new \DateTimeImmutable("@{$graceDate->getTimestamp()}");
  608.         return $this;
  609.     }
  611.     public function getPublishedAtFormat(): JournalDateFormat
  612.     {
  613.         return $this->publishedAtFormat;
  614.     }
  616.     public function setPublishedAtFormat(JournalDateFormat $publishedAtFormat): self
  617.     {
  618.         $this->publishedAtFormat = $publishedAtFormat;
  620.         return $this;
  621.     }
  623.     public function getDoi(): ?string
  624.     {
  625.         return $this->doi;
  626.     }
  628.     public function setDoi(?string $doi): self
  629.     {
  630.         $this->doi = $doi;
  632.         return $this;
  633.     }
  635.     public function getLicence(): JournalLicence
  636.     {
  637.         return $this->licence;
  638.     }
  640.     public function setLicence(JournalLicence $licence): self
  641.     {
  642.         if ($this->licence !== $licence) {
  643.             foreach($this->articles as $article) {
  644.                 $article->setLicence($licence);
  645.             }
  646.         }
  648.         $this->licence = $licence;
  650.         return $this;
  651.     }
  653.     public function getSuggestedCitationType(): ?CitationType
  654.     {
  655.         return $this->suggestedCitationType;
  656.     }
  658.     public function setSuggestedCitationType(?CitationType $suggestedCitationType): self
  659.     {
  660.         $this->suggestedCitationType = $suggestedCitationType;
  662.         return $this;
  663.     }
  665.     public function getFundingNumber(): ?string
  666.     {
  667.         return $this->fundingNumber;
  668.     }
  670.     public function setFundingNumber(?string $fundingNumber): self
  671.     {
  672.         $this->fundingNumber = $fundingNumber;
  674.         return $this;
  675.     }
  677.     public function getMetaLink(): ?string
  678.     {
  679.         return $this->metaLink;
  680.     }
  682.     public function setMetaLink(?string $metaLink): self
  683.     {
  684.         $this->metaLink = $metaLink;
  686.         return $this;
  687.     }
  689.     public function getVisibleEditorialGroupMemberProperties(): array
  690.     {
  691.         return $this->visibleEditorialGroupMemberProperties;
  692.     }
  694.     public function setVisibleEditorialGroupMemberProperties(array $visibleEditorialGroupMemberProperties): self
  695.     {
  696.         $this->visibleEditorialGroupMemberProperties = $visibleEditorialGroupMemberProperties;
  698.         return $this;
  699.     }
  701.     /**
  702.      * @return Collection|JournalIssueFile[]
  703.      */
  704.     public function getFiles(): Collection
  705.     {
  706.         return $this->files;
  707.     }
  709.     public function addFile(JournalIssueFile $file): self
  710.     {
  711.         if ($this->files->contains($file)) {
  712.             return $this;
  713.         }
  715.         $this->files[] = $file;
  717.         return $this;
  718.     }
  720.     public function removeFile(JournalIssueFile $file): self
  721.     {
  722.         $this->files->removeElement($file);
  724.         return $this;
  725.     }
  727.     public function resetFiles(): self
  728.     {
  729.         $this->files = new ArrayCollection();
  731.         return $this;
  732.     }
  734.     public function getVisibleFiles(string $lang): Collection
  735.     {
  736.         return $this->files->filter(
  737.             fn (JournalIssueFile $file) =>
  738.                 $file->getStat() === true &&
  739.                 $file->readAvailableTranslation($lang, 'media')
  740.         );
  741.     }
  743.     /**
  744.      * @return Collection|JournalIssueSponsor[]
  745.      */
  746.     public function getSponsors(): Collection
  747.     {
  748.         return $this->sponsors;
  749.     }
  751.     public function addSponsor(JournalIssueSponsor $sponsor): self
  752.     {
  753.         if ($this->sponsors->contains($sponsor)) {
  754.             return $this;
  755.         }
  757.         $this->sponsors[] = $sponsor;
  759.         return $this;
  760.     }
  762.     public function removeSponsor(JournalIssueSponsor $sponsor): self
  763.     {
  764.         $this->sponsors->removeElement($sponsor);
  766.         return $this;
  767.     }
  769.     public function resetSponsors(): self
  770.     {
  771.         $this->sponsors = new ArrayCollection();
  773.         return $this;
  774.     }
  776.     /**
  777.      * @return Collection|JournalIssueBlock[]
  778.      */
  779.     public function getBlocks(): Collection
  780.     {
  781.         return $this->blocks;
  782.     }
  784.     public function addBlock(JournalIssueBlock $block): self
  785.     {
  786.         if ($this->blocks->contains($block)) {
  787.             return $this;
  788.         }
  790.         $this->blocks[] = $block;
  792.         return $this;
  793.     }
  795.     public function removeBlock(JournalIssueBlock $block): self
  796.     {
  797.         $this->blocks->removeElement($block);
  799.         return $this;
  800.     }
  802.     public function resetBlocks(): self
  803.     {
  804.         $this->blocks = new ArrayCollection();
  806.         return $this;
  807.     }
  809.     /**
  810.      * @return Collection|JournalIssueSection[]
  811.      */
  812.     public function getSections(): Collection
  813.     {
  814.         return $this->sections;
  815.     }
  817.     public function addSection(JournalIssueSection $section): self
  818.     {
  819.         if ($this->sections->contains($section)) {
  820.             return $this;
  821.         }
  823.         $this->sections[] = $section;
  825.         return $this;
  826.     }
  828.     public function removeSection(JournalIssueSection $section): self
  829.     {
  830.         $this->sections->removeElement($section);
  832.         return $this;
  833.     }
  835.     public function resetSections(): self
  836.     {
  837.         $this->sections = new ArrayCollection();
  839.         return $this;
  840.     }
  842.     /**
  843.      * @return array|JournalArticle[]
  844.      */
  845.     public function getArticles(): array
  846.     {
  847.         if (null === $this->sortedArticles) {
  848.             $this->sortedArticles = $this->articles->toArray();
  850.             if ($this->getParent()->isSortArticlesByOrd()) {
  851.                 usort(
  852.                     $this->sortedArticles,
  853.                     function(JournalArticle $a, JournalArticle $b) {
  854.                         return $b->getOrd() > $a->getOrd();
  855.                     }
  856.                 );
  857.             } else {
  858.                 usort(
  859.                     $this->sortedArticles,
  860.                     function(JournalArticle $a, JournalArticle $b) {
  861.                         $aPageFrom = RomanNumber::isRoman($a->getPageFrom())
  862.                             ? RomanNumber::convertToInt($a->getPageFrom())
  863.                             : (int) $a->getPageFrom();
  865.                         $bPageFrom = RomanNumber::isRoman($b->getPageFrom())
  866.                             ? RomanNumber::convertToInt($b->getPageFrom())
  867.                             : (int) $b->getPageFrom();
  869.                         return $aPageFrom > $bPageFrom;
  870.                     }
  871.                 );
  872.             }
  873.         }
  875.         return $this->sortedArticles;
  876.     }
  878.     public function addArticle(JournalArticle $article): self
  879.     {
  880.         if ($this->articles->contains($article)) {
  881.             return $this;
  882.         }
  884.         $this->articles[] = $article;
  886.         return $this;
  887.     }
  889.     public function removeArticle(JournalArticle $article): self
  890.     {
  891.         $this->articles->removeElement($article);
  893.         return $this;
  894.     }
  896.     public function resetArticles(): self
  897.     {
  898.         $this->articles = new ArrayCollection();
  900.         return $this;
  901.     }
  903.     public function getArticlesVisible(bool $sectionable = false): array
  904.     {
  905.         $articles = [];
  907.         /** @var JournalArticle $article */
  908.         foreach ($this->getArticles() as $article) {
  909.             if (! $article->getStat()) {
  910.                 continue;
  911.             }
  913.             if (
  914.                 ($sectionable && ! $article->getSection()) ||
  915.                 (! $sectionable && $article->getSection())
  916.             ) {
  917.                 continue;
  918.             }
  920.             $articles[] = $article;
  921.         }
  923.         return $articles;
  924.     }
  926.     public function getArticlesVisibleIgnoreSections(): array
  927.     {
  928.         $articles = [];
  930.         foreach ($this->getArticles() as $article) {
  931.             if (! $article->getStat()) {
  932.                 continue;
  933.             }
  935.             $articles[] = $article;
  936.         }
  938.         return $articles;
  939.     }
  941.     public function getSectionGroupedArticles(): array
  942.     {
  943.         $articles = [];
  945.         /** @var JournalArticle $article */
  946.         foreach ($this->getArticles() as $article) {
  947.             if (! $article->getStat() || ! $article->getSection()?->getStat()) {
  948.                 continue;
  949.             }
  951.             $sectionOrd = $this->getSectionOrd($article->getSection());
  953.             if (! isset($result[$sectionOrd])) {
  954.                 $result[$sectionOrd] = [];
  955.             }
  957.             $articles[$sectionOrd][] = $article;
  958.         }
  960.         return $articles;
  961.     }
  963.     private function getSectionOrd(JournalSection $search): ?int
  964.     {
  965.         foreach($this->sections as $section) {
  966.             if ($search === $section->getSection()) {
  967.                 return $section->getOrd();
  968.             }
  969.         }
  971.         return null;
  972.     }
  974.     public function getArticlesKeywords(string|Language $lang): array
  975.     {
  976.         $results = [];
  978.         /** @var JournalArticle $article */
  979.         foreach ($this->getArticles() as $article) {
  980.             if (! $article->getStat()) {
  981.                 continue;
  982.             }
  984.             $keywords = $article->readAvailableMetadataTranslation($lang, 'keywords');
  986.             if (! $keywords) {
  987.                 continue;
  988.             }
  990.             $results = array_merge($results, $keywords->toArray());
  991.         }
  993.         return $results;
  994.     }
  996.     public function getVisibleEditorialGroups(): Collection
  997.     {
  998.         return $this->editorialGroups;
  999.     }
  1001.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class])]
  1002.     public function getParentNativeLanguage(): Language
  1003.     {
  1004.         return $this->getLanguageableParent()->getNativeLanguage();
  1005.     }
  1007.     #[Groups(['read:' . self::class, 'read:' . JournalVolume::class])]
  1008.     public function getParentLanguages(): array
  1009.     {
  1010.         return $this->getLanguageableParent()->getLanguages();
  1011.     }
  1013.     public function getNativeTitle(): string
  1014.     {
  1015.         return $this->getTranslation($this->parent->getNativeLanguage())?->getTitle();
  1016.     }
  1018.     public function getOaiId(): string
  1019.     {
  1020.         return Urlizer::urlize($this->getNativeTitle());
  1021.     }
  1023.     public function clone(Journal $parent = null): self
  1024.     {
  1025.         $clone = clone $this;
  1027.         $clone->id = null;
  1028.         $clone->setUuid();
  1030.         $clone->importId = null;
  1032.         ClassUtils::cloneCollection($this, $clone, 'translations');
  1033.         $clone->synchronizeTranslations();
  1035.         if (! $parent) {
  1036.             $nativeLanguage = $clone->parent->getNativeLanguage();
  1037.             $nativeTranslation = $clone->getTranslation($nativeLanguage);
  1038.             $nativeTranslation->setTitle($nativeTranslation->getTitle() . ' [KOPIA]');
  1040.             $clone->ord = 0;
  1041.             $clone->stat = false;
  1042.         } else {
  1043.             $clone->parent = $parent;
  1044.             $clone->parent->addIssue($clone);
  1045.         }
  1047.         ClassUtils::cloneCollection($this, $clone, 'sponsors');
  1048.         ClassUtils::cloneCollection($this, $clone, 'blocks');
  1049.         ClassUtils::cloneCollection($this, $clone, 'editorialGroups');
  1050.         ClassUtils::cloneCollection($this, $clone, 'sections');
  1052.         $this
  1053.             ->resetFiles()
  1054.             ->resetArticles();
  1056.         $clone->createdAt = new \DateTimeImmutable();
  1057.         $clone->updatedAt = new \DateTimeImmutable();
  1059.         return $clone;
  1060.     }
  1061. }