README

基本配置

要使用来自Shopware的数据，您需要在您的Settings.yaml中设置一些配置

Networkteam:
  Neos:
    ShopwareIntegration:
      api: '<The base url of your shopware shop>'
      key: '<The Api Key for your shopware shop>'

可用的混入（Mixin）

Networkteam.Neos.ShopwareIntegration:Mixin.ProductId

可用于将节点连接到Shopware产品。下拉菜单显示来自您的Shopware安装的所有产品。

Networkteam.Neos.ShopwareIntegration:Mixin.CategoryId 可用于将节点连接到Shopware分类。下拉菜单显示来自您的Shopware安装的所有分类。

产品列表

要获取类别中所有产品的数组，请使用Networkteam.Neos.ShopwareIntegration:ProductsByCategory原型并设置类别ID

prototype(Vendor.Site:Page) {
    productList = Neos.Fusion:Loop {
        items = Networkteam.Neos.ShopwareIntegration:ProductsByCategory {
            categoryId = <Your category id>
        }
        renderer = <Your product renderer>
    }
}

产品数据

要按ID获取产品数据的数组，请使用Networkteam.Neos.ShopwareIntegration:ProductData原型并设置产品ID

prototype(Vendor.Site:Page) {
    productData = Networkteam.Neos.ShopwareIntegration:ProductData {
        productId = <Your product id>
    }
}

分类数据

要按ID获取分类数据的数组，请使用Networkteam.Neos.ShopwareIntegration:CategoryData原型并设置分类ID

prototype(Vendor.Site:Page) {
    categoryData = Networkteam.Neos.ShopwareIntegration:ProductData {
        categoryId = <Your category id>
    }
}

占位符

您可以使用占位符添加来自您的Shopware实例的数据。

产品占位符

产品占位符的格式为 {{shopware.product.<data-path>}}

要丰富占位符中的数据，请添加Networkteam.Neos.ShopwareIntegration:ProductPlaceholder-Prototype作为处理器并设置产品ID

prototype(Vendor.Site:Page) {
    @process.enrichPlaceholder = Networkteam.Neos.ShopwareIntegration:ProductPlaceholder {
        productId = <Your product id>
    }
}

分类占位符

分类占位符的格式为 {{shopware.category.<data-path>}}

要丰富占位符中的数据，请添加Networkteam.Neos.ShopwareIntegration:CategoryPlaceholder-Prototype作为处理器并设置分类ID

prototype(Vendor.Site:Page) {
    @process.enrichPlaceholder = Networkteam.Neos.ShopwareIntegration:CategoryPlaceholder {
        categoryId = <Your product id>
    }
}

ShopwareRuntime

您可以在自己的JavaScript中使用ShopwareRuntime。它是一个全局umd模块，可以通过window.ShopwareRuntime访问。您还可以将其用作构建过程中的外部模块，例如在webpack 5中

externals: {
    'shopware-connector': {
        root: ['ShopwareRuntime', 'ShopwareConnector'],
        commonjs: ['ShopwareRuntime', 'ShopwareConnector'],
        commonjs2: ['ShopwareRuntime', 'ShopwareConnector'],
    },
}

要使用Runtime，请将相应的JavaScript添加到您的页面中，例如通过将Networkteam.Neos.ShopwareIntegration:Shopware.Widgets.Js添加到您的脚本中

小部件（需要ShopwareRuntime JS）

要使用带有功能和最小标记的小部件，请将相应的JavaScript添加到您的页面中。只需将Networkteam.Neos.ShopwareIntegration:Shopware.Widgets.Js添加到您的脚本中。

添加到购物车小部件

此小部件只是一个包装器，它通过点击监听器增强您的标记，并提供将元素添加到购物车的功能。您只需在现有标记中添加两个数据属性即可

<button data-component="AddToBasket" data-prop-product-id="SomeID">TestButton</button>