🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
[TOC] ### 站内公告列表 #### URL > web/index.php?c=article&a=notice #### 请求方式 > GET #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | page | int | 否 | 页码 | | | title | varchar | 否 | 搜索的关键字 | | | createtime | int | 否 | 添加时间 | 三天内(3) 一周内(7) 一月内(30) 三月内(90)| | cateid | int | 否 | 公告类型 | 公告类型id | #### 返回数据 ``` { "message": { "errno": 0, "message": { "total": "1", //总条数 "page": 1, //当前页 "page_size": 20,//一页多少条 "list": [ { "id": "11", //公告id "cateid": "17", //分类id "title": "sdfasd", //公告标题 "content": "sdfasdfasdf",//公告内容 "displayorder": "0", //排序 "is_display": "1", //是否显示  1是 "is_show_home": "1", //是否首页显示 1是 "createtime": "2019-09-27 11:57", //添加时间 "click": "17", //阅读次数 "style": { "color": "#ff0000", //如果是真值,就color 属性为这个值 "bold": 0 //如果是真值 就有font-weight:bold; 这个属性 }, "group": { "normal": [ 54 //哪些用户组ID可见,不设置代表全部用户组可见 ], "vice_founder": [ 5 //哪些副创始人用户组ID可见,不设置代表全部副创始人用户组可见 ] }, "catename": "测试版公告02" //所属公告分类名称 } ], "comment_status": 1 //是否开启留言了  1是 } }, "redirect": "", "type": "ajax" } ``` ### 删除公告 #### URL > web/index.php?c=article&a=notice&do=del&id=公告ID #### 请求方式 > POST #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | id | int | 是 | 公告id | || #### 返回数据 ``` { "message": { "errno": 0, "message": "删除公告成功" }, "redirect": "", "type": "ajax" } ``` ### 添加/编辑站内公告 #### URL > web/index.php?c=article&a=notice&do=post #### 请求方式 > POST #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | id | int | 否 | 公告id | 如果有传就是修改 如果不传就是添加 | | group | array | 否 | 哪些用户组可见 | group[0]=1&group[1]=3 | | vice_founder_group | array | 否 | 哪些副创始人用户组可见 | vice_founder_group[0]=2&vice_founder_group[1]=4 | | title | varchar | 是 | 公告标题 | | | cateid | int | 是 | 分类id | | | content | text| 是 | 公告内容 | | | style | array| 否 | 标题样式及颜色 |styel[bold]=1&style[color]=#f0f0f0 | | click | int | 否 | 阅读次数 | | | is_show_home | int | 否 | 是否首页显示 | 1是 0否 | | is_display | int | 否 | 是否显示 | 1是 0 否 | | displayorder | int | 否 | 排序 | | | #### 返回数据 正确: ``` { "message": { "errno": 0, "message": "操作公告成功" }, "redirect": "", "type": "ajax" } ``` 错误: ``` { "message": { "errno": -1, "message": "公告标题不能为空" }, "redirect": "", "type": "ajax" } ``` ### 获取某一公告详情 #### URL > web/index.php?c=article&a=notice-show&do=detail&id=公告ID #### 请求方式 > GET #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | id | int | 是 | 公告id | || #### 返回数据 ``` { "message": { "errno": 0, "message": { "notice": { "id": "14", "cateid": "16", "title": "新的公告", //标题 "content": "<p>111111</p>", //公告内容 "displayorder": "0", "is_display": "1", "is_show_home": "1", "createtime": "2019-09-27 11:57:20", //创建时间 "click": "3", //阅读次数 "style": { //样式 "color": "", "bold": 0 }, "group": { "normal": [ //在哪些用户组显示 54, 56 ], "vice_founder": [ //在哪些副创始人用户组显示 5, 6 ] } }, "comment_status": 1 } }, "redirect": "", "type": "ajax" } ``` ### 开关留言功能 #### URL > web/index.php?c=article&a=notice&do=comment_status #### 请求方式 > POST #### 参数 无 #### 返回数据 ``` { "message": { "errno": 0, "message": "更改成功" }, "redirect": "", "type": "ajax" } ``` ### 排序设置 #### URL > web/index.php?c=article&a=notice&do=displaysetting #### 请求方式 > POST #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | setting | varchar | 是 | 排序的字段 | createtime:按时间 orde:数字大小 | #### 返回数据 ``` { "message": { "errno": 0, "message": "更改成功" }, "redirect": "", "type": "ajax" } ``` ### 点赞评论 #### URL > web/index.php?c=article&a=notice-show&do=like_comment #### 请求方式 > POST #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | id | int |是 | 这条评论id | - | | articleid | int |是 | 公告id | - | #### 返回数据 正确: ``` { "message": { "errno": 0, "message": "点赞成功" }, "redirect": "", "type": "ajax" } ``` 错误: ``` { "message": { "errno": -1, "message": "已赞" }, "redirect": "", "type": "ajax" } ``` ### 查看留言/预览公告下面的评论列表 #### URL > web/index.php?c=article&a=notice-show&do=more_comments&id=公告ID&page=页码 #### 请求方式 > GET #### 请求参数 | 名称 | 类型 | 必填 | 描述 | 值 | | ----------- | :-----: | :-----: | ----------- | | id | int |是 | 公告id | | | order | int |否 | 排序规则 | id(最新排序)  like_num(最多赞) | | page | 否 |是 | 页数 | || #### 返回数据 ``` { "message": { "errno": 0, "message": { "total": "3", "page": 1, "page_size": 15, "list": [ { "id": "13", "articleid": "2", "parentid": "0", "uid": "337", "content": "大师傅", //评论内容 "createtime": "2019-10-15 15:29", //评论时间 "is_like": "2", "is_reply": "2", "like_num": "1", //点赞数量 "username": "brjun", //评论用户名 "avatar": "http://prox.we7.com/attachment/images/0/2019/01/v3ZE8ZYfFip5E7f7yFf1ee1PB7EPK8.gif" //评论人头像 }, { "id": "10", "articleid": "2", "parentid": "0", "uid": "337", "content": "python最好", "createtime": "2019-10-15 15:25", "is_like": "2", "is_reply": "2", "like_num": "1", "username": "brjun", "avatar": "http://prox.we7.com/attachment/images/0/2019/01/v3ZE8ZYfFip5E7f7yFf1ee1PB7EPK8.gif" }, { "id": "8", "articleid": "2", "parentid": "0", "uid": "1", "content": "php是最好的语言", "createtime": "2019-10-15 11:27", "is_like": "2", "is_reply": "2", "like_num": "2", "username": "admin", "avatar": "http://localhost/project/we7/prox/attachment//images/851/2018/05/Q75VU48Sm4OguuWo2wRj8z7j8Ewu8G.png" } ], "pager": "" } }, "redirect": "", "type": "ajax" } ```