magento/devdocs#7366: GraphQl. subscribeEmailToNewsletter. Mutation for subscribe feature.

[atwixfirster]

Purpose of this pull request

This pull request (PR) adds a new topic subscribeEmailToNewsletter mutation requested in #7366.

Affected DevDocs pages

• https://devdocs.magento.com/guides/v2.4/graphql/mutations/subscribe-email-to-newsletter.html

Links to Magento source code

• magento/magento2#27337: GraphQl. Add a mutation for subscribe feature magento2#27586
• magento/architecture#: GraphQl. Add a mutation for subscribe feature architecture#367

whatsnew
Added the subscribeEmailToNewsletter mutation to the GraphQL Developer Guide.

[devops-devdocs]

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

[rogyar]

Suggested change

	Mutation contains a required `email` argument specified an email address which should be added into a newsletter subscription.
	Mutation contains a required `email` parameter that specifies an email address that should be added into a newsletter subscription.

[atwixfirster]

implemented

[rogyar]

To be precise, the SubscriptionStatusesEnum is not an "object" but a "set of possible states"

I would suggest the following

Suggested change

	In general, the `SubscriptionStatusesEnum` object can return one of the following values:
	The `SubscriptionStatusesEnum` is a predefined set of possible subscription statuses

[atwixfirster]

implemented

[rogyar]

Suggested change

	For the `subscribeEmailToNewsletter` mutation the `SubscriptionStatusesEnum` object may return only 2 of them:
	The `subscribeEmailToNewsletter` mutation for the `status` field may return only the following statuses:

[rogyar]

A minor adjustment just to mention that SubscriptionStatusesEnum cannot physically return anything since it's like an array.

[atwixfirster]

Yep.

implemented

[atwixfirster]

@rogyar , all your suggestions have been implemented. Could you please review?

Thank you!

[keharper]

Mention that Magento must be configured to allow guests to subscribe.

I think it might be worthwhile to mention the Store request header.

Check whether my rewrite of the UNCONFIRMED enum description is correct.

[keharper]

@atwixfirster I'm pinging you to make sure you're aware that I requested some updates to to #7422

[atwixfirster]

@keharper

Mention that Magento must be configured to allow guests to subscribe.

By default, Magento allows a newsletter subscription for quests.

Reference to source: https://github.com/magento/magento2/blob/2.4-develop/app/code/Magento/Newsletter/etc/config.xml#L15

Check whether my rewrite of the UNCONFIRMED enum description is correct.

approved :)

Thank you so much for your grammatical fixes.

[keharper]

running tests

[ghost]

Hi @atwixfirster, 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.