Code samples fixes

Author: mnocon

docs/administration/dashboard/php_api_dashboard_service.md

@@ -24,12 +24,12 @@ Using the `admin` account, it loads the group members, logs each one in, creates
 First argument is the `Content ID` of the dashboard to copy.
 Following arguments are the Content IDs of the user groups.
 
-``` php hl_lines="61"
+``` php hl_lines="63"
 [[= include_file('code_samples/back_office/dashboard/src/Command/DashboardCommand.php') =]]
 ```
 
 The following line runs the command with `74` as the model dashboard's Content ID, `13` the user group's Content ID, and on the SiteAccess `admin` to have the right `user_content_type_identifier` config:
 
 ```bash
 php bin/console doc:dashboard 74 13 --siteaccess=admin
-```
+```

docs/ai_actions/extend_ai_actions.md

@@ -15,7 +15,7 @@ For example, you can create a handler that connects to a translation model and u
 You can execute AI Actions by using the [ActionServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-ActionServiceInterface.html) service, as in the following example:
 
 ``` php
-[[= include_file('code_samples/ai_actions/src/Command/AddMissingAltTextCommand.php', 102, 121) =]]
+[[= include_file('code_samples/ai_actions/src/Command/AddMissingAltTextCommand.php', 105, 124) =]]
 ```
 
 The `GenerateAltTextAction` is a built-in action that implements the [ActionInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-ActionInterface.html), takes an [Image](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-Action-DataType-Image.html) as an input, and generates the alternative text in the response.
@@ -44,7 +44,7 @@ You can influence the execution of an Action with two events:
 Below you can find the full example of a Symfony Command, together with a matching service definition.
 The command finds the images modified in the last 24 hours, and adds the alternative text to them if it's missing.
 
-``` php hl_lines="88 101-126"
+``` php hl_lines="91 104-129"
 [[= include_file('code_samples/ai_actions/src/Command/AddMissingAltTextCommand.php') =]]
 ```
 
@@ -78,7 +78,7 @@ See [Action Configuration Search Criteria reference](action_configuration_criter
 The following example creates a new Action Configuration:
 
 ``` php hl_lines="3 17"
-[[= include_file('code_samples/ai_actions/src/Command/ActionConfigurationCreateCommand.php', 59, 76) =]]
+[[= include_file('code_samples/ai_actions/src/Command/ActionConfigurationCreateCommand.php', 62, 79) =]]
 ```
 
 Actions Configurations are tied to a specific Action Type and are translatable.
@@ -89,7 +89,7 @@ Reuse existing Action Configurations to simplify the execution of AI Actions.
 You can pass one directly to the `ActionServiceInterface::execute()` method:
 
 ``` php hl_lines="7-8"
-[[= include_file('code_samples/ai_actions/src/Command/ActionConfigurationCreateCommand.php', 77, 85) =]]
+[[= include_file('code_samples/ai_actions/src/Command/ActionConfigurationCreateCommand.php', 80, 88) =]]
 ```
 
 The passed Action Configuration is only taken into account if the Action Context was not passed to the Action directly using the [ActionInterface::setActionContext()](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-ActionInterface.html#method_hasActionContext) method.

docs/commerce/order_management/order_management_api.md

@@ -18,15 +18,15 @@ To get orders and manage them, use the `Ibexa\Contracts\OrderManagement\OrderSer
 To access a single order by using its string identifier, use the `OrderService::getOrderByIdentifier` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 57, 61) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 61, 65) =]]
 ```
 
 ### Get single order by ID
 
 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', 63, 67) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 68, 72) =]]
 ```
 
 ## Get multiple orders
@@ -38,15 +38,15 @@ It follows the same search query pattern as other APIs:
 [[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 8, 9) =]][[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 10, 14) =]]
 
 // ...
-[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 116, 125) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 120, 130) =]]
 ```
 
 ## Create order
 
 To create an order, use the `OrderService::createOrder` method and provide it with the `Ibexa\Contracts\OrderManagement\Value\OrderCreateStruct` object that contains a list of products, purchased quantities, product, total prices, and tax amounts.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 97, 108) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 101, 113) =]]
 ```
 
 ## Update order
@@ -56,5 +56,5 @@ You could do it to support a scenario when, for example, the order is processed
 To update order information, use the `OrderService::updateOrder` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 110, 114) =]]
+[[= include_file('code_samples/api/commerce/src/Command/OrderCommand.php', 114, 119) =]]
 ```

docs/commerce/payment/extend_payment.md

@@ -94,11 +94,11 @@ When you create a payment, you can attach custom data to it, for example, you ca
 You add custom data by using the `setContext` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 89, 101) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 96, 108) =]]
 ```
 
 Then, you retrieve it with the `getContext` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 66, 69) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 70, 75) =]]
 ```

docs/commerce/payment/payment_api.md

@@ -17,15 +17,15 @@ You can change that by providing a custom payment identifier in `Ibexa\Contracts
 To access a single payment by using its numerical ID, use the `PaymentServiceInterface::getPayment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 60, 64) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 64, 68) =]]
 ```
 
 ### Get single payment by identifier
 
 To access a single payment by using its string identifier, use the `PaymentServiceInterface::getPaymentByIdentifier` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 66, 70) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 70, 74) =]]
 ```
 
 ## Get multiple payments
@@ -34,16 +34,16 @@ To fetch multiple payments, use the `PaymentServiceInterface::findPayments` meth
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 72, 88) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 78, 94) =]]
 ```
 
 ## Create payment
 
 To create a payment, use the `PaymentServiceInterface::createPayment` method and provide it with the `Ibexa\Contracts\Payment\Payment\PaymentCreateStruct` object that takes the following arguments: `method`, `order` and `amount`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 94, 94) =]]
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 101, 104) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 100, 104) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 107, 111) =]]
 ```
 
 ## Update payment
@@ -54,13 +54,13 @@ The `Ibexa\Contracts\Payment\Payment\PaymentUpdateStruct` object takes the follo
 To update payment information, use the `PaymentServiceInterface::updatePayment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 106, 112) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 112, 118) =]]
 ```
 
 ## Delete payment
 
 To delete a payment from the system, use the `PaymentServiceInterface::deletePayment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 114, 115) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 120, 121) =]]
 ```

docs/commerce/payment/payment_method_api.md

@@ -26,15 +26,15 @@ From the developer's perspective, payment methods are referenced with identifier
 To access a single payment method by using its string identifier, use the `PaymentMethodService::getPaymentMethodByIdentifier` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 52, 56) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 56, 60) =]]
 ```
 
 ### Get single payment method by ID
 
 To access a single payment method by using its numerical ID, use the `PaymentMethodService::getPaymentMethod` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 46, 50) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 50, 54) =]]
 ```
 
 ## Get multiple payment methods
@@ -44,7 +44,7 @@ To fetch multiple payment methods, use the `PaymentMethodService::findPaymentMet
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 58, 75) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 62, 79) =]]
 ```
 
 ## Create payment method
@@ -59,7 +59,7 @@ To create a payment method, use the `PaymentMethodService::createPaymentMethod`
 - `options` object.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 58, 59) =]][[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 77, 87) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 62, 63) =]][[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 81, 91) =]]
 ```
 
 ## Update payment method
@@ -70,20 +70,20 @@ An `Ibexa\Contracts\Payment\PaymentMethod\PaymentMethodUpdateStruct` object can
 To update payment method information, use the `PaymentMethodServiceInterface::updatePaymentMethod` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 89, 99) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 93, 103) =]]
 ```
 
 ## Delete payment method
 
 To delete a payment method from the system, use the `PaymentMethodService::deletePayment` method:
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 101, 107) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 105, 111) =]]
 ```
 
 ## Check whether payment method is used
 
 To check whether a payment method is used, for example, before you delete it, use the `PaymentMethodService::isPaymentMethodUsed` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 109, 122) =]]
-```
+[[= include_file('code_samples/api/commerce/src/Command/PaymentMethodCommand.php', 113, 126) =]]
+```

docs/commerce/shipping_management/shipment_api.md

@@ -16,15 +16,15 @@ From the developer's perspective, shipments are referenced with a UUID identifie
 To access a single shipment by using its string identifier, use the `ShipmentService::getShipmentByIdentifier` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 69, 78) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 73, 82) =]]
 ```
 
 ### Get single shipment by id
 
 To access a single shipment by using its numerical id, use the `ShipmentService::getShipment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 57, 67) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 61, 71) =]]
 ```
 
 ## Get multiple shipments
@@ -33,15 +33,15 @@ To fetch multiple shipments, use the `ShipmentService::findShipments` method.
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 80, 99) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 84, 103) =]]
 ```
 
 ## Create shipment
 
 To create a shipment, use the `ShipmentService::createShipment` method and provide it with an `Ibexa\Contracts\Shipping\Value\ShipmentCreateStruct` object that takes two parameters, a `shippingMethod` string and a `Money` object.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 101, 115) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 105, 119) =]]
 ```
 
 ## Update shipment
@@ -51,13 +51,13 @@ You could do it to support a scenario when, for example, the shipment is process
 To update shipment information, use the `ShipmentService::updateShipment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 117, 128) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 121, 132) =]]
 ```
 ## Delete shipment
 
 To delete a shipment from the system, use the `ShipmentService::deleteShipment` method:
 
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 130, 131) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 134, 135) =]]
 ```

docs/commerce/shipping_management/shipping_method_api.md

@@ -17,7 +17,7 @@ To access a shipping method by using its identifier, use the `ShippingMethodServ
 The method takes a string as `$identifier` parameter and uses a prioritized language from SiteAccess settings unless you pass another language as `forcedLanguage`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 61, 71) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 65, 75) =]]
 ```
 
 ### Get shipping method by ID
@@ -26,7 +26,7 @@ To access a shipping method by using its ID, use the `ShippingMethodServiceInter
 The method takes a string as `$id` parameter and uses a prioritized language from SiteAccess settings unless you pass another language as `forcedLanguage`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 49, 59) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 53, 63) =]]
 ```
 
 ## Get multiple shipping methods
@@ -35,37 +35,37 @@ To fetch multiple shipping methods, use the `ShippingMethodServiceInterface::get
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 73, 91) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 77, 95) =]]
 ```
 
 ## Create shipping method
 
 To create a shipping method, use the `ShippingMethodServiceInterface::createShippingMethod` method and provide it with the `Ibexa\Contracts\Shipping\Value\ShippingMethodCreateStruct` object that you created by using the  `newShippingMethodCreateStruct` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 92, 116) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 97, 120) =]]
 ```
 
 ## Update shipping method
 
 To update a shipping method, use the `ShippingMethodServiceInterface::updateShippingMethod` method and provide it with the `Ibexa\Contracts\Shipping\Value\ShippingMethodUpdateStruct`  object that you created by using the  `newShippingMethodUpdateStruct` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 118, 133) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 122, 137) =]]
 ```
 
 ## Delete shipping method
 
 To update a shipping method, use the `ShippingMethodServiceInterface::deleteShippingMethod` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 134, 140) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 138, 144) =]]
 ```
 
 ## Delete shipping method translation
 
 To delete shipping method translation, use the `ShippingMethodServiceInterface::deleteShippingMethodTranslation` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 142, 151) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 146, 155) =]]
 ```