Merge branch 'main' into events-develop

package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/AdobeDocs/commerce-extensibility"
   },
   "dependencies": {
-    "@adobe/gatsby-theme-aio": "4.10.7",
+    "@adobe/gatsby-theme-aio": "^4.11.3",
     "gatsby": "4.22.0",
     "react": "^17.0.2",
     "react-dom": "^17.0.2"

src/pages/admin-ui-sdk/extension-points/order/mass-action.md

@@ -34,6 +34,7 @@ order: {
             {
                 actionId: `${extensionId}::another-first-mass-action`,
                 label: 'Another Mass Action',
+                title: 'Another Orders Mass Action',
                 type: `${extensionId}.another-mass-action`,
                 path: '#/another-mass-action'
             }
@@ -50,6 +51,7 @@ order: {
 | `confirm.message` | string | No | The message displayed on the confirmation dialog for a mass action. |
 | `confirm.title` | string | No | The title of a dialog that confirms the mass action. |
 | `label` | string | Yes | An Action label to display in the Mass Actions grid. |
+| `title` | string | No | An optional page title for the action. If not specified, the label is used.
 | `path` | string | Yes | The relative path in the application to redirect to the action. You might need to prepend `#/` to the path to ensure access to the correct page. |
 | `orderSelectLimit` | integer | No | Set the maximum number of orders that can be selected for a mass action. By default, the number is unlimited. |
 | `type` | string | Yes | A unique ID that identifies the type of action. |

src/pages/admin-ui-sdk/extension-points/order/view-button.md

@@ -45,8 +45,9 @@ order: {
 | Field | Type | Required | Description |
 | --- | --- | --- | --- |
 | `buttonId` | string | Yes | A unique ID to identify the button. We recommend using the format `<extensionId>::<buttonName>`. |
-| `label` | string | No | The label of the button. |
+| `label` | string | Yes | The label of the button. |
 | `confirm.message` | string | No | Confirmation message to display. |
 | `path` | string | Yes | The relative path to the button page in the App. The order ID will be sent as part of the query. |
-| `level` | integer | Yes |  The position in which a set of buttons are placed in the toolbar. The possible values are `-1` (left), `0` (center), and `1` (right). |
+| `level` | integer | No |  The position in which a set of buttons are placed in the toolbar. The possible values are `-1` (left), `0` (center), and `1` (right). |
 | `sortOrder` | integer | No | The order in which the button is placed inside the level. |
+| `class` | string | Yes  | The class of the button. Possible values are `save`, `edit`, `reset`, and `custom`. |

src/pages/admin-ui-sdk/extension-points/product/mass-action.md

@@ -35,6 +35,7 @@ product: {
                 actionId: `${extensionId}::another-first-mass-action`,
                 label: 'Another Mass Action',
                 type: `${extensionId}.another-mass-action`,
+                title: 'Another Products Mass Action',
                 path: '#/another-mass-action'
             }
         ]
@@ -50,6 +51,7 @@ product: {
 | `confirm.message` | string | No | The message displayed on the confirmation dialog for a mass action |
 | `confirm.title` | string | No | The title of a dialog that confirms the mass action |
 | `label` | string | Yes | An Action label to display in the Mass Actions grid |
+| `title` | string | No | An optional page title for the action. If not specified, the label is used. |
 | `path` | string | Yes | The relative path in the application to redirect to the action. You might need to prepend `#/` to the path to ensure access to the correct page. |
 | `productSelectLimit` | integer | No | Set the maximum number products that can be selected for a mass action. By default, the number is unlimited. |
 | `type` | string | Yes | A unique ID that identifies the type of the action. |

src/pages/admin-ui-sdk/release-notes.md

@@ -8,6 +8,26 @@ keywords:
 
 # Adobe Commerce Admin UI SDK release notes
 
+## Version 1.3.1
+
+### Release date
+
+January 25, 2024
+
+### Enhancements
+
+* Enhanced unit coverage by 150%. <!-- CEXT-2345, CEXT-2425, CEXT-2593, CEXT-2596, CEXT-2600, CEXT-2601, CEXT-2602, CEXT-2603, CEXT-2604 -->
+
+* Added the ability to optionally specify a page title for a mass action. <!-- CEXT-2598 -->
+
+* The Admin UI SDK cache is now flushed weekly instead of every 12 hours. <!-- CEXT-2643 -->
+
+* The Admin UI SDK now supports PHP 8.3. <!-- CEXT-2724 -->
+
+### Bug fixes
+
+* The Admin now displays extensions correctly when they are loaded from the extension manager registry. <!-- CEXT-2595 -->
+
 ## Version 1.3.0
 
 ### Release date

src/pages/events/configure-commerce.md

@@ -145,6 +145,10 @@ stage:
       consumers: []
 ```
 
+<InlineAlert variant="warning" slots="text" />
+
+The deployment process might become stuck if the consumer runs in the background. The [Troubleshooting](./troubleshooting.md#stuck-deployment-after-configuring-priority-events) topic describes how to resolve this condition.
+
 See [Global variables](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/configure/env/stage/variables-global.html) for more information about the `ENABLE_EVENTING` variable.
 
 Cloud infrastructure and on-premises instances require different cron management procedures as described here:

src/pages/events/troubleshooting.md

@@ -112,3 +112,37 @@ bin/magento events:metadata:populate
 ```
 
 After refreshing the page with your App Builder project, you should be able to find the provider.
+
+## Stuck deployment after configuring priority events
+
+The deployment process can get stuck in some cases in the Cloud environment when consumers are running in the background. To resolve the issue, you must `ssh` into your environment and manually kill the consumer process.
+
+1. Use SSH to log in to the remote environment.
+
+   ```bash
+   magento-cloud ssh
+   ```
+
+1. Find the consumer processes.
+
+   ```bash
+   ps aux | grep consumer
+   ```
+
+   The response lists the running consumers.
+
+   ```terminal
+   web          980  2.4  0.0 232176 163012 ?       S    22:22   0:00 /usr/bin/php8.1-zts /app/bin/magento queue:consumers:start commerce.eventing.event.publish
+   ```
+
+1. Use one of the following commands to kill the consumer:
+
+   ```bash
+   kill -9 <PROCESS_ID>
+   ```
+
+   ```bash
+   vendor/bin/ece-tools cron:kill
+   ```
+
+By default, the consumer will restart within one minute, but this value may vary, based on your [cron configuration](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/configure/app/properties/crons-property.html) or whether you have set up a [worker](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/configure/app/properties/workers-property.html).