README

我决定退役这个插件，因为它在最佳情况下的使用非常有限。如今，创建模板、自行查询产品并拥有一个更具自定义性和更适合您特定需求的 RSS 投放信息同样简单。Craft 4 版本已发布，因此可以从 3 版本升级到 4 版本。

Craft CMS 的 Google Shopping 投放信息

使用 Google Shopping 投放信息将您的产品或条目放入 Google 商户中心

要求

此插件需要 Craft CMS 3.0.0 或更高版本，并在您安装了 Craft Commerce 时即可直接使用。

如果您想在不使用 Commerce 和/或使用常规条目的情况下使用此插件，请参阅 Twig 函数。

安装

要安装此插件，请按照以下说明操作。

1. 打开您的终端并转到您的 Craft 项目

    cd /path/to/project
    composer require studioespresso/craft-google-shopping-feed
    ./craft install/plugin google-shopping-feed
   

用法

默认情况下，该插件将为您提供 1 个投放信息，包含所有 Craft Commerce 产品，每个产品使用默认变体。

如果您需要更多控制投放信息中显示的产品，或您需要多个投放信息，请参阅 Twig 函数。

Twig 函数

如果您想使用常规条目、提供自己的 Element 查询或想有多个投放信息，请参阅这些函数

产品 - craft.googleshopping.products

与任何 Commerce 产品 元素查询兼容，并将使用每个产品的默认变体

   {% set query = craft.products.limit(1) %}
   {{ craft.googleshopping.products(query) }}

条目 - craft.googleshopping.entries

与任何元素查询兼容

   {% set query = craft.entries.section('books') %}
   {{ craft.googleshopping.entries(query) }}

这两个函数都接受一个 ElementQuery 作为第一个参数，并将使用插件设置中映射的字段。

可以添加一个可选的第二个参数，该参数包含以下固定字段名称和要映射到它们的条目字段名称。

   {{ craft.googleshopping.entries(products, {
        title: 'fieldHandle',
        id: 'fieldHandle',
        description: 'fieldHandle',
        image_link: 'fieldHandle',
        brand: 'fieldHandle',
        price: 'fieldHandle',
        currency: 'USD' // ISO code of the currency you want to use
   }) }}

如果这些字段中的任何一个都没有在数组中，投放信息将无法验证并抛出异常。

由 Studio Espresso 提供