README

贡献者：ShoppingFeed, BeAPI
标签：shoppingfeed, 市场place, woocommerce, woocommerce shoppingfeed, create woocommerce products shoppingfeed, products feed, generate shoppingfeed, amazon, Jet, Walmart, many marketplace, import orders
稳定版本：6.7.0
版本：6.7.0
需要PHP：7.3
至少需要：5.7
测试到：6.5
WC至少需要：5.1.0
WC测试到：8.8

升级通知

版本6.0.0是一个主要版本，有多个更改和改进，影响了插件架构。您将需要重新配置插件，所有以前的设置都将丢失

变更日志

6.7.0
- 订单：如果存在，则将'buyer_identification_number'字段导入订单自定义字段。
- 订单：通过SF API进行产品更新（价格和库存）是通过计划任务异步进行的。
- 杂项：ShoppingFeed服务标识不再存储在WooCommerce提供的应用程序日志中。
6.6.0
- Feed：修复某些缺货产品出现在饲料中的情况。
- Feed：现在有新选项可以将缺货产品包含在饲料中。
- Feed：更新数量计算，以在多种情况下更加准确
- Feed：更新饲料元数据，包括WooCommerce和插件版本。
- 订单：如果库存不足，则不在WooCommerce中创建订单，并发送自定义确认错误。
- 订单：现在有新工具可以导入两周前创建的未确认订单。
- 帐户：刷新帐户设置。
- 帐户：现在有新选项可以更改默认商店。
- 运输（AST）：处理多个跟踪号码。
- 杂项：修复前缀依赖项中剩余的冲突。
6.5.1
- Feed：添加选项，当产品更改时禁用与ShoppingFeed的库存和价格同步。
6.5.0
- 杂项：HPOS兼容性。
- 订单：更新用于从ShoppingFeed检索订单的过滤器。
- 订单：重新设计从ShoppingFeed导入订单时的检查。
6.4.0
- 杂项：将Guzzle库和相关依赖项添加前缀，以避免冲突。
6.3.0
- 订单：默认情况下不导入由市场完成的订单，请参阅描述中的详细信息。
- WPCLI命令：当发生错误时不要重新运行生成过程。
6.2.0
- 重新设计饲料生成过程，以更好地处理拥有大量产品的商店。
6.1.20
- 修复迁移过程失败与新的WooCommerce版本调度的问题。
- 更新插件要求
6.1.19
- 更新'shopping_feed_variation_images'过滤器，包括WC变体ID。
6.1.18
- 更新'shopping_feed_custom_ean'过滤器，包括WC产品。
6.1.17
- 添加新过滤器'pre_sf_carrier_from_wc_shipping'以覆盖发送给ShoppingFeed的订单的默认承运数据。
6.1.16
- PHP 8兼容性修复
- 更新README
6.1.15
- 变体的重量重新回到属性中
6.1.14
- 添加对Woocommerce Shipment Tracking Pro的支持
- 修复Yoast选项的使用
- 更新README
6.1.13
- 修复与WPSEO premium的PHP错误
6.1.12
- 修复缺失的admin选项卡
6.1.11
- 重量属性位于产品XML饲料的根目录中
- 'other'字段映射到客户备注
- 考虑Yoast分类
6.1.10
- 更新AST插件以支持专业版
6.1.9
- 修复连锁产品的数量错误
6.1.8
- 添加Zalando为可用的市场
6.1.7
- 修复保存运输选项的问题
6.1.6
- 发布主版本
6.1.5
- 性能改进：日志记录器和HTTP连接
6.1.4
- 添加费用处理的过滤器
- 刷新翻译
6.1.3
- 修复composer依赖关系
6.1.0
- 添加将多个ShoppingFeed账户连接到一个WC商店的可能性
6.0.33
- 修复与其他插件相关的优先级问题
6.0.32
- 添加WC日志链接
6.0.31
- 不要向其他客户发送邮件
6.0.30
- 不要强制WC邮件设置
6.0.29
- AST与Shopping-Feed Advanced助手紧凑型
6.0.28
- 修复版本错误
6.0.27
- 支持WP 5.8
6.0.26
- 修复版本号
6.0.25
- 跟踪：添加选择检索模式选项
6.0.24
- 跟踪：修复条件错误
6.0.23
- 如果账单地址电话为空，则获取运输地址电话以在BO上显示电话
6.0.22
- 修复文件大小写问题
6.0.21
- 将状态设置为产品列表上的发布
6.0.20
- 添加对插件ATS的兼容性
6.0.19
- 添加对插件连锁产品的兼容性
6.0.18
- 为生成器添加异步生成
6.0.17
- 使用生成器生成产品列表
6.0.16
- 在父项上汇总所有变体的数量
6.0.15
- 添加选择导入订单默认状态的可能性
6.0.14
- 添加将类别树导出到生成器的可能性
6.0.13
- 向生成器添加额外字段
6.0.12
- 修复静态调用
6.0.11
- 增强日志记录
6.0.10
- 修复部署问题
6.0.9
- 订单发货时发送WC运输方法名称
6.0.8
- 添加缺少的提交
6.0.7
- 添加重量作为属性
- 修复电话值
6.0.6
- 为变体添加ean支持
6.0.5
- 纠正属性值
6.0.4
- 修复永久链接问题
6.0.3
- 编辑版本号
6.0.1
- 编辑readme.txt
6.0.0
- 这是一个主要版本，有一些更改和改进，这些更改和改进影响了插件的结构
- 您必须重新配置插件，所有以前的设置都将丢失

描述

ShoppingFeed - WordPress连接控制器插件，用于在亚马逊、eBay、谷歌和成千上万的国际市场销售

要求

服务器

PHP版本7.1或更高
PHP cURL扩展已启用

WordPress

核心版本5.7或更高
WooCommerce版本5.1或更高

安装

在ShoppingFeed上免费注册：https://shopping-feed.com/

在插件 > 已安装插件中激活插件
在插件 > 已安装插件 > ShoppingFeed > 设置中，使用您的ShoppingFeed凭据登录
在设置中，确认ShoppingFeed已启用并保存更改

由市场履行订单

默认情况下，插件不会导入由市场完成的订单。

在插件设置中提供了选项，可以在导入时包括这些订单。

它们可以在“订单”标签中找到

由市场履行的订单：即使由市场完成也导入订单
由市场完成的订单状态：选择导入时用于市场完成的订单的状态

运输跟踪支持

目前，支持的唯一运输跟踪插件是

高级运输跟踪：https://wordpress.org/plugins/woo-advanced-shipment-tracking/
高级运输跟踪PRO：https://www.zorem.com/product/woocommerce-advanced-shipment-tracking/
Woocommerce运输跟踪专业版：https://www.pluginhive.com/product/woocommerce-shipment-tracking-pro/

配置

要正确使用插件，您需要使用您的首选项（生成器、运输、订单）进行配置

可用的钩子

以下代码段可以添加到您的主题的 functions.php 文件或自定义插件文件中

分类

默认情况下，我们支持 product_cat 作为分类法缩略名来识别产品分类，您可以使用此代码段来覆盖它

add_filter( 'shopping_feed_custom_category_taxonomy', 'your_custom_category_function' );

/** @return string */
function your_custom_category_function() {
    return 'your_custom_category_slug';
}

品牌

默认情况下，我们不支持任何用于产品品牌的自定义插件，您可以使用此代码段设置自定义分类法缩略名来识别它

add_filter( 'shopping_feed_custom_brand_taxonomy', 'your_custom_brand_function' );

/** @return string */
function your_custom_brand_function() {
    return 'your_custom_brand_slug';
}

国际标准书号（EAN）

默认情况下，我们不支持任何用于产品 EAN 的自定义插件，您可以使用此代码段设置自定义分类法缩略名来识别它

add_filter( 'shopping_feed_custom_ean', 'your_custom_ean_function' );

/** @return string */
function your_custom_ean_function() {
    return 'your_custom_ean_slug';
}

产品列表参数

要导出数据，我们使用插件的设置，如果您想添加/使用特定的参数，可以使用以下代码段

add_filter( 'shopping_feed_products_custom_args', 'your_custom_args_function' );

/** @return array */
function your_custom_args_function() {
//array of args
    return array();
}

您可以在以下位置找到所有可用的参数：WooCommerce 文档

要导入的订单（状态）

默认情况下，我们导入状态为“等待发货”的订单，如果您想导入更多状态或特定状态，可以使用以下代码段

add_filter( 'shopping_feed_orders_to_import', 'your_custom_statuses_function' );

/** @return array */
function your_custom_statuses_function() {
    // array of statuses (strings)
    return array();
}

可用的状态：created、waiting_store_acceptance、refused、waiting_shipment、shipped、cancelled、refunded、partially_refunded、partially_shipped

更多详细信息请在这里查看

追踪号

如果您想设置一个自定义元键来识别它，可以使用以下代码段

add_filter( 'shopping_feed_tracking_number', 'your_custom_tracking_number_function' );

/** @return string */
function your_custom_tracking_number_function() {
    return ‘your_custom_order_meta_key’
}

追踪网址

如果您想设置一个自定义元键来识别它，可以使用以下代码段

add_filter( 'shopping_feed_tracking_link', 'your_custom_tracking_url_function' );

/** @return string */
function your_custom_tracking_url_function() {
    return ‘your_custom_order_meta_key’
}

扩展字段

如果您想向您的 XML 数据源添加扩展字段，可以使用以下代码段

add_filter( 'shopping_feed_extra_fields', 'your_custom_fields_function', 10, 2 );

/** @return array */
function your_custom_fields_function($fields, $wc_product) {
    $fields[] = array('name'=>'my_field', 'value'=>'my_value');
    return $fields;
}

变体图片

默认情况下，我们不支持任何用于添加图片到 WC 产品变体的自定义插件，使用此过滤器，您可以设置每个变体所需的图片，您可以使用以下代码段

add_filter( 'shopping_feed_variation_images', 'your_custom_variation_images_function', 10, 3 );

/** 
 * @param array $images
 * @param WC_Product $wc_product
 * @param int $variation_id
 * 
 * @return array 
 */
function your_custom_variation_images_function( $images, $wc_product, $variation_id ) {
    $images[] = 'https://domain.com/image1.jpg';
    $images[] = 'https://domain.com/image2.jpg';
    
    return $images;
}

开发

本地环境

使用 Lando，您可以使用所有必需的插件和默认数据集启动本地环境

# Start local env
lando start

# Configure and load default dataset
lando setup-env

环境可在以下网址访问：https://shoppingfeed-for-woocommerce.lndo.site

登录：admin
密码：password

测试

测试通过 WPBrowser 处理，它是围绕 Codeception 框架构建的。使用 Lando 来拥有一个完全工作的环境。

要运行所有测试套件

lando start
lando tests

要运行单元测试套件

lando start
lando test-unit

要运行 WPUnit 测试套件

lando start
lando test-wpunit

要运行功能测试套件

lando start
lando test-functional

要运行验收测试套件

lando start
lando test-acceptance

shoppingfeed / shoppingfeed-for-woocommerce

维护者

详细信息