Adjusted code samples

Author: mnocon

code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php

@@ -26,10 +26,11 @@ class CreateContentTypeCommand extends Command
 
     public function __construct(ContentTypeService $contentTypeService, UserService $userService, PermissionResolver $permissionResolver)
     {
-        parent::__construct();
         $this->contentTypeService = $contentTypeService;
         $this->userService = $userService;
         $this->permissionResolver = $permissionResolver;
+
+        parent::__construct();
     }
 
     protected function configure(): void

code_samples/api/public_php_api/src/Command/CreateImageCommand.php

@@ -32,12 +32,13 @@ class CreateImageCommand extends Command
 
     public function __construct(ContentService $contentService, ContentTypeService $contentTypeService, LocationService $locationService, UserService $userService, PermissionResolver $permissionResolver)
     {
-        parent::__construct();
         $this->contentService = $contentService;
         $this->contentTypeService = $contentTypeService;
         $this->locationService = $locationService;
         $this->userService = $userService;
         $this->permissionResolver = $permissionResolver;
+
+        parent::__construct();
     }
 
     protected function configure(): void

code_samples/api/public_php_api/src/Command/DeleteContentCommand.php

@@ -24,10 +24,11 @@ class DeleteContentCommand extends Command
 
     public function __construct(LocationService $locationService, UserService $userService, PermissionResolver $permissionResolver)
     {
-        parent::__construct();
         $this->locationService = $locationService;
         $this->userService = $userService;
         $this->permissionResolver = $permissionResolver;
+
+        parent::__construct();
     }
 
     protected function configure(): void

code_samples/api/public_php_api/src/Command/FindComplexCommand.php

@@ -24,9 +24,10 @@ class FindComplexCommand extends Command
 
     public function __construct(SearchService $searchService, LocationService $locationService)
     {
-        parent::__construct();
         $this->searchService = $searchService;
         $this->locationService = $locationService;
+
+        parent::__construct();
     }
 
     protected function configure(): void

code_samples/api/public_php_api/src/Command/FindContentCommand.php

@@ -20,8 +20,9 @@ class FindContentCommand extends Command
 
     public function __construct(SearchService $searchService)
     {
-        parent::__construct();
         $this->searchService = $searchService;
+
+        parent::__construct();
     }
 
     protected function configure(): void

docs/api/php_api/php_api.md

@@ -126,7 +126,7 @@ While [using `sudo()`](#using-sudo) is the recommended option, you can also set
 To identify as a different user, you need to use the `UserService` together with `PermissionResolver` (in the example `admin` is the login of the administrator user):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 50, 52) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 55, 57) =]]
 ```
 
 !!! tip

docs/commerce/order_management/order_management_api.md

@@ -26,7 +26,7 @@ To access a single order by using its string identifier, use the `OrderService::
 To access a single order by using its numerical ID, use the `OrderService::getOrder` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 68, 72) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 67, 72) =]]
 ```
 
 ## Get multiple orders

docs/content_management/content_api/browsing_content.md

@@ -25,15 +25,15 @@ This value object provides primitive fields, such as `contentTypeId`, `published
 
 You can also use it to request other Content-related value objects from various services:
 
-``` php hl_lines="9"
+``` php hl_lines="10"
 // ...
 [[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 4, 5) =]]
-[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 20, 21) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 20, 22) =]]
 // ...
-[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 55, 57) =]][[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 63, 64) =]]
-[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 65, 71) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 55, 57) =]][[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 63, 72) =]]
 ```
 
+
 `ContentInfo` is loaded from the [`ContentService`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ContentService.html) (line 9).
 It provides you with basic content metadata such as modification and publication dates or main language code.
 
@@ -142,7 +142,7 @@ You need to provide it with the object state group.
 All object state groups can be retrieved through [`loadObjectStateGroups`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ObjectStateService.html#method_loadObjectStateGroups).
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 115, 120) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentMetaDataCommand.php', 120, 125) =]]
 ```
 
 ## Viewing content with fields
@@ -151,7 +151,7 @@ To retrieve the fields of the selected content item, you can use the following c
 
 ```php hl_lines="13-14 16-22"
 [[= include_file('code_samples/api/public_php_api/src/Command/ViewContentCommand.php', 4, 7) =]]    // ...
-[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentCommand.php', 37, 55) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/ViewContentCommand.php', 42, 60) =]]
 }
 ```
 
@@ -182,7 +182,7 @@ $contentService->loadContent($content->id, Language::ALL);
 To go through all the content items contained in a subtree, you need to use the [`LocationService`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html).
 
 ``` php hl_lines="5 15"
-[[= include_file('code_samples/api/public_php_api/src/Command/BrowseLocationsCommand.php', 30, 49) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/BrowseLocationsCommand.php', 35, 54) =]]
 ```
 
 `loadLocation` (line 15) returns a value object, here a `Location`.

docs/content_management/content_api/creating_content.md

@@ -21,7 +21,7 @@ Value objects such as content items are read-only, so to create or modify them y
 returns a new [`ContentCreateStruct`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-ContentCreateStruct.html) object.
 
 ``` php hl_lines="2-3 5"
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 57, 66) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 62, 71) =]]
 ```
 
 This command creates a draft using [`ContentService::createContent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ContentService.html#method_createContent) (line 7).
@@ -42,7 +42,7 @@ Therefore, when creating a content item of the Image type (or any other content
 the `ContentCreateStruct` is slightly more complex than in the previous example:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateImageCommand.php', 56, 69) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateImageCommand.php', 61, 74) =]]
 ```
 
 Value of the Image field type contains the path to the image file and other basic information based on the input file.
@@ -66,7 +66,7 @@ To publish it, use [`ContentService::publishVersion`](/api/php_api/php_api_refer
 This method must get the [`VersionInfo`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-VersionInfo.html) object of a draft version.
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 68, 69) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentCommand.php', 73, 74) =]]
 ```
 
 ## Updating content
@@ -76,7 +76,7 @@ and pass it to [`ContentService::updateContent`](/api/php_api/php_api_reference/
 This method works on a draft, so to publish your changes you need to use [`ContentService::publishVersion`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ContentService.html#method_publishVersion) as well:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/UpdateContentCommand.php', 47, 55) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/UpdateContentCommand.php', 52, 60) =]]
 ```
 
 ## Translating content
@@ -86,15 +86,15 @@ Content [translations](languages.md#language-versions) are created per version.
 To translate a content item to a new language, you need to update it and provide a new `initialLanguageCode`:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 52, 57) =]]
-[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 62, 64) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 57, 62) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 67, 69) =]]
 ```
 
 You can also update content in multiple languages at once using the `setField` method's third argument.
 Only one language can still be set as a version's initial language:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 59, 60) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TranslateContentCommand.php', 64, 65) =]]
 ```
 
 ### Deleting a translation

docs/content_management/content_api/managing_content.md

@@ -22,8 +22,8 @@ Creating a new location, like creating content, requires using a struct, because
 To add a new location to existing content you need to create a [`LocationCreateStruct`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-LocationCreateStruct.html) and pass it to the [`LocationService::createLocation`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html#method_createLocation) method:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 50, 51) =]]
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 55, 57) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 55, 56) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 60, 62) =]]
 ```
 
 `LocationCreateStruct` must receive the parent location ID.
@@ -32,7 +32,7 @@ It sets the `parentLocationId` property of the new location.
 You can also provide other properties for the location, otherwise they're set to their defaults:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 52, 54) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 57, 59) =]]
 ```
 
 ### Changing the main location
@@ -41,15 +41,15 @@ When a content item has more that one location, one location is always considere
 You can change the main location using [`ContentService`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ContentService.html), by updating the `ContentInfo` with a [`ContentUpdateStruct`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-ContentUpdateStruct.html) that sets the new main location:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/SetMainLocationCommand.php', 48, 52) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/SetMainLocationCommand.php', 53, 57) =]]
 ```
 
 ### Hiding and revealing locations
 
 To hide or reveal (unhide) a location you need to make use of [`LocationService::hideLocation`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html#method_hideLocation) or [`LocationService::unhideLocation`:](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html#method_unhideLocation)
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 46, 47) =]][[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 49, 50) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 51, 52) =]][[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 54, 55) =]]
 ```
 
 See [location visibility](locations.md#location-visibility) for detailed information on the behavior of visible and hidden Locations.
@@ -66,22 +66,22 @@ Content which has more locations is still available in its other locations.
 If you delete the [main location](#changing-the-main-location) of a content item that has more locations, another location becomes the main one.
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/DeleteContentCommand.php', 44, 45) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/DeleteContentCommand.php', 49, 50) =]]
 ```
 
 To send the location and its subtree to Trash, use [`TrashService::trash`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-TrashService.html#).
 Items in Trash can be later [restored, or deleted permanently](#trash).
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 54, 55) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 59, 60) =]]
 ```
 
 ### Moving and copying a subtree
 
 You can move a location with its whole subtree using [`LocationService::moveSubtree`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html#method_moveSubtree):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/MoveContentCommand.php', 46, 49) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/MoveContentCommand.php', 51, 54) =]]
 ```
 
 [`LocationService::copySubtree`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LocationService.html#method_copySubtree) is used in the same way, but it copies the location and its subtree instead of moving it.
@@ -108,7 +108,7 @@ You must provide the method with the ID of the object in Trash.
 Trash location is identical to the origin location of the object.
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 64, 65) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 69, 70) =]]
 ```
 
 The content item is restored under its previous location.
@@ -138,29 +138,29 @@ In this case you use [`ContentTypeCreateStruct`](/api/php_api/php_api_reference/
 A content type must have at least one name, in the main language, and at least one field definition.
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 59, 69) =]][[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 76, 85) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 64, 74) =]][[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 81, 90) =]]
 ```
 
 You can specify more details of the field definition in the create struct, for example:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 67, 77) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 72, 82) =]]
 ```
 
 ### Copying content types
 
 To copy a content type, use [`ContentTypeService::copyContentType`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-ContentTypeService.html#method_copyContentType):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 89, 90) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 94, 95) =]]
 ```
 
 The copy is automatically getting an identifier based on the original content type identifier and the copy's ID, for example: `copy_of_folder_21`.
 
 To change the identifier of the copy, use a [`ContentTypeUpdateStruct`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-ContentType-ContentTypeUpdateStruct.html):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 90, 96) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 95, 101) =]]
 ```
 
 ## Calendar events
@@ -177,19 +177,19 @@ To get a list of events for a specified time period, use the `CalendarServiceInt
 You need to provide the method with an EventQuery, which takes a date range and a count as the minimum of parameters:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 39, 50) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 44, 55) =]]
 ```
 
 You can also get the first and last event in the list by using the `first()` and `last()` methods of an `EventCollection` (`Ibexa\Contracts\Calendar\EventCollection`):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 51, 53) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 56, 58) =]]
 ```
 
 You can process the events in a collection using the `find(Closure $predicate)`, `filter(Closure $predicate)`, `map(Closure $callback)` or `slice(int $offset, ?int $length = null)` methods of `EventCollection`, for example:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 54, 57) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 59, 62) =]]
 ```
 
 ### Performing calendar actions
@@ -199,7 +199,7 @@ You must pass an `Ibexa\Contracts\Calendar\EventAction\EventActionContext` insta
 `EventActionContext` defines events on which the action is performed, and action-specific parameters, for example, a new date:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 59, 61) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 64, 66) =]]
 ```
 
 ``` php