Magento
To integrate with Magento, most of the functionality should work out-of-the box if Magento exposes a working GraphQL API.
Magento configuration
Configure Base Link Url to get emails working
Configure the Base Link Url's to match your GraphCommerce frontend URL per
storeview with the locale included. e.g. https://graphcommerce.vercel.app/nl/
Unsecure:
Stores -> Configuration -> General -> Web -> Base URLs -> Base Link Url
Secure:
Stores -> Configuration -> General -> Web -> Base URLs (secure) -> Base Link Url
Configure Base Link Url with 'Add Store Code to Urls' enabled:
If you are including the store code in the URL you can configure the above on the website scope without the locale added.
To properly redirect to the actual URL used in the fontend add redirects to next.config.js:
/** @type {import('next').NextConfig} */
const config = {
async redirects() {
return [
{ source: '/b2b_nl/:path*', destination: '/nl/:path*', permanent: false },
{ source: '/b2b_en/:path*', destination: '/en/:path*', permanent: false },
]
},
}
Configure the address lines to fix the checkout
Set the number of address lines to 3. (default is 2)
For Magento Open Source:
Stores -> Configuration -> Customers -> Customer Configuration -> Name and address options
For Adobe Commerce:
Stores -> Attributes -> Customer Address -> street -> Lines Count
Remove URL suffixes from products and categorories (optional)
GraphCommerce does not support URL suffixes, because Next.js can not handle urls
ending in .html. When migrating from an existing shop, GraphCommerce will
automatically redirect to the suffix-less URL. However, GraphCommerce will need
to do an additional query to Magento to find the route.
If you are starting out from a new project, we recommend to remove the URL suffixes from products and categories.
Remove the URL suffixes from products and categories. (default is .html)
Stores -> Configuration -> Catalog -> Catalog -> Search Engine Optimization -> Product URL Suffix
Stores -> Configuration -> Catalog -> Catalog -> Search Engine Optimization -> Category URL Suffix
Enable guest checkout login
During customer login, GraphCommerce queries Magento to determine whether the
customer account already exists. To do this the following setting must be set to
Yes:
Stores -> Configuration -> Sales -> Checkout -> Checkout Options -> Enable Guest Checkout Login
If this is not set correctly, customers will not be able to log in, since they will always be prompted to create a new account.