微信小程序留言助手使用指南

前言

由于之前前段时间比较忙，没有对上传的代码进行详细的注释。非常抱歉，所以今天利用一天的时间，把前后台的代码项目结构做了一个整体的简介。

很多小伙伴加我微信问我关于这个小程序的问题，我在这里也统一说一下。如果只想单单的给公众号加一个留言功能，我建议没必要自己去做了，因为很多热你都没有编程基础，要想做出来，必须从基础开始看，这个过程非常考验你的学习能力的。因为我的《小鹿留言助手》已经发布，可以关联多个公众号，前提是粉丝量大于 1000 可以关联哦！因为服务器费用都是小鹿自己掏腰包，我还是个学生，没什么收入来源，小程序也是免费关联的，所以粉丝不多的前期留言不怎么重要，还是好好做内容吧。

另一方面就是，如果你想用小程序留言来学习小程序，可以亲自动手根据小鹿提供的源码自己写一个，说实话，我是从零开始学习小程序的，包括后台的代码都是自学的，因为现在所在的大学是三流大学，只能靠自己去学习研究，服务器、数据库需要自己配置。所以说，如果能够自己做出来，我相信你会在编程技术上会有很大的收获的。

如果有问题，可以加我微信，拉你进群，可能白天给企业做项目，我会在晚上统一在群里解决各位小伙伴遇到的问题的，好的，谢谢各位对项目的支持！再次感谢！

※ 体验留言小程序，即可搜索：小鹿留言助手

小程序端

1、小程序端目录结构

下面是留言小程序的主要目录结构，目录中的具体结构和代码以及对应的页面示意图会在下方详细标记。

images： 此目录下为小程序中所用到的图片文件。
- artical： 用户文章列表页面。
- index： 主页面。
- lookmessage: 留言筛选、回复、删除页面。
- message： 留言显示页面。
- myartical： 后台筛选文章的列表页面。
- mycenter： 后台文章发布、编辑、删除页面。
- select： 后台留言管理、文章管理选择页面。
- write： 写留言页面。
pages： 此路径下存放的为小程序的页面文件（每个页面对应一个文件夹）。
serverAPI： 服务器端 API ，配置好数据库，放入服务器即可运行。
wxSearch： 页面搜索框的组件。

2、具体页面

下面详细介绍各个页面以及对应的目录文件，下面的页面都存在于 pages 文件夹中。

2.1 主页面（index）

此页面是小程序两个入口之一的主页面。该页面的功能主要显示关联小程序的公众号信息，图中的右下角的对勾是进入后台管理，每个公众号主都有超级管理员设置的唯一密码，输入密码即可进入。点击页面中的公众号信息，即可进入该公众号的文章列表页面（artical 页面）。

▉ 示意图：

▉ 页面逻辑：

这里涉及到一个页面用户授权登录，具体逻辑参照根据微信小程序文档。

1）该页面的 js 中 postOpenid 函数作用为上传用户的 openID。

▉ API 接口：

该页面共有三个 API 接口:

1、验证后台登录密码；

2、从服务器获取关联的公众号信息；

3、上传用户的 openID（如果不知道这个是什么，可以去微信小程序官网了解，这里不详细说了）。

 // 验证登录密码（只有关联的公众号主才能进行登录）
  getIdentifyId: function () {
    var that = this;
    wx.request({
      url: '自己服务器API', //f服务器验证密码的 API
      data: {
        password: that.data.inputContent //获取输入框中的密码
      },
      ......
        
// 获取公众号信息显示到页面
  getGongInfo: function () {
    var that = this;
    wx.request({
      url: '自己服务器API', //获取公众号信息的 API
      data: {
      },      
      ......
        
// 上传管理员 openid
  postOpenid: function () {
    var that = this;
    wx.request({
      url: '自己服务器API', // 上传 openid 的 API
      data: {
        openid: wx.getStorageSync('openid'),
        id: that.data.id
      },

2.2 文章列表（artical）

该页面主要显示进入该公众号的历史文章列表。

▉ 示意图：

▉ 页面逻辑：

该页面是用户点击主页面的某个公众号跳转进来的，主要显示该公众号的历史文章列表，点击某一文章即可查看该篇文章的已筛选的留言内容（message 页面）。

▉ API 接口：

该页面的接口只有一个：

1、获取该公众号的历史文章列表。

// 获取文章列表
wx.request({
    url: '自己服务器API', //获取文章列表API
    data: {
        type: '1',//获取列表标识
        id: g_id //公众号id
    },
    ......

2.3 留言显示页面（message）

主要呈现给用户某篇文章已经筛选过的留言内容。

**注意：**这个页面也是用户进入小程序留言的第二个页面入口，因为我们的小程序留言会嵌入在公众号文章中，然后用户点击某篇文章的内的小程序链接，页面直接跳转到用户留言显示页面。而不是从主页面进入，提高交互体验。

▉ 示意图：

▉ 页面逻辑：

该页面是用户点击某篇文章跳转进来的，用于显示某篇文章的留言。可以点击该页面的右上角的写留言，即可进入写留言的页面（write 页面）。

▉ API 接口：

该页面共有两个 API 接口:

1、获取服务器的精选留言。

2、上传点赞的数量。

//获取已精选留言内容
  getChooseCotent: function (){
    var that = this;
    wx.request({
      url: '自己服务器API', //获取已精选留言内容
      data: {
        no: that.data.no,  //文章编号 
        ischeckmessage: '1', //留言是否经过筛选
        g_id: that.data.g_id,  //公众号 id
        openid: wx.getStorageSync('openid'), //用户唯一标识
      },
       ......
        
 // 获得一个赞
      that.getChooseCotent();
      wx.request({
        url: '自己服务器API', //url
        data: {
          p_id: that.data.messages[u_index].p_id,//用户的 id
          openid: wx.getStorageSync('openid'),//点赞用户
          status: 1, //获得一个赞
          no: that.data.no,  //文章编号 
          g_id: that.data.g_id,  //公众号 id
        },
        ......

2.4 写留言页面（write）

用户留言上传服务器，该公众号主可以在后台对用户留言进行筛选，防止不文明留言显示给用户

▉ 示意图：

▉ 页面逻辑：

通过获取到用户输入框内的留言内容，在页面退出的时候上传服务器，如果用户在本页面删除了该留言，退出页面不会上传服务器。

▉ API 接口：

该页面只有一个上传的 API 接口：

1、上传留言内容，以及用户的相关信息。

 /**
   * 生命周期函数--监听页面卸载
   */
  onUnload: function () {
    var that = this;
    if(that.data.messages==""){
      console.log("没有留言数据！")
    }else{
      console.log("formid" + that.data.formId)
      wx.request({
        url: '自己服务器API', //上传留言内容API
        data: {
          username: wx.getStorageSync('username'),//用户名
          avatarUrl: wx.getStorageSync('headpath'),//头像
          messages: that.data.messages,//留言内容
          title: that.data.title,// 标题
          ischeck: '0', //作者是否已回复
          no: that.data.no,  //文章编号
          openid: wx.getStorageSync('openid'), //用户唯一标识
          g_id: that.data.g_id,   //公众号标识
          form_id: that.data.formId,//表单id
          token: wx.getStorageSync('token')//token
        },
        ......

2.5 后台管理界面

当已关联的公众号主输入密码进入后台管理界面，可以进行一些文章的发布、编辑以及留言筛选、回复、置顶等操作。

基本的逻辑就是在主界面右下角输入密码。如图：

▉ API 接口：

只有一个 API 接口：

1、上传密码在服务器进行验证（在主界面已经介绍过了）。

服务器验证通过后，进入操作选择界面（select 页面）。

进入文章管理页面（mycenter 页面），可以进行发布文章，发布文章按钮是可以折叠的。如下：

▉ API 接口：

该页面只有两个 API：

1、上传文章相关信息的 API

2、上传照片的 API

 //上传照片
  post_image: function () {
    var that = this;
    console.log("照片路径"+that.data.tempFilePath)
    //上传服务器
    wx: wx.showToast({
      title: '上传中',
      icon: 'loading'
    })
    wx.uploadFile({
      url: '自己服务器API',
    ......
 // 上传文章信息的 API
 wx.request({
        url: '自己服务器API', //url
        data: {
          title: this.data.title,   //标题
          describe: this.data.describe, //描述
          id: that.data.id,//公众号id
          isheck: 0 //标识
        },
  .......

文章的配图、标题、描述，然后即可上传服务器。收起发布文章的折叠按钮，下方即将显示已经发布的历史文章。如下：

我们通过长按路径，在公众号发表文章的时候即可将路径填入小程序的链接中，用户点击留言，直接跳转到该文章的留言页面进行留言。

返回我们选择进入留言管理页面，进入留言筛选，首先要知道你要筛选那个文章下的留言，所以先出现一个筛选文章列表，点击该列表进入对该文章的留言筛选，（myartical 页面为文章筛选列表）。如图：

▉ API 接口：

该页面只有一个 API：

1、获取该公众号的文章列表

 wx.request({
      url: '自己服务器API', //获取文章列表
      data: {
        type: '1', //操作类型
        id: that.data.id //公众号id
      },
 ......

其实该页面和用户想进入哪篇文章进行留言的页面是一样的，知识后台管理人员进入某篇文章下进行留言筛选、回复、置顶等功能操作。

下面进入某篇文章下的留言筛选页面（lookmessage 页面）。如图：

管理员可以在页面进行筛选、置顶、回复等操作了。

▉ API 接口：

该页面只有四个 API：

1、获取留言列表

2、回复留言 API

3、设置精选留言 API （取消精选同一 API）

4、删除留言 API

5、留言置顶 API （取消置顶同一 API）

// 在已进入页面就获取留言列表
onLoad: function (options) {
    var that = this;
    var title = options.title;//文章标题
    var nos = options.no;   //文章编号
    var ids = options.id;//公众号id
    that.setData({
      no: nos,
      title: title,
      id: ids
    })
    wx: wx.showToast({
      title: '正在获取数据',
      icon: 'loading'
    })
    wx.request({
      url: '自己服务器API', //获取留言列表
      data: {
        ischeckmessage: 0,
        no: that.data.no,
        id: that.data.id
      },
	......

//作者回复API
  replay: function () {
    var that = this;
    var l = '自己服务器API';//信息用户自己接收
    console.log("更新forim"+that.data.formId)
    var d = {
      p_id: that.data.messages[that.data.index2].p_id,//用户留言编号
      page: '/pages/message/message?g_id=' + that.data.messages[that.data.index2].g_id + '&no=' + that.data.messages[that.data.index2].no + '&title=' + that.data.title,//跳转页面
      title: that.data.messages[that.data.index2].title,//文章标题
      message: that.data.messages[that.data.index2].userMesContent,//留言内容
      replyMes: that.data.inputContent,//回复内容
      formid: that.data.formId, //更新formid
      g_id: that.data.id //公众号id
    }
    wx: wx.showToast({
      title: '正在回复中',
      icon: 'loading'
    })
    wx.request({
      url: '自己服务器API', //作者回复
      data: {
        id: that.data.messages[that.data.index2].p_id,//用户编号
        replyContent: that.data.inputContent,   //回复内容
        isCheckChoess: '0'  //是否筛选（否）
      },
     ......
        
  //精选留言 API
  choose: function (event) {
    var that = this;
    var j_index = event.currentTarget.dataset.index;
    console.log("精选索引：" + event.currentTarget.dataset.index)
    wx: wx.showToast({
      title: '正在设置中',
      icon: 'loading'
    })
    wx.request({
      url: '自己服务器API', //设置为精选留言
      data: {
        id: that.data.messages[j_index].p_id,//留言用户id
        type: '1' //精选留言标识 
      },
   ......
 
        
 //删除留言 API
  deleteMessage: function (event) {
    var that = this;
    var j_index = event.currentTarget.dataset.index;
    console.log("精选索引：" + event.currentTarget.dataset.index)
    wx: wx.showToast({
      title: '正在删除',
      icon: 'loading'
    })
    wx.request({
      url: '自己服务器API', //删除留言
      data: {
        id: that.data.messages[j_index].p_id,//留言用户id
        type: '0' //精选留言标识 
      },      
 ......
 
  // 置顶留言 API
  settop: function (event) {
    var that = this;
    var j_index = event.currentTarget.dataset.index;
    console.log("置顶索引：" + event.currentTarget.dataset.index)
    wx: wx.showToast({
      title: '正在设置中',
      icon: 'loading'
    })
    wx.request({
      url: '自己服务器API', //留言置顶
      data: {
        id: that.data.messages[j_index].p_id,//留言用户id
        type: '1' //置顶留言标识 
      },
   ......

服务器端

因为我的专业方向是前端，所以后台接触的不是很深，也没有用到框架去开发，所以无论是在设计数据库上还是在代码逻辑上多多少少很多欠缺，所以说有能力的小伙伴可以后台很久我提供的逻辑，重新把表和后台代码逻辑梳理一遍。

一、数据库表

共有五张数据库表，分别如此下：

articel
gonginfo
messages
zan

1、gonginfo （公众号信息表）

该表存储的是公众号关联的相关信息表，字段包括 id(主键ID)、name（公众号名）、headpath（公众号头像路径）、describes（公众号描述）、password（后台密码）、openid（公众号主的openID唯一标识）、fromid（模板ID）、token（token 验证字段）。表的设计结构如下：

2、articel (文章信息表)

该表主要存储的是每篇文章的相关信息，字段包括 no（主键，文章编号）、title（文章标题）、describ（文章描述）、imageTitle（文章配图）、date（文章日期）、g_id（公众号id）——这里没有关联两个表，重新创建的与另一个表的 ID。表的设计结构如下：

3、messages （留言信息表）

**特别注意：**该表主要存储留言相关信息。由于起初没有学习过后台，所以在建表的时候，没有将表分离关联，所以用户信息和留言信息直接写到一个表中了。后期也没有改，所以回后台的小伙伴可以自己更改过来。

字段包括 p_id(主键)、title(文章标题)、username（用户名）、headimage（用户头像路径）、userMesContent（用户留言内容）、authorMesContent（作者回复内容）、no（文章编号）、isCheck（是否精选）、goodnum（可去掉）、ispraise（可去掉）、isTop（置顶标识）、g_id（公众号id）、zanCount（点赞数量）、fromid（模板id）、token（token验证值）。

二、接口 API

1、后台接口目录

com.xiaolu 下的包命名介绍：

bean：实体类

dao: dao 层

servlet：接口类，所有对外小程序的接口。

ThreadGetdata: 线程类，获取 token

util：工具类，链接数据库之类的。

注意: 在 servlet 中每个接口的功能在这里不做介绍了，都在每个代码的开头标记清除了，可自行查看。

2、连接数据库

在后台代码中的 util 包中的 Util.java 类中配置连接数据库的相关信息。

public class Util {
	//jdbc:mysql://这里写上你服务器的 IP 地址和端口号/数据库名?useUnicode=true&characterEncoding=UTF-8
	private static final String URL = "...";
	private static final String DRIVER = "com.mysql.jdbc.Driver";
	private static final String USER = "...";// 数据库用户名
	private static final String PASS = "...";// 数据库密码
	private static Connection conn = null;

	public static Connection getConnection() {
		try {
			if (conn == null || conn.isClosed()) {
				Class.forName(DRIVER);
				conn = DriverManager.getConnection(URL, USER, PASS);
			}
		} catch (SQLException e) {
			e.printStackTrace();
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
		return conn;
	}
}

2、配置小程序的 APPID

在 servlet 包中的 AppIDCodeServlet.java 类中配置小程序的 APPID 和 AppScret（小程序官网后台获取）。

@WebServlet("/AppIDCodeServlet")
public class AppIDCodeServlet extends HttpServlet {
	private static final long serialVersionUID = 1L;
	public static final String appID = ""; // 填写你小程序的 APPid
	public static final String appScret = "";// 你小程序的 AppScret（微信小程序官网获取）
	public static String  openid = ""; // 空
	public static String  token = ""; // 空
       
    public AppIDCodeServlet() {
        super();
    }
    ......

十一 / WeiXin_MessageApplet

微信小程序留言助手使用指南

前言

小程序端

1、小程序端目录结构

2、具体页面

2.1 主页面（index）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.2 文章列表（artical）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.3 留言显示页面（message）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.4 写留言页面（write）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.5 后台管理界面

▉ API 接口：

▉ API 接口：

▉ API 接口：

▉ API 接口：

服务器端

一、数据库表

1、gonginfo （公众号信息表）

2、articel (文章信息表)

3、messages （留言信息表）

二、接口 API

1、后台接口目录

2、连接数据库

2、配置小程序的 APPID

简介

发行版

贡献者

近期动态

十一 / WeiXin_MessageApplet .gitee-modal { width: 500px !important; }

微信小程序留言助手使用指南

前言

小程序端

1、小程序端目录结构

2、具体页面

2.1 主页面（index）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.2 文章列表（artical）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.3 留言显示页面（message）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.4 写留言页面（write）

▉ 示意图：

▉ 页面逻辑：

▉ API 接口：

2.5 后台管理界面

▉ API 接口：

▉ API 接口：

▉ API 接口：

▉ API 接口：

服务器端

一、数据库表

1、gonginfo （公众号信息表）

2、articel (文章信息表)

3、messages （留言信息表）

二、接口 API

1、后台接口目录

2、连接数据库

2、配置小程序的 APPID

简介

发行版

贡献者

近期动态

搜索帮助

十一 / WeiXin_MessageApplet