Merge pull request #2737 from magento-devdocs/db_pwa_gql

PWA-2188 Adding PWA GQL topic

Author: bdenham

src/_data/toc/graphql.yml

@@ -318,6 +318,11 @@ pages:
           edition: ee-only
           exclude_versions: ["2.3"]
 
+        - label: contactUs mutation
+          url: /graphql/mutations/contact-us.html
+          edition: pwa-only
+          exclude_versions: ["2.3"]
+
         - label: createBraintreeClientToken mutation
           url: /graphql/mutations/create-braintree-client-token.html
 

src/_data/var.yml

@@ -17,6 +17,7 @@ ce: Magento Open Source
 ee: Adobe Commerce
 b2b: B2B for Adobe Commerce
 mbi: Adobe Commerce Reporting
+pwa: PWA Studio
 
 # Cloud product name variables
 

src/_includes/graphql/store-config.md

@@ -26,6 +26,7 @@ Attribute | Data Type | Description | Default or example value
 `cms_no_route` | String | Identifies a specific CMS page that you want to appear when a 404 “Page Not Found” error occurs | `no-route`
 `code` | String | Deprecated. Use `store_code` instead. A unique identifier for the store | `default`
 `configurable_thumbnail_source` | String | Determines which thumbnail should be used in the cart for configurable products. Possible values: `parent` or `itself` (child) | `parent`
+`contact_enabled` | Boolean! | Indicates whether the Contact Us form is enabled | true or false
 `copyright` | String | The copyright statement that appears at the bottom of each page | Copyright © 2013-present Magento, Inc. All rights reserved.
 `default_description` | String | The description that provides a summary of your site for search engine listings and should not be more than 160 characters in length | null
 `default_display_currency_code` | String | The code representing the currency displayed on the store | `USD`
@@ -67,6 +68,7 @@ Attribute | Data Type | Description | Default or example value
 `magento_wishlist_general_is_enabled` | String | Indicates whether wish lists are enabled (1) or disabled (0) | 1
 `maximum_number_of_wishlists` | String | If multiple wish lists are enabled, the maximum number of wish lists the customer can have | 5
 `minimum_password_length` | String | The minimum number of characters required for a valid password. <br/>Configuration path: customer/password/minimum_password_length | 6
+`newsletter_enabled` | Boolean! | Indicates whether newsletters are enabled | true or false
 `no_route` | String | Contains the URL of the default page that you want to appear when if a 404 “Page not Found” error occurs | `cms/noroute/index`
 `payment_payflowpro_cc_vault_active` | String | Payflow Pro vault status | `0` (inactive) or `1` (active)
 `printed_card_price` | String | The default price of a printed card that accompanies an order | 10

src/guides/v2.4/graphql/mutations/contact-us.md

@@ -0,0 +1,66 @@
+---
+group: graphql
+title: contactUs mutation
+pwa_only: true
+---
+
+The `contactUs` mutation submits the contents of the Contact Us form.
+
+## Syntax
+
+ `mutation: contactUs(input: ContacUsInput!): ContactUsOutput`
+
+## Example usage
+
+The following example adds a Contact Us form to the site.
+
+**Request:**
+
+```graphql
+mutation {
+  contactUs(
+    input: {
+      comment: "My comment",
+      email: "bobloblaw@example.com",
+      telephone: "(555)-CALL-BOB",
+      name: "Bob Loblaw" }
+      ) {
+    status
+  }
+}
+```
+
+**Response:**
+
+```json
+{
+  "data": {
+    "contactUs": {
+      "status": true
+    }
+  }
+}
+```
+
+## Input attributes
+
+The `contactUs` mutation requires the  `contactUsInput` object.
+
+### contactUsInput object {#contactUsInput}
+
+The `contactUsInput` object must contain the following attributes:
+
+Attribute | Data Type | Description
+--- | --- | ---
+`email` | String! | The email address of the shopper
+`name` | String! | The full name of the shopper
+`telephone` | String | The shopper's telephone number
+`comment` | String! | The shopper's comment to the merchant
+
+## Output attributes
+
+The `contactUsOutput` object returns a Boolean value indicting the success or failure of the request.
+
+Attribute |  Data Type | Description
+--- | --- | ---
+`status` | Boolean! | Indicates whether the request was successful