Adjusted lines

Author: mnocon

docs/ai_actions/extend_ai_actions.md

@@ -116,7 +116,7 @@ Create a class implementing the [ActionHandlerInterface](/api/php_api/php_api_re
 
 See the code sample below, together with a matching service definition:
 
-``` php hl_lines="17 23-26 28-63 65-68"
+``` php hl_lines="17 25-27 30-65 67-70"
 [[= include_file('code_samples/ai_actions/src/AI/Handler/LLaVaTextToTextActionHandler.php') =]]
 ```
 

docs/commerce/checkout/checkout_api.md

@@ -22,7 +22,7 @@ From the developer's perspective, checkouts are referenced with an UUID identifi
 To access a single checkout, use the `CheckoutServiceInterface::getCheckout` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 26, 27) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 28, 29) =]]
 ```
 
 ## Get single checkout for specific cart
@@ -31,15 +31,15 @@ To fetch checkout for a cart that already exists, use the `CheckoutServiceInterf
 You can use it when you want to initiate the checkout process right after products are successfully added to a cart.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 20, 24) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 22, 26) =]]
 ```
 
 ## Create checkout
 
 To create a checkout, use the `CheckoutServiceInterface::createCheckout` method and provide it with a `CheckoutCreateStruct` struct that contains a `CartInterface` object.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 29, 35) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 31, 37) =]]
 ```
 
 ## Update checkout
@@ -53,13 +53,13 @@ To update the checkout, use the `CheckoutServiceInterface::updateCheckout` metho
 All data is placed in session storage.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 37, 39) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 39, 41) =]]
 ```
 
 ## Delete checkout
 
 To delete a checkout from the session, use the `CheckoutServiceInterface::deleteCheckout` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 41, 42) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 43, 44) =]]
 ```

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', 42, 43) =]]
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 47, 49) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 46, 47) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 51, 53) =]]
 ```
 
 `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', 44, 46) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLocationToContentCommand.php', 48, 50) =]]
 ```
 
 ### Changing the main location
@@ -41,15 +41,16 @@ 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', 43, 47) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/SetMainLocationCommand.php', 46, 51) =]]
 ```
 
 ### 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', 41, 42) =]][[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 44, 45) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 44, 45) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/HideLocationCommand.php', 47, 48) =]]
 ```
 
 See [location visibility](locations.md#location-visibility) for detailed information on the behavior of visible and hidden Locations.
@@ -66,22 +67,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', 39, 40) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/DeleteContentCommand.php', 40, 43) =]]
 ```
 
 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#method_trash).
 Items in Trash can be later [restored, or deleted permanently](#trash).
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 46, 47) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 50, 51) =]]
 ```
 
 ### 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', 41, 44) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/MoveContentCommand.php', 44, 47) =]]
 ```
 
 [`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 +109,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', 56, 57) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/TrashContentCommand.php', 60, 61) =]]
 ```
 
 The content item is restored under its previous location.
@@ -138,30 +139,30 @@ 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', 54, 64) =]][[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 71, 80) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 56, 66) =]][[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 73, 82) =]]
 
 ```
 
 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', 62, 72) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 64, 74) =]]
 ```
 
 ### 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', 83, 85) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 85, 88) =]]
 ```
 
 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', 85, 91) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CreateContentTypeCommand.php', 87, 93) =]]
 ```
 
 ## Calendar events
@@ -178,19 +179,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', 34, 45) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 37, 48) =]]
 ```
 
 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', 46, 48) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 49, 51) =]]
 ```
 
 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', 49, 53) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 52, 56) =]]
 ```
 
 ### Performing calendar actions
@@ -200,5 +201,5 @@ 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', 54, 58) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/CalendarCommand.php', 57, 61) =]]
 ```

docs/multisite/languages/language_api.md

@@ -11,7 +11,7 @@ You can manage languages configured in the system with PHP API by using [`Langua
 To get a list of all languages in the system use [`LanguageService::loadLanguages`:](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LanguageService.html#method_loadLanguage)
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLanguageCommand.php', 27, 33) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLanguageCommand.php', 31, 37) =]]
 ```
 
 ## Creating a language
@@ -20,5 +20,5 @@ To create a new language, you need to create a [`LanguageCreateStruct`](/api/php
 Then, use [`LanguageService::createLanguage`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-LanguageService.html#method_createLanguage) and pass the `LanguageCreateStruct` to it:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/AddLanguageCommand.php', 34, 38) =]]
+[[= include_file('code_samples/api/public_php_api/src/Command/AddLanguageCommand.php', 38, 42) =]]
 ```

docs/pim/price_api.md

@@ -12,13 +12,13 @@ To access a currency object by its code, use `CurrencyServiceInterface::getCurre
 To access a whole list of currencies, use `CurrencyServiceInterface::findCurrencies`.
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 42, 50) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 45, 53) =]]
 ```
 
 To create a new currency, use `CurrencyServiceInterface::createCurrency()` and provide it with a `CurrencyCreateStruct` with code, number of fractional digits and a flag indicating if the currency is enabled:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 57, 60) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 60, 63) =]]
 ```
 
 ## Prices

docs/pim/product_api.md

@@ -47,7 +47,7 @@ Provide the method with the product type object and the main language code.
 You also need to set (at least) the code for the product and the required Field of the underlying content type, `name`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductCommand.php', 71, 76) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductCommand.php', 69, 76) =]]
 ```
 
 To delete a product, use `LocalProductServiceInterface::deleteProduct()`:
@@ -108,13 +108,13 @@ To work with product types, use [`ProductTypeServiceInterface`](/api/php_api/php
 Get a product type object by using `ProductTypeServiceInterface::getProductType()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 38, 39) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 41, 42) =]]
 ```
 
 You can also get a list of product types with `ProductTypeServiceInterface::findProductTypes()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 42, 47) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 45, 50) =]]
 ```
 
 ## Product availability