Add integrations, cleanup

shopware · May 4, 2023 · dd6e6ff · dd6e6ff
1 parent 5dbe891
commit dd6e6ff
Show file tree

Hide file tree

Showing 7 changed files with 817 additions and 833 deletions.
diff --git a/.vitepress/navigation.ts b/.vitepress/navigation.ts
@@ -18,7 +18,8 @@ const navigation = buildSidebarNav('./src/', [
         repo: 'shopware/frontends',
     },
     {
-        link: '/docs/guides/integrations-api/',
+        link: '/integrations/',
+        //link: '/docs/guides/integrations-api/',
         text: 'Integrations',
     },
     {

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/integrations/.gitkeep b/src/integrations/.gitkeep
diff --git a/src/integrations/index.md b/src/integrations/index.md
@@ -0,0 +1,66 @@
+---
+head:
+  - - meta
+    - property: 'og:image'
+      content: https://shopware-docs-og.vercel.app/api/og?title=Integrations
+items:
+  - text: Integrations
+    link: /integrations/
+  - text: Admin API
+    items:
+      - text: Authentication
+        link: /docs/guides/integrations-api/general-concepts
+      - text: General concepts
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Reading data
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Writing data
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Processes
+        link: /docs/guides/integrations-api/general-concepts
+  - text: Guides
+    items:
+      - text: Product data
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Media Uploads
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Customers
+        link: /docs/guides/integrations-api/general-concepts
+      - text: Order automation
+        link: /docs/guides/integrations-api/general-concepts
+  - text: Reference
+    items:
+      - text: Admin API
+        link: https://shopware.stoplight.io/docs/admin-api/
+aside: false
+swag:
+  related: false
+---
+
+<SwagLanding image="/landing/themes.png">
+    <template #title>Automate, integrate & connect</template>
+    <template #description>
+        Shopware offers an extensive Admin API that allows for way more than just reading and writing data. Learn how to make the most of it and build integrations, connectors or imports.
+    </template>
+    <template #ctas>
+        <PageRef page="/docs/concepts/api/admin-api" title="Admin API Quick Start" sub="Dive into the basics of authentication, privileges, reading and writing data, working with errors." />
+    </template>
+    <template #exposed>
+        <SwagLandingCardList>
+            <template #cards>
+                <SwagLandingCard page="/docs/guides/integrations-api/general-concepts/search-criteria">
+                    <template #title>Criteria concept</template>
+                    <template #sub>Understand the search criteria, a powerful concept to read, filter and aggregate data through the Admin API.</template>
+                </SwagLandingCard>
+                <SwagLandingCard page="/docs/guides/plugins/themes/add-assets-to-theme">
+                    <template #title>Automate processes</template>
+                    <template #sub>Transition order or payment states, send out emails, clear caches - automation can make life a lot easier - and more efficient.</template>
+                </SwagLandingCard>
+                <SwagLandingCard page="/docs/guides/plugins/themes/add-theme-inheritance">
+                    <template #title>Working with media</template>
+                    <template #sub>When working with products, you're also working with images. Learn best practices to implement media imports.</template>
+                </SwagLandingCard>
+            </template>
+        </SwagLandingCardList>
+    </template>
+</SwagLanding>
diff --git a/src/landing/integrations.md b/src/landing/integrations.md
diff --git a/src/landing/themes.md b/src/landing/themes.md
diff --git a/src/themes/index.md b/src/themes/index.md
@@ -38,12 +38,17 @@ head:
 <SwagLanding image="/landing/themes.png">
     <template #title>Craft beautiful themes that inspire</template>
     <template #description>
-        Themes allow merchants transport their brand and identity. They are the way they present their products and services. Explore all the possibilities and tools at hand.
+        <p>Themes allow merchants transport their brand and identity. They are the way they present their products and services. Create a theme and sell it on the store, so merchants can use it in their stores.</p>
+        <p>Shopware's theme system is based on [Twig.js](#) and an inheritance mechanism, so you can write individual themes without breaking Shopware's core functionalities.</p>
     </template>
     <template #ctas>
         <PageRef page="/docs/guides/plugins/themes/theme-base-guide.html" title="Start building a theme" />
     </template>
     <template #exposed>
+        <template #title>Starter guides</template>
+        <template #description>
+            The amount of topics to start with can be overwhelming. For that reason we have prepared a handful of step-by-step tutorials to follow along that make you familiar with some of our concepts:
+        </template>
         <SwagLandingCardList>
             <template #cards>
                 <SwagLandingCard page="/docs/guides/plugins/themes/theme-configuration">