studioespresso / craft-facebook-catalog
此包已被弃用且不再维护。未建议替代包。
将您的产品与您的Facebook页面链接
2.0.0
2022-03-13 14:50 UTC
Requires
- craftcms/cms: ^4.0.0-beta.1
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函数。
安装
要安装插件,请按照以下说明操作。
-
打开您的终端并转到您的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'
}) }}
如果这些字段中的任何一个在数组中不存在,源将无法通过验证并抛出异常。