From ce707826083669e247171b787e20dc135326763d Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Tue, 10 Dec 2024 10:56:58 +0200 Subject: [PATCH] docs: revise integrations page (#10518) --- www/apps/resources/app/integrations/page.mdx | 86 +++++++++++++++----- www/apps/resources/generated/edit-dates.mjs | 2 +- www/apps/resources/generated/sidebar.mjs | 72 ++++++++++------ www/apps/resources/sidebar.mjs | 48 +++++++---- 4 files changed, 145 insertions(+), 63 deletions(-) diff --git a/www/apps/resources/app/integrations/page.mdx b/www/apps/resources/app/integrations/page.mdx index b822b4957f..59f0004c55 100644 --- a/www/apps/resources/app/integrations/page.mdx +++ b/www/apps/resources/app/integrations/page.mdx @@ -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. + + + +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. + + + +--- ## 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. +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. +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. ---- - -## Guides - -The following guides are step-by-step guides on how to integrate Medusa to third-party systems. - - +Learn how to create a payment provider in [this guide](/references/payment/provider). \ No newline at end of file diff --git a/www/apps/resources/generated/edit-dates.mjs b/www/apps/resources/generated/edit-dates.mjs index 260b12b878..2f2accfdf7 100644 --- a/www/apps/resources/generated/edit-dates.mjs +++ b/www/apps/resources/generated/edit-dates.mjs @@ -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", diff --git a/www/apps/resources/generated/sidebar.mjs b/www/apps/resources/generated/sidebar.mjs index e11ea6e753..6491cb9aa5 100644 --- a/www/apps/resources/generated/sidebar.mjs +++ b/www/apps/resources/generated/sidebar.mjs @@ -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": [] - } - ] } ] }, diff --git a/www/apps/resources/sidebar.mjs b/www/apps/resources/sidebar.mjs index 7bb7b67fb8..34466cabac 100644 --- a/www/apps/resources/sidebar.mjs +++ b/www/apps/resources/sidebar.mjs @@ -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", - }, - ], - }, ], }, {