"api工廠" 使用手冊
api介面開箱即用,雲後臺管理,助力前端,解放後端開發;
不懂程式設計也能獨立開發應用,小步快跑,快速創業!
旨為更懂你!
“天使童裝”入門教程
註冊開通小程式賬號
https://mp.weixin.qq.com/
根據自己的實際情況選擇 “企業”、“個體工商戶”身份,註冊小程式賬號
商城類小程式不支援個人使用者上線,所以一定要選擇 企業或者個體戶
獲得你自己小程式的 appid 和 secret 資訊,儲存好,下面會用到
《如何檢視我的小程式的 APPID,在哪裡看我的小程式的 APPID?》
你需要設定小程式的合法域名,否則開發工具上執行正常,手機訪問的時候將看不到資料:
《設定小程式合法伺服器域名》
註冊開通後臺賬號
https://admin.it120.cc/
免費註冊開通新後臺後登入,登入後的首頁,請記下你的專屬域名,後面會用到
左側選單 “工廠設定” --> “資料克隆” --> “將別人的資料克隆給我”
對方商戶ID填寫 951
點選 “立即克隆”,克隆成功後,F5 重新整理一下後臺
配置小程式APPID/SECRET
左側選單,微信設定,填寫配置上一步獲得的 appid 和 secret
這一步很重要!!!
如果沒有正確配置,下面步驟中開啟小程式將無法連線你的後臺
配置微信支付
左側選單,系統設定 --> 線上支付配置,填寫您自己的微信支付的資訊
下載安裝開發工具
https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
根據你自己的作業系統,下載最新穩定版,下載完畢後完成安裝
下載小程式原始碼
https://github.com/EastWorld/wechat-app-mall
或者從碼雲映象下載,速度會快一些:
https://gitee.com/javazj/wechat-app-mall
將最新的小程式原始碼下載下來,下載下來的是一個zip壓縮包,請將其解壓縮
執行小程式看效果
雙擊執行第一步安裝的小程式開發工具,開啟看效果
匯入專案這裡,目錄選擇你 “第二步” 中下載並解壓的小程式程式碼所在目錄
APPID 務必要改成你自己的小程式的 APPID
APPID 務必要改成你自己的小程式的 APPID
APPID 務必要改成你自己的小程式的 APPID
然後點選匯入按鈕
《如何檢視我的小程式的 APPID,在哪裡看我的小程式的 APPID?》
配置對接你自己的後臺
在開發工具中 config.js 中的subDomain 改成你自己專屬域名, ctrl + s 儲存
《如何檢視你自己的subDomain》
系統引數設定
訂單支付使用餘額
- 引數型別 開關型別
- 引數名 order_pay_user_balance
開啟週期性訂閱訂單
- 引數型別 開關型別
- 引數名 orderPeriod_open
是否顯示簽到送積分
- 引數型別 開關型別
- 引數名 show_score_sign
是否顯示積分贈送成長值
- 引數型別 開關型別
- 引數名 show_score_exchange_growth
是否顯示積分券贈送積分
- 引數型別 開關型別
- 引數名 show_quan_exchange_score
是否顯示三級分銷
- 引數型別 開關型別
- 引數名 show_3_seller
搜尋頁面商品展現方式
- 引數型別 文字型別
- 引數名 goods_search_show_type
- 說明 1 為一行1個商品;2為一行2個商品
是否顯示購買動態
- 引數型別 開關型別
- 引數名 show_buy_dynamic
是否顯示商品銷量
- 引數型別 開關型別
- 引數名 show_seller_number
是否開啟訂單回收
- 引數型別 開關型別
- 引數名 recycle_open
是否開啟CPS
- 引數型別 開關型別
- 引數名 cps_open
指定小程式支付介面
小程式支付預設使用官方微信支付,如果您有需要使用別的支付方式(前提是在後臺系統設定->線上支付,設定了新的支付方式),那麼可以透過設定系統引數的方式來指定支付介面:
- 引數型別 文字引數
- 引數名 wxpay_api_url
- 引數值 /pay/wx/wxapp
收貨地址省市區級數
- 引數型別 文字引數
- 引數名 shipping_address_region_level
- 引數值 填3為省市區,填4為省市區街道
新增收貨地址是否需要選擇定位
- 引數型別 開關型別
- 引數名 shipping_address_gps
- 引數值 是否需要在地圖上選擇定位
其他配置
後臺配置
《微信小程式直播帶貨教程》
訂單詳情介面展示核銷二維碼
為了實現快速核銷,使用者購買下單以後,可以在訂單詳情介面生成核銷二維碼,以便後續可以實現一鍵掃碼核銷,只需改動一行程式碼:
isCanHx: true
至此,你的訂單,將可以看到核銷二維碼
開啟掃碼核銷功能
後臺左側選單 “系統設定” --> “系統引數”,新增一個 “文字型別” 的引數:
引數編碼,填寫 order_hx_uids
引數值,填寫有許可權核銷的使用者編號(左側選單使用者管理裡面的使用者編號,是一串數字),如果多個使用者編號,請用逗號隔開即可
首頁的購買動態
引數:
- 0 使用者只要下單就記錄購買動態;
- 1 使用者必須支付訂單以後,才會產生購買動態;
如何刪除動態資料:
《商品交易動態資料如何刪除》
下單時指定該訂單需要使用配送外掛
商家自己有配送員/騎手,自行配送的情況下,結合商家配送外掛:https://www.it120.cc/help/ozughe.html
需要制定訂單是需要商家自己配送的,那麼在小程式端下單的時候,指定該訂單需要配送:
下單增加引數:autoPeisong:true
即可
開啟貨到付款
首先需要配置後臺,支援前端建立貨到付款的訂單:
https://www.it120.cc/help/hagquy.html
開啟頁面:pages/to-pay-order/index
建立訂單的時候增加引數:payOnDelivery: 1
頁面自動彈出編輯頭像和暱稱對話方塊
- 對應頁面的 js 檔案的 onload 方法裡面,加上程式碼
getApp().initNickAvatarUrlPOP(this)
- 對應頁面的 wxml 檔案最下面,加上程式碼
<login show="{{ nickPopShow }}" avatarUrl="{{ popavatarUrl }}" name="{{ popnick }}" />
- 預設是進入頁面後3秒彈出,如果需要修改這個時間,在
app.js
檔案中,搜尋initNickAvatarUrlPOP
方法,裡面的3000
改成自己需要的時間即可
後臺配置教程
如何設定啟動圖
左側選單 “系統設定” --> “Banner管理” 中,新增 或者 修改型別為 app 的圖片即可;
app 型別的圖片,會在首次開啟小程式的時候進行展示,根據你自己的需要傳幾張都可以;
修改小程式名稱
左側選單 “系統設定” --> “系統引數”,修改編號為 mallName 的那個引數即可;
如何修改分享文案
左側選單 “系統設定” --> “系統引數” 中,新增一個文字型別的引數: share_profile
如何設定首頁輪播圖
左側選單 “系統設定” --> “Banner管理” 中,新增 或者 修改型別為 index 的圖片即可;
index 型別的圖片,會顯示在首頁輪播的位置;
如何釋出商品
https://www.it120.cc/help/xers4q.html
首頁輪播圖如何加連結
點選後開啟某個商品
- 首先找到你需要開啟的商品編號:
左側選單,“商城管理” --> “商品管理”,開啟後的第一列的數字就是商品編號;
- banner管理中新增跳轉連結:
左側選單,“系統設定” --> “Banner管理”,編輯,連結地址處填寫:
/pages/goods-details/index?id=1234
其中 1234 改成你要開啟的商品編號
點選後開啟某個分類的商品列表
- 後臺檢視分類管理,找到分類編號和分類名稱:
左側選單,“商城管理” --> “商品分類”,開啟後第一列的數字和名稱就是了;
- banner管理中新增跳轉連結:
左側選單,“系統設定” --> “Banner管理”,編輯,連結地址處填寫:
/pages/goods/list?categoryId=分類編號&name=分類名稱
點選後進入分銷中心
banner 管理裡的連結地址,填寫:
/pages/fx/apply-status
商品詳情頭圖如何使用影片
請按照以下步驟操作:
- 左側選單,工廠設定,模組管理,啟用模組 “影片點播轉碼” ,然後 F5 重新整理後臺;
- 左側選單,影片點播,上傳你的影片,並記錄下影片ID,如下圖:
- 釋出 / 編輯商品的時候,影片編號的地方填寫上面的影片ID即可:
配置訂閱訊息模板編號
左側選單 “系統設定” --> “系統引數”,修改編號為 subscribe_ids 的那個引數即可(如果存在就修改);
訂閱號模板ID,多個用英文的逗號分隔 |
關於我們
登陸後臺,左側選單 “CMS模組” --> “單頁管理”,新增一個編號為 aboutus 的文章即可。
幫助中心
新增分類的時候,型別填寫: qa
然後在 “文章管理” 中,對應的分類下發布對應的文章即可
上線小程式
- 上傳程式碼到微信伺服器
- 提交稽核
登入“第一步”時候的小程式商戶後臺,左側選單 “版本管理” ,找到你剛才上傳的小程式版本,點選提交微信稽核,稽核透過以後即可正式釋出你的小程式
注意事項:
提交稽核介面,小程式訂單中心path
務必填下: pages/order-list/index
- 正式釋出你的小程式
登入“第一步”時候的小程式商戶後臺,左側選單 “版本管理” ,找到稽核透過的那個版本,點選立即釋出即可
wx.getLocation 改為 wx.getFuzzyLocation
微信申請 getLocation 介面的稽核比較嚴格,可能比較難申請到這個介面,可以用 wx.getFuzzyLocation 來代替: https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.getFuzzyLocation.html
開發工具,全域性替換以下程式碼:
需要替換3次
scope.userLocation
替換為 scope.userFuzzyLocation
如圖:
再全域性替換程式碼:
wx.getLocation
替換為 wx.getFuzzyLocation
再全域性替換程式碼:
"getLocation"
替換為 "getFuzzyLocation"
常見問題
《"regeneratorRuntime is not defined"》
《無法登入》
《微信支付50000錯誤 / 簽名錯誤》
《繫結手機號碼介面顯示失敗》
《生成商品海報/分銷中心一直轉轉轉》
《如何配置訂閱訊息》
api scope is not declared in the privacy agreement
錯誤:
https://www.zhuige.com/index/news/detail/id/1902.html
上傳程式碼[getFuzzyLocation] is not authorized
因為你沒用申請getFuzzyLocation
介面的許可權:
https://mp.weixin.qq.com/
去申請開通這3個介面的許可權即可,上圖提示 暫無許可權
的原因是因為你沒用新增類目,右上角頭像點進去,服務類目新增了以後就可以申請了
稽核的時候說有直播業務需要刪除
- app.json 檔案刪除分包
- 刪除分包資料夾
底部選單調整以後,購物車紅色數字位置顯示不對
小紅點的位置,預設是3,也就是底部第四個選單,因為陣列是從 0 開始的
還有其他問題,請檢視專案主頁上面的 “常見問題內容說明”
https://github.com/EastWorld/wechat-app-mall
https://gitee.com/javazj/wechat-app-mall
Copyright © 杭州於芯科技有限公司
浙ICP備15041833號