Merge pull request #8485 from magento/sync-2.4.2

Sync 2.4.2-develop

Author: jeff-matthews

src/_data/whats-new.yml

@@ -4,8 +4,17 @@ description: This page contains recent changes that we think you'd like to know
   We exclude from this list proofreading, spelling checks, and all minor updates.
 link: "/whats-new.html"
 thread: "/whatsnew-feed.xml"
-updated: Wed Dec 16 16:19:47 2020
+updated: Mon Jan 4 22:34:52 2021
 entries:
+- description: Added a new topic with instructions for [reverting from a split database
+    to a single database](https://devdocs.magento.com/guides/v2.4/config-guide/revert-split-database.html)
+    implementation.
+  versions: 2.3.x, 2.4.x
+  type: New Topic
+  date: December 21, 2020
+  link: https://github.com/magento/devdocs/pull/8422
+  contributor: jeff-matthews
+  profile: https://github.com/jeff-matthews
 - description: Added an [example](https://devdocs.magento.com/guides/v2.4/javascript-dev-guide/javascript/requirejs.html)
     of overwriting a Knockout JS .html template file in the `requirejs-config.js`
     file.

src/_includes/cloud/enable-ssh.md

@@ -38,34 +38,23 @@ If the directory does not exist or has no SSH key files, you must generate at le
 
 If you have at least one SSH key in your directory, add the key to your Magento and GitHub accounts:
 
--  [Add an SSH key to your GitHub account](https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/)
+-  [Add an SSH key to your GitHub account](https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/) and [test the SSH connection](https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/testing-your-ssh-connection).
 -  [Add your public SSH key to your Magento account](#ssh-add-to-account)
 
-### Test the SSH keys {#test}
-
-After adding the SSH keys, test the SSH connection to GitHub:
-
-1. In the terminal, enter the following command:
-
-   ```bash
-   ssh -T [email protected]
-   ```
-
-1. You may see a warning that the authenticity of the host can't be established followed by an RSA fingerprint. Enter `yes` to continue.
-
-1. If successful, you should receive a success message. If you receive a permission denied error, see [Error: Permission denied (publickey)](https://help.github.com/articles/error-permission-denied-publickey) troubleshooting on GitHub.
-
 ## Add a public SSH key to your Magento account {#ssh-add-to-account}
 
 You can add SSH keys to your account in any of the following ways:
 
 -  Using the [{{site.data.var.ece}} CLI](#add-key-cli)
 -  Using the [{{site.data.var.ece}} Web Interface](#add-key-web)
+-  Using the [{{site.data.var.ece}} Cloud account Dashboard](#add-key-cloud)
+
+After you add a key, you must [redeploy active Cloud environments](#update-cloud-environments-with-a-new-ssh-key) to upload the key.
 
 ### Add your SSH key using the CLI {#add-key-cli}
 
 {:.procedure}
-To add an SSH key using the CLI:
+To add an SSH key using the [Magento Cloud CLI]({{site.baseurl}}/cloud/reference/cli-ref-topic.html):
 
 1. Open a terminal application on your local workstation.
 
@@ -118,8 +107,23 @@ To add an SSH key using the Project Web interface:
 
    -  Follow the prompts on your screen to complete the task.
 
-{:.bs-callout-tip}
-You can view and manage the SSH keys on your account in _Account settings_. In the upper right corner of the Project Web interface, click **your-user-name** > **Account Settings**.
+### Add a key from the Cloud Account dashboard {#add-key-cloud}
+
+You can add your SSH public key directly from the Cloud _Account Settings_ page.
+
+1. Open your [Cloud account page](https://accounts.magento.cloud) and log in if required.
+1. On the Cloud account dashboard, click the **Account Settings** tab.
+1. Under _SSH keys_, click **Add a public key**.
+
+## Update Cloud environments with a new SSH key
+
+After you add an SSH key, redeploy each active Cloud environment to upload the new key.
+
+Use the [Magento Cloud CLI]({{site.baseurl}}/cloud/reference/cli-ref-topic.html) to redeploy the environment:
+
+```bash
+magento-cloud redeploy --project <project-name> --host <host-name> --environment <environment-name>
+```
 
 ## Set global Git variables
 

src/_includes/install/sampledata/sample-data_list-of-modules.md

@@ -21,7 +21,6 @@
 *  magento/module-theme-sample-data
 *  magento/module-widget-sample-data
 *  magento/module-wishlist-sample-data
-*  magento/sample-data
 *  magento/sample-data-media
 
 {{site.data.var.ee}} only:

src/cloud/project/project-webint-basic.md

@@ -98,7 +98,7 @@ To set environment specific variables in the Project Web Interface:
 
    ![Set environment variables]({{ site.baseurl }}/common/images/cloud/cloud_env-var.png)
 
-1. As needed, select options for **JSON value**, **Visible during build**, and **Visible during runtime**. If you do not have Super User access, you may only see the JSON value option.
+1. As needed, select options for **JSON value**, **Enabled**, **Inheritable by child environments** and **Sensitive**. If you do not have Super User access, you may only see the JSON value option.
 1. Click **Add Variable**. After you add the variable, the environment will deploy. Wait until deployment completes before more edits.
 
 {:.bs-callout-warning}

src/common/js/glossary-link-enhancer.js

@@ -1,11 +1,11 @@
-//  When loaded, this script finds all link elements that point to the glossary 
+//  When loaded, this script finds all link elements that point to the glossary
 //  and applies the glossary-term style
 //
 //  TODO: Use this script to add pop up functionality when the following issue
 //  is resolved: https://github.com/magento/glossary/issues/13
 
-document.querySelectorAll("a").forEach(element => {
-  if (element.href.indexOf("glossary.magento.com") > -1) {
-    element.className = "glossary-term";
+document.querySelectorAll('a').forEach(element => {
+  if (element.href.indexOf('glossary.magento.com') > -1) {
+    element.className = 'glossary-term'
   }
-});
+})

src/compliance/privacy/gdpr.md

@@ -10,8 +10,8 @@ The European Union (EU) enacted [General Data Protection Regulation](https://ec.
 
 System integrators can use the data flow diagrams and database information in the Personal Information Reference to build scripts to resolve use cases similar to the following:
 
--  A shopper asks for a copy of the data the merchant has stored about her
--  A shopper requests that all information about him be deleted
+-  A shopper asks for a copy of the data the merchant has stored about them
+-  A shopper requests that all information about them be deleted
 
 ## Personal Information Reference
 

src/guides/v2.3/config-guide/prod/config-reference-var-name.md

@@ -140,7 +140,7 @@ To get these values from the database:
 1. Use the following SQL queries to find the relevant values:
 
    ```shell
-   SELECT * FROM STORES;
+   SELECT * FROM STORE;
    SELECT * FROM STORE_WEBSITE;
    ```
 

src/guides/v2.3/frontend-dev-guide/themes/admin_theme_apply.md

@@ -42,9 +42,9 @@ Each step is described further with more details.
 
 ## Specify the custom Admin theme in `di.xml` {#specify_di}
 
-You need to specify the admin theme to be used in the `<your_module_dir>/etc/adminhtml/di.xml` file. Add it, if the file does not yet exist in your module.
+You need to specify the admin theme to be used in the `<your_module_dir>/etc/di.xml` file. Add it, if the file does not yet exist in your module.
 
-In `<your_module_dir>/etc/adminhtml/di.xml` add the following (replace the placeholders with the vendor name and theme code of your Admin theme):
+In `<your_module_dir>/etc/di.xml` add the following (replace the placeholders with the vendor name and theme code of your Admin theme):
 
 ```xml
 <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">

src/guides/v2.3/graphql/authorization-tokens.md

@@ -43,8 +43,12 @@ You can now use this token in the Authorization request header field for any que
 
 If necessary, you also can [revoke the customer's token]({{ page.baseurl }}/graphql/mutations/revoke-customer-token.html
 
+By default, a customer token is valid for 1 hour. You can change these values from Admin by selecting **Stores** > **Settings** > **Configuration** > **Services** > **OAuth** > **Access Token Expiration** > **Customer Token Lifetime**.
+
 ## Admin tokens
 
 In Magento GraphQL, you specify an admin token only if you need to query products, categories, price rules, or other entities that are scheduled to be in a campaign (staged content). Staging is supported in {{site.data.var.ee}} only. See [Staging queries]({{page.baseurl}}/graphql/queries/index.html#staging) for more information.
 
 Magento does not provide a GraphQL mutation that generates an admin token. You must use the `POST /V1/integration/admin/token` REST endpoint instead. [Generate the admin token]({{page.baseurl}}/rest/tutorials/prerequisite-tasks/create-admin-token.html) shows how to use this endpoint.
+
+By default, an admin token is valid for 4 hours. You can change these values from Admin by selecting **Stores** > **Settings** > **Configuration** > **Services** > **OAuth** > **Access Token Expiration** > **Admin Token Lifetime**.

src/guides/v2.3/graphql/mutations/apply-store-credit.md

@@ -110,3 +110,11 @@ Attribute |  Data Type | Description
 {% include graphql/cart-object.md %}
 
 [Cart query output]({{page.baseurl}}/graphql/queries/cart.html#cart-output) provides more information about the `Cart` object.
+
+## Errors
+
+Error | Description
+--- | ---
+`Could not find a cart with ID \"xxxxx\"` | The ID provided in the `cart_id` field is invalid or the cart does not exist for the customer.
+`The cart isn't active` | The cart with the given cart ID is unavailable, because the items have been purchased and the cart ID becomes inactive.
+`Field ApplyStoreCreditToCartInput.cart_id of required type String! was not provided` | The value specified in the `ApplyStoreCreditToCartInput.cart_id` argument is empty.

src/guides/v2.3/graphql/mutations/create-payflow-pro-token.md

@@ -103,3 +103,14 @@ Attribute |  Data Type | Description
 `result_code` | Int! |  The **RESULT** returned by PayPal. A value of `0` indicates the transaction was approved
 `secure_token` | String! | Secure token generated by PayPal
 `secure_token_id` | String! | Secure token ID generated by PayPal
+
+## Errors
+
+Error | Description
+--- | ---
+`Could not find a cart with ID "XXX"` | The specified `cart_id` value does not exist in the `quote_id_mask` table.
+`Field PayflowProTokenInput.cart_id of required type String! was not provided.` | You must specify the `cart_id` attribute.
+`Field PayflowProTokenInput.urls of required type PayflowProUrlInput! was not provided.` | You must specify the `urls` attribute.
+`Field PayflowProUrlInput.return_url of required type String! was not provided.` | You must specify the `return_url` attribute.
+`Field PayflowProUrlInput.error_url of required type String! was not provided.` | You must specify the `error_url` attribute.
+`Field PayflowProUrlInput.cancel_url of required type String! was not provided.` | You must specify the `cancel_url` attribute.

src/guides/v2.3/graphql/mutations/create-paypal-express-token.md

@@ -112,3 +112,14 @@ Attribute |  Data Type | Description
 --- | --- | ---
 `edit` | String | The PayPal URL that allows the buyer to edit their checkout details
 `start` | String | The URL to the PayPal login page
+
+## Errors
+
+Error | Description
+--- | ---
+`Required parameter "cart_id" is missing` | The mutation does not contain a `cart_id` argument.
+`Could not find a cart with ID "XXX"` | The specified `cart_id` value does not exist in the `quote_id_mask` table.
+`Field PaypalExpressTokenInput.code of required type String! was not provided.` | The required attribute `code` is missing.
+`The requested Payment Method is not available.` | The payment method is not configured.
+`Field PaypalExpressUrlsInput.cancel_url of required type String! was not provided.` | The required attribute `cancel_url` is missing.
+`Field PaypalExpressUrlsInput.return_url of required type String! was not provided.` | The required attribute `return_url` is missing.

src/guides/v2.3/graphql/mutations/redeem-giftcard-balance.md

@@ -79,4 +79,11 @@ Attribute |  Data Type | Description
 --- | --- | ---
 `balance` | Money | The remaining balance of the gift card, including the currency
 `code` | String | The gift card code
-`expiration_date` | String | The date when the gift card expires, if any
+`expiration_date` | String | The date when the gift card expires, if any
+
+## Errors
+
+Error | Description
+--- | ---
+`Gift card not found` | The specified `gift_card_code` value does not exist in the `giftcardaccount` table or the amount has been already redeemed.
+`Field GiftCardAccountInput.gift_card_code of required type String! was not provided` | The value specified in the `GiftCardAccountInput.gift_card_code` argument is empty.

src/guides/v2.3/graphql/queries/cart.md

@@ -790,3 +790,11 @@ Attribute |  Data Type | Description
 *  [setShippingMethodsOnCart mutation]({{page.baseurl}}/graphql/mutations/set-shipping-method.html)
 *  [setBillingAddressOnCart mutation]({{page.baseurl}}/graphql/mutations/set-billing-address.html)
 *  [setPaymentMethodOnCart mutation]({{page.baseurl}}/graphql/mutations/set-payment-method.html)
+
+## Errors
+
+Error | Description
+--- | ---
+`Could not find a cart with ID \"xxxxx\"` | The ID provided in the `cart_id` field is invalid or the cart does not exist for the customer.
+`The cart isn't active` | The cart with the specified cart ID is unavailable, because the items have been purchased and the cart ID becomes inactive.
+`Field cart.cart_id of required type String! was not provided` | The value specified in the `cart.cart_id` argument is empty.

src/guides/v2.3/graphql/queries/get-hosted-pro-url.md

@@ -50,3 +50,11 @@ The query returns the PayPal URL that enables the customer to sign in to PayPal
 Attribute | Data type | Description
 --- | --- | ---
 `secure_form_url` | String | Secure URL generated by PayPal
+
+## Errors
+
+Error | Description
+--- | ---
+`Could not find a cart with ID \"xxxxx\"` | The ID provided in the `cart_id` field is invalid or the cart does not exist for the customer.
+`The cart isn't active` | The cart with the specified cart ID is unavailable, because the items have been purchased and the cart ID becomes inactive.
+`Field HostedProUrlInput.cart_id of required type String! was not provided` | The value specified in the `HostedProUrlInput.cart_id` argument is empty.

src/guides/v2.3/graphql/queries/giftcard-account.md

@@ -69,3 +69,10 @@ Attribute |  Data Type | Description
 `balance` | Money | Returns the currency and remaining balance of the gift card
 `code` | String | Returns the gift card code
 `expiration_date` | String | Returns the date when the gift card expires, if any
+
+## Errors
+
+Error | Description
+--- | ---
+`Gift card not found` | The specified `gift_card_code` value does not exist in the `giftcardaccount` table, or the full amount has already been redeemed.
+`Field GiftCardAccountInput.gift_card_code of required type String! was not provided` | The value specified in the `GiftCardAccountInput.gift_card_code` argument is empty.

src/guides/v2.3/graphql/queries/is-email-available.md

@@ -50,3 +50,10 @@ Attribute |  Data Type | Description
 ## Related topics
 
 [customer query]({{page.baseurl}}/graphql/queries/customer.html)
+
+## Errors
+
+Error | Description
+--- | ---
+`Email is invalid` | The given email-id is not in a proper format.
+`Field isEmailAvailable.email of required type String! was not provided` | The value specified in the `isEmailAvailable.email` argument is empty.

src/guides/v2.3/graphql/queries/url-resolver.md

@@ -134,3 +134,9 @@ Attribute |  Data Type | Description
 ## Related topics
 
 [Products endpoint]({{page.baseurl}}/graphql/queries/products.html)
+
+## Errors
+
+Error | Description
+--- | ---
+`Field urlResolver.url of type String! is required but not provided.` | The value specified in the `urlResolver.url` argument is empty.

src/guides/v2.3/howdoi/checkout/checkout_customize.md

@@ -154,16 +154,47 @@ To disable the component in your `checkout_index_index.xml` use the following in
 
 ## Remove a component {#remove}
 
-To remove a component from layout rendering, you need to create a [plugin]({{ page.baseurl }}/extension-dev-guide/plugins.html) for the `\Magento\Checkout\Block\Checkout\LayoutProcessor::process` method. In your plugin, implement the around method removing the corresponding layout nodes at run-time.
+To keep a component from being rendered, create a layout processor. A layout processor consists of a class, implementing
+the `\Magento\Checkout\Block\Checkout\LayoutProcessorInterface` interface, and thus a `LayoutProcessorInterface::process($jsLayout)` method.
+
+```php
+<?php
+
+namespace <Vendor>\<Module>\Block\Checkout;
+
+use Magento\Checkout\Block\Checkout\LayoutProcessorInterface;
+
+class OurLayoutProcessor implements LayoutProcessorInterface
+{
+    /**
+     * @param array $jsLayout
+     * @return array
+     */
+    public function process($jsLayout)
+    {
+        //%path_to_target_node% is the path to the component's node in checkout_index_index.
+        unset($jsLayout['components']['checkout']['children']['steps'][%path_to_target_node%]);
+        return $jsLayout;
+    }
+}
+```
 
-The following sample is an example of the around method removing a component:
+Once created, add the layout processor through Dependency Injection (DI).
 
-```php?start_inline=1
-unset($jsLayout['components']['checkout']['children']['steps'][%path_to_target_node%]); //%path_to_target_node% is the path to the component's node in checkout_index_index.xml
-return $jsLayout;
+```xml
+<?xml version="1.0"?>
+<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
+    <type name="Magento\Checkout\Block\Onepage">
+        <arguments>
+            <argument name="layoutProcessors" xsi:type="array">
+                <item name="ourLayoutProcessor" xsi:type="object"><Vendor>\<Module>\Block\Checkout\OurLayoutProcessor</item>
+            </argument>
+        </arguments>
+    </type>
+</config>
 ```
 
-If you want to use this sample in your code, replace the `%path_to_target_node%` placeholder with real value.
+To use this sample in your code, replace the `%path_to_target_node%` placeholder with real value.
 
 {:.bs-callout-info}
-Disable vs remove a component: If you disable a component, it is loaded but not rendered. If you remove a component, it is removed and not loaded.
+Disable vs remove a component: A disabled component is loaded but not rendered. If you remove a component, it is removed and not loaded.