@graphcommerce/docs 7.1.0-canary.39 → 7.1.0-canary.42
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1 -1
- package/framework/config.md +64 -48
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
package/framework/config.md
CHANGED
|
@@ -77,7 +77,7 @@ Below is a list of all possible configurations that can be set by GraphCommerce.
|
|
|
77
77
|
|
|
78
78
|
### GraphCommerceConfig
|
|
79
79
|
|
|
80
|
-
####
|
|
80
|
+
#### canonicalBaseUrl: string (required)
|
|
81
81
|
|
|
82
82
|
The canonical base URL is used for SEO purposes.
|
|
83
83
|
|
|
@@ -86,7 +86,7 @@ Examples:
|
|
|
86
86
|
- https://example.com/en
|
|
87
87
|
- https://example.com/en-US
|
|
88
88
|
|
|
89
|
-
####
|
|
89
|
+
#### hygraphEndpoint: string (required)
|
|
90
90
|
|
|
91
91
|
The HyGraph endpoint.
|
|
92
92
|
|
|
@@ -94,33 +94,33 @@ The HyGraph endpoint.
|
|
|
94
94
|
|
|
95
95
|
Project settings -> API Access -> High Performance Read-only Content API
|
|
96
96
|
|
|
97
|
-
####
|
|
97
|
+
#### magentoEndpoint: string (required)
|
|
98
98
|
|
|
99
99
|
GraphQL Magento endpoint.
|
|
100
100
|
|
|
101
101
|
Examples:
|
|
102
102
|
- https://magento2.test/graphql
|
|
103
103
|
|
|
104
|
-
####
|
|
104
|
+
#### storefront: [GraphCommerceStorefrontConfig](#GraphCommerceStorefrontConfig)[] (required)
|
|
105
105
|
|
|
106
106
|
All storefront configuration for the project
|
|
107
107
|
|
|
108
|
-
####
|
|
108
|
+
#### cartDisplayPricesInclTax: boolean
|
|
109
109
|
|
|
110
110
|
Due to a limitation of the GraphQL API it is not possible to determine if a cart should be displayed including or excluding tax.
|
|
111
111
|
|
|
112
112
|
When Magento's StoreConfig adds this value, this can be replaced.
|
|
113
113
|
|
|
114
|
-
####
|
|
114
|
+
#### compare: boolean
|
|
115
115
|
|
|
116
116
|
Use compare functionality
|
|
117
117
|
|
|
118
|
-
####
|
|
118
|
+
#### compareVariant: 'CHECKBOX' | 'ICON' = 'ICON'
|
|
119
119
|
|
|
120
120
|
By default the compare feature is denoted with a 'compare ICON' (2 arrows facing one another).
|
|
121
121
|
This may be fine for experienced users, but for more clarity it's also possible to present the compare feature as a CHECKBOX accompanied by the 'Compare' label
|
|
122
122
|
|
|
123
|
-
####
|
|
123
|
+
#### configurableVariantForSimple: boolean = false
|
|
124
124
|
|
|
125
125
|
If a simple product is part of a Configurable product page, should the simple product be
|
|
126
126
|
rendered as a configured option of the configurable product page?
|
|
@@ -133,25 +133,25 @@ Magento also returns the Simple product and the Configurable product the simple
|
|
|
133
133
|
If that is the case we render the configurable product page instead of the simple product page but
|
|
134
134
|
the options to select the simple product are pre-selected.
|
|
135
135
|
|
|
136
|
-
####
|
|
136
|
+
#### configurableVariantValues: [MagentoConfigurableVariantValues](#MagentoConfigurableVariantValues) = { content: true, url: true }
|
|
137
137
|
|
|
138
138
|
When a user selects a variant, it will switch the values on the configurable page with the values of the configured variant.
|
|
139
139
|
|
|
140
140
|
Enabling options here will allow switching of those variants.
|
|
141
141
|
|
|
142
|
-
####
|
|
142
|
+
#### crossSellsHideCartItems: boolean = false
|
|
143
143
|
|
|
144
144
|
Determines if cross sell items should be shown when the user already has the product in their cart. This will result in a product will popping off the screen when you add it to the cart.
|
|
145
145
|
|
|
146
146
|
Default: 'false'
|
|
147
147
|
|
|
148
|
-
####
|
|
148
|
+
#### crossSellsRedirectItems: boolean = false
|
|
149
149
|
|
|
150
150
|
Determines if, after adding a cross-sell item to the cart, the user should be redirected to the cross-sell items of the product they just added.
|
|
151
151
|
|
|
152
152
|
Default: 'false'
|
|
153
153
|
|
|
154
|
-
####
|
|
154
|
+
#### customerRequireEmailConfirmation: boolean
|
|
155
155
|
|
|
156
156
|
Due to a limitation in the GraphQL API of Magento 2, we need to know if the
|
|
157
157
|
customer requires email confirmation.
|
|
@@ -159,11 +159,11 @@ customer requires email confirmation.
|
|
|
159
159
|
This value should match Magento 2's configuration value for
|
|
160
160
|
`customer/create_account/confirm` and should be removed once we can query
|
|
161
161
|
|
|
162
|
-
####
|
|
162
|
+
#### debug: [GraphCommerceDebugConfig](#GraphCommerceDebugConfig)
|
|
163
163
|
|
|
164
164
|
Debug configuration for GraphCommerce
|
|
165
165
|
|
|
166
|
-
####
|
|
166
|
+
#### demoMode: boolean = true
|
|
167
167
|
|
|
168
168
|
Enables some demo specific code that is probably not useful for a project:
|
|
169
169
|
|
|
@@ -171,7 +171,7 @@ Enables some demo specific code that is probably not useful for a project:
|
|
|
171
171
|
- Adds "dominant_color" attribute swatches to the product list items.
|
|
172
172
|
- Creates a big list items in the product list.
|
|
173
173
|
|
|
174
|
-
####
|
|
174
|
+
#### googleAnalyticsId: string
|
|
175
175
|
|
|
176
176
|
See https://support.google.com/analytics/answer/9539598?hl=en
|
|
177
177
|
|
|
@@ -179,7 +179,7 @@ Provide a value to enable Google Analytics for your store.
|
|
|
179
179
|
|
|
180
180
|
To override the value for a specific locale, configure in i18n config.
|
|
181
181
|
|
|
182
|
-
####
|
|
182
|
+
#### googleRecaptchaKey: string
|
|
183
183
|
|
|
184
184
|
Google reCAPTCHA site key.
|
|
185
185
|
When using reCAPTCHA, this value is required, even if you are configuring different values for each locale.
|
|
@@ -189,17 +189,17 @@ Get a site key and a secret key from https://developers.google.com/recaptcha/doc
|
|
|
189
189
|
The secret key should be added in the Magento admin panel (Stores > Configuration > Security > Google ReCAPTCHA Storefront > reCAPTCHA v3 Invisible)
|
|
190
190
|
ReCAPTCHA can then be enabled/disabled for the different forms, separately (Stores > Configuration > Security > Google ReCAPTCHA Storefront > Storefront)
|
|
191
191
|
|
|
192
|
-
####
|
|
192
|
+
#### googleTagmanagerId: string
|
|
193
193
|
|
|
194
194
|
The Google Tagmanager ID to be used on the site.
|
|
195
195
|
|
|
196
196
|
This value is required even if you are configuring different values for each locale.
|
|
197
197
|
|
|
198
|
-
####
|
|
198
|
+
#### hygraphProjectId: string
|
|
199
199
|
|
|
200
200
|
Hygraph Project ID. **Only used for migrations.**
|
|
201
201
|
|
|
202
|
-
####
|
|
202
|
+
#### hygraphWriteAccessEndpoint: string
|
|
203
203
|
|
|
204
204
|
Content API. **Only used for migrations.**
|
|
205
205
|
|
|
@@ -207,7 +207,7 @@ Content API. **Only used for migrations.**
|
|
|
207
207
|
|
|
208
208
|
Project settings -> API Access -> Content API
|
|
209
209
|
|
|
210
|
-
####
|
|
210
|
+
#### hygraphWriteAccessToken: string
|
|
211
211
|
|
|
212
212
|
Hygraph Management SDK Authorization Token. **Only used for migrations.**
|
|
213
213
|
|
|
@@ -239,7 +239,7 @@ GC_HYGRAPH_WRITE_ACCESS_TOKEN="AccessTokenFromHygraph"
|
|
|
239
239
|
yarn graphcommerce hygraph-migrate
|
|
240
240
|
```
|
|
241
241
|
|
|
242
|
-
####
|
|
242
|
+
#### legacyProductRoute: boolean
|
|
243
243
|
|
|
244
244
|
On older versions of GraphCommerce products would use a product type specific route.
|
|
245
245
|
|
|
@@ -247,45 +247,49 @@ This should only be set to true if you use the /product/[url] AND /product/confi
|
|
|
247
247
|
|
|
248
248
|
@deprecated Will be removed in a future version. [migration](../upgrading/graphcommerce-5-to-6.md#product-routing-changes)
|
|
249
249
|
|
|
250
|
-
####
|
|
250
|
+
#### limitSsg: boolean
|
|
251
251
|
|
|
252
252
|
Limit the static generation of SSG when building
|
|
253
253
|
|
|
254
|
-
####
|
|
254
|
+
#### previewSecret: string
|
|
255
255
|
|
|
256
256
|
To enable next.js' preview mode, configure the secret you'd like to use.
|
|
257
257
|
|
|
258
|
-
####
|
|
258
|
+
#### productFiltersLayout: 'DEFAULT' | 'SIDEBAR' = 'DEFAULT'
|
|
259
259
|
|
|
260
260
|
Layout how the filters are rendered.
|
|
261
261
|
DEFAULT: Will be rendered as horzontal chips on desktop and mobile
|
|
262
262
|
SIDEBAR: Will be rendered as a sidebar on desktop and horizontal chips on mobile
|
|
263
263
|
|
|
264
|
-
####
|
|
264
|
+
#### productFiltersPro: boolean
|
|
265
265
|
|
|
266
266
|
Product filters with better UI for mobile and desktop.
|
|
267
267
|
|
|
268
|
-
####
|
|
268
|
+
#### productRoute: string
|
|
269
269
|
|
|
270
270
|
By default we route products to /p/[url] but you can change this to /product/[url] if you wish.
|
|
271
271
|
|
|
272
272
|
Default: '/p/'
|
|
273
273
|
Example: '/product/'
|
|
274
274
|
|
|
275
|
-
####
|
|
275
|
+
#### recentlyViewedProducts: [RecentlyViewedProductsConfig](#RecentlyViewedProductsConfig)
|
|
276
|
+
|
|
277
|
+
Settings for recently viewed products
|
|
278
|
+
|
|
279
|
+
#### robotsAllow: boolean
|
|
276
280
|
|
|
277
281
|
Allow the site to be indexed by search engines.
|
|
278
282
|
If false, the robots.txt file will be set to disallow all.
|
|
279
283
|
|
|
280
|
-
####
|
|
284
|
+
#### sidebarGallery: [SidebarGalleryConfig](#SidebarGalleryConfig)
|
|
281
285
|
|
|
282
286
|
Configuration for the SidebarGallery component
|
|
283
287
|
|
|
284
|
-
####
|
|
288
|
+
#### wishlistHideForGuests: boolean
|
|
285
289
|
|
|
286
290
|
Hide the wishlist functionality for guests.
|
|
287
291
|
|
|
288
|
-
####
|
|
292
|
+
#### wishlistShowFeedbackMessage: boolean
|
|
289
293
|
|
|
290
294
|
Show a message when the product is added to the wishlist.
|
|
291
295
|
|
|
@@ -293,18 +297,18 @@ Show a message when the product is added to the wishlist.
|
|
|
293
297
|
|
|
294
298
|
Debug configuration for GraphCommerce
|
|
295
299
|
|
|
296
|
-
####
|
|
300
|
+
#### pluginStatus: boolean
|
|
297
301
|
|
|
298
302
|
Reports which plugins are enabled or disabled.
|
|
299
303
|
|
|
300
|
-
####
|
|
304
|
+
#### webpackCircularDependencyPlugin: boolean
|
|
301
305
|
|
|
302
306
|
Cyclic dependencies can cause memory issues and other strange bugs.
|
|
303
307
|
This plugin will warn you when it detects a cyclic dependency.
|
|
304
308
|
|
|
305
309
|
When running into memory issues, it can be useful to enable this plugin.
|
|
306
310
|
|
|
307
|
-
####
|
|
311
|
+
#### webpackDuplicatesPlugin: boolean
|
|
308
312
|
|
|
309
313
|
When updating packages it can happen that the same package is included with different versions in the same project.
|
|
310
314
|
|
|
@@ -316,11 +320,11 @@ Issues that this can cause are:
|
|
|
316
320
|
|
|
317
321
|
All storefront configuration for the project
|
|
318
322
|
|
|
319
|
-
####
|
|
323
|
+
#### locale: string (required)
|
|
320
324
|
|
|
321
325
|
Must be a locale string https://www.unicode.org/reports/tr35/tr35-59/tr35.html#Identifiers
|
|
322
326
|
|
|
323
|
-
####
|
|
327
|
+
#### magentoStoreCode: string (required)
|
|
324
328
|
|
|
325
329
|
Magento store code.
|
|
326
330
|
|
|
@@ -331,7 +335,7 @@ Examples:
|
|
|
331
335
|
- en-us
|
|
332
336
|
- b2b-us
|
|
333
337
|
|
|
334
|
-
####
|
|
338
|
+
#### canonicalBaseUrl: string
|
|
335
339
|
|
|
336
340
|
The canonical base URL is used for SEO purposes.
|
|
337
341
|
|
|
@@ -340,39 +344,39 @@ Examples:
|
|
|
340
344
|
- https://example.com/en
|
|
341
345
|
- https://example.com/en-US
|
|
342
346
|
|
|
343
|
-
####
|
|
347
|
+
#### cartDisplayPricesInclTax: boolean
|
|
344
348
|
|
|
345
349
|
Due to a limitation of the GraphQL API it is not possible to determine if a cart should be displayed including or excluding tax.
|
|
346
350
|
|
|
347
|
-
####
|
|
351
|
+
#### defaultLocale: boolean
|
|
348
352
|
|
|
349
353
|
There can only be one entry with defaultLocale set to true.
|
|
350
354
|
- If there are more, the first one is used.
|
|
351
355
|
- If there is none, the first entry is used.
|
|
352
356
|
|
|
353
|
-
####
|
|
357
|
+
#### domain: string
|
|
354
358
|
|
|
355
359
|
Domain configuration, must be a domain https://tools.ietf.org/html/rfc3986
|
|
356
360
|
|
|
357
|
-
####
|
|
361
|
+
#### googleAnalyticsId: string
|
|
358
362
|
|
|
359
363
|
Configure different Google Analytics IDs for different locales.
|
|
360
364
|
|
|
361
365
|
To disable for a specific locale, set the value to null.
|
|
362
366
|
|
|
363
|
-
####
|
|
367
|
+
#### googleRecaptchaKey: string
|
|
364
368
|
|
|
365
369
|
Locale specific google reCAPTCHA key.
|
|
366
370
|
|
|
367
|
-
####
|
|
371
|
+
#### googleTagmanagerId: string
|
|
368
372
|
|
|
369
373
|
The Google Tagmanager ID to be used per locale.
|
|
370
374
|
|
|
371
|
-
####
|
|
375
|
+
#### hygraphLocales: string[]
|
|
372
376
|
|
|
373
377
|
Add a gcms-locales header to make sure queries return in a certain language, can be an array to define fallbacks.
|
|
374
378
|
|
|
375
|
-
####
|
|
379
|
+
#### linguiLocale: string
|
|
376
380
|
|
|
377
381
|
Specify a custom locale for to load translations.
|
|
378
382
|
|
|
@@ -380,25 +384,37 @@ Specify a custom locale for to load translations.
|
|
|
380
384
|
|
|
381
385
|
Options to configure which values will be replaced when a variant is selected on the product page.
|
|
382
386
|
|
|
383
|
-
####
|
|
387
|
+
#### content: boolean
|
|
384
388
|
|
|
385
389
|
Use the name, description, short description and meta data from the configured variant
|
|
386
390
|
|
|
387
|
-
####
|
|
391
|
+
#### gallery: boolean
|
|
388
392
|
|
|
389
393
|
This option enables the automatic update of product gallery images on the product page when a variant is selected,
|
|
390
394
|
provided that the gallery images for the selected variant differ from the currently displayed images.
|
|
391
395
|
|
|
392
|
-
####
|
|
396
|
+
#### url: boolean
|
|
393
397
|
|
|
394
398
|
When a variant is selected the URL of the product will be changed in the address bar.
|
|
395
399
|
|
|
396
400
|
This only happens when the actual variant is can be accessed by the URL.
|
|
397
401
|
|
|
402
|
+
### RecentlyViewedProductsConfig
|
|
403
|
+
|
|
404
|
+
Settings for recently viewed products
|
|
405
|
+
|
|
406
|
+
#### enabled: boolean
|
|
407
|
+
|
|
408
|
+
Enable/disable recently viewed products
|
|
409
|
+
|
|
410
|
+
#### maxCount: number
|
|
411
|
+
|
|
412
|
+
Number of recently viewed products to be stored in localStorage
|
|
413
|
+
|
|
398
414
|
### SidebarGalleryConfig
|
|
399
415
|
|
|
400
416
|
SidebarGalleryConfig will contain all configuration values for the Sidebar Gallery component.
|
|
401
417
|
|
|
402
|
-
####
|
|
418
|
+
#### paginationVariant: 'DOTS' | 'THUMBNAILS_BOTTOM'
|
|
403
419
|
|
|
404
420
|
Variant used for the pagination
|
package/package.json
CHANGED
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
"name": "@graphcommerce/docs",
|
|
3
3
|
"homepage": "https://www.graphcommerce.org/docs",
|
|
4
4
|
"repository": "github:graphcommerce-org/graphcommerce/docs",
|
|
5
|
-
"version": "7.1.0-canary.
|
|
5
|
+
"version": "7.1.0-canary.42",
|
|
6
6
|
"sideEffects": true,
|
|
7
7
|
"peerDependencies": {
|
|
8
|
-
"@graphcommerce/prettier-config-pwa": "7.1.0-canary.
|
|
8
|
+
"@graphcommerce/prettier-config-pwa": "7.1.0-canary.42"
|
|
9
9
|
},
|
|
10
10
|
"prettier": "@graphcommerce/prettier-config-pwa"
|
|
11
11
|
}
|