studioespresso/craft-facebook-catalog

此包已被弃用且不再维护。未建议替代包。

将您的产品与您的Facebook页面链接

2.0.0 2022-03-13 14:50 UTC

This package is auto-updated.

Last update: 2022-07-04 17:33:52 UTC


README

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

Facebook 产品目录

将您的产品或条目添加到Facebook目录、您的Facebook页面和您的Instagram账户。

要求

此插件需要Craft CMS 3.0.0或更高版本,并在您安装了Craft Commerce时直接工作。

如果您想在不使用commerce的情况下使用此插件,或者与常规条目一起使用,请查看Twig函数

安装

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

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

     cd /path/to/project
     composer require studioespresso/craft-facebook-catalog
     ./craft install/plugin craft-facebook-catalog
    

用法

默认情况下,该插件将为您提供1个包含所有Craft Commerce产品的源,每个产品使用默认变体。

如果您需要更精确地控制哪些产品显示在源中,或者您需要多个源,请查看Twig函数

Twig函数

如果您想使用常规条目使用该插件、提供自己的Element查询或想要多个源,请查看这些函数。

产品 - craft.catalog.products

与任何Commerce产品元素查询一起工作,并将使用每个产品的默认变体。

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

条目 - craft.catalog.entries

与任何元素查询一起工作

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

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

可以添加一个可选的第二个参数,其中包含以下固定字段名称以及您想要映射到条目字段名称。

   {{ craft.catalog.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,
        google_product_category: 'fieldHandle'
   }) }}

如果这些字段中的任何一个在数组中不存在,源将无法通过验证并抛出异常。

Studio Espresso提供