微信好物圈好物推荐插件开发文档

插件介绍

开发者可以将好物推荐插件添加到小程序中，在订单列表、商品详情页或其他合适的场景放置推荐按钮，用户可以直接在小程序内将物品推荐到好物圈。

申请插件

符合以下条件的小程序可以申请使用好物推荐插件：

1. 开通微信支付；
2. 不属于金融、游戏、医疗等类目。

使用插件

app.json增加plugins项。

"plugins": {
   "goodsSharePlugin": {
     "version": "3.1.1",
     "provider": "wx56c8f077de74b07c"
   }
}

调用插件的页面的json文件，增加usingComponents["share-button"]项。

"usingComponents": {
  "share-button": "plugin://goodsSharePlugin/share-button"
}

调用方法

在声明了引入该插件的页面的wxml中，使用该插件。

<view class="test-container">
<share-button
  product="{{product}}"
  bind:error="on_error"
/>
</view>

share-button字段说明

开发者可以从以下三种标准推荐按钮中选择其一或者完全自定义。

按钮素材下载

product字段说明

brand_info字段说明

sku_list字段说明

sku_attr_list字段说明

poi_list字段说明

参数示例

product: {
  "item_code":"00003563372839_00000010154601",
  "title":"product_name",
  "desc":"product_description",
  "category_list":[
    "服装",
    "上衣",
    "短袖衬衫"
  ],
  "image_list":[
    "https://res.wx.qq.com/mpres/htmledition/images/xxxx.jpeg"
  ],
  "src_mini_program_path":"/detail?item_code=00003563372839_00000010154601",
  "sku_list":[
    {
      "sku_id":"SKU_ID",
      "price":12345,
      "original_price":67890,
      "status":1,
      "poi_list":[
        {
          "longitude":116.32676,
          "latitude":40.003305,
          "radius":5,
          "business_name":"XXX",
          "branch_name":"珠江新城店",
          "address":"新港中路123号"
        },
        {
          "longitude":117.32676,
          "latitude":41.003305,
          "radius":5,
          "business_name":"CCC",
          "branch_name":"客村店",
          "address":"新港中路123号"
        }
      ],
      "sku_attr_list":[
        {
          "name":"颜色",
          "value":"白色"
        },
        {
          "name":"尺码",
          "value":"XXL"
        }
      ]
    }
  ],
  "brand_info":{
    "name":"品牌名、小程序名",
    "logo":"http://xxxxx"
  }
}

回调返回码

on-error回调中的返回码列表：

常见问题

• 点击分享按钮没反应。一般来说是入参错误。请开发者绑定并查看error回调函数中的第一个参数，内含的ret_msg会详细列出参数错误的原因。
• 修改了全局变量App或Page导致引用插件报错。建议开发者绕开占用变量名。

//一般而言，修改Page是为了对Page注入一些东西，例如：
const ORIGINAL_PAGE = Page; // 这个Page是原始的Page

Page = function(options){ //
    //做点其他注入操作
    //一顿修改后
    return ORIGINAL_PAGE(options)
}

// 然后常规得初始化页面
Page({
    data: {}
    //...
})

//为了避免这个问题，可以换一个名字，不再占用变量名
XXXPage = function(options){ //
    //做点其他注入操作
    //一顿修改后
    return Page(options)
}

// 然后常规得初始化页面
XXXPage({
    data: {}
    //...
})
//App这个变量名也是同理的