Awesome

有问题请issue

项目名称

• 趣婚礼

• 基于Taro2 + 云开发 打造婚礼邀请函

Taro2

云开发

项目介绍

• 结婚的时候婚礼邀请函是一道必不可少的程序，但是没法去很好的留存我们的数据和回忆（除非有后端支持）。 最近刚好在学习Taro，所有就尝试基于Taro + 云开发快速的搭建一个婚礼邀请函小程序。

• 也有人会问，使用了云开发，怎么去管理数据呢，不用担心，云开发CMS帮你搞定，支持文本、富文本、图片、文件、关联类型等多种类型的可视化编辑。

CMS 概览

项目效果截图

模块划分

1. 邀请 =》邀请函信息
2. 相册 =》相册展示
3. 导航 =》婚礼举办地
4. 祝福 =》婚礼视频及弹幕留言，留言保存至留言列表
5. 留言 =》好友留言

目录结构

├── config                              # 配置文件
├── cloud                               # 云函数存放
├── dist                                # 打包文件
├── node_modules                        # 依赖的模块包
├── package.json                        # 项目基本信息
├── src                                 # 项目的核心组件
│   ├── service                         # 资源文件（css、image、config）
│   ├── common                          # 资源文件（css、image、config）
│   ├── components                      # 公共组件
│   ├── store                           # 状态管理（redux）
|   ├── pages                           # 页面文件目录
|   |   ├── Index                       # index页面目录
|   |   |   ├── index.jsx               # index页面逻辑
|   |   |   └── index.scss              # index页面样式
|   |   |   └── index.config.js         # index页面配置（小程序page.json内容）
│   ├── util                            # 公共方法(util.js、globalData.js)
│   ├── app.jsx                         # 入口文件
│   ├── app.scss                        # 公共样式
│   ├── index.html                      # 主页模板
├── static                              # 静态资源(CDN)
├── README.md                           # 项目描述信息

效果预览

视频演示

视频演示

部署

clone

clone该项目，并在project.config.json下修改自己的小程序appid

开通云开发

首先需要你在小程序的控制台去开通云开发，并拿到环境名称

在src/service/config下修改DBID为你自己申请的环境ID`；

新建数据库并导入

表的设计

• wedding_invite：婚礼信息

• wedding_msgs：留言祝福

• wedding_photos：相册

• wedding_video：视频

数据库文件存放在static/db下，按照文件名新建数据库集合，并导入数据文件即可完成数据库创建。

项目启动

• 使用yarn

安装依赖

yarn

编译和打包

 yarn dev:weapp
 yarn build:weapp

• 使用npm

安装依赖

 npm install

编译和打包

 npm run dev:weapp
 npm run build:weapp

具体可查看Taro教程

到此你就可以看到效果了...

云开发CMS的使用

用于管理云开发数据的CMS

CMS文档

CMS截图

CMS Web端

CMS端需要建立与数据库对应的内容模型，才能在列表正常展示对应数据库数据。

可直接导入内容模型，位于 static/schema

• 模型管理

• 内容管理

开发者工具端

圈出来的部分是和小程序云开发控制台数据库所对应的.

技术及框架

1.小程序

具体入门和使用，请访问官方文档。

• 小程序文档
• 小程序云开发

开发者可以使用云开发开发微信小程序、小游戏，无需搭建服务器，即可使用云端能力。包含云函数 、数据库、存储和云调用。

2.Taro2 + Redux

Taro2

Taro 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5 等应用。

项目中使用了最新版本Taro2，由于Taro3使用期间不是很丝滑，所以选择了Taro2

所以本项目可以作为Taro的学习入门，也可以作为小程序云开发的一个入门Demo

3.TaroUI

基于Taro2的UI框架

TaroUI

云开发的使用

官方文档

需要在控制台去开启云开发，并获取DBID（数据库初始化用到）

• 1. 云开发入口
• 2. 数据库配置

数据库

可以在项目中的service中去查看数据库的CURD代码。

有数据库基础的很容易就上手了，小程序的数据库其实就是一个JSON，类似于MongoDb。

顾名思义，数据库中的每条记录都是一个 JSON 格式的对象。一个数据库可以有多个集合（相当于关系型数据中的表），集合可看做一个 JSON 数组，数组中的每个对象就是一条记录，记录的格式是 JSON 对象。

操作

• 初始化

在开始使用数据库 API 进行增删改查操作之前，需要先获取数据库的引用。

const db = Taro.cloud.database({
    env: 'DBID'
});

• 数据库操作

要操作一个集合，需先获取它的引用。在获取了数据库的引用后，就可以通过数据库引用上的 collection 方法获取一个集合的引用了

db.collection('wedding_msgs')
   .orderBy('createTime', 'desc') // 时间升序
   .skip(current * 10)
   .limit(pageSize)
   .get()

这样每次都比较麻烦，所以我做了统一的处理，都写在service/cloud/index.js当中，并export，只需要按需引入，并传入要操作的数据库名称即可。

Tips：如果发现数据库有数据，但是拿不到所有数据，那应该就是数据库的权限问题了，改成仅创建者可写，所有人可读就可以了

云函数

官方文档

使用云函数去获取用户信息就变得简单多了，具体可翻阅文档！

项目中云函数所在目录，cloud/functions.js，项目中使用到了一个云函数，留言的内容过滤功能msgSecCheck， 具体使用方法：security.msgSecCheck

• 声明

/**
 * @Description: 文本内容过滤；
*/
// 云函数入口文件
const cloud = require('wx-server-sdk');

cloud.init();

// 云函数入口函数
exports.main = async function (event, context) {
    console.log(event);
    let opts = {
        content: event.content || ''
    };
    let fun = cloud.openapi.security.msgSecCheck(opts);

    return fun.then(res => {
        return res;
    }).catch(err => {
        return err;
    });
};

• 调用

    // 云调用内容安全过滤
    Taro.cloud.callFunction({
      name: 'msgCheck',
      data: { content: data.userMsg },
    }).then(res => {
      if (res && res.result && res.result.errCode === 0) {
          Taro.showLoading({
              title: '发送中...',
              mask: true
          });
          // 数据库插入留言数据
          cloud.add('wedding_msgs', data).then(msgRes => {
              resolve(msgRes);
          }, (err) => {
              console.log(err);
              reject(err);
          });
      } else {
          reject(res.result);
      }
    }).catch(err => {
      console.log(err);
      reject(err);
    });

ToDos

• 朋友圈海报生成...
• ...

这次的版本使用了Taro + 云开发，后面打算出一版Taro + Antd + koa2 + MongoDb的版本，初步内容已经差不错了，详见下面项目地址

Taro + Antd + koa2 + MongoDb

Taro3的坑

• redux使得下拉刷新和上拉加载冲突

• 无法阻止事件冒泡

• 无法使用 小程序的selectComponent，获取组件实例

const barrageComp = this.selectComponent('.barrage') 使用 Taro.createRef(); 代替

关于

• 个人主页
• CSDN
• 掘金

本项目仅供学习和交流，部分素材来源于网络，如有侵权联系删除。 项目有需改进也请留言和Issues， 如有合作请在博客留言或wx：（iforguo）。

编码不易，感谢各位大佬的吐槽和GitHub的Star

有问题请issue【这样也方便别人查阅】