- 免费开源,采用 Apache-2.0 开源协议。
- 采用 Skyline 渲染引擎和 glass-easel 组件框架
- 界面文字支持多语言,时间值支持多时区,针对海外用户也能满足需求。
- 支持 Donut 跨端方案,编译成 iOS 和 Android 应用也方便。
- 可应用为社交媒体领域,同样也可以当成 Blog 或 CMS 等其他用途。
技术框架
本小程序是基于 Fresns API 开发,采用小程序原生语言,纯净干爽,无耦合。二开时使用任何第三方服务或样式库时不用担心兼容和冲突问题,因为我没有在代码里使用和绑定任何其他元素,二开更方便。
框架 | 版本 | 用途 |
---|---|---|
Fresns | 3.x | 后端 API |
WeUI | 2.x | 小程序 UI 框架 |
使用说明
遵循 Fresns 客户端设计理念,小程序以结构化方式实现了全部功能,使用者可以根据自己的需求,自定义页面风格、交互体验、栏目命名、入口路径等,实现各自个性化的运营场景。
- 1、下载代码包
- 方法一:在「站点后台->应用中心->应用市场」访问本应用页,点击下载按钮
- 方法二:复制标识名,在后台应用中心点「下载应用」,输入标识名下载
- 2、解压后使用微信开发者工具导入项目,项目名称和 AppID 填写你的小程序信息;
- 3、从
/sdk/
文件夹复制env.example.js
文件到根目录,并重命名为env.js
,然后根据里面的描述填写你的配置信息(公共密钥); - 4、将你的
apiHost
录入到微信配置:公众平台->开发->开发管理->开发设置- 服务器域名
request合法域名
和uploadFile合法域名
- 业务域名
- 服务器域名
- 5、配置基础库最低可用版本
- 公众平台->设置->基本设置->版本设置->基础库最低可用版本
- 最低可用版本
3.1.0
- 6、申请位置信息接口
- 如果你不需要该功能,忽略下方开通描述,并删除
app.json
配置文件中"requiredPrivateInfos": ["chooseLocation"]
- 公众平台->开发->开发管理->接口设置
- 申请开通
wx.chooseLocation
打开地图选择位置 - 申请时,可使用编辑器页面截图作为使用场景
- 如果你不需要该功能,忽略下方开通描述,并删除
- 7、自定义开发
- 修改风格样式,或者使用第三方开发的风格样式覆盖原文件
- 导航栏位置
components/commons/tabbar/
- 回调处理
mixins/fresnsCallback.js
- 私有模式处理
mixins/common.js
this.checkFresnsSiteMode();
- 8、使用微信开发者工具上传代码,提交到微信公众平台。
小程序支持编译成 iOS 和 Android 移动应用,也可以编译成 Web 网页应用,具体方法阅读 Donut 教程。
备注说明
- 本小程序是为开发者准备的,所以 TabBar 平铺了所有功能,开发者定制 UI 时自行新增或删减。
- 为了纯净干爽,UI 只使用了微信原生样式组件,二开时,可以替换使用其他样式库,比如使用 TDesign 等。
- 本小程序的开发指南 https://docs.fresns.com/zh-hans/clients/sdk/wechat/
- 基于本小程序定制开发的案例: https://github.com/jevantang/zhijie-app
小程序隐私保护指引
- 选中的照片或视频信息:用于
发表附带图片或视频的内容
- 选中的文件:用于
发表附带文件的内容
- 选择的位置信息:用于
发表附带位置信息的内容
(未启用 chooseLocation 功能则无需选择该隐私功能) - 发布内容:用于
发表帖子和评论
- 剪切板:用于
复制分享链接和帖子内容中的超链接
- 设备信息:用于
记录互动和错误问题的日志
分类
运行要求
适用于
Fresns 3.x
关于
版本 3.0.6
发布时间 2024-07-07 15:40
Apache-2.0
- 修复若干问题
- 优化加载效果组件
- 优化用户中心页面体验
- 修复编辑器 uploadAppUrl 参数
- 修复设置页 LOGO 值缺失时报错
- 修复帖子 block 操作接口错误
- 优化登录页,兼容苹果 App 审核要求
- Web-View 额外加一个定时,解决 App 端 bindload 不生效问题
- 修复若干问题
- 更新 SDK
- 删除不兼容的样式
- 优化互动功能
- 适配编辑键名
- 修复话题和地理标签的互动功能
- 适配新版 Fresns API
- 采用 Skyline 渲染引擎和 glass-easel 组件框架
- 优化隐私指引弹窗
- 新增 App 版本更新提示
-
fresns.js
配置新增email
参数
- 适配列表页接口的分页信息
pagination
参数名 - 适配新的钱包交易记录参数名
- 修复注册和登录问题
- 优化关于页面
- 修复设备信息问题
- 修复若干问题
- 优化 API 结构
- 适配新的标头要求
- 修复用户主页点击帖子后没有进详情页
- 修复下拉刷新重复请求问题(增加防抖机制)
- 修复面板缓存调用问题
- 修复若干问题
- 视图优化
- 重构定位功能,移除插件方案,使用小程序 API
- 优化编译多端应用的功能
- 修复若干问题
- 支持微信新隐私政策
- 修复时区问题导致签名异常
- 修复未开启多语言功能时,语言切换未隐藏
- 关于页面,分别显示主程序和客户端版本号
- 修复若干问题
- 修复若干问题
- 修复若干问题
- 封装了新的方法
utils/fresnsUtilities.js
Fixes
- 修复若干视图问题
- 修复快速发表未判断审核状态的问题
- 修复上传接口必传 usageType 参数的问题
Added
- 屏蔽操作增加二次确认
- 小组详情页获取置顶帖子数据
stickyPosts
- 帖子和评论列表增加
whitelistKeys
- 新增账号注销申请和撤销功能
pages/account/delete-account
- 新增用户积分记录页面
pages/account/user-extcredits
- 评论组件增加「作者点赞了该评论」和「帖子作者」互动标识元素
components/comment/comment
- 编辑器新增「禁止发表」时的提示框,方便用户前往账号设置页
pages/editor/index
- 新增接口配置
- 客户端状态
fresnsApi.global.globalStatus
- 扩展频道
fresnsApi.global.globalChannels
- 用户扩展分值记录
fresnsApi.user.userExtcreditsLogs
- 客户端状态
Fixes
- 修复位置信息的隐私申明
app.json
scope.userLocation
- 修复评论互动图标参数错误
components/comment/section/interaction.js
- 修复用户注册时服务条款可选框
pages/account/register
- 修复若干视图体验
BREAKING CHANGES
- 样式库 WeUI 升级到 v2.6.6
- 基于本框架小程序,官方二开了一套与网站主题 Moments 体验一致的小程序
- Moments WeChat https://github.com/fresns/wechat-moments
- Moments Website https://github.com/fresns/themes/tree/release/Moments
Added
- 交互功能按钮的图标采用自定义配置参数
operations.buttonIcons
- 使用场景1:比如某个帖子内容是自拍照,点赞按钮可以配置为照相机图标。
- 使用场景2:比如某个用户是消息小能手,“关注”他的按钮可以是一个订阅图标。
- 用户页增加「管理扩展」的功能。
- 小程序初始化判断是否有新版本和设备支持状态,提示用户重启或升级。
- 新版本 2.x 开始
- 新启航⛵️
Fresns 应用市场 免责声明
Fresns 应用市场是 Fresns 扩展包存储库,它聚合了基于 Fresns 生态机制开发的公共或私有的扩展包。
Fresns 应用市场是一个开放的平台,任何注册为开发者的账号均可发布应用(认证的开发者可以发布收费应用)。所以 Fresns 应用市场无法全面监控由第三方上传至应用市场的应用程序,因此不保证应用程序的合法性、安全性、完整性、真实性或品质等。您从 Fresns 应用市场下载应用程序时,同意自行判断并承担所有风险,而不依赖于 Fresns 应用市场。
免费应用无特殊说明,开发者没有义务提供技术支持,请自行安装测试功能。
在任何情况下,Fresns 应用市场有权依法停止应用市场服务并采取相应行动,包括但不限于对于相关应用程序进行下架、暂停服务的全部或部分。由此对您及第三人可能造成的损失,Fresns 应用市场不承担任何直接、间接或者连带的责任。
Fresns