卖家数据 | 卖家ID ：id 卖家昵称 ：nick 注册时间 : registrationDate 国家 ：country 省份 ：province 城市 ：city 信用 ：sellerCredit 好评率 ：sellerGoodRate | |||||||||||||||||||||||||||||||||||
通过$_user获取当前的卖家信息 | ||||||||||||||||||||||||||||||||||||
<?php $_user->credit; /*获取卖家信用*/ $_user->goodRate; /*获取卖家好评率*/ $_user->id; /*获取卖家ID*/ $_user->nick; /*获取卖家昵称*/ $_user->registrationDate; /*获取卖家注册时间*/ $_user->country; /获取卖家国家*/ $_user->province; /*获取卖家省份*/ $_user->city; /*获取卖家城市*/ ?> | ||||||||||||||||||||||||||||||||||||
店铺数据 | 店 铺 id ：id 店铺标题 ：title 店铺域名 ：domainName 店铺logo ：shopLogo（新版头部上用到的那种） 店 标 ：logoUrl（原先老的80x80的） 店铺主营 ：mainBusiness 收藏人气 ：collectedCount 宝贝数量 ：itemCount 店主昵称 ：ownerNick 店主标识 ：ownerId 开店时间 ：startTime 店铺简介 ：introduction 店铺公告 ：bulletin 店铺页面链接 ：shopPageLinks | |||||||||||||||||||||||||||||||||||
通过$_shop获取当前的店铺的信息,其中页面链接信息通过“shopManager”来获取 | ||||||||||||||||||||||||||||||||||||
<?php $_shop->id; /*获取店铺ID*/ $_shop->title; /*获取店铺名称*/ $_shop->introduction; /*获取店铺简介*/ $_shop->bulletin; /获取店铺公告*/ $_shop->id; /*获取店铺ID*/ $_shop->title; /*获取店铺标题*/ ?> | ||||||||||||||||||||||||||||||||||||
店铺类目 | 店铺类目ID : id 店铺类目名称 : name 店铺类目图标 : iconUrl 父类目ID : parentId 类目所属店铺ID ：shopId | |||||||||||||||||||||||||||||||||||
店铺类目获取通过ShopCategoryManager获取，ShopCategoryManager的说明如下： 1.查询所有的店铺一级类目：queryAll 参数说明：此接口不需要参数，查询当前店铺的所有店铺类目 2.查询店铺类目的所有子类目：querySubCategories 参数说明：此方法需要传递父类目id 3.根据店铺类目标识查询店铺类目：queryById 参数说明：此方法需要传递类目id | ||||||||||||||||||||||||||||||||||||
/*查询所有的店铺类目数据*/ <?php $subCategories = $shopCategoryManager->querySubCategories($parentId); foreach($subCategories as $shopCategory){ echo "店铺类目名称是：".$shopCategory->name; } ?> /*查询店铺类目的所有子类目*/ 查询店铺类目中的一级类目：此时$parentId=0,即所有一级类目的父类目的id=0。 查询店铺类目中的二级类目：把已经查到一级类目的类目id作为$parentId,查询店铺类目的二级类目 <?php $shopCategory = $shopCategoryManager->queryById($Id); echo "店铺类目名称是：".$shopCategory->name; ?> | ||||||||||||||||||||||||||||||||||||
宝贝数据 | 宝贝ID ：id 宝贝后台类目 ：itemCategoryId 宝贝标题 ：title 宝贝价格 ：price 宝贝图片地址 ：picUrl 宝贝销售量 ：soldCount 宝贝收藏量 ：collectedCount 宝贝所属卖家ID ：ownerId 宝贝评论数 ：commentCount (此属性只有商城店铺有，C店铺没有) | |||||||||||||||||||||||||||||||||||
设计师通过ItemManager获取宝贝数据，ItemManager的接口说明如下： 1. 根据关键字查询宝贝：queryByKeyword 参数说明：此接口需要传递3个参数，分别为查询关键字，宝贝排序类型，查询数量，其中宝贝排序类型具体见下表，此接口最多返回20个宝贝。 2. 根据店铺类目ID来查询该类目下的宝贝： queryByCategory 参数说明：此接口需要传递3个参数，分别为店铺类目id，宝贝排序类型，查询数量，其中宝贝排序类型具体见下表，此接口最多返回20个宝贝。 3. 根据指定的宝贝Id查询对应的宝贝数据：queryById 参数说明：此接口需要传递1个参数宝贝ID，如果没有查询到宝贝则返回空 4. 根据一组宝贝ID查询宝贝，返回的宝贝最大个数为20个：queryByIds 参数说明：此接口需要传递2个参数，分别为待查询的宝贝ID列表以及排序类型，其中宝贝排序类型具体见下表，此接口最多返回20个宝贝。
| ||||||||||||||||||||||||||||||||||||
根据关键字查询宝贝： <?php /*查询关键字为IPad的10个宝贝，按照热销降序排列*/ $items = $itemManager->queryByKeyword("Ipad","hotsell",10); foreach($items as $item){ echo "宝贝标题：". $item->title; echo "宝贝价格：". $item->price; } ?> 根据店铺类目ID查询该类目下的宝贝： <?php /*根据类目ID查询10个宝贝，按照热销降序排序*/ $items = $itemManager->queryByCategory($categoryId,"hotsell",10); foreach($items as $item){ echo "宝贝标题：". $item->title; echo "宝贝价格：". $item->price; } ?> 根据指定的宝贝ID查询对应的宝贝数据： <?php /*根据ID查询宝贝*/ $item = $itemManager->queryById($id); echo "宝贝标题：". $item->title; echo "宝贝价格：". $item->price; ?> 根据一组宝贝ID查询宝贝： <?php /*根据ID列表查询宝贝*/ $ids = array(123456,654321); $items = $itemManager->queryByIds($ids,"hotsell"); foreach($items as $item){ echo "宝贝标题：". $item->title; echo "宝贝标题：". $item->price; } ?> 宝贝图片大小获取不同尺寸的图片 <?php /*根据ID查询宝贝*/ $item = $itemManager->queryById($id); echo "宝贝图片120x120". $item->getPicUrl(120); echo "宝贝图片220x220". $item->getPicUrl(220); ?> | ||||||||||||||||||||||||||||||||||||
友情链接 | 友情链接id ：id 友情链接标题 : title 用户标识 : userId 友情链接URL : url | |||||||||||||||||||||||||||||||||||
友情链接数据通过FriendLinkManager接口获取，FriendLinkManager的接口说明如下： 1.查询当前用户的所有友情链接：queryAllLinks 参数说明：此接口不需要参数，获取当前用户的友情链接 | ||||||||||||||||||||||||||||||||||||
查询当前用户的所有友情链接： <?php /*查询用户所有的友情链接*/ $friendLinks = $friendLinkManager->queryAllLinks(); foreach($friendLinks as $friendLink){ echo "友情链接：". $friendLink->title; } ?> | ||||||||||||||||||||||||||||||||||||
URL数据 | 宝贝详情页URI 搜索列表页URI 评价页面URI 店铺介绍页面URI 店铺类目URI 收藏店铺URI 旺旺链接URI | |||||||||||||||||||||||||||||||||||
1. 生成宝贝详情页的URI: detailURI 参数说明：此接口需要传递宝贝对象作为参数 <?php $uriManager->detailURI($item); ?> 2. 生成搜索列表页的URI: searchURI 参数说明：此接口不需要参数 <?php $uriManager->searchURI(); ?> 3. 生成当前用户的评价页面URI: rateURI 参数说明：此接口不需要参数 <?php $uriManager->rateURI(); ?> 4. 生成当前店铺介绍页面的URI: shopIntrURI 参数说明：此接口不需要参数 <?php $uriManager->shopIntrURI(); ?> 5. 生成店铺类目对应的URI:shopCategoryURI 参数说明：此接需要传递店铺类目对象作为参数，当点击生成的uri时,本地sdk会自动跳转到searchList.htm，而此URI最终会渲染searchList.php页面 <?php $uriManager->shopCategoryURI ($shopCategory); ?> 6. 生成收藏店铺URI：favoriteLink 参数说明：此接口不需要参数，默认获取收藏当前店铺的URI <?php $uriManager-> favoriteLink(); ?> 7. 生成旺旺链接URI：contactTag(userNick) 参数说明：此接需要传递用户的旺旺名称 <?php $uriManager-> contactTag ('nick'); ?> 新增子旺旺的数据接口 旺旺客服标签 $uriManager->supportTag 方法和参数详细介绍，提供了四种调用模式,单个参数模式,参数为客户旺旺的ID. <?php echo $uriManager->supportTag("客服旺旺ID号"); ?> 两个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">) <?php echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问"); ?> 三个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">),旺旺点灯的图片样式(1为默认新样式,二为老样式) <?php echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问",1); ?> 四个参数模式,参数为: 客户旺旺ID,旺旺点灯图片提示消息(等价于 <img alt="提示消息">),旺旺点灯的图片样式(1为默认新样式,二为老样式),E客服分流. <?php echo $uriManager->supportTag("客服旺旺ID号","请点击直接访问",1,false); ?> | ||||||||||||||||||||||||||||||||||||
生成宝贝详情页的URI： <?php /*生成宝贝详情页的URI*/ $itemURI = $uriManager->detailURI($item); ?> 生成搜索列表页的URI： <?php /*生成搜索列表页的URI*/ $searchURI = $uriManager->searchURI(); ?> 生成评价页面的URI： <?php /*生成评价页面的URI*/ $rateURI = $uriManager->rateURI(); ?> 生成店铺介绍页面的URI： <?php /*生成店铺介绍页面的URI*/ $shopIntroduction = $uriManager->shopIntrURI(); ?> 生成店铺类目的URI： <?php /*生成店铺类目的URI*/ $uriManager->shopCategoryURI($shopCategory); ?> 生成收藏店铺URI：favoriteLink <?php /*参数说明：此接口不需要参数，默认获取收藏当前店铺的URI*/ echo"生成收藏店铺URI：".$uriManager->favoriteLink(); ?> 生成旺旺链接URI：contactTag(userNick) <?php /*参数说明：此接口需要传递用户的旺旺名称*/ echo"生成旺旺链接URI：".$uriManager->contactTag('nickname'); ?> | ||||||||||||||||||||||||||||||||||||
评价接口说明 | 评价数据详解宝贝数字id：auctionId 评价者昵称：raterNick 评价者头像：raterAvatar;支持"24x24","30x30","40x40","60x60","70x70","80x80","100x100","110x110","120x120","160x160",默认"160x160" 评价内容：feedback 评价时间：feedbackdate 好评数：goodCount 中评数：normalCount 差评数：badCount 总评数：total | |||||||||||||||||||||||||||||||||||
else { $items=explode(',',$rate_items); foreach($items as $item) { $rates = $rateManager->queryAuctionRates($item); foreach($rates as $rate) { echo "评价者：".$rate->raterNick; echo "评价者头像：".$rate->getRaterAvatar('24'); echo " 评价详情：".$rate->feedback; echo " 评价时间：".$rate->feedbackdate; echo " 宝贝id：".$rate->auctionId; } } } ?> 3、查询店铺当前收到的买家评价信息：queryShopRates() 参数说明：无 业务规则说明： a、拉取店铺收到的20条买家评价信息 b、优先拉取评分高的评价，按照评价时间倒序排序； c、1次页面渲染最多1次调用（接口调用可以分布在不同模块，但是总调用次数不超过1次/页）；如果超过1次，则返回前1次调用的结果，其余忽略； d、不保证评论字数在某一个字数范围内； e、接口始终返回非null； 使用实例： <?php $rates = $rateManager->queryShopRates(); foreach($rates as $rate){ echo " 宝贝id：".$rate->auctionId; echo " 评价者：".$rate->raterNick; echo "评价者头像：".$rate->getRaterAvatar('24'); echo " 评价详情：".$rate->feedback; echo " 评价时间：".$rate->feedbackdate; } ?> 4、查询指定宝贝的评论数：queryRateCount($auctionNumId) 参数说明：宝贝数字id；确保有效宝贝id； 业务规则说明： a、获取auctionNumId指定的宝贝，所拥有的主站好评数、中评数、差评数以及总评数 b、1次页面渲染最多30次调用（接口调用可以分布在不同模块，但是总调用次数不超过30次/页）；如果超过30次，则返回前30次调用的结果，其余忽略；； c、接口允许返回null 使用实例： <?php $rate_items=$_MODULE['test_rate_items']; if(!$rate_items) echo "请选择宝贝"; else { $items=explode(',',$rate_items); foreach($items as $item){ $count = $rateManager->queryRateCount($rate_item); if($count){ echo "好评数：".$count->goodCount; echo "中评数：".$count->normalCount; echo "差评数：".$count->badCount; } } } ?> | ||||||||||||||||||||||||||||||||||||
sku接口说明 | skuID ：skuId 商品ID ：itemId 商品数量 : quantity 商品价格 ：price sku属性列表：openItemSkuPropertiesDOList 属性图URL：propertyImageUrlskuProperty 属性ID ：propertyId 属性值ID ：valueId 属性文本名称 ：propertyText 属性文本值：valueText | |||||||||||||||||||||||||||||||||||
获取宝贝sku信息是通过$itemManager获取，具体说明如下： 批量查询最多查询20个，即查询的数量<=20,否则只返回前20个的查询结果。查询方式：$itemManager->queryOpenSkuDOListByOpenItemDOList ($openItemDOList);参数是宝贝列表$openItemDOList。 获取宝贝的属性列表是通过$itemManager->getSkuProperties(List<OpenItemSkuDO> openItemSkuDOList),返回的结果为该宝贝的属性列表，类型为：List<String>。参数openItemSkuDOList是一个宝贝的sku对象列表。 获取宝贝某一属性值列表是通过$itemManager->getSkuPropertyValues(List<OpenItemSkuDO> openItemSkuDOList,String skuProperty),返回的结 果为该宝贝的属性列表，类型为：List<String>。参数 openItemSkuDOList是一个宝贝的sku对象列表；skuProperty指的是要查询的属性名称。 获取宝贝颜分类的属性图列表，提供了三种重载方法： sdk$itemManager->getSkuPropertyPics(List<OpenItemSkuDO> openItemSkuDOList); 获取默认的属性小图URL列表，参数openItemSkuDOList同上，为一个宝贝的sku对象列表。 $itemManager->getSkuPropertyPics(List<OpenItemSkuDO> openItemSkuDOList,String widthAndHeight); 获取长宽比相同的图片URL列表，参数openItemSkuDOList同上，为一个宝贝的sku对象列表，widthAndHeight为宽度。 $itemManager->getSkuPropertyPics(List<OpenItemSkuDO> openItemSkuDOList,String width,String height); 获取任意长宽的图片URL列表，参数openItemSkuDOList同上，为一个宝贝的sku对象列表，width和height如果为空，返回默认大小的图片。 通过OpenItemSkuDO对象可以直接调用getPropertyImageUrl(String width , String height)，方法直接获取单个sku的图片URL | ||||||||||||||||||||||||||||||||||||
首先使用queryByIds查询出宝贝列表，然后以宝贝列表做参数，查询sku列表。 <?php echo "-----测试批量查询-----"; $idList = Array('20','21'); $openItemDOList= $itemManager->queryByIds($idList,''); $skuLists = $itemManager->queryOpenSkuDOListByOpenItemDOList($openItemDOList); foreach($skuLists as $skuList){ foreach($skuList as $sku){ echo "sku的ID：".$sku->skuId; echo "sku的itemID：".$sku->itemId; echo "sku的数量：".$sku->quantity; echo "sku的价格：".$sku->price; echo "sku的图片url：".$sku->propertyImageUrl; $skuPropertyList = $sku->openItemSkuPropertiesDOList; echo "sku的属性："; foreach($skuPropertyList as $skuProperty){ echo $skuProperty->propertyText." : ".$skuProperty->valueText; } } } ?> 获取属性列表： <?php $skuLists = $itemManager->queryOpenSkuDOListByOpenItemDOList($openItemDOList); foreach($skuLists as $skuList){ $propertyList = $itemManager->getSkuProperties($skuList); foreach($propertyList as $property){ echo $property; } } ?> 获取属性值列表： <?php $skuLists = $itemManager->queryOpenSkuDOListByOpenItemDOList($openItemDOList); foreach($skuLists as $skuList){ $propertyList = $itemManager->getSkuProperties($skuList); foreach($propertyList as $property){ $propertyValueList = $itemManager->getSkuPropertyValues($skuList,$property); foreach($propertyValueList as $propertyValue){ echo $propertyValue; } } ?> 获取属性图片列表： 注：有些宝贝sku没有属性图，此时返回null <?php $skuLists = $itemManager->queryOpenSkuDOListByOpenItemDOList($openItemDOList); foreach($skuLists as $skuList){ $picUrlList = $itemManager->getSkuPropertyPics($skuList); 或者 $picUrlList = $itemManager->getSkuPropertyPics($skuList，"310"); 或者 $picUrlList = $itemManager->getSkuPropertyPics($skuList，"310","310"); foreach($picUrlList as $picUrl){ echo $picUrl; } } ?> 仿照宝贝详情页获取sku信息的DEMO示例代码： <?php global $itemIds; if($_MODULE["itemss"]!=null){ $itemIds=explode(',',$_MODULE["itemss"]); //根据宝贝id列表批量查询宝贝对象列表 $openItemDOList= $itemManager->queryByIds($itemIds,''); //根据宝贝列表查询宝贝的sku信息，input:宝贝列表，output:sku列表的列表，如果 //宝贝列表中的某个宝贝不存在sku信息，则返回null值；如果参数：宝贝列表的数目 //超过20个时，则返回前20个宝贝的sku信息。 $skuLists = $itemManager->queryOpenSkuDOListByOpenItemDOList($openItemDOList); foreach($skuLists as $skuList){ //根据某个宝贝的sku列表信息，获取宝贝所具有的属性列表，一个宝贝有多条属性 $properties = $itemManager->getSkuProperties($skuList); foreach($properties as $property){ //根据宝贝属性查询该属性下所具有的值 $propertyValueList = $itemManager->getSkuPropertyValues($skuList,$property); echo $property .":"; foreach($propertyValueList as $propertyValue){ echo $propertyValue.","; } echo "<br>"; } echo "<br>"; //获取某个宝贝的属性图片列表 $picList = $itemManager->getSkuPropertyPics($skuList); foreach($picList as $pic){ echo $pic .","."<br>"; } } } ?> | ||||||||||||||||||||||||||||||||||||
宝贝评价选择器说明 | 宝贝数字id：auctionId 宝贝详情url：auctionUrl 评价者昵称：raterNick 评价者个人主页：raterUrl 评价者头像地址：raterAvatar 评价者信用等级图片地址：raterStarImg 评价内容：feedback 评价图片：ratePics 查看更多评价url：moreFeedbackUrl 做出评价时间：feedbackdate | |||||||||||||||||||||||||||||||||||
1、获取卖家通过宝贝评价选择器设置的参数值 $value= $_MODULE['paramName']; 2、使用开放接口解析卖家设置的参数值 $itemRates = $rateManager->parse($value); 3、遍历第二步返回的$itemRates foreach($itemRates->keySet() as $itemId) { $rates = $itemRates->get($itemId); foreach($rates as $rate) { echo '宝贝id：'.$rate->auctionId; echo '宝贝url'.$rate->auctionUrl; echo '评价者数字id：'.$rate->raterId; echo '评价者头像：'.$rate->getRaterAvatar('60'); echo '评价者昵称：'.$rate->raterNick; echo '评论者信用等级：'.$rate->raterStarImg; echo '评价者个人主页：'.$rate->raterUrl; echo '该宝贝的更多评价：'.$rate->moreFeedbackUrl; echo '评价内容：'.$rate->feedback; $pics = $rate->getRatePics('40'); foreach($pics as $pic) { echo '评价图片：'.$pic; } echo '评价时间：'.$rate->feedbackdate; } } | ||||||||||||||||||||||||||||||||||||
特别参数说明1、评价者头像： 通过接口getRaterAvatar(size)获取完整头像地址；目前头像大小支持："24x24","30x30","40x40","60x60","70x70","80x80","100x100","110x110","120x120","160x160" 2、评价图片： 通过接口getRaterPics(size)获取完整的评价图片列表；建议图片大小使用"40x40"或者"400x400";目前大小支持："24x24","30x30","40x40","60x60","70x70","80x80","100x100","110x110","120x120","160x160","400x400" 使用示例1、SDK工具 在引入宝贝评价选择器的模块中引入新的参数类型，具体详见l部分代码 ...... <parameters> <group title="选择器组"> <section folded="false" title="选择器部分"> <param ptype="itemRate" name="test_item_rate" label="宝贝评价选择器" formType="itemRateForm" description="宝贝评价选择器"></param> </section> </group> </parameters> ...... 2、php示例 <?php /** * 开始设计PHP页面 */ $value = $_MODULE['test_item_rate']; if($value) { $itemRates = $rateManager->parse($value); foreach($itemRates->keySet() as $itemId) { $rates = $itemRates->get($itemId); foreach($rates as $rate) { echo '宝贝id：'.$rate->auctionId.'<br/>'; echo '宝贝url'.$rate->auctionUrl; echo '评价者数字id：'.$rate->raterId; echo '评价者头像：'.$rate->getRaterAvatar('60'); echo '评价者昵称：'.$rate->raterNick; echo '评论者信用等级：'.$rate->raterStarImg; echo '评价者个人主页：'.$rate->raterUrl; echo '该宝贝的更多评价：'.$rate->moreFeedbackUrl; echo '评价内容：'.$rate->feedback; echo '评价图片：'.$rate->getRatePics('40'); foreach($rate->getRatePics('40') as $ratePic) { echo '$ratePic'; } echo '评价时间：'.$rate->feedbackdate; } } } ?> | ||||||||||||||||||||||||||||||||||||
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论