# YouRanSNS for Fresns 场景化 SNS 解决方案

**Repository Path**: zjkxiaoqiangge/you-ran-sns

## Basic Information

- **Project Name**: YouRanSNS for Fresns 场景化 SNS 解决方案
- **Description**: YouRanSNS for Fresns 是一整套的可扩展社交解决方案，着重于个性化、定制化、场景化。需要一款个性化、场景化社交解决方案？来吧！一切，从这里开始。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.0313.co
- **GVP Project**: No

## Statistics

- **Stars**: 18
- **Forks**: 9
- **Created**: 2023-02-21
- **Last Updated**: 2024-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

需要一款个性化、场景化社交解决方案？来吧！一切，从这里开始！！！

## 简介

YouranSNS 是由悠然技术团队从零开发并持续维护的一款免费的社交软件解决方案，它致力于提供个性化、定制化以及场景化的服务体验，该项目严格遵循 Apache-2.0 开源协议，确保了其开放性和可自由使用性。

## YouranSNS 技术架构

在后端架构上，YouranSNS 选择了开源产品 Fresns（[Fresns](https://fresns.cn/)），该产品因其通用性强、适用场景广泛、灵活性高且同样坚持免费开源的原则，与 YouranSNS 的核心定位完美契合。因此，可以将 YouranSNS 理解为针对 Fresns 进行深度开发的客户端，即 "YouranSNS and Fresns"。

前端技术栈，YouranSNS 采用了 uni-app/vue3，确保了跨平台的一致性和高效性，使得该解决方案能够无缝兼容包括 App、小程序及 H5 在内的多种终端环境。

自设计初期，YouranSNS 就强调了 DIY 模块化设计理念，用户可以根据自身需求对诸多页面进行灵活多样的个性化定制，从而满足不同用户的独特诉求。

此外，我们还提供一系列配套的技术服务与商业合作选项，不仅涵盖了 YouranSNS 的基础安装配置服务，还包括但不限于对其的深度二次开发等专业支持，旨在满足客户多元化的技术需求和业务拓展诉求。

## YouranSNS 使用帮助

从这里开始，我们开始一步一步的学习、搭建我们自己的社交平台。

同时也可以加入 VIP 服务，把技术交给我们，您只负责运营项目、验证项目可行性、做大做强！[VIP服务详情](https://www.0313.co/vip.html)。

## YouranSNS 源码获取方式

源码获取地址（1）Fresns官方插件市场：[https://marketplace.fresns.cn/clients/detail/YouRanSNS](https://marketplace.fresns.cn/clients/detail/YouRanSNS)

源码获取地址（2）Dcloud插件市场：[https://ext.dcloud.net.cn/plugin?id=11023](https://ext.dcloud.net.cn/plugin?id=11023)

源码获取地址（3）Gitee：[https://gitee.com/zjkxiaoqiangge/you-ran-sns](https://gitee.com/zjkxiaoqiangge/you-ran-sns)

## 一、后端安装与配置

- [Fresns 官方文档](https://fresns.cn/guide/)
- [Fresns 常见问题](https://fresns.cn/guide/faq.html)
- [Fresns 官方社区](https://zhijieshequ.com/group/fresns)

## 二、视频教程

- [001.Fresns的安装与基础模板配置](https://www.bilibili.com/video/BV1FBVVeaExa/)
- [002.悠然客户端基础配置安装（小程序）](https://www.bilibili.com/video/BV1FBVVeaExQ/)
- [003.配置选项卡](https://www.bilibili.com/video/BV1nBVVeaE3m/)
- [004.幻灯片例子 DIY 机制](https://www.bilibili.com/video/BV1FBVVeaEWt/)
- [005.首页弹窗的配置](https://www.bilibili.com/video/BV1JBVVeaEX3/)
- [006.html万能模块](https://www.bilibili.com/video/BV1FBVVeaEcz/)
- [007.页面跳转方式](https://www.bilibili.com/video/BV1PhVVeTEJD/)
- [008.编辑器传参跳转](https://www.bilibili.com/video/BV1AhVVeTEVs/)
- [009.编辑器的配置](https://www.bilibili.com/video/BV15mVVexED2/)
- [010.小组的DIY](https://www.bilibili.com/video/BV1AhVVeTEW1/)
- [011.话题的DIY](https://www.bilibili.com/video/BV1AhVVeTEBM/)
- [012.列表组件的妙用](https://www.bilibili.com/video/BV1WhVVeTETK/)
- [013.小程序的打包与发布](https://www.bilibili.com/video/BV1AhVVeTEb8/)
- [014.App打包升级](https://www.bilibili.com/video/BV1phVVeTEXK/)
- [015.简单二次开发](https://www.bilibili.com/video/BV1AhVVeTEWK/)

## 三、其他相关

- [YouranSNS 字体图标](https://www.0313.co/YouransnsFile/iconfont/index.html)
- [YouranSNS 全局颜色、间距、字体大小](https://www.0313.co/post/SNn5ltBP)
- [YouranSNS 主导航的修改](https://www.0313.co/post/6vyAK0rM)
- [为什么要用原生导航栏而不是自定义导航](https://www.0313.co/post/oioF4CuM)
- [YouranSNS 编辑器配置](https://www.0313.co/post/afCDGTLZ)

## 四、二开相关

## 目录结构
### common 通用工具类
	- globalMethod.js 全局方法
	- globalStyle.scss 全局 css
	- iconfont 全局字体

### components 组件
	- box-chat 即时聊天组件
	- box-comment-fixed 浮动输入框
	- box-group-tree 小组列表树排列
	- box-group-tree1 选项式小组排序
	- box-sidebar-button 侧边按钮组件
	- box-swiper-hashtag 横向滑动标签
	- box-swiper-group 滑动小组
	- box-swiper-hot 一行滚动头条
	- box-swiper-list-post 滚动帖子
	- box-swiper-list-text 滚动帖子
	- box-swiper-list-user 滚动用户
	- box-swiper-list-user-1 滚动用户1
	- box-swiper-slide 幻灯片
	- global-audio 通用语音播放
	- global-empty 通用无数据
	- global-lazy-load-image 图片懒加载
	- global-loading 通用转圈loading
	- list-ask 问答列表
	- list-circle 朋友圈列表
	- list-comment 回复列表
	- list-default 默认列表
	- list-hashtag 话题列表
	- list-interaction 互动列表
	- list-simple-sorting 简单列表
	- list-vicinity-post 附近的帖子
	- list-waterfall 瀑布流列表
	- my-mark-post 我互动的帖子列表
	- my-mark-user 我互动的用户列表
	- public-list-files 附件显示
	- public-privacy-popup 微信隐私保护
	- screen-publish-1 整页发布
	- youransns-diy DIY总组件

### configJSON 默认配置文件，打包时可删除
	
	- 若干JSON文件

### locale 多语言文件夹
	- en.json 英文
	- index.js 配置文件
	- zh-Hans.json 中文简体
	- zh-Hant.json 中文繁体

### pages 主要页面
	- comment 评论
	- draft 草稿
	- editor 编辑器
	- group 小组
	- hashtag 话题
	- my 我的
	- navigation 3个DIY导航
	- notification 通知
	- pages 通用页面
	- post 帖子
	- search 搜索
	- user 用户

## uni.setStorageSync 本地同步储存
`headlineRecommendation` 首页的头条推荐
`accountAuthToken` 账号与用户的token
`clientDeviceInfo` fresns header 中的 X-Fresns-Client-Device-Info
`language` 语言设置
`diy_1_json` diy_1.json 缓存
`diy_2_json` diy_2.json 缓存
`diy_3_json` diy_3.json 缓存
`post_json` 帖子缓存

### 以下为监听
`editorPublishSuccess` 编辑器发布成功标识
`noticePostDeleteSuccess` 帖子删除后的通知
`noticeCommentDeleteSuccess` 评论删除后的通知
`extendWebView` 插件管理完成后的通知

## 演示

安卓App可以直接下载 [https://www.0313.co/YouransnsFile/youran.apk](https://www.0313.co/YouransnsFile/youran.apk)

小程序预览

![小程序预览](https://www.0313.co/storage/images/posts/202406/16/aJtjGb8I7cqmcYZSEYcmejlm-big.jpg "小程序预览")


## 关于版权

免费、开源、可商用，Apache-2.0 开源协议，不限形式二开、不限形式传播，但是一定要遵纪守法不得将 YouranSNS 用于任何违反法律的事情上。

## 加入我们

网址：[悠然创业社区](http://www.0313.co)

QQ群：592713454

QQ：97028048

微信群，加我拉群

![](https://www.0313.co/storage/images/posts/202406/16/7Ezozip33PFmA0gaWybswBej-big.png)

## 鸣谢

- [Fresns](https://fresns.cn) 一款免费开源的社交网络服务软件
- [uni-app](https://uniapp.dcloud.net.cn/) 是一个使用 Vue.js 开发所有前端应用的框架
- [mp-html](https://jin-yufeng.gitee.io/mp-html) 一个强大的富文本组件

YouranSNS 是采用 Apache-2.0 许可的开源项目，使用完全免费。

维护这样一个高质量的、长久性的开源项目是需要巨大的努力，只有在我们的赞助者慷慨的财务支持下才得以持续。

## VIP 服务联系

QQ：97028048

微信号：dabiaogejiayouya

[https://www.0313.co/vip.html](https://www.0313.co/vip.html)