magento/devdocs#7367: Added the article "addProductsToCart mutation"

[andrewbess]

Purpose of this pull request

This pull request (PR) provides a new article for AddProductsToCart single mutation.
Also, this PR adds deprecation notices to the single-product type mutations

Affected DevDocs pages

• addBundleProductsToCart mutation
• addConfigurableProductsToCart mutation
• addDownloadableProductsToCart mutation
• addSimpleProductsToCart mutation
• addVirtualProductsToCart mutation

Related Issues (if relevant)

1. GraphQL: Document addProductsToCart mutation #7367: GraphQL: Document addProductsToCart mutation

whatsnew
Added information about the addProductsToCart mutation to add any type of product to the active cart. We recommend using this mutation instead of single-purpose mutations such as addSimpleProductsToCart.

[devops-devdocs]

An admin must run tests on this PR before it can be merged.

[dmytro-ch]

@andrewbess, thank you for your contribution!
Could you please apply the following minor CR recommendations from my side?

Thank you!

[andrewbess]

Hello @dmytro-ch.
Thank you for your review.
I fixed all the proposed changes.
The commit has been squashed.
Please recheck.

Thank you in advance.

[dmytro-ch]

From a technical perspective, the changes look good to me. ✔️
Thank you!

[rogyar]

I would say UID of selected_option and entered_option. The option itself is not an identifier

[rogyar]

Hi @andrewbess. Thanks for the great work. Please, check my notices above.

[keharper]

@andrewbess

I reorganized the content of add-products-to-cart.md so that selected and entered options are discussed toward the beginning.

I would like to know more about the selected option example. Is this way more efficient than the traditional way of adding a configurable product by specifying a parent SKU like WSH12 and a child SKU like WSH12-29-Green?

Do we need to specify how to find uid values?

The entered-option-input.md file was created in another PR that was merged after you submitted this PR. I changed the contents so that they'll match exactly, avoiding a merge conflict.

[andrewbess]

Hello @rogyar.
I have a question about your remark here
I am not sure, but I think my proposition is correct.
The "Syntax" is different for all already created topics about mutations.
Please take a look at:

• https://devdocs.magento.com/guides/v2.4/graphql/mutations/add-bundle-products.html
• https://devdocs.magento.com/guides/v2.4/graphql/mutations/add-downloadable-products.html

I think my proposed syntax will be more understandable for all developers (juniors, middles, etc.)
How do you think about it?

Also, I want to fix it for all mutation topics, if you'll approve my proposition.

Thank you in advance.

cc @keharper @dmytro-ch

[rogyar]

Hi @andrewbess that makes sense, thank you for the clarification.

[andrewbess]

Hello @keharper
I think it has no advantage to using UIDs when adding a configurable product to a cart. It just extends the add to cart functionality provides another one way for it.

[keharper]

running tests

[ghost]

Hi @andrewbess, thank you for your contribution!
Please, complete Contribution Survey, it will take less than a minute.
Your feedback will help us to improve contribution process.