docs: revise integrations page (#10518)

This commit is contained in:
Shahed Nasser
2024-12-10 10:56:58 +02:00
committed by GitHub
parent 212b37c2fe
commit ce70782608
4 changed files with 145 additions and 63 deletions
+64 -22
View File
@@ -6,11 +6,55 @@ export const metadata = {
# {metadata.title}
Find in this document Medusa's modules that integrate third-party services and systems.
You can integrate any third-party service to Medusa, including storage services, notification systems, Content-Management Systems (CMS), etc… By integrating third-party services, you build flows and synchronize data around these integrations, making Medusa not only your commerce application, but a middleware layer between your data sources and operations.
Medusa provides integrations out-of-the-box that are listed here, but you can also create your own integrations, such as integrating ERP systems, as explained in [this guide](!docs!/learn/customization/integrate-systems).
## Auth
An Auth Module Provider authenticates users with their account on a third-party service.
<CardList
items={[
{
href: "/commerce-modules/auth/auth-providers/google",
title: "Google",
},
{
href: "/commerce-modules/auth/auth-providers/github",
title: "GitHub",
},
]}
className="mb-1"
/>
Learn how to create a custom third-party authentication provider in [this guide](/references/auth/provider).
---
## CMS
Integrate third-party CMS to utilize rich content-related features.
<CardList
items={[
{
href: "/integrations/guides/sanity",
title: "Sanity",
badge: {
variant: "blue",
children: "Guide"
}
},
]}
className="mb-1"
/>
---
## File
Learn how to create a file provider in [this guide](/references/file-provider-module).
A File Module Provider uploads and manages assets, such as product images, on a third-party service.
<CardList
items={[
@@ -19,28 +63,42 @@ Learn how to create a file provider in [this guide](/references/file-provider-mo
title: "AWS S3 (and Compatible APIs)"
}
]}
className="mb-1"
/>
Learn how to create a custom third-party file or storage provider in [this guide](/references/file-provider-module).
---
## Notification
Learn how to create a notification provider in [this guide](/references/notification-provider-module).
A Notification Module Provider sends messages to users and customers in your Medusa application using a third-party service.
<CardList
items={[
{
href: "/architectural-modules/notification/sendgrid",
title: "SendGrid"
},
{
href: "/integrations/guides/resend",
title: "Resend",
badge: {
variant: "blue",
children: "Guide"
}
}
]}
className="mb-1"
/>
Learn how to create a notification provider in [this guide](/references/notification-provider-module).
---
## Payment
Learn how to create a payment provider in [this guide](/references/payment/provider).
A Payment Module Provider processes payments made in your Medusa store using a third-party service.
<CardList
items={[
@@ -49,23 +107,7 @@ Learn how to create a payment provider in [this guide](/references/payment/provi
title: "Stripe"
}
]}
className="mb-1"
/>
---
## Guides
The following guides are step-by-step guides on how to integrate Medusa to third-party systems.
<CardList
items={[
{
href: "/integrations/guides/sanity",
title: "Sanity"
},
{
href: "/integrations/guides/resend",
title: "Resend"
}
]}
/>
Learn how to create a payment provider in [this guide](/references/payment/provider).
+1 -1
View File
@@ -119,7 +119,7 @@ export const generatedEditDates = {
"app/deployment/medusa-application/railway/page.mdx": "2024-11-11T11:50:10.517Z",
"app/deployment/storefront/vercel/page.mdx": "2024-07-26T07:21:31+00:00",
"app/deployment/page.mdx": "2024-11-25T14:31:45.277Z",
"app/integrations/page.mdx": "2024-11-19T10:09:54.075Z",
"app/integrations/page.mdx": "2024-12-10T08:20:41.203Z",
"app/medusa-cli/page.mdx": "2024-08-28T11:25:32.382Z",
"app/medusa-container-resources/page.mdx": "2024-12-09T16:18:38.852Z",
"app/medusa-workflows-reference/page.mdx": "2024-12-09T16:22:32.129Z",
+48 -24
View File
@@ -7983,6 +7983,46 @@ export const generatedSidebar = [
"title": "Integrations",
"isChildSidebar": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Auth",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/commerce-modules/auth/auth-providers/google",
"title": "Google",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/commerce-modules/auth/auth-providers/github",
"title": "GitHub",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "CMS",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/integrations/guides/sanity",
"title": "Sanity",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
@@ -8012,6 +8052,14 @@ export const generatedSidebar = [
"path": "/architectural-modules/notification/sendgrid",
"title": "SendGrid",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/integrations/guides/resend",
"title": "Resend",
"children": []
}
]
},
@@ -8030,30 +8078,6 @@ export const generatedSidebar = [
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Guides",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/integrations/guides/sanity",
"title": "Sanity",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/integrations/guides/resend",
"title": "Resend",
"children": []
}
]
}
]
},
+32 -16
View File
@@ -1744,6 +1744,33 @@ export const sidebar = sidebarAttachHrefCommonOptions([
title: "Integrations",
isChildSidebar: true,
children: [
{
type: "category",
title: "Auth",
children: [
{
type: "link",
path: "/commerce-modules/auth/auth-providers/google",
title: "Google",
},
{
type: "link",
path: "/commerce-modules/auth/auth-providers/github",
title: "GitHub",
},
],
},
{
type: "category",
title: "CMS",
children: [
{
type: "link",
path: "/integrations/guides/sanity",
title: "Sanity",
},
],
},
{
type: "category",
title: "File",
@@ -1764,6 +1791,11 @@ export const sidebar = sidebarAttachHrefCommonOptions([
path: "/architectural-modules/notification/sendgrid",
title: "SendGrid",
},
{
type: "link",
path: "/integrations/guides/resend",
title: "Resend",
},
],
},
{
@@ -1777,22 +1809,6 @@ export const sidebar = sidebarAttachHrefCommonOptions([
},
],
},
{
type: "category",
title: "Guides",
children: [
{
type: "link",
path: "/integrations/guides/sanity",
title: "Sanity",
},
{
type: "link",
path: "/integrations/guides/resend",
title: "Resend",
},
],
},
],
},
{