TheBiz 小程序使用文檔

安裝激活

小程序購買后可以在本站用戶中心>我的服務(wù)下載到一個(gè)插件安裝包，我們可以認(rèn)為這是一個(gè)小程序控制臺(tái)插件。

然后進(jìn)入自己網(wǎng)站后臺(tái)插件>安裝插件>上傳插件里面上傳小程序控制臺(tái)插件壓縮包文件，然后啟用，啟用后網(wǎng)站后臺(tái)左邊菜單會(huì)有個(gè)小程序入口，可以通過這個(gè)入口進(jìn)入到小程序控制臺(tái)。

第一次進(jìn)入小程序控制臺(tái)會(huì)要求激活，插件的激活授權(quán)和主題是一樣的，具體激活方法參考主題的激活流程：http://www.air-home.cn/docs/themer/auth.html

基礎(chǔ)設(shè)置

準(zhǔn)備工作

目前小程序接口地址有兩個(gè)要求：

  1. 域名需要備案，未備案域名暫時(shí)無法使用的；
  2. 接口地址需要為HTTPS，如果網(wǎng)站未開啟HTTPS需要先配置好HTTPS，另外部分網(wǎng)站SSL證書配置不規(guī)范也會(huì)導(dǎo)致校驗(yàn)失敗，建議使用此工具測試后評(píng)級(jí)達(dá)到A級(jí)標(biāo)準(zhǔn)。

后臺(tái)設(shè)置

小程序設(shè)置可以在小程序控制臺(tái)小程序里面進(jìn)行設(shè)置，比如小程序的接口設(shè)置、菜單設(shè)置等。

接口設(shè)置

小程序部分功能會(huì)涉及到和小程序平臺(tái)方的對(duì)接，比如登錄、百度小程序內(nèi)容提交、分享海報(bào)里面的小程序二維碼等功能。

接口設(shè)置在網(wǎng)站后臺(tái)小程序>接口設(shè)置里面，涉及到的接口信息獲取不同平臺(tái)有差異，下面分平臺(tái)說明下。

微信小程序

需要配置AppID和AppSecret，可以在微信小程序后臺(tái)開發(fā)>開發(fā)管理>開發(fā)設(shè)置獲取，如圖：

小程序AppID

百度智能小程序

需要配置App Key和App Secret，可以在百度智能小程序后臺(tái)管理>基礎(chǔ)設(shè)置>開發(fā)設(shè)置獲取，如圖：

百度小程序接口

服務(wù)器域名

小程序需要配置服務(wù)器域名用于驗(yàn)證各個(gè)接口請(qǐng)求地址的合法性，此項(xiàng)設(shè)置是在各個(gè)小程序平臺(tái)方管理后臺(tái)設(shè)置。

微信小程序

進(jìn)入微信小程序后臺(tái)開發(fā)-開發(fā)管理-開發(fā)設(shè)置，在服務(wù)器域名欄目下設(shè)置request合法域名、uploadFile合法域名、downloadFile合法域名、DNS預(yù)解析域名選項(xiàng)（如有其他選項(xiàng)也可以參考一樣填寫），全部設(shè)置為網(wǎng)站域名（協(xié)議前綴參考選項(xiàng)說明，后面地址全部是網(wǎng)站的域名，是否帶www的話需要和網(wǎng)站保持一致）。

百度智能小程序

進(jìn)入百度智能小程序后臺(tái)管理>基礎(chǔ)設(shè)置>開發(fā)設(shè)置，找到服務(wù)器域名，將里面的選項(xiàng)都增加上網(wǎng)站的域名（協(xié)議前綴參考選項(xiàng)說明，后面地址全部是網(wǎng)站的域名，是否帶www的話需要和網(wǎng)站保持一致）。

首頁設(shè)置（小程序可視化編輯器）

溫馨提示：請(qǐng)完成首頁設(shè)置后再提交代碼，否則首頁沒有內(nèi)容會(huì)導(dǎo)致審核無法通過。

操作步驟

1、使用小程序可視化編輯器編輯

TheBiz小程序內(nèi)置小程序可視化編輯器工具，如果某個(gè)頁面需要開啟可視化編輯器的話，可在后他頁面編輯頁下方設(shè)置選項(xiàng)>小程序設(shè)置開啟，如圖：

小程序可視化編輯器

2、進(jìn)入小程序可視化編輯器

回到后臺(tái)頁面列表，如果某個(gè)頁面已經(jīng)被設(shè)置為使用小程序可視化編輯器，那么鼠標(biāo)移到對(duì)應(yīng)頁面上方會(huì)出現(xiàn)小程序可視化編輯入口，點(diǎn)擊即可進(jìn)入，如圖：

小程序可視化編輯器

3、使用可視化編輯器搭配模塊制作頁面

模塊添加操作部分和主題的可視化編輯器差不多，可以參考：主題可視化編輯器教程。

4、發(fā)布頁面，設(shè)置為小程序首頁

如需將頁面設(shè)置為小程序的首頁，可以點(diǎn)擊右上角設(shè)置圖標(biāo)，勾選設(shè)為小程序首頁選項(xiàng)，然后點(diǎn)擊提交，最后確認(rèn)頁面無誤以后點(diǎn)擊發(fā)布，如圖：

小程序可視化編輯器

注意事項(xiàng)

代碼提交發(fā)布

溫馨提示：

  • 提交發(fā)布前請(qǐng)確保首頁已使用小程序可視化編輯器創(chuàng)建并添加了內(nèi)容，無內(nèi)容的空白頁面會(huì)無法通過審核；
  • 目前所有后臺(tái)設(shè)置以及小程序可視化編輯器頁面的修改無需再次提交代碼；
  • 小程序版本更新如無特殊說明均需要重新下載并提交代碼以完成更新。

微信小程序

小程序控制臺(tái)（小程序>發(fā)布管理）提供了完善的微信小程序代碼提交發(fā)布流程，無需用戶自己管理提交代碼，只需要點(diǎn)幾下就可完成小程序發(fā)布上線，即使小白用戶也能輕松完成代碼提交部署。發(fā)布流程界面截圖如下：

小程序發(fā)布流程

百度智能小程序

1、代碼包下載

進(jìn)入后臺(tái)小程序>資源下載下載百度小程序代碼包，然后解壓到本地電腦。

2、安裝開發(fā)者工具

下載百度智能小程序開發(fā)者工具（點(diǎn)擊進(jìn)入下載頁面），然后安裝。

3、導(dǎo)入小程序項(xiàng)目

打開上面安裝的小程序開發(fā)者工具，然后導(dǎo)入項(xiàng)目，項(xiàng)目目錄選擇上面代碼包解壓后的目錄，并填寫自己的小程序APPID，然后提交導(dǎo)入。

4、修改配置信息

編輯common/vendor.js文件，找到第8行，找不到的話直接使用快捷鍵搜索(CTRL+F，蘋果系統(tǒng)使用command+F)“此處替換成網(wǎng)站首頁地址”關(guān)鍵字找到對(duì)應(yīng)位置，將引號(hào)里面的文字改成自己網(wǎng)站首頁地址即可（要保留引號(hào)，https協(xié)議地址），再使用快捷鍵Ctrl+S保存修改。百度小程序默認(rèn)開啟云加速功能，可提高小程序加載速度，如需關(guān)閉可以將后面的cloudCache字段true改成false。

百度小程序配置信息修改

5、提交代碼

點(diǎn)擊發(fā)布，然后隨便設(shè)置下版本號(hào)，其中最低基礎(chǔ)庫建議設(shè)置3.480及以上版本。

百度小程序提交

6、提交審核

進(jìn)入百度智能小程序管理后臺(tái)管理>版本管理>開發(fā)版本，提交審核。

7、發(fā)布上線

接到百度審核通過的提醒后，進(jìn)入百度智能小程序管理后臺(tái)管理>版本管理，在審核版本里面找到通過審核的版本直接提交上線即可。

常見問題

1、為什么小程序打開空白，一直加載中？

如果小程序提交發(fā)布上線后還未設(shè)置服務(wù)器域名則會(huì)出現(xiàn)接口域名驗(yàn)證失敗的問題，這時(shí)可以先配置好服務(wù)器域名，如果已經(jīng)配置那么則可能是APP本地緩存，可通過重啟對(duì)應(yīng)APP（比如微信/百度APP）解決，重啟APP后再進(jìn)入小程序即可。

2、為什么小程序里面的圖片無法加載？

可能是網(wǎng)站圖片開啟了防盜鏈，如果開啟圖片防盜鏈的話需要增加域名白名單：

// 微信平臺(tái)
servicewechat.com

// 百度平臺(tái)
smartapps.cn
*.smartapps.cn
*.bcebos.com

另外在微信小程序分享的場景下，需要圖片允許直接訪問（即允許Referer為空），否則分享給好友或者朋友圈的時(shí)候縮略圖可能出現(xiàn)加載失敗的情況。

3、小程序里面的視頻無法播放？

首先小程序?qū)τ谝曨l的支持是有限的，同時(shí)如果是第三方視頻平臺(tái)的iframe分享代碼也會(huì)無法正常播放，所以建議視頻使用mp4格式，也可支持m3u8格式。

4、小程序?qū)徍宋赐ㄟ^怎么辦？

如果是由于內(nèi)容的原因?qū)е挛赐ㄟ^的話可以嘗試跳轉(zhuǎn)首頁模塊以及菜單入口，避免審核的時(shí)候能直接看到對(duì)應(yīng)內(nèi)容；首頁上面也可以在小程序可視化編輯器里面設(shè)置隱藏或者刪除對(duì)應(yīng)模塊，最后只顯示一些可通過審核的內(nèi)容再提交審核，等審核通過后上線再修改設(shè)置信息顯示回來，小程序設(shè)置以及小程序可視化編輯器頁面里面的信息修改無需再次提交代碼的。

5、百度小程序的自動(dòng)同步索引頁P(yáng)ATH路徑是什么？

百度小程序支持自動(dòng)同步小程序文章資源，索引頁P(yáng)ATH路徑：/pages/sitemap/index

6、小程序每個(gè)頁面的頁面路徑是多少？

首頁：/pages/index/index
文章分類：/pages/term/index?id=分類ID  // 分類ID請(qǐng)?zhí)鎿Q成對(duì)應(yīng)分類的ID
文章詳情頁：/pages/single/index?id=文章ID  // 文章ID請(qǐng)?zhí)鎿Q成對(duì)應(yīng)文章的ID
頁面：/pages/page/index?id=頁面ID  // 頁面ID請(qǐng)?zhí)鎿Q成對(duì)應(yīng)頁面的ID
聯(lián)系表單頁：/pages/contact/index
名片頁：/pages/profile/index
菜單頁：/pages/menu/index
百度自動(dòng)同步索引頁：/pages/sitemap/index