-
智能建站2.0项目源代码,支持安卓和苹果APP、微信支付宝百度等小程序平台。
-
智能建站2.0属于定制开发类的项目,建议下载源代码自行开发,或联系我们协助开发。
-
Logo、滚动广告、平铺广告、导航图标,可以使用服务器上的设置,也可以在源代码中自行设置。
-
小程序“模板选项”中的设置项并非全部支持,因为这些选项是为“通版商城”这个小程序模板而设置的, 但是导航栏背景和文字颜色、常用的显示模块等信息还是支持,其他没有涉及到的,直接在源代码中修改; 当然,这些支持的在线设置选项,在源代码中把读取和判断的逻辑去掉,就相当于自己设置了。
-
会员、商品、订单等,集成延誉宝SaaS云平台,支持大数据并发,性能稳定,不建议剥离。
-
当前支持发布的平台有: app-ios,app-android, h5, mp-weixin, mp-alipay, mp-baidu。
-
项目的设置和使用说明发布在这里:需要注册才能查看,使用手机号码登录即可。
http://yanyubao.tseo.cn/Supplier/ShopAppV2Mgr/index/setting_type/readme.html
-
主页镜像:关于智能建站2.0的说明,以及找到此文档的链接
-
最新的代码发布在Github上,喜欢记得点个小星星!
-
考虑到Github在国内访问速度较慢,也可以通过国内的Gitee查看(该镜像正在审核中)。
- 使用上的问题和疑问,请用微信扫码查看其他开发者的提问和回复记录,也可以在文章末尾写留言。
- 当前支持发布的平台有: app-ios,app-android, h5, mp-weixin, mp-alipay, mp-baidu。
-
基本信息:设置商城小程序基本信息,点击这里,设置站点名称和Logo图标,这些信息与H5商城同步。
-
滚动广告:设置小程序中的滚动广告,点击这里,将广告类型设置为“小程序商城首页滚动广告”。
-
平铺广告:设置小程序中的平铺广告,点击这里,将广告类型设置为“小程序商城首页平铺广告”。
-
导航图标:设置小程序中的导航图标,点击这里。
-
模板选项:设置小程序模板选项,点击这里,可以设置小程序商城的主题颜色、图片以及过审版等。
**首页 /pages/index/index **
- 支持的参数:
- parentid 推荐人的userid
- scene 来自微信小程序扫码后的自带参数,如果内容为“parentid_”开头,则是推荐者ID,否则默认为sellerid。
- sellerid 商户编号(非ID)
- goto_new_index 跳转到新的界面,不同于SaaS云后台的高级选项中的“首页跳转”,这里不会加载服务器端的设置项,所以跳转速度更快。支持下文的商城、会员、小程序、视频号等路径,路径中如果包含空格等,建议先做urlencode。
- 补充:关于首页的自动跳转到其他页面,有三种方式:
- (1)abot_data.js中设置“goto_new_index”这个选项,优先级最高。
- (2)通过参数“goto_new_index”,优先级较低,需要重新定义首页路径,例如“/pages/index/index?goto_new_index=xxxxxx”。
- (3)在SaaS云后台的高级选项中设置“首页跳转”。
商城商品相关
-
跳转商品详情
/pages/product/detail?productid=1234
- productid为必填项,具体数字在商品列表中获取,获取方式请参考 http://yanyubao.tseo.cn/saasdocs/861.html
-
跳转商品分类
/pages/category/category
- (可能会出现在底部导航中)
-
跳转商品列表
/pages/product/goods-list/goods-list?cataid=1234&cataname=分类001
- cataid为商品分类ID,具体数字在商品分类列表中获取,获取方式请参考 http://yanyubao.tseo.cn/saasdocs/861.html; 如果不填,则显示所有商品。
-
跳转商品评论
/pages/product/ratings/ratings (开发中)
-
跳转商品搜索结果
/pages/listdetail/listdetail?keyword=会员卡
- keyword为必填项,要搜索的商品关键词。
-
跳转购物车
/pages/cart/cart
-
跳转充值页
/pages/user/deposit/deposit
-
跳转优惠券
/pages/user/coupon/coupon
-
跳转订单列表
/pages/user/order_list/order_list
订单支付相关
-
跳转确认订单(下订单)界面
/pages/order/pay?productid=1234&total=12.34&extraData=abcdefg
-
productid为必填参数,可以为商品的ID,也可以为多个商品ID,例如“[1234,2345]”。
-
total和extraData为选填参数,total为总价格;extraData为任意扩展的参数,如果参数值为json,建议做BASE64后URLEncode再传递。
-
除此之外,选填参数还有:amount(商品数量)、single_price(商品单价)、all_price(总价格,同total)、ucid(优惠券ID)
-
用户在不登录的情况下生成订单,使用参数(1)no_user_login=1;(2)no_user_login_ext_data_str = '{}'。
-
-
跳转订单支付页
/pages/pay/payment/payment?orderid=20201234567
-
orderid为必填参数,值为系统中没有支付的订单的编号。
-
选填的参数包括:(1)balance_zengsong_dikou;(2)balance_dikou;(3)traffic_price;(3)user_coupon_dikou。
-
-
跳转支付成功页
/pages/pay/success/success
个人信息相关
-
跳转个人中心
/pages/tabbar/user
- (可能会出现在底部导航中)
-
跳转用户设置(个人资料)
/pages/user/setting/setting
-
跳转我的收藏
/pages/user/keep/keep
- (包括实体商家收藏)
-
跳转收货地址
/pages/user/address/address
-
跳转收货地址编辑页
/pages/user/address/edit/edit?addressid=1234
- addressid为必填项,具体数字在收货地址列表中获取
-
跳转我的二维码
/pages/user/myQR/myQR
-
跳转我的现金余额和明细
/pages/user/log
-
跳转我的赠款余额和明细
/pages/user/log?type=zengkuan
-
跳转我的积分余额和明细
/pages/user/logscore
-
关于小程序/关于我们
/pages/main/about/about
- 可以跳转到客服聊天功能
消息与对话
- 跳转消息列表 /pages/msg/msg
- 跳转聊天界面 /pages/msg/chat/chat
带参数的挂接入口为:“/pages/msg/chat/chat?type=0&userid=123456&name=用户昵称”。其中123456为用户ID。
文章内容(CMS)相关
-
跳转文章详情
/pages/help/detail?id=1234
1、文章详情页适用于“商城头条的文章”,其中的id为文章ID,可以在延誉宝CMS控制台的 微网站 或 图文回复 中找到ID。
2、文章详情页支持评论、收藏和点赞,如果隐藏评论功能,请在“CMS控制台”的具体项目的“基础应用>>留言板>>留言板配置”中,选择“需要审核”。
3、为了确保详情页的文章可以被正常的评论、点赞和收藏,需要在“ 系统配置 > 全局配置选项 > 延誉宝CMS控制台选项 > 登录信息同步”选中“CMS控制台”。
-
跳转文章列表
/pages/help/list
-
跳转文章列表
/pages/help/list?cms_token=abcdefg&cms_cataid=1234
- (指定文章分类)
-
跳转文章列表
/pages/help/list?article_list_style=list
- (按照列表分类显示:左侧图片,右侧为标题和简介)
-
跳转文章列表
/pages/help/list?article_list_style=icon
- (按照图标方式显示,上方为图片,下方为标题,建议标题不超过6个汉字)
1、文章列表默认显示“商城头条”中的内容,对应CMS控制台为“商户头条”这个分类,或者在“系统配置>>全局设置选项”中指定了商城头条的CMS Token和内容分类ID。
2、“商城头条”具体设置见:智能建站>>商城头条。
3、挂接其他分类的文章列表,请使用参数cms_token和cms_cataid;支持显示为列表或图标方式。示例如上。
4、另一种挂接文章内容的路径为论坛模式,请查询“ 论坛发帖相关”的模块。
自定义页面(CMS)相关
-
跳转自定义页面
/pages/welcome_page/welcome_page?scene=1234@4321@cms
-
1234为CMS的文章ID,4321为推荐者的userid,可以设置为0,cms为平台标志,支持cms和pic两个值。
-
具体参数见“SaaS云后台>>功能与扩展>>自定义页面”。
-
万能表单(CMS)相关
-
跳转自定义表单(万能表单)
/pages/publish/publish_write?form_type=2&token=abcdefg&formid=1234
- 支持(1)会员的扩展属性;(2)CMS控制台的万能表单模块(3)发表带自定义属性的文章。具体的设置说明: “SaaS云后台>>功能与扩展>>万能表单>>智能建站2.0”。
实体商家相关
- 查看路径: SaaS云控制台>>行业与应用>>实体/多商家入驻>>前端和商家入口>>
论坛发帖相关
- 论坛发帖的数据管理在CMS控制台的“文章列表”或者“图文消息”模块,查看挂接路径: 行业模块>>智能建站2.0>>更多功能模块,关于“发帖与评论”的说明。
小工具和小游戏
-
简约时钟 /pages/tools/clock
-
计算器 /pages/tools/calculator
-
掷骰子 /pages/tools/dice
-
扫雷 /pages/tools/mine_clearing
-
拼图 /pages/tools/puzzle (内测版)
-
涂鸦 /pages/tools/graffiti (微信小程序中正常,H5和APP中待验证)
-
记事本 /pages/tools/notepad
-
Todo List /pages/tools/todo_list
-
火星文 /pages/tools/leetspeak
-
智能抠图 /pages/tools/remove_img_bg
跳转到视频号相关的功能
-
(1)打开视频号视频
wxa_api openChannelsActivity [视频号 id] [视频 feedId]
- 举例:“wxa_api openChannelsActivity sphS4yv9ezcY4us export/UzFfAgtgekIEAQAAAAAAXCQsCSuQIAAAAAstQy6ubaLX4KHWvLEZgBPE1aM4WTRkOI79zNPgMJrZQ-qh4Sb9SjOQXokzylYT”。
-
(2)打开视频号活动页
wxa_api openChannelsEvent [视频号 id] [活动 id]
- 举例:“wxa_api openChannelsEvent sphS4yv9ezcY4us export/UzFfAgtgekIEAQAAAAAAXCQsCSuQIAAAAAstQy6ubaLX4KHWvLEZgBPE1aM4WTRkOI79zNPgMJrZQ-qh4Sb9SjOQXokzylYT”。
-
(3)打开视频号直播
wxa_api openChannelsLive [视频号 id]
- 举例:“wxa_api openChannelsLive sphS4yv9ezcY4us”。
-
(4)打开视频号主页(跳转到视频号主页)
wxa_api openChannelsUserProfile [视频号 id]
- 举例:“wxa_api openChannelsUserProfile sphS4yv9ezcY4us”。
视频号 id,以“sph”开头的id,可在视频号助手获取。
视频号的登陆网址为“ https://channels.weixin.qq.com/ ”,在首页可以查看自己的视频号ID。
如果是在APP中,点击以上链接会自动唤起手机中 的微信,然后自动跳转到视频号相关的功能页面;如果在百度、支付、抖音等其他版本的小程序中,则提示不支持此功能。
跳转到视频号直播和视频号活动,目前的规则是要求必须为同一个认证主体。
-
Tab页面和非Tab页面跳转
-
如果页面被tabBar包含,那么跳转的时候,需要指定,具体格式为:
switchTab [pagepath]
用空格分开,switchTab跳转的页面,不能带任何多余的参数,即不可以出现“?”及其后面的内容。
-
如果页面没有被tabBar包含,那么跳转的时候,需要指定,具体格式为:
navigateTo [pagepath]
用空格分开,navigateTo跳转的页面,可以带参数,参数放在“?”后面;
-
如果在同一个容器中跳转,请使用redirectTo
redirectTo [pagepath]
用空格分开,redirectTo跳转的页面,也可以带参数,参数放在“?”后面。
-
商城小程序默认情况下一般都会自动识别,而不需要指定switchTab或者navigateTo。
但是特殊的情况,如:
1、购物车默认都是在底部Tab上的,但是你发布的小程序版本没有在Tab上挂接购物车,那么在首页导航图标或者会员中心图标中增加购物车链接的时候,需要设置为 “navigateTo /pages/cart/cart”,如果不这样指定,会使用默认的switchTab而跳转失败。 商品分类页面也是类似这样的处理方式:“navigateTo /pages/category/index”。
2、有一些默认是不包含在底部Tab上的,但是你发布小程序的时候,将这个页面指定到了底部Tab上,那么跳转的时候,需要指定switchTab这个参数。例如“发圈发现随拍”的小程序挂接入口。
-
跳转到H5页面链接设置
-
跳转到H5页面,直接填写https://开头的网址,需要说明的是,对应的域名必须是在小程序登记的业务域名中,否则无法显示页面。
-
HTTP链接中支持的变量有:%oneclicklogin%, %ensellerid%, %wxa_appid%, %wxa_openid%,%userid%。
-
1、%oneclicklogin%一键登录获取用户信息参数, %ensellerid%商户编码, %wxa_appid%小程序appid, %wxa_openid%微信公众号粉丝openid,%userid%为当前登录用户的userid。
-
-
嵌入H5网页的时候,如果页面内设置了头部导航栏,会与小程序默认的导航栏重复,影响页面美观;在延誉宝系统的H5页面中,我们都做了自动判断,如果被小程序中引用,会自动隐藏H5的导航栏; 如果是在APP中引用延誉宝的H5,请在页面网址中增加参数“hidden_nav_header_h5=1”以达到隐藏的目的。
-
跳转H5网页默认方式为“navigateTo”,即小程序的左上角会显示返回的箭头图标。
-
(1)在小程序中,可以指定使用“redirectTo”跳转,跳转后左上角显示的是小房子图标,用于快速回到首页。
-
(2)在Android版本的APP中,不会出现左上角的返回图标,需要使用手机的返回功能直接返回原生的功能界面。
-
(3)在iPhone上,由于没有硬件返回按钮,会导致无法返回原生界面,所以不要做“redirectTo”的设置。
-
-
如果要控制网页被分享转发时候的文字和图片,请在挂接网址的同时,增加参数share_image和share_title,例如:
/pages/h5browser/h5browser?url=网址&share_title=分享时候的文字&share_image=分享时候显示的图片
以上三个参数务必使用urlencode转换之后在赋值使用。
-
对于H5页面内需要反复跳转的网页应用,建议使用redirectTo跳转,以避免用户反复点击返回键产生疑惑。
设置方式:在H5网页的末尾添加“#redirectTo”。例如: https://app.tseo.cn/o2owaimai/Merchant/MerchantWap/index/ensellerid/pQNNmSkaq?refresh_token_value=%refresh_token%&synchronize_userid=1
支持“redirectTo”的跳转设置为: https://app.tseo.cn/o2owaimai/Merchant/MerchantWap/index/ensellerid/pQNNmSkaq?refresh_token_value=%refresh_token%&synchronize_userid=1#redirectTo
-
跳转到其他小程序链接设置
-
跳转到其他小程序,使用填写以下格式:
miniprogram [url] [appid] [pagepath] [extraData]
用空格分开。
[url]替换为网址,[appid]替换为要跳转的小程序,[pagepath]替换为小程序的路径,可以包含参数,如 /pages/detail/detail?id=1577。
[extraData]为模板小程序应用级别的参数(App.onLaunch,App.onShow中获取),如 {"sellerid":"abcdef","userid":"1234"},内容中不能留空格,变量名称和变量值必须用双引号。
-
在APP中唤起微信小程序,设置相同,会识别APP环境,唤起微信并自动打开小程序和对应的页面;需要将appid换成小程序账号(gh_开头的),同时extraData参数不会被使用。
-
百度小程序中的相互跳转,设置相同,需要将appid换成百度智能小程序的app key,而不是填几个数字的appid。
-
小程序官方平台最新的升级,要求跳转其他小程序需要先申明要跳转的小程序ID,所以这里的appid, 需要在发布小程序新版本的时候添加,登录延誉宝CMS后的设置路径为: 项目设置 >>小程序版本控制。如果已经登录,点击这里设置。
-
-
拨打电话
-
如果需要拨打电话,请按照以下格式填写:
tel:[phone_number]
举例:“tel:13812345678”。
-
如果你会简单的代码开发,最好了解一点微信小程序的开发工具,那么,接下来的文档完全可以简单读懂。
源代码的编译和二次开发,在uniapp环境操作,具体的步骤如下:
- 下载项目源代码:
通过github或延誉宝官网(www.abot.cn)下载,建议通过github下载最新版本的源代码。
-
在HBuilder X中打开项目。
-
修改配置:
-
【必改】打开项目根目录下的 abot_data.js,如下图所示:
-
修改 default_sellerid 为自己的延誉宝商户编号;
-
修改xiaochengxu_appid为自己的小程序appid;
-
修改current_platform为当前要发布的平台名称,可以设置的值有: app, h5, mp-weixin, mp-alipay, mp-baidu。
-
-
【可选项】在项目根目录下,打开pages.json,
- 找到 navigationBarTitleText 将值改为自己的网站名称,还可以自定义标题文字的颜色和顶部导航的背景色。
备注:微信小程序、百度智能小程序、支付宝小程序对应的appid各不相同,请不要填错了。
- 发布项目
-
通过 HBuilder X将项目导入到不同的小程序开发环境中编译并提交发布。
-
发布为APP的操作过程类似,支持uniapp云打包,也可以本地打包为apk或者ipa文件。
-
打包为ipa文件才可以申请上架苹果应用商店(App Store),如果本地打包,需要在Mac OS环境下运行XCode编译。
-
接口文档
文档中没有涉及到的API接口,可以在项目源代码中通过“网络控制台”查看。
-
源代码主页
是否支持App Store的苹果超级签名?
项目本身并不涉及到超级签,建议通过TestFlight做免签发布,比超级签稳定。
支持上架安卓市场吗?
国内的安卓市场鱼龙混杂,各种上架要求各不相同,但是基本都要有与APP名称一致的软件著作权才可以申请上架,申请软件著作权请查看《在上海也能直接申请软件著作权啦!》