頭條/抖音小程序商城，頭條/抖音小程序微店，長期維護(hù)版本

好的開源產(chǎn)品離不開大家的支持和一同維護(hù)，首先感謝大家。

特別鳴謝

本項(xiàng)目是基于 “EastWorld” 的 “wechat-app-mall” 的微信小程序商城進(jìn)行改造，且同步更新，詳細(xì)功能請(qǐng)參閱微信小程序的版本：

https://gitee.com/javazj/wechat-app-mall

接口 & 后臺(tái)聲明

本項(xiàng)目未有開發(fā)配套的后臺(tái)系統(tǒng)，而是直接使用了 api 工廠 提供的免費(fèi)接口和后臺(tái)，可以完全滿足本項(xiàng)目的所有功能需求。

• 接口 SDK

• 免費(fèi)后臺(tái)

• WeUI

初始化測試數(shù)據(jù)

登錄后臺(tái)，左側(cè)菜單 “工廠設(shè)置” --> “數(shù)據(jù)克隆” --> “將別人的數(shù)據(jù)克隆給我”

對(duì)方商戶ID填寫 951

點(diǎn)擊 “立即克隆” ，然后退出后臺(tái)重新登錄

你將立即享有初始化測試數(shù)據(jù)，方便你進(jìn)行測試

編譯說明

請(qǐng)時(shí)刻保證你的開發(fā)工具是最新版，如果不是最新版，請(qǐng)先升級(jí)你的開發(fā)工具

使用說明

1、申請(qǐng)后臺(tái)賬號(hào)/獲取專屬域名

2、開通商城模塊

3、修改根目錄下 config.js 文件

module.exports = {
  version: "5.0",
  note: "優(yōu)化接口調(diào)用流程",
  subDomain: "tz", // 根據(jù)教程 https://www.yuque.com/apifm/doc/qr6l4m 查看你自己的 subDomain
  appid: "wxa46b09d413fbcaff", // 您的小程序的appid，購物單功能需要使用
  shareProfile: "百款精品商品，總有一款適合您" // 首頁轉(zhuǎn)發(fā)的時(shí)候話術(shù)
};
/*
根據(jù)自己需要修改下單時(shí)候的模板消息內(nèi)容設(shè)置，可增加關(guān)閉訂單、收貨時(shí)候模板消息提醒；
1、/pages/to-pay-order/index.js 中已添加關(guān)閉訂單、商家發(fā)貨后提醒消費(fèi)者；
2、/pages/order-details/index.js 中已添加用戶確認(rèn)收貨后提供用戶參與評(píng)價(jià)；評(píng)價(jià)后提醒消費(fèi)者好評(píng)獎(jiǎng)勵(lì)積分已到賬；
3、請(qǐng)自行修改上面幾處的模板消息ID，參數(shù)為您自己的變量設(shè)置即可。  
*/

4、設(shè)置小程序合法服務(wù)器域名

5、重啟您的小程序開發(fā)工具，完成

6、如何在后臺(tái)管理小程序啟動(dòng)圖和首頁頭部的輪播 banner 圖片

這兩個(gè)功能都是使用后臺(tái) “系統(tǒng)設(shè)置” --> “banner” 管理功能來實(shí)現(xiàn)的；
后臺(tái)發(fā)布banner的時(shí)候，自定義類型請(qǐng)分別填寫  app  和  new
小程序會(huì)自動(dòng)讀取類型為 app 的banner圖片作為啟動(dòng)展示圖片；
小程序會(huì)自動(dòng)讀取類型為 new 的banner圖片作為首頁分類下的輪播圖；

系統(tǒng)參數(shù)設(shè)置

登錄后臺(tái)，左側(cè)菜單“系統(tǒng)設(shè)置” --> “系統(tǒng)參數(shù)” 菜單；如果你找不到該菜單，那是因?yàn)槟氵€沒啟用 “系統(tǒng)參數(shù)設(shè)置” 的模塊，左側(cè)菜單“系統(tǒng)設(shè)置” --> “模塊管理”，啟用 “系統(tǒng)參數(shù)設(shè)置” 模塊，然后F5刷新網(wǎng)頁即可

• RECHARGE_OPEN （開關(guān)類型）

  微信審核的時(shí)候，如果你的小程序有充值功能會(huì)導(dǎo)致審核不通過，所以默認(rèn)情況下，小程序?qū)㈦[藏充值提現(xiàn)功能，通過該參數(shù)可開啟充值提現(xiàn)的顯示

• ROLE_FOR_SHOP （開關(guān)類型）

  如果你有多店鋪功能，改功能將開啟店鋪管理員功能，屆時(shí)，每個(gè)店鋪管理員將只能管理自己店鋪下的商品和訂單，而無法查看并管理其他店鋪的訂單

• ALLOW_SELF_COLLECTION （開關(guān)類型）

  是否開啟到店自提功能（快遞和到店自提客戶自己可以選擇）

• WITHDRAW_FEE_PERCENT （文本參數(shù)）

  提現(xiàn)手續(xù)費(fèi)比例，填1為 1%

• free_shipping_for_purchases （文本參數(shù)）

  下單金額滿多少后實(shí)現(xiàn)包郵

• mallName （文本參數(shù)）

  小程序名稱（商城名稱）

• REGISTER_OPEN_SELLER （開關(guān)類型）

  新注冊(cè)用戶是否自動(dòng)成為分銷商，如果不開啟該參數(shù)，分銷商需要自己申請(qǐng)，你進(jìn)行審核

  《api工廠三級(jí)分銷插件使用教程》

常見問題

• 如何修改小程序商城的標(biāo)題？

  請(qǐng)查看上面的系統(tǒng)設(shè)置中的 mallName

• “無法登錄” / Token 無效 ？

  1. config.js 里面的 subDomain 改成你自己的，保存；
  2. 登錄你的小程序后臺(tái)（MP 那個(gè)地址），Request 域名處增加 api.it120.cc
  3. 確保小程序后臺(tái)（MP 那個(gè)地址） 的 appid，工廠后臺(tái)填寫的 appid ，開發(fā)工具右上角 “項(xiàng)目詳情” 打開后顯示的 appid ，這 3 個(gè) appid 是一模一樣的；
  4. 開發(fā)工具上點(diǎn)擊 “清除緩存” —> “編譯”

• 登錄后臺(tái)發(fā)布您自己的商品

• 如何給 Banner 增加鏈接，點(diǎn)擊打開某個(gè)商品？

• 工廠后臺(tái)設(shè)置 appid、secret、微信支付商戶號(hào)和秘鑰時(shí)候的 token 怎么填？

  不要填！

  不要填！

  不要填！

  重要的事情說三遍，這個(gè)小程序用不到，是給服務(wù)號(hào)使用的，所以大家空著不要填

• 微信支付時(shí)候，提示 50000 錯(cuò)誤，不能獲取到預(yù)支付 id

  這個(gè)錯(cuò)誤是無法獲取到微信支付的預(yù)支付信息

  • 可能是你沒有在后臺(tái)配置您的微信支付商戶號(hào)和秘鑰，或者配置錯(cuò)誤
  • 可能是你配置的微信支付不是當(dāng)前小程序申請(qǐng)的（微信支付目前無法跨小程序調(diào)用）
  • 確保微信開發(fā)工具上面登錄的 APPID 和你在后臺(tái)配置的 APPID 是同一個(gè)

• 能否幫我免費(fèi)添加功能？

  可以！

  1. 點(diǎn)擊頁面頂部的 Star ，關(guān)注后，項(xiàng)目有最新動(dòng)態(tài) github 會(huì)提醒您，不錯(cuò)過重要更新；
  2. 點(diǎn)擊頁面頂部的 Fork， 將您需要增加的功能完成 小程序 端界面的調(diào)整，然后在 github 上請(qǐng)求將您的代碼合并
  3. 您的代碼合并請(qǐng)求審核通過后，我們將會(huì)為您完善配套的后臺(tái)功能；
  4. 開源項(xiàng)目離不開您的支持和代碼共享，我們一起把該項(xiàng)目長期維護(hù)下去；

• 下單的時(shí)候沒有地方填寫收貨地址？

  1. 添加一個(gè)“物流模板”，只有需要快遞的商品才會(huì)提示用戶填寫收貨地址
  2. 發(fā)布商品的時(shí)候，選擇剛才添加的“物流模板”
  3. 重新下單，將會(huì)需要用戶輸入收貨地址

• 如何使用退款功能？

  1. 后臺(tái)支持針對(duì)訂單指定退款多少金額；
  2. 可選擇退款至用戶可用余額或者按照用戶支付原路退還第三方或者銀行卡；
  3. 如果選用原路退還，需要在商戶號(hào)和秘鑰設(shè)置的地方上傳您的微信支付證書文件（PK12 格式文件）

• 如何設(shè)置滿多少包郵？

  1. 后臺(tái)系統(tǒng)設(shè)置 -- 系統(tǒng)參數(shù)，增加系統(tǒng)參數(shù)；
  2. 參數(shù)名 free_shipping_for_purchases （注意不要有空格）
  3. 參數(shù)值填寫您希望的買滿金額即可

• 如何修改或者關(guān)閉訂單超過 30 分鐘未付款自動(dòng)關(guān)閉？

  1. 創(chuàng)建訂單接口增加 expireMinutes 參數(shù)；
  2. 代表多少分鐘未支付自動(dòng)關(guān)閉本訂單，傳 0 不自動(dòng)關(guān)閉訂單；

• 我沒有那么多分類，首頁2行分類能否改成1行？

  打開 /pages/index/index.js 文件，找到下圖所示位置，代碼

  // 這行代碼為顯示2行
  const _n = Math.ceil(categories.length / 2)
  // 這行代碼為顯示1行
  const _n = Math.ceil(categories.length)

  

• 更多問題？

如何升級(jí)到最新版

• 小程序程序的修改和您后臺(tái)的數(shù)據(jù)是獨(dú)立的，所以不用擔(dān)心您會(huì)丟失數(shù)據(jù)
• 先把你開發(fā)工具下的現(xiàn)有版本程序備份
• 下載最新版的程序，直接覆蓋您本地的程序
• 用開發(fā)工具修改域名 tz 為你自己的域名
• 開發(fā)工具里面上傳代碼提交微信審核
• 審核通過后，小程序后臺(tái)去發(fā)布新版本即可
• 用戶無需重新掃碼，關(guān)閉小程序重新打開就是新版本了