TheBiz 小程序使用文檔

安裝激活

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

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

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

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

準備工作

目前小程序接口地址有兩個要求：

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

后臺設(shè)置

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

接口設(shè)置

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

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

微信小程序

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

小程序AppID

百度智能小程序

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

百度小程序接口

服務(wù)器域名

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

微信小程序

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

百度智能小程序

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

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

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

操作步驟

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

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

小程序可視化編輯器

2、進入小程序可視化編輯器

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

小程序可視化編輯器

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

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

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

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

小程序可視化編輯器

注意事項

代碼提交發(fā)布

溫馨提示：

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

微信小程序

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

小程序發(fā)布流程

百度智能小程序

1、代碼包下載

進入后臺小程序>資源下載下載百度小程序代碼包，然后解壓到本地電腦。

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

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

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

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

4、修改配置信息

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

百度小程序配置信息修改

5、提交代碼

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

百度小程序提交

6、提交審核

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

7、發(fā)布上線

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

常見問題

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

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

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

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

// 微信平臺
servicewechat.com

// 百度平臺
smartapps.cn
*.smartapps.cn
*.bcebos.com

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

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

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

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

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

5、百度小程序的自動同步索引頁PATH路徑是什么？

百度小程序支持自動同步小程序文章資源，索引頁PATH路徑：/pages/sitemap/index

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

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