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)備工作
目前小程序接口地址有兩個要求:
域名需要備案
,未備案域名暫時無法使用的;- 接口地址需要為
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è)置>微信小程序接口
):AppID
和AppSecret
,可以在微信小程序后臺開發(fā)>開發(fā)管理>開發(fā)設(shè)置
獲取,如圖:

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

百度智能小程序
接口配置
百度智能小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>百度小程序接口
):App Key
和App 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)目
-
將下載的小程序代碼包解壓,記住解壓的路徑;
-
打開百度小程序開發(fā)者工具;
-
新增項(xiàng)目,新增頁面上方會有
新建項(xiàng)目
和導(dǎo)入項(xiàng)目
的切換選項(xiàng),請務(wù)必選擇導(dǎo)入項(xiàng)目
; -
項(xiàng)目目錄
選擇第1步解壓的小程序路徑并設(shè)置好APPID; - 點(diǎn)擊完成按鈕完成項(xiàng)目新增。
附上開發(fā)者工具項(xiàng)目導(dǎo)入截圖:

4、修改配置信息
-
編輯
common/vendor.js
文件,找到第2行
,找不到的話直接使用快捷鍵搜索(CTRL+F,蘋果系統(tǒng)使用command+F)“此處替換成網(wǎng)站首頁地址
”關(guān)鍵字找到對應(yīng)位置; -
將引號里面的文字改成自己網(wǎng)站首頁地址即可(要保留引號,
https
協(xié)議地址); -
百度小程序默認(rèn)開啟
云加速
功能,可提高小程序加載速度,如需關(guān)閉可以將后面的cloudCache
字段true
改成false
; - 使用快捷鍵
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è)置>抖音小程序接口
):AppID
和AppSecret
,可以在抖音小程序后臺開發(fā)管理>開發(fā)設(shè)置
獲取,如圖:

服務(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
保存修改。

然后再編輯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
)保存修改。

最后還需要編輯project.config.json
文件,修改里面的appid
字段為自己的小程序APPID即可。
5、提交代碼
點(diǎn)擊開發(fā)者工具左上角菜單欄里面的上傳
,然后隨便設(shè)置下版本號以及更新日志即可。
6、提交審核
進(jìn)入抖音小程序管理后臺版本管理
,在測試版本
里面可以看到提交的代碼,然后提交審核即可。
7、發(fā)布上線
接到抖音審核通過的提醒后,進(jìn)入抖音小程序管理后臺版本管理
,在審核版本
里面找到通過審核的版本直接提交上線即可。
QQ小程序
接口配置
QQ小程序自帶登錄功能,這會涉及到登錄接口的配置(小程序>接口設(shè)置>QQ小程序接口
):AppID
和AppSecret
,可以在QQ小程序后臺開發(fā)>開發(fā)設(shè)置
獲取,如圖:

服務(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
)保存修改。

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