JustWeapp 小程序使用文檔

安裝激活

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

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

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

小程序設(shè)置

準(zhǔn)備工作

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

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

后臺設(shè)置

小程序設(shè)置可以在小程序控制臺小程序里面進(jìn)行設(shè)置,比如首頁文章列表、底部導(dǎo)航菜單、流量主廣告等。

溫馨提示

目前所有后臺設(shè)置修改無需再次提交代碼。

微信小程序

接口配置

微信小程序自帶微信登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>微信小程序接口):AppIDAppSecret,可以在微信小程序后臺開發(fā)>開發(fā)管理>開發(fā)設(shè)置獲取,如圖:

小程序AppID

提交發(fā)布

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

小程序發(fā)布流程

百度智能小程序

接口配置

百度智能小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>百度小程序接口):App KeyApp Secret,可以在百度智能小程序后臺管理>基礎(chǔ)設(shè)置>開發(fā)設(shè)置獲取,如圖:

百度小程序接口

服務(wù)器域名配置

進(jìn)入百度智能小程序后臺管理>基礎(chǔ)設(shè)置>開發(fā)設(shè)置,找到服務(wù)器域名,將里面的選項(xiàng)都增加上網(wǎng)站的域名。

提交發(fā)布

1、代碼包下載

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

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

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

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

  1. 將下載的小程序代碼包解壓,記住解壓的路徑;

  2. 打開百度小程序開發(fā)者工具;

  3. 新增項(xiàng)目,新增頁面上方會有新建項(xiàng)目導(dǎo)入項(xiàng)目的切換選項(xiàng),請務(wù)必選擇導(dǎo)入項(xiàng)目;

  4. 項(xiàng)目目錄選擇第1步解壓的小程序路徑并設(shè)置好APPID;

  5. 點(diǎn)擊完成按鈕完成項(xiàng)目新增。

附上開發(fā)者工具項(xiàng)目導(dǎo)入截圖:

百度小程序項(xiàng)目導(dǎo)入

4、修改配置信息

  1. 編輯common/vendor.js文件,找到第2行,找不到的話直接使用快捷鍵搜索(CTRL+F,蘋果系統(tǒng)使用command+F)此處替換成網(wǎng)站首頁地址”關(guān)鍵字找到對應(yīng)位置;

  2. 將引號里面的文字改成自己網(wǎng)站首頁地址即可(要保留引號,https協(xié)議地址);

  3. 百度小程序默認(rèn)開啟云加速功能,可提高小程序加載速度,如需關(guān)閉可以將后面的cloudCache字段true改成false;

  4. 使用快捷鍵Ctrl+S(蘋果系統(tǒng)使用command+S)保存修改。
百度小程序配置信息修改

5、提交代碼

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

百度小程序提交

6、提交審核

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

7、發(fā)布上線

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

抖音(字節(jié)跳動)小程序

接口配置

抖音小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>抖音小程序接口):AppIDAppSecret,可以在抖音小程序后臺開發(fā)管理>開發(fā)設(shè)置獲取,如圖:

字節(jié)跳動小程序接口

服務(wù)器域名配置

進(jìn)入抖音小程序后臺開發(fā)>開發(fā)配置>域名管理,找到服務(wù)器域名,將里面的選項(xiàng)都增加上網(wǎng)站的域名。

同時建議設(shè)置一下小程序基礎(chǔ)庫版本設(shè)置>基礎(chǔ)設(shè)置>功能信息,找到小程序基礎(chǔ)庫版本選項(xiàng),建議修改成2.89.0及以上版本。

提交發(fā)布

1、代碼包下載

進(jìn)入后臺小程序>資源下載下載抖音小程序代碼包,然后解壓到本地電腦。

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

下載抖音小程序開發(fā)者工具(點(diǎn)擊進(jìn)入下載頁面),然后安裝。

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

打開上面安裝的小程序開發(fā)者工具,然后點(diǎn)擊界面的導(dǎo)入按鈕,項(xiàng)目目錄選擇上面代碼包解壓后的目錄。

4、修改配置信息

首先編輯app.json文件,找到最后面的prefetches字段,將引號里面的地址修改成自己的(要保留引號),即替換首頁的地址,后面的參數(shù)需要保留,舉個例子:如果您的網(wǎng)站首頁地址是https://www.abc.com,那修改后就是https://www.abc.com/index.php?rest_route=/wpcom/v1/config,再使用快捷鍵Ctrl+S保存修改。

字節(jié)跳動小程序配置信息修改

然后再編輯common/vendor.js文件,找到第2行,找不到的話直接使用快捷鍵搜索(CTRL+F,蘋果系統(tǒng)使用command+F)此處替換成網(wǎng)站首頁地址”關(guān)鍵字找到對應(yīng)位置,將引號里面的文字改成自己網(wǎng)站首頁地址即可(要保留引號,https協(xié)議地址),再使用快捷鍵Ctrl+S(蘋果系統(tǒng)使用command+S)保存修改。

字節(jié)跳動小程序配置信息修改

最后還需要編輯project.config.json文件,修改里面的appid字段為自己的小程序APPID即可。

5、提交代碼

點(diǎn)擊開發(fā)者工具左上角菜單欄里面的上傳,然后隨便設(shè)置下版本號以及更新日志即可。

6、提交審核

進(jìn)入抖音小程序管理后臺版本管理,在測試版本里面可以看到提交的代碼,然后提交審核即可。

7、發(fā)布上線

接到抖音審核通過的提醒后,進(jìn)入抖音小程序管理后臺版本管理,在審核版本里面找到通過審核的版本直接提交上線即可。

QQ小程序

接口配置

QQ小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>QQ小程序接口):AppIDAppSecret,可以在QQ小程序后臺開發(fā)>開發(fā)設(shè)置獲取,如圖:

QQ小程序接口

服務(wù)器域名配置

進(jìn)入QQ小程序后臺開發(fā)>開發(fā)設(shè)置,找到服務(wù)器域名,將里面的選項(xiàng)都增加上網(wǎng)站的域名。

提交發(fā)布

1、代碼包下載

進(jìn)入后臺小程序>資源下載下載QQ小程序代碼包,然后解壓到本地電腦。

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

下載QQ小程序開發(fā)者工具(點(diǎn)擊進(jìn)入下載頁面),然后安裝。

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

打開上面安裝的小程序開發(fā)者工具,然后點(diǎn)擊界面的新建項(xiàng)目,項(xiàng)目目錄選擇上面代碼包解壓后的目錄,并填寫好APPID,后端服務(wù)勾選不使用云服務(wù)。

4、修改配置信息

編輯common/vendor.js文件,找到第2行,找不到的話直接使用快捷鍵搜索(CTRL+F,蘋果系統(tǒng)使用command+F)此處替換成網(wǎng)站首頁地址”關(guān)鍵字找到對應(yīng)位置,將引號里面的文字改成自己網(wǎng)站首頁地址即可(要保留引號,https協(xié)議地址),再使用快捷鍵Ctrl+S(蘋果系統(tǒng)使用command+S)保存修改。

QQ小程序配置信息修改

5、提交代碼

點(diǎn)擊開發(fā)者工具右上角菜單欄里面的上傳,然后隨便設(shè)置下版本號以及項(xiàng)目備注即可。

6、提交審核

進(jìn)入QQ小程序管理后臺開發(fā)>版本設(shè)置,在開發(fā)版本里面可以看到提交的代碼,然后提交審核即可。

7、發(fā)布上線

接到QQ小程序?qū)徍送ㄟ^的提醒后,進(jìn)入小程序管理后臺開發(fā)>版本設(shè)置,在審核版本里面找到通過審核的版本直接提交上線即可。

支付寶小程序

接口配置

支付寶小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>支付寶小程序接口):APPID應(yīng)用私鑰,可以在支付寶小程序后臺開發(fā)設(shè)置獲取,如圖:

支付寶小程序接口

左上角那一串?dāng)?shù)字就是APPID,點(diǎn)開設(shè)置后會有加簽管理彈框,在里面可以設(shè)置密鑰信息,其中選擇加簽?zāi)J?/code>選項(xiàng)選擇公鑰,下面的填寫公鑰字符可以根據(jù)選項(xiàng)下方給出的工具生成,生成后將其中的公鑰填寫到這里,剩下一個私鑰就是填寫到網(wǎng)站后臺小程序>常規(guī)設(shè)置>支付寶小程序接口應(yīng)用私鑰選項(xiàng)。

支付寶小程序接口

服務(wù)器域名配置

進(jìn)入支付寶小程序后臺開發(fā)設(shè)置,找到服務(wù)器域名白名單,增加上網(wǎng)站的域名。

能力添加

進(jìn)入支付寶小程序后臺產(chǎn)品綁定,點(diǎn)擊綁定產(chǎn)品添加獲取會員基礎(chǔ)信息、小程序端基礎(chǔ)產(chǎn)品小程序-權(quán)限集-小程序碼

提交發(fā)布

1、代碼包下載

進(jìn)入后臺小程序>資源下載下載支付寶小程序代碼包,然后解壓到本地電腦。

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

下載支付寶小程序開發(fā)者工具(點(diǎn)擊進(jìn)入下載頁面),然后安裝。

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

打開上面安裝的小程序開發(fā)者工具,然后點(diǎn)擊右上角打開項(xiàng)目,選擇上面代碼包解壓后的目錄。

4、修改配置信息

編輯common/vendor.js文件,找到第2行,找不到的話直接使用快捷鍵搜索(CTRL+F,蘋果系統(tǒng)使用command+F)此處替換成網(wǎng)站首頁地址”關(guān)鍵字找到對應(yīng)位置,將引號里面的文字改成自己網(wǎng)站首頁地址即可(要保留引號,https協(xié)議地址),再使用快捷鍵Ctrl+S(蘋果系統(tǒng)使用command+S)保存修改。

支付寶小程序配置信息修改

5、提交代碼

點(diǎn)擊右上角上傳,將代碼上傳到小程序管理后臺。

6、提交審核

進(jìn)入支付寶小程序管理后臺開發(fā)管理>版本管理>開發(fā)版本,提交審核。

7、發(fā)布上線

接到支付寶審核通過的提醒后,進(jìn)入支付寶小程序管理后臺開發(fā)管理,在審核版本里面找到通過審核的版本直接提交上線即可。

常見問題

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

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

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

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

// 微信平臺
servicewechat.com

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

// QQ平臺
*.qq.com

// 支付寶平臺
*.alipay-eco.com
*.alipay.com
127.0.0.1

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

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

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

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

如果是由于內(nèi)容的原因?qū)е挛赐ㄟ^的話可以嘗試在小程序>常規(guī)設(shè)置里面將不需要的內(nèi)容先不顯示,例如隱藏底部菜單的快訊專題;首頁的文章列表可以通過排除分類只顯示一些正??赏ㄟ^審核的內(nèi)容;首頁上面的分類切換也可以設(shè)置隱藏,最后只顯示一些可通過審核的內(nèi)容再提交審核,等審核通過后上線再修改設(shè)置信息顯示回來,小程序常規(guī)設(shè)置里面的信息修改無需再次提交代碼的。

5、微信小程序要求完善【用戶隱私保護(hù)指引】后再重新提審

微信小程序?qū)徍瞬煌ㄟ^,拒絕原因:

1:小程序功能不符合規(guī)則:
(1):你好,小程序內(nèi)涉及收集"相冊(僅寫入)權(quán)限/手機(jī)號"相關(guān)接口或組件,請通過接口完善【用戶隱私保護(hù)指引】后再重新提審。

這種情況主要是需要完善用戶隱私保護(hù)指引,目前我們在提交代碼環(huán)節(jié)會自動通過接口完善,所以出現(xiàn)這種情況建議重新點(diǎn)擊第二步的提交代碼(建議可以多點(diǎn)幾次),然后再重新提交審核;另外根據(jù)以往經(jīng)驗(yàn),建議按順序執(zhí)行發(fā)布流程,不要再往后倒著操作,比如已經(jīng)提交審核了就不要再次點(diǎn)擊提交代碼,否則可能也會出現(xiàn)這種情況。

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

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

7、小程序廣告如何添加和配置?

小程序廣告位添加和配置可以參考JustWeapp小程序流量主廣告配置教程

8、小程序每個頁面的頁面路徑是多少?

首頁:/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
專題匯總列表:/pages/special/index
專題文章列表:/pages/term/index?type=special&id=專題ID  // 專題ID請?zhí)鎿Q成對應(yīng)專題的ID
快訊頁:/pages/kuaixun/index
問答頁:/pages/question/index
問答詳情頁:/pages/question/single?id=問題ID  // 問題ID請?zhí)鎿Q成對應(yīng)問題文章的ID
問答分類頁:/pages/term/index?type=qa_cat&post_type=qa_post&id=問答分類ID  // 問答分類ID請?zhí)鎿Q成對應(yīng)問答分類的ID
問答提問頁:/pages/question/add
用戶個人主頁:/pages/user/index?id=用戶ID  // 用戶ID請?zhí)鎿Q成對應(yīng)用戶的ID
搜索頁:/pages/search/index
登錄頁:/pages/login/index
我的:/pages/profile/index