vendor/ezsystems/ezpublish-kernel/eZ/Publish/Core/SignalSlot/ContentService.php line 201

Open in your IDE?
  1. <?php
  3. /**
  4.  * @copyright Copyright (C) eZ Systems AS. All rights reserved.
  5.  * @license For full copyright and license information view LICENSE file distributed with this source code.
  6.  */
  7. namespace eZ\Publish\Core\SignalSlot;
  9. use eZ\Publish\API\Repository\ContentService as ContentServiceInterface;
  10. use eZ\Publish\API\Repository\Values\Content\ContentDraftList;
  11. use eZ\Publish\API\Repository\Values\Content\ContentCreateStruct;
  12. use eZ\Publish\API\Repository\Values\Content\ContentUpdateStruct;
  13. use eZ\Publish\API\Repository\Values\Content\ContentMetadataUpdateStruct;
  14. use eZ\Publish\API\Repository\Values\Content\Language;
  15. use eZ\Publish\API\Repository\Values\Content\LocationCreateStruct;
  16. use eZ\Publish\API\Repository\Values\Content\ContentInfo;
  17. use eZ\Publish\API\Repository\Values\Content\RelationList;
  18. use eZ\Publish\API\Repository\Values\Content\VersionInfo;
  19. use eZ\Publish\API\Repository\Values\ContentType\ContentType;
  20. use eZ\Publish\API\Repository\Values\User\User;
  21. use eZ\Publish\Core\SignalSlot\Signal\ContentService\CreateContentSignal;
  22. use eZ\Publish\Core\SignalSlot\Signal\ContentService\DeleteTranslationSignal;
  23. use eZ\Publish\Core\SignalSlot\Signal\ContentService\HideContentSignal;
  24. use eZ\Publish\Core\SignalSlot\Signal\ContentService\RemoveTranslationSignal;
  25. use eZ\Publish\Core\SignalSlot\Signal\ContentService\RevealContentSignal;
  26. use eZ\Publish\Core\SignalSlot\Signal\ContentService\UpdateContentMetadataSignal;
  27. use eZ\Publish\Core\SignalSlot\Signal\ContentService\DeleteContentSignal;
  28. use eZ\Publish\Core\SignalSlot\Signal\ContentService\CreateContentDraftSignal;
  29. use eZ\Publish\Core\SignalSlot\Signal\ContentService\UpdateContentSignal;
  30. use eZ\Publish\Core\SignalSlot\Signal\ContentService\PublishVersionSignal;
  31. use eZ\Publish\Core\SignalSlot\Signal\ContentService\DeleteVersionSignal;
  32. use eZ\Publish\Core\SignalSlot\Signal\ContentService\CopyContentSignal;
  33. use eZ\Publish\Core\SignalSlot\Signal\ContentService\AddRelationSignal;
  34. use eZ\Publish\Core\SignalSlot\Signal\ContentService\DeleteRelationSignal;
  36. /**
  37.  * ContentService class.
  38.  */
  39. class ContentService implements ContentServiceInterface
  40. {
  41.     /**
  42.      * Aggregated service.
  43.      *
  44.      * @var \eZ\Publish\API\Repository\ContentService
  45.      */
  46.     protected $service;
  48.     /**
  49.      * SignalDispatcher.
  50.      *
  51.      * @var \eZ\Publish\Core\SignalSlot\SignalDispatcher
  52.      */
  53.     protected $signalDispatcher;
  55.     /**
  56.      * Constructor.
  57.      *
  58.      * Construct service object from aggregated service and signal
  59.      * dispatcher
  60.      *
  61.      * @param \eZ\Publish\API\Repository\ContentService $service
  62.      * @param \eZ\Publish\Core\SignalSlot\SignalDispatcher $signalDispatcher
  63.      */
  64.     public function __construct(ContentServiceInterface $service, SignalDispatcher $signalDispatcher)
  65.     {
  66.         $this->service = $service;
  67.         $this->signalDispatcher = $signalDispatcher;
  68.     }
  70.     /**
  71.      * Loads a content info object.
  72.      *
  73.      * To load fields use loadContent
  74.      *
  75.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to read the content
  76.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if the content with the given id does not exist
  77.      *
  78.      * @param int $contentId
  79.      *
  80.      * @return \eZ\Publish\API\Repository\Values\Content\ContentInfo
  81.      */
  82.     public function loadContentInfo($contentId)
  83.     {
  84.         return $this->service->loadContentInfo($contentId);
  85.     }
  87.     /**
  88.      * {@inheritdoc}
  89.      */
  90.     public function loadContentInfoList(array $contentIds): iterable
  91.     {
  92.         return $this->service->loadContentInfoList($contentIds);
  93.     }
  95.     /**
  96.      * Loads a content info object for the given remoteId.
  97.      *
  98.      * To load fields use loadContent
  99.      *
  100.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to read the content
  101.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if the content with the given remote id does not exist
  102.      *
  103.      * @param string $remoteId
  104.      *
  105.      * @return \eZ\Publish\API\Repository\Values\Content\ContentInfo
  106.      */
  107.     public function loadContentInfoByRemoteId($remoteId)
  108.     {
  109.         return $this->service->loadContentInfoByRemoteId($remoteId);
  110.     }
  112.     /**
  113.      * Loads a version info of the given content object.
  114.      *
  115.      * If no version number is given, the method returns the current version
  116.      *
  117.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if the version with the given number does not exist
  118.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  119.      *
  120.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  121.      * @param int $versionNo the version number. If not given the current version is returned.
  122.      *
  123.      * @return \eZ\Publish\API\Repository\Values\Content\VersionInfo
  124.      */
  125.     public function loadVersionInfo(ContentInfo $contentInfo, $versionNo = null)
  126.     {
  127.         return $this->service->loadVersionInfo($contentInfo, $versionNo);
  128.     }
  130.     /**
  131.      * Loads a version info of the given content object id.
  132.      *
  133.      * If no version number is given, the method returns the current version
  134.      *
  135.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if the version with the given number does not exist
  136.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  137.      *
  138.      * @param mixed $contentId
  139.      * @param int $versionNo the version number. If not given the current version is returned.
  140.      *
  141.      * @return \eZ\Publish\API\Repository\Values\Content\VersionInfo
  142.      */
  143.     public function loadVersionInfoById($contentId, $versionNo = null)
  144.     {
  145.         return $this->service->loadVersionInfoById($contentId, $versionNo);
  146.     }
  148.     /**
  149.      * Loads content in a version for the given content info object.
  150.      *
  151.      * If no version number is given, the method returns the current version
  152.      *
  153.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if version with the given number does not exist
  154.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  155.      *
  156.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  157.      * @param array $languages A language filter for fields. If not given all languages are returned
  158.      * @param int $versionNo the version number. If not given the current version is returned
  159.      * @param bool $useAlwaysAvailable Add Main language to \$languages if true (default) and if alwaysAvailable is true
  160.      *
  161.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  162.      */
  163.     public function loadContentByContentInfo(ContentInfo $contentInfo, array $languages = null, $versionNo = null, $useAlwaysAvailable = true)
  164.     {
  165.         return $this->service->loadContentByContentInfo($contentInfo, $languages, $versionNo, $useAlwaysAvailable);
  166.     }
  168.     /**
  169.      * Loads content in the version given by version info.
  170.      *
  171.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  172.      *
  173.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  174.      * @param array $languages A language filter for fields. If not given all languages are returned
  175.      * @param bool $useAlwaysAvailable Add Main language to \$languages if true (default) and if alwaysAvailable is true
  176.      *
  177.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  178.      */
  179.     public function loadContentByVersionInfo(VersionInfo $versionInfo, array $languages = null, $useAlwaysAvailable = true)
  180.     {
  181.         return $this->service->loadContentByVersionInfo($versionInfo, $languages, $useAlwaysAvailable);
  182.     }
  184.     /**
  185.      * Loads content in a version of the given content object.
  186.      *
  187.      * If no version number is given, the method returns the current version
  188.      *
  189.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException if the content or version with the given id and languages does not exist
  190.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  191.      *
  192.      * @param int $contentId
  193.      * @param array $languages A language filter for fields. If not given all languages are returned
  194.      * @param int $versionNo the version number. If not given the current version is returned
  195.      * @param bool $useAlwaysAvailable Add Main language to \$languages if true (default) and if alwaysAvailable is true
  196.      *
  197.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  198.      */
  199.     public function loadContent($contentId, array $languages = null, $versionNo = null, $useAlwaysAvailable = true)
  200.     {
  201.         return $this->service->loadContent($contentId, $languages, $versionNo, $useAlwaysAvailable);
  202.     }
  204.     /**
  205.      * Loads content in a version for the content object reference by the given remote id.
  206.      *
  207.      * If no version is given, the method returns the current version
  208.      *
  209.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException - if the content or version with the given remote id does not exist
  210.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load this version
  211.      *
  212.      * @param string $remoteId
  213.      * @param array $languages A language filter for fields. If not given all languages are returned
  214.      * @param int $versionNo the version number. If not given the current version is returned
  215.      * @param bool $useAlwaysAvailable Add Main language to \$languages if true (default) and if alwaysAvailable is true
  216.      *
  217.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  218.      */
  219.     public function loadContentByRemoteId($remoteId, array $languages = null, $versionNo = null, $useAlwaysAvailable = true)
  220.     {
  221.         return $this->service->loadContentByRemoteId($remoteId, $languages, $versionNo, $useAlwaysAvailable);
  222.     }
  224.     /**
  225.      * Creates a new content draft assigned to the authenticated user.
  226.      *
  227.      * If a different userId is given in $contentCreateStruct it is assigned to the given user
  228.      * but this required special rights for the authenticated user
  229.      * (this is useful for content staging where the transfer process does not
  230.      * have to authenticate with the user which created the content object in the source server).
  231.      * The user has to publish the draft if it should be visible.
  232.      * In 4.x at least one location has to be provided in the location creation array.
  233.      *
  234.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to create the content in the given location
  235.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if there is a provided remoteId which exists in the system
  236.      *                                                                        or there is no location provided (4.x) or multiple locations
  237.      *                                                                        are under the same parent or if the a field value is not accepted by the field type
  238.      * @throws \eZ\Publish\API\Repository\Exceptions\ContentFieldValidationException if a field in the $contentCreateStruct is not valid
  239.      * @throws \eZ\Publish\API\Repository\Exceptions\ContentValidationException if a required field is missing or is set to an empty value
  240.      *
  241.      * @param \eZ\Publish\API\Repository\Values\Content\ContentCreateStruct $contentCreateStruct
  242.      * @param \eZ\Publish\API\Repository\Values\Content\LocationCreateStruct[] $locationCreateStructs For each location parent under which a location should be created for the content
  243.      *
  244.      * @return \eZ\Publish\API\Repository\Values\Content\Content - the newly created content draft
  245.      */
  246.     public function createContent(ContentCreateStruct $contentCreateStruct, array $locationCreateStructs = [])
  247.     {
  248.         $returnValue = $this->service->createContent($contentCreateStruct, $locationCreateStructs);
  249.         $this->signalDispatcher->emit(
  250.             new CreateContentSignal(
  251.                 [
  252.                     'contentId' => $returnValue->getVersionInfo()->getContentInfo()->id,
  253.                     'versionNo' => $returnValue->getVersionInfo()->versionNo,
  254.                 ]
  255.             )
  256.         );
  258.         return $returnValue;
  259.     }
  261.     /**
  262.      * Updates the metadata.
  263.      *
  264.      * (see {@link ContentMetadataUpdateStruct}) of a content object - to update fields use updateContent
  265.      *
  266.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to update the content meta data
  267.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if the remoteId in $contentMetadataUpdateStruct is set but already exists
  268.      *
  269.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  270.      * @param \eZ\Publish\API\Repository\Values\Content\ContentMetadataUpdateStruct $contentMetadataUpdateStruct
  271.      *
  272.      * @return \eZ\Publish\API\Repository\Values\Content\Content the content with the updated attributes
  273.      */
  274.     public function updateContentMetadata(ContentInfo $contentInfo, ContentMetadataUpdateStruct $contentMetadataUpdateStruct)
  275.     {
  276.         $returnValue = $this->service->updateContentMetadata($contentInfo, $contentMetadataUpdateStruct);
  277.         $this->signalDispatcher->emit(
  278.             new UpdateContentMetadataSignal(
  279.                 [
  280.                     'contentId' => $contentInfo->id,
  281.                 ]
  282.             )
  283.         );
  285.         return $returnValue;
  286.     }
  288.     /**
  289.      * Deletes a content object including all its versions and locations including their subtrees.
  290.      *
  291.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to delete the content (in one of the locations of the given content object)
  292.      *
  293.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  294.      *
  295.      * @return mixed[] Affected Location Id's
  296.      */
  297.     public function deleteContent(ContentInfo $contentInfo)
  298.     {
  299.         $returnValue = $this->service->deleteContent($contentInfo);
  300.         $this->signalDispatcher->emit(
  301.             new DeleteContentSignal(
  302.                 [
  303.                     'contentId' => $contentInfo->id,
  304.                     'affectedLocationIds' => $returnValue,
  305.                 ]
  306.             )
  307.         );
  309.         return $returnValue;
  310.     }
  312.     /**
  313.      * Creates a draft from a published or archived version.
  314.      *
  315.      * If no version is given, the current published version is used.
  316.      * 4.x: The draft is created with the initialLanguage code of the source version or if not present with the main language.
  317.      * It can be changed on updating the version.
  318.      *
  319.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to create the draft
  320.      *
  321.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  322.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  323.      * @param \eZ\Publish\API\Repository\Values\User\User $user if set given user is used to create the draft - otherwise the current user is used
  324.      * @param \eZ\Publish\API\Repository\Values\Content\Language|null if not set the draft is created with the initialLanguage code of the source version or if not present with the main language.
  325.      *
  326.      * @return \eZ\Publish\API\Repository\Values\Content\Content - the newly created content draft
  327.      */
  328.     public function createContentDraft(
  329.         ContentInfo $contentInfo,
  330.         VersionInfo $versionInfo = null,
  331.         User $creator = null,
  332.         ?Language $language = null
  333.     ) {
  334.         $contentDraft = $this->service->createContentDraft($contentInfo, $versionInfo, $creator, $language);
  335.         $this->signalDispatcher->emit(
  336.             new CreateContentDraftSignal(
  337.                 [
  338.                     'contentId' => $contentInfo->id,
  339.                     'versionNo' => ($versionInfo !== null ? $versionInfo->versionNo : null),
  340.                     'newVersionNo' => $contentDraft->getVersionInfo()->versionNo,
  341.                     'userId' => ($creator !== null ? $creator->id : null),
  342.                     'languageCode' => $contentDraft->getVersionInfo()->initialLanguageCode,
  343.                 ]
  344.             )
  345.         );
  347.         return $contentDraft;
  348.     }
  350.     /**
  351.      * Counts drafts for a user.
  352.      *
  353.      * If no user is given the number of drafts for the authenticated user are returned
  354.      *
  355.      * @param \eZ\Publish\API\Repository\Values\User\User|null $user The user to load drafts for, if defined, otherwise drafts for current-user
  356.      *
  357.      * @return int The number of drafts ({@link VersionInfo}) owned by the given user
  358.      */
  359.     public function countContentDrafts(?User $user = null): int
  360.     {
  361.         return $this->service->countContentDrafts($user);
  362.     }
  364.     /**
  365.      * Loads drafts for a user.
  366.      *
  367.      * If no user is given the drafts for the authenticated user are returned
  368.      *
  369.      * @param \eZ\Publish\API\Repository\Values\User\User $user
  370.      *
  371.      * @return \eZ\Publish\API\Repository\Values\Content\VersionInfo[] the drafts ({@link VersionInfo}) owned by the given user
  372.      *
  373.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to load the draft list
  374.      */
  375.     public function loadContentDrafts(User $user = null)
  376.     {
  377.         return $this->service->loadContentDrafts($user);
  378.     }
  380.     /**
  381.      * {@inheritdoc}
  382.      */
  383.     public function loadContentDraftList(?User $user = null, int $offset = 0, int $limit = -1): ContentDraftList
  384.     {
  385.         return $this->service->loadContentDraftList($user, $offset, $limit);
  386.     }
  388.     /**
  389.      * Updates the fields of a draft.
  390.      *
  391.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to update this version
  392.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is not a draft
  393.      * @throws \eZ\Publish\API\Repository\Exceptions\ContentFieldValidationException if a field in the $contentUpdateStruct is not valid
  394.      * @throws \eZ\Publish\API\Repository\Exceptions\ContentValidationException if a required field is set to an empty value
  395.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if a field value is not accepted by the field type
  396.      *
  397.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  398.      * @param \eZ\Publish\API\Repository\Values\Content\ContentUpdateStruct $contentUpdateStruct
  399.      *
  400.      * @return \eZ\Publish\API\Repository\Values\Content\Content the content draft with the updated fields
  401.      */
  402.     public function updateContent(VersionInfo $versionInfo, ContentUpdateStruct $contentUpdateStruct)
  403.     {
  404.         $returnValue = $this->service->updateContent($versionInfo, $contentUpdateStruct);
  405.         $this->signalDispatcher->emit(
  406.             new UpdateContentSignal(
  407.                 [
  408.                     'contentId' => $versionInfo->getContentInfo()->id,
  409.                     'versionNo' => $versionInfo->versionNo,
  410.                 ]
  411.             )
  412.         );
  414.         return $returnValue;
  415.     }
  417.     /**
  418.      * Publishes a content version.
  419.      *
  420.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to publish this version
  421.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is not a draft
  422.      *
  423.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  424.      * @param string[] $translations
  425.      *
  426.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  427.      */
  428.     public function publishVersion(VersionInfo $versionInfo, array $translations = Language::ALL)
  429.     {
  430.         $returnValue = $this->service->publishVersion($versionInfo, $translations);
  431.         $this->signalDispatcher->emit(
  432.             new PublishVersionSignal(
  433.                 [
  434.                     'contentId' => $versionInfo->getContentInfo()->id,
  435.                     'versionNo' => $versionInfo->versionNo,
  436.                     'affectedTranslations' => $translations,
  437.                 ]
  438.             )
  439.         );
  441.         return $returnValue;
  442.     }
  444.     /**
  445.      * Removes the given version.
  446.      *
  447.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is in
  448.      *         published state or is the last version of the Content
  449.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to remove this version
  450.      *
  451.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  452.      */
  453.     public function deleteVersion(VersionInfo $versionInfo)
  454.     {
  455.         $returnValue = $this->service->deleteVersion($versionInfo);
  456.         $this->signalDispatcher->emit(
  457.             new DeleteVersionSignal(
  458.                 [
  459.                     'contentId' => $versionInfo->contentInfo->id,
  460.                     'versionNo' => $versionInfo->versionNo,
  461.                 ]
  462.             )
  463.         );
  465.         return $returnValue;
  466.     }
  468.     /**
  469.      * Loads all versions for the given content.
  470.      *
  471.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to list versions
  472.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if the given status is invalid
  473.      *
  474.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  475.      * @param int|null $status
  476.      *
  477.      * @return \eZ\Publish\API\Repository\Values\Content\VersionInfo[] Sorted by creation date
  478.      */
  479.     public function loadVersions(ContentInfo $contentInfo, ?int $status = null)
  480.     {
  481.         return $this->service->loadVersions($contentInfo, $status);
  482.     }
  484.     /**
  485.      * Copies the content to a new location. If no version is given,
  486.      * all versions are copied, otherwise only the given version.
  487.      *
  488.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to copy the content to the given location
  489.      *
  490.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  491.      * @param \eZ\Publish\API\Repository\Values\Content\LocationCreateStruct $destinationLocationCreateStruct the target location where the content is copied to
  492.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  493.      *
  494.      * @return \eZ\Publish\API\Repository\Values\Content\Content
  495.      */
  496.     public function copyContent(ContentInfo $contentInfo, LocationCreateStruct $destinationLocationCreateStruct, VersionInfo $versionInfo = null)
  497.     {
  498.         $returnValue = $this->service->copyContent($contentInfo, $destinationLocationCreateStruct, $versionInfo);
  499.         $this->signalDispatcher->emit(
  500.             new CopyContentSignal(
  501.                 [
  502.                     'srcContentId' => $contentInfo->id,
  503.                     'srcVersionNo' => ($versionInfo !== null ? $versionInfo->versionNo : null),
  504.                     'dstContentId' => $returnValue->getVersionInfo()->getContentInfo()->id,
  505.                     'dstVersionNo' => $returnValue->getVersionInfo()->versionNo,
  506.                     'dstParentLocationId' => $destinationLocationCreateStruct->parentLocationId,
  507.                 ]
  508.             )
  509.         );
  511.         return $returnValue;
  512.     }
  514.     /**
  515.      * Loads all outgoing relations for the given version.
  516.      *
  517.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to read this version
  518.      *
  519.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo
  520.      *
  521.      * @return \eZ\Publish\API\Repository\Values\Content\Relation[]
  522.      */
  523.     public function loadRelations(VersionInfo $versionInfo)
  524.     {
  525.         return $this->service->loadRelations($versionInfo);
  526.     }
  528.     /**
  529.      * {@inheritdoc}
  530.      */
  531.     public function countReverseRelations(ContentInfo $contentInfo): int
  532.     {
  533.         return $this->service->countReverseRelations($contentInfo);
  534.     }
  536.     /**
  537.      * Loads all incoming relations for a content object.
  538.      *
  539.      * The relations come only from published versions of the source content objects
  540.      *
  541.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to read this version
  542.      *
  543.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  544.      *
  545.      * @return \eZ\Publish\API\Repository\Values\Content\Relation[]
  546.      */
  547.     public function loadReverseRelations(ContentInfo $contentInfo)
  548.     {
  549.         return $this->service->loadReverseRelations($contentInfo);
  550.     }
  552.     /**
  553.      * {@inheritdoc}
  554.      */
  555.     public function loadReverseRelationList(ContentInfo $contentInfo, int $offset = 0, int $limit = -1): RelationList
  556.     {
  557.         return $this->service->loadReverseRelationList($contentInfo, $offset, $limit);
  558.     }
  560.     /**
  561.      * Adds a relation of type common.
  562.      *
  563.      * The source of the relation is the content and version
  564.      * referenced by $versionInfo.
  565.      *
  566.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to edit this version
  567.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is not a draft
  568.      *
  569.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $sourceVersion
  570.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $destinationContent the destination of the relation
  571.      *
  572.      * @return \eZ\Publish\API\Repository\Values\Content\Relation the newly created relation
  573.      */
  574.     public function addRelation(VersionInfo $sourceVersion, ContentInfo $destinationContent)
  575.     {
  576.         $returnValue = $this->service->addRelation($sourceVersion, $destinationContent);
  577.         $this->signalDispatcher->emit(
  578.             new AddRelationSignal(
  579.                 [
  580.                     'srcContentId' => $sourceVersion->contentInfo->id,
  581.                     'srcVersionNo' => $sourceVersion->versionNo,
  582.                     'dstContentId' => $destinationContent->id,
  583.                 ]
  584.             )
  585.         );
  587.         return $returnValue;
  588.     }
  590.     /**
  591.      * Removes a relation of type COMMON from a draft.
  592.      *
  593.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed edit this version
  594.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is not a draft
  595.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if there is no relation of type COMMON for the given destination
  596.      *
  597.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $sourceVersion
  598.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $destinationContent
  599.      */
  600.     public function deleteRelation(VersionInfo $sourceVersion, ContentInfo $destinationContent)
  601.     {
  602.         $returnValue = $this->service->deleteRelation($sourceVersion, $destinationContent);
  603.         $this->signalDispatcher->emit(
  604.             new DeleteRelationSignal(
  605.                 [
  606.                     'srcContentId' => $sourceVersion->contentInfo->id,
  607.                     'srcVersionNo' => $sourceVersion->versionNo,
  608.                     'dstContentId' => $destinationContent->id,
  609.                 ]
  610.             )
  611.         );
  613.         return $returnValue;
  614.     }
  616.     /**
  617.      * {@inheritdoc}
  618.      */
  619.     public function removeTranslation(ContentInfo $contentInfo, $languageCode)
  620.     {
  621.         @trigger_error(
  622.             __METHOD__ . ' is deprecated, use deleteTranslation instead',
  623.             E_USER_DEPRECATED
  624.         );
  625.         $this->deleteTranslation($contentInfo, $languageCode);
  626.     }
  628.     /**
  629.      * Delete Content item Translation from all Versions (including archived ones) of a Content Object.
  630.      *
  631.      * NOTE: this operation is risky and permanent, so user interface should provide a warning before performing it.
  632.      *
  633.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the specified Translation
  634.      *         is the Main Translation of a Content Item.
  635.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed
  636.      *         to delete the content (in one of the locations of the given Content Item).
  637.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if languageCode argument
  638.      *         is invalid for the given content.
  639.      *
  640.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  641.      * @param string $languageCode
  642.      *
  643.      * @since 6.13
  644.      */
  645.     public function deleteTranslation(ContentInfo $contentInfo, $languageCode)
  646.     {
  647.         $this->service->deleteTranslation($contentInfo, $languageCode);
  648.         $this->signalDispatcher->emit(
  649.             new RemoveTranslationSignal(['contentId' => $contentInfo->id, 'languageCode' => $languageCode])
  650.         );
  651.         $this->signalDispatcher->emit(
  652.             new DeleteTranslationSignal(['contentId' => $contentInfo->id, 'languageCode' => $languageCode])
  653.         );
  654.     }
  656.     /**
  657.      * Delete specified Translation from a Content Draft.
  658.      *
  659.      * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the specified Translation
  660.      *         is the only one the Content Draft has or it is the main Translation of a Content Object.
  661.      * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed
  662.      *         to edit the Content (in one of the locations of the given Content Object).
  663.      * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if languageCode argument
  664.      *         is invalid for the given Draft.
  665.      * @throws \eZ\Publish\API\Repository\Exceptions\NotFoundException if specified Version was not found
  666.      *
  667.      * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $versionInfo Content Version Draft
  668.      * @param string $languageCode Language code of the Translation to be removed
  669.      *
  670.      * @return \eZ\Publish\API\Repository\Values\Content\Content Content Draft w/o the specified Translation
  671.      *
  672.      * @since 6.12
  673.      */
  674.     public function deleteTranslationFromDraft(VersionInfo $versionInfo, $languageCode)
  675.     {
  676.         return $this->service->deleteTranslationFromDraft($versionInfo, $languageCode);
  677.     }
  679.     /**
  680.      * Bulk-load Content items by the list of ContentInfo Value Objects.
  681.      *
  682.      * Note: it does not throw exceptions on load, just ignores erroneous Content item.
  683.      * Moreover, since the method works on pre-loaded ContentInfo list, it is assumed that user is
  684.      * allowed to access every Content on the list.
  685.      *
  686.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo[] $contentInfoList
  687.      * @param string[] $languages A language priority, filters returned fields and is used as prioritized language code on
  688.      *                            returned value object. If not given all languages are returned.
  689.      * @param bool $useAlwaysAvailable Add Main language to \$languages if true (default) and if alwaysAvailable is true,
  690.      *                                 unless all languages have been asked for.
  691.      *
  692.      * @return \eZ\Publish\API\Repository\Values\Content\Content[] list of Content items with Content Ids as keys
  693.      */
  694.     public function loadContentListByContentInfo(
  695.         array $contentInfoList,
  696.         array $languages = [],
  697.         $useAlwaysAvailable = true
  698.     ) {
  699.         return $this->service->loadContentListByContentInfo(
  700.             $contentInfoList,
  701.             $languages,
  702.             $useAlwaysAvailable
  703.         );
  704.     }
  706.     /**
  707.      * Hides Content by making all the Locations appear hidden.
  708.      * It does not persist hidden state on Location object itself.
  709.      *
  710.      * Content hidden by this API can be revealed by revealContent API.
  711.      *
  712.      * @see revealContent
  713.      *
  714.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  715.      */
  716.     public function hideContent(ContentInfo $contentInfo): void
  717.     {
  718.         $this->service->hideContent($contentInfo);
  719.         $this->signalDispatcher->emit(
  720.             new HideContentSignal([
  721.                 'contentId' => $contentInfo->id,
  722.             ])
  723.         );
  724.     }
  726.     /**
  727.      * Reveals Content hidden by hideContent API.
  728.      * Locations which were hidden before hiding Content will remain hidden.
  729.      *
  730.      * @see hideContent
  731.      *
  732.      * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $contentInfo
  733.      */
  734.     public function revealContent(ContentInfo $contentInfo): void
  735.     {
  736.         $this->service->revealContent($contentInfo);
  737.         $this->signalDispatcher->emit(
  738.             new RevealContentSignal([
  739.                 'contentId' => $contentInfo->id,
  740.             ])
  741.         );
  742.     }
  744.     /**
  745.      * Instantiates a new content create struct object.
  746.      *
  747.      * alwaysAvailable is set to the ContentType's defaultAlwaysAvailable
  748.      *
  749.      * @param \eZ\Publish\API\Repository\Values\ContentType\ContentType $contentType
  750.      * @param string $mainLanguageCode
  751.      *
  752.      * @return \eZ\Publish\API\Repository\Values\Content\ContentCreateStruct
  753.      */
  754.     public function newContentCreateStruct(ContentType $contentType, $mainLanguageCode)
  755.     {
  756.         return $this->service->newContentCreateStruct($contentType, $mainLanguageCode);
  757.     }
  759.     /**
  760.      * Instantiates a new content meta data update struct.
  761.      *
  762.      * @return \eZ\Publish\API\Repository\Values\Content\ContentMetadataUpdateStruct
  763.      */
  764.     public function newContentMetadataUpdateStruct()
  765.     {
  766.         return $this->service->newContentMetadataUpdateStruct();
  767.     }
  769.     /**
  770.      * Instantiates a new content update struct.
  771.      *
  772.      * @return \eZ\Publish\API\Repository\Values\Content\ContentUpdateStruct
  773.      */
  774.     public function newContentUpdateStruct()
  775.     {
  776.         return $this->service->newContentUpdateStruct();
  777.     }
  778. }