在线访谈
旗舰版商业版功能
校对日期:2026-09-24。需要商业版旗舰版。 本文面向站点管理员、互动交流工作人员和网站运维人员,介绍在线访谈的功能设置、访谈创建与发布、直播控制、实录发布、提问审核及前台页面使用方法。
一、功能总览
在线访谈是政府网站与公众开展在线交流的互动栏目,可邀请领导干部、业务负责人或专家,围绕政策法规、重点工作和公众关切解答问题。
工作人员在控制台创建访谈、发布预告,网民可在访谈开始前和进行中提交提问。访谈开始后,工作人员逐条发布文字实录,前台页面自动更新。访谈结束后,实录和已采用的提问作为往期访谈资料保留,供公众查阅。
在线访谈的相关制度依据包括《政府网站发展指引》(国办发〔2017〕47号)和《政府网站与政务新媒体检查指标》(国办秘函〔2019〕19号,以下简称“检查指标”)。前者要求建设统一的互动交流平台,提供在线访谈功能,并对公众参与内容进行审核把关;后者将政务咨询、征集调查、在线访谈和智能交互列为互动交流评分项。系统按照“先审后发”的原则处理网民提问,仅公开审核通过的提问,并对提问人姓名作脱敏处理,隐藏部分姓名。
一场访谈通常按以下流程开展:
- 新增访谈:在控制台填写访谈主题、访谈单位、主持人、访谈嘉宾、开始时间和访谈介绍等信息。新建访谈默认为“预告”状态,尚未发布。
- 发布预告:勾选访谈,点击“发布”,前台“在线访谈”页面即显示预告。访谈默认开放提问,网民可提前提交问题,供工作人员筛选、嘉宾解答。
- 开始访谈:到达预定时间后,在“管理”界面中点击“开始访谈”,状态变为“直播中”。
- 发布实录、审核提问:逐条录入发言人和发言内容,前台详情页每 15 秒自动显示新发布的实录;同时审核网民提问,已采用的提问会在前台显示,也可附上简短答复。
- 结束访谈:点击“结束访谈”,状态变为“已结束”,前台停止自动更新并隐藏提问表单。访谈归入“往期访谈”列表,实录和已采用的提问继续保留。
各项功能的入口如下:
| 功能 | 入口 | 说明 |
|---|---|---|
| 在线访谈设置 | 控制台:配置 → 站点设置 → 在线访谈 | 开启功能,设置提问是否需要登录;各站点分别配置 |
| 访谈管理 | 控制台:政务 → 在线访谈 | 新增、编辑、发布、取消发布和删除访谈 |
| 直播控制与访谈实录 | 控制台:政务 → 在线访谈 → 管理 → 访谈实录 | 开始或结束访谈,发布、修改和删除实录发言 |
| 网友提问审核 | 控制台:政务 → 在线访谈 → 管理 → 网友提问 | 审核提问、填写简短答复,批量采用、拒绝或删除提问 |
| 待办提醒 | 控制台首页顶部的待办项“待审核访谈提问” | 显示待审核提问数量,点击后进入在线访谈列表 |
| 前台页面 | 在站点动态访问地址后添加 /interview 或 /interview/访谈ID | 分别进入在线访谈首页和访谈详情页,详见“前台页面地址”一节 |
使用前,请先了解以下事项:
- 版本要求:在线访谈属于商业版旗舰版功能。社区版控制台中的“在线访谈”菜单和“在线访谈设置”选项卡带有商业版标识(皇冠图标),点击后进入功能介绍页;商业版基础版、标准版、高级版不显示这些入口。
- 按站点管理:功能开关、访谈数据、实录和提问均按站点独立管理。切换站点后,可查看和管理对应站点的数据。
- 文字直播:访谈实录由发言人、发言内容和发言时间组成。发言内容为纯文本,不支持图片和富文本;系统本身不提供视频直播或视频嵌入功能。
- 手动控制状态:“开始时间”和“结束时间”用于前台展示,其中开始时间还用于排序。系统不会按设定时间自动开始或结束访谈,需由工作人员在“管理”界面中操作。
- 前台模板:默认主题已提供在线访谈首页和详情页模板。使用自定义主题时,需提供同名模板,详见第八章。
二、访谈状态与提问状态
2.1 访谈状态
访谈状态分为“预告”“直播中”“已结束”三种,控制台列表、“管理”界面和前台页面均会显示当前状态。下表中的前台展示以访谈已发布为前提。
| 状态 | 含义 | 前台显示位置 | 可执行的操作 |
|---|---|---|---|
| 预告 | 访谈尚未开始;开放提问后,可提前征集问题 | 在线访谈首页“访谈直播与预告”区域,标注“预告” | 开始访谈、编辑、发布或取消发布、删除、审核提问 |
| 直播中 | 访谈正在进行,前台详情页每 15 秒自动更新内容 | “访谈直播与预告”区域,标注“直播中” | 结束访谈;发布、修改或删除实录;审核提问;编辑、发布、取消发布或删除访谈 |
| 已结束 | 访谈已结束,前台停止自动更新并隐藏提问表单,实录和已采用的提问继续保留 | 在线访谈首页“往期访谈”列表 | 重新开始访谈(用于纠正误操作)、补录或修改实录、审核提问、编辑、发布或取消发布、删除 |
“是否发布”和“开放提问”由单独的开关控制,与访谈状态相互独立:
- 是否发布:决定访谈是否在前台显示。未发布的访谈不会出现在前台列表中,直接访问详情页也会提示“页面不存在”(404)。发布或取消发布不会改变访谈状态,“预告”状态的访谈也可以发布。
- 开放提问:决定是否接受网民提问。关闭后可提前结束问题征集,不影响访谈继续进行。
2.2 提问状态
网民提交的提问需经工作人员审核,审核状态如下:
| 状态 | 含义 | 前台是否显示 |
|---|---|---|
| 待审核 | 提问已提交,等待工作人员审核 | 否 |
| 已采用 | 提问已通过审核,可附简短答复 | 是,显示脱敏后的姓名、提问内容、提问时间及答复(如有) |
| 已拒绝 | 提问不予采用 | 否 |
审核结果可以调整:已采用的提问可改为“已拒绝”,已拒绝的提问也可改为“已采用”。
2.3 提问开放条件
网民提交提问前,需满足以下条件:
- 当前站点已开启在线访谈功能;
- 访谈已发布,且处于“预告”或“直播中”状态;
- 访谈的“开放提问”已开启。
满足以上条件后,默认主题会在访谈详情页显示提问表单。提交时还需填写必填项和正确的图形验证码;如果站点开启了“提问需登录”,网民还需登录会员账号。
“提问需登录”不会自动隐藏默认主题中的提问表单。 未登录的网民仍能看到表单,但提交时会收到需要登录的提示,详见“开启在线访谈”一节。
访谈状态的切换关系如下,发布或取消发布均不改变状态:
flowchart TD
upcoming[预告] -->|开始访谈| live[直播中]
live -->|结束访谈| ended[已结束]
ended -->|重新开始访谈,纠正误操作| live三、开启功能与设置前台入口
3.1 开启在线访谈
进入配置 → 站点设置 → 在线访谈。当前账号需具有“站点设置 → 在线访谈”权限。
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 是否开启 | 关闭 | 开启后可访问前台页面和公开接口。关闭时,前台两个页面及相关公开接口均返回“禁止访问”(403),控制台的访谈管理功能仍可使用 |
| 提问需登录 | 关闭 | 关闭时,网民无需注册或登录即可提问;开启后,只有已登录的会员才能提交提问。浏览访谈预告、实录和已采用的提问不受影响 |
开启“提问需登录”后,未登录的网民提交提问时,系统会拒绝提交并提示需要登录(401)。默认主题仍会显示提问表单,建议由主题开发人员补充登录提示,具体处理方法见第九章。
设置变更会记录在操作日志中,模块为“站点设置”,操作为“修改站点在线访谈设置”。
3.2 前台页面地址
开启功能后,即可访问以下页面,无需另建栏目或导入数据:
| 地址 | 页面 | 内容 |
|---|---|---|
/interview | 在线访谈首页 | 包括“访谈直播与预告”和“往期访谈”两个区域。“访谈直播与预告”最多显示 6 场已发布的预告或直播中访谈,按开始时间从早到晚排列,展示访谈图片、状态、主题、单位、嘉宾和时间;“往期访谈”显示已发布且已结束的访谈,按开始时间从新到旧排列,每页 10 条 |
/interview/访谈ID | 访谈详情页 | 展示状态、主题、图片、访谈单位、主持人、嘉宾、时间、内容简介、访谈介绍、访谈实录、已采用的网友提问及“我要提问”表单;表单显示条件见“提问开放条件”一节。访谈未发布或不属于当前站点时,提示“页面不存在”(404) |
使用时,将上述路径加在站点动态访问地址之后。多站点采用子目录方式部署时,路径中需包含对应的站点子目录,例如 /子目录/interview。访谈 ID 可在控制台“在线访谈”列表中查看:“ID”列默认隐藏,点击列表右上角的“列设置”勾选“ID”后显示。
子目录站点的自动更新和提问提交还涉及接口的站点识别,部署要求见“公开接口”一节。
3.3 添加导航入口
如需让网民从网站导航进入在线访谈,可采用以下任一方式手动添加入口:
- 在内容 → 栏目管理中新建栏目,栏目类型选择“转向链接”,链接地址填写
/interview。子目录站点需加上子目录,也可填写“站点完整动态访问地址 +/interview”。 - 由主题开发人员在互动交流专栏、页脚等位置添加链接。模板中可使用
${dy}/interview生成当前站点的在线访谈链接。
四、访谈管理(控制台)
4.1 列表与筛选
进入政务 → 在线访谈,可按访谈主题、访谈单位、开始时间范围筛选,也可按状态查看全部、预告、直播中或已结束的访谈。
列表显示 ID、访谈主题、访谈单位、主持人、开始时间、状态、是否发布、开放提问和创建日期。点击支持排序的列标题可调整排序,通过“列设置”可选择显示哪些列。
列表中的常用操作如下:
- 管理:进入直播控制、访谈实录和网友提问的管理界面(见第五章)。
- 发布 / 取消发布:按访谈当前的发布状态显示其中一项,点击即可切换,无需勾选。
- 编辑:修改访谈信息,也可双击访谈所在行打开编辑对话框。
- 删除:删除当前访谈。
- 工具栏操作:提供“新增”按钮、“发布”下拉菜单(对勾选的多场访谈批量“发布”或“取消发布”)及批量“删除”按钮。
有待审核提问时,控制台首页顶部会显示待办项“待审核访谈提问”,列出当前站点的待审核提问总数,点击后进入在线访谈列表。列表不显示每场访谈的待审核数量,需打开相应访谈的“管理”界面查看。账号具有“在线访谈”下的任一权限,即可看到该待办项。
4.2 新增访谈
点击“新增”,填写访谈信息。标有星号(*)的项目为必填项。
| 填写项 | 说明 |
|---|---|
| 访谈主题 * | 最多 150 字,用作控制台列表、前台卡片、往期访谈列表和详情页中的标题 |
| 访谈单位 | 最多 100 字,例如“市住房和城乡建设局” |
| 主持人 | 最多 50 字。打开“管理”界面时,系统会将主持人自动填入实录的“发言人”,可手动修改 |
| 访谈嘉宾 | 按行录入每位嘉宾的姓名(最多 50 字)和职务(选填),可添加或删除行。系统按“姓名(职务)、姓名(职务)”拼接保存(合计最多 300 字),录入区下方会预览前台显示效果;嘉宾同时作为“管理”界面中实录的发言人选项 |
| 开始时间 * | 计划开始时间,用于前台展示和排序。系统不会按此时间自动开始访谈 |
| 结束时间 | 选填。填写后,前台显示为“访谈时间:开始时间 至 结束时间” |
| 访谈图片 | 选填,显示在前台首页卡片和详情页中 |
| 开放提问 | 默认开启。关闭后不再接受提问,前台也不再显示提问表单,可用于提前结束问题征集 |
| 内容简介 | 最多 1000 字,使用纯文本,显示在详情页信息区,同时作为页面描述供搜索引擎使用 |
| 访谈介绍 | 支持富文本,可插入图片和附件,显示在详情页信息区下方,适合介绍访谈背景、嘉宾情况和讨论议题 |
保存后,访谈状态为“预告”,“是否发布”为“否”,前台暂不显示。核对信息无误后,按“发布与取消发布”一节的步骤发布。
4.3 发布与取消发布
单场访谈可直接点击操作栏中的“发布”或“取消发布”(按当前发布状态只显示其中一项)。需要批量处理时,勾选一场或多场访谈,打开工具栏中的“发布”下拉菜单,选择“发布”或“取消发布”。已发布的访谈不会重复发布,未发布的访谈也无需取消发布,系统会自动跳过。
- 发布:访谈在前台显示。“预告”状态的访谈发布后即可展示预告;如果已开启“开放提问”,网民还可提前提交问题。建议提前发布预告,留出征集提问的时间。
- 取消发布:访谈从前台隐藏,直接访问详情页会提示“页面不存在”。访谈信息、实录和提问均保留,之后可再次发布。取消发布不会改变访谈状态;如还需结束直播或停止征集提问,请分别点击“结束访谈”或关闭“开放提问”。
发布和取消发布均需“发布”权限。
4.4 编辑与删除
点击“编辑”或双击访谈所在行,可修改“新增访谈”一节中的各项信息,包括“开放提问”开关。编辑对话框标题旁会显示当前状态,已发布的访谈还会显示“发布”标记。创建用户和创建日期由系统记录,仅供查看。
访谈状态和“是否发布”不能在编辑对话框中修改,需分别通过“管理”界面和“发布”菜单操作。
删除支持单条和批量操作。删除访谈时,其全部实录和网民提问会一并删除,且无法恢复。 已结束的访谈可作为往期档案和检查依据,建议保留。如只需从前台撤下,请使用“取消发布”。
五、直播控制与访谈实录
5.1 管理界面
在访谈列表的操作栏中点击“管理”,打开全屏管理界面。顶部工具栏依次提供“返回”、“开始访谈”或 “结束访谈”、“编辑”和“前台页面”按钮,右侧显示访谈状态、发布状态和开放提问状态。 工具栏下方展示访谈主题、单位、主持人、嘉宾和时间,并根据“预告”“直播中”“已结束”等状态给出操作提示。
- 编辑:打开编辑对话框,修改访谈信息。保存后,管理界面会同步更新。
- 前台页面:在新窗口打开访谈详情页。链接使用当前站点的完整动态地址,控制台与前台使用不同域名时也可访问。
- 返回:关闭管理界面。如果发言框中还有未发布的内容,系统会先要求确认。
主体分为左右两栏:左栏为“访谈实录”,上方是发言框,下方是实录时间线;右栏为“网友提问”,显示待审核数量、状态筛选和提问列表。两栏同时可见,直播时可一边发布实录、一边审核提问,无需切换选项卡。窗口较窄时两栏改为上下排列。
账号具有“在线访谈”下的任一权限,即可使用“管理”按钮。对话框内各项操作仍受相应权限限制,无权限的按钮不可用。
5.2 开始与结束访谈
- 开始访谈:访谈处于“预告”或“已结束”状态时显示此按钮。点击并确认后,状态变为“直播中”。已发布的访谈会在前台首页卡片上标注“直播中”,此时打开详情页,内容会每 15 秒自动更新。误操作结束的访谈也可通过此按钮重新开始。
- 结束访谈:访谈处于“直播中”状态时显示此按钮。点击并确认后,状态变为“已结束”。已打开的直播详情页会在下一次自动更新时显示“已结束”,隐藏提问表单,并停止自动更新;已发布的访谈归入前台“往期访谈”列表。
开始和结束访谈均需手动操作,建议按以下顺序开展工作:
- 访谈开始前几分钟,点击“开始访谈”,在“访谈实录”中发布开场发言。
- 访谈进行中,逐条发布发言,并同步审核“网友提问”中的问题。
- 访谈结束、实录发布完毕后,点击“结束访谈”。结束后仍可补录或修改实录。
5.3 发布实录发言
在左栏“访谈实录”的发言框中填写发言内容,在下方选择“发言人”,点击“发布发言”或按 Ctrl + Enter(Mac 为 Command + Enter)。保存成功后,发言会显示在下方时间线中,发言框保留发言人并清空内容,可继续录入;访谈处于“直播中”时,已启用自动更新的前台详情页会在下一次更新时显示新发言,更新间隔为 15 秒。
- 发言人:必填,最多 50 字。主持人和各位嘉宾以按钮形式列出(职务仅作提示,发言只记录姓名),点击即可切换,打开界面时默认选中主持人。如需使用列表之外的发言人(如“记者”),点击“其他”,再在出现的输入框中填写姓名。
- 发言内容:必填,使用纯文本,Enter 换行。前台按原文显示,不支持图片、链接样式和富文本。
时间线显示发言人、身份标记(主持人或嘉宾)、发言时间和内容,默认最新发言在前,可切换为“时间正序”(与前台一致)。点击某条发言的“编辑”可就地修改发言人和内容,点击“删除”可删除单条发言。已显示在前台的发言被修改或删除后,不会自动同步,网民需手动刷新页面才能看到变化。
访谈处于“直播中”时,实录时间线每 10 秒自动刷新一次,便于多人同时录入;正在就地修改某条发言时不刷新。
访谈开始前或结束后也可发布实录,例如提前录入开场白、结束后补录发言。补录内容同样按发言时间排列。实录的展示不受访谈状态限制;默认主题的显示数量上限见“页面模板”一节。
5.4 前台详情页的自动更新
网民打开“直播中”的访谈详情页后,页面每 15 秒自动更新一次,具体包括:
- 显示新发布的实录发言;
- 更新已采用的提问列表,同步提问审核结果和答复内容;
- 检查访谈是否结束。结束后,将页面顶部的状态改为“已结束”,隐藏提问表单,并停止自动更新。
自动更新功能仅在打开页面时访谈已处于“直播中”状态的情况下启用。在“预告”阶段打开的页面不会自动进入直播,访谈开始后,网民需手动刷新页面。可请主题开发人员在页面中增加刷新提示。
实录和提问的更新方式不同:新增实录会自动显示,但修改或删除已有实录后需手动刷新页面才能看到变化。提问列表会整体更新,因此直播期间对审核结果或答复的修改会自动同步。处于“预告”或“已结束”状态的页面均需手动刷新,才能看到最新内容。
六、网友提问与审核
6.1 前台提问
满足“提问开放条件”一节所述显示条件时,访谈详情页底部会显示“我要提问”表单。网民填写以下信息后,点击“提交提问”。标有星号(*)的项目为必填项。
| 填写项 | 说明 |
|---|---|
| 姓名 * | 最多 50 字。公开显示时仅保留第一个字,其余部分用两个星号代替,例如“张**” |
| 提问内容 * | 最多 1000 字 |
| 图形验证码 * | 按图片内容填写,点击图片可更换验证码 |
提交成功后,页面提示“您的提问已提交,审核通过后将在本页面展示。”此时提问为“待审核”状态,暂不公开显示。
提交失败时,页面会提示原因并更换验证码。常见原因包括:验证码错误或已使用、访谈已关闭提问或已结束,以及站点要求登录但网民尚未登录。
会员登录后提交的提问会关联其会员账号;未登录时提交的提问记录为匿名用户。系统还会记录提交者的 IP 地址,仅供控制台查看,前台不显示。
6.2 审核提问
打开访谈的“管理”界面,右栏即为“网友提问”。标题旁显示当前访谈的待审核数量;列表默认显示“待审核”提问,也可按状态查看已采用、已拒绝或全部提问,支持分页,没有符合条件的提问时,会根据当前筛选条件显示“暂无待审核提问”等提示。每条提问显示提问人、提问时间、状态、提问内容和答复内容(如有),下方提供以下操作:
- 采用 / 拒绝:一键修改状态,不填写答复。已采用的提问不再显示“采用”,已拒绝的提问不再显示“拒绝”。
- 审核:在对话框中设置状态并填写答复,说明见下文。
- 引用到发言:将该提问按「网友“姓名”提问:内容」的格式填入左栏发言框,并把发言人切换为主持人,由操作人员确认后发布。适合主持人在实录中转述网友问题,随后由嘉宾作答。
- 删除:删除该提问。
点击“审核”后,在对话框中填写以下内容:
- 状态:选择“已采用”或“已拒绝”。首次审核时,默认选中“已采用”。
- 答复内容:选填,最多 1000 字,使用纯文本。提问被采用后,答复会随提问一起在前台显示,格式为“答复:……”。此处适合简短回应;需要详细解答的问题,建议由嘉宾在访谈实录中回答。
提交审核结果后,已采用的提问会在前台“网友提问”区域显示。直播页面会在下一次自动更新时同步,更新间隔为 15 秒;其他状态的页面需手动刷新。
如需调整审核结果或答复内容,再次点击“审核”并修改即可。
6.3 批量处理与列表自动刷新
勾选一条或多条提问后,列表上方出现批量操作栏,点击“采用”“拒绝”或“删除”即可批量处理,点击“取消”清除勾选。批量采用和拒绝只修改状态,不填写答复;已经处于目标状态的提问会自动跳过。批量删除后无法恢复。
访谈处于“直播中”且管理界面保持打开时,“网友提问”列表和待审核数量每 10 秒自动刷新一次,新提交的提问会自动显示;也可随时点击标题栏的刷新按钮。访谈结束或关闭界面后,自动刷新停止。
6.4 关闭提问
如需在访谈结束前停止征集提问,例如已收集到足够的问题,或出现大量无关内容,可在访谈编辑对话框中关闭“开放提问”。
关闭后,系统不再接受新的提问,网民重新打开或刷新页面后也不再看到提问表单;已经打开的页面即使仍显示表单,也无法成功提交。已收到的提问仍可继续审核,访谈可正常进行。如需继续征集,可重新开启“开放提问”。
结束访谈后,系统不再接受提问,并隐藏提问表单,无需另行关闭“开放提问”。
6.5 提问公开与隐私保护
前台只显示“已采用”的提问,按提交时间从新到旧排列。每条提问显示脱敏后的姓名、提问时间、提问内容和答复(如有)。
待审核和已拒绝的提问,以及提问人的完整姓名、IP 地址、会员账号和联系方式,均不会通过前台或公开接口展示。删除访谈时,其全部提问会一并删除。
控制台目前不提供录入线下提问(如电话、信函提问)的界面。如需录入,可由技术人员通过后台接口提交,详见“公开接口”一节。
七、权限与操作日志
进入用户 → 角色管理,在权限树中为相应角色分配权限。
| 权限树位置 | 权限项 | 说明 |
|---|---|---|
| 政务 → 在线访谈 | 列表 | 查看访谈列表;勾选“在线访谈”节点时,还会授予实录列表和提问列表的读取权限,供首页待办项和“管理”界面使用 |
| 政务 → 在线访谈 | 新增 | 新增访谈 |
| 政务 → 在线访谈 | 编辑 | 修改访谈信息、查看访谈详情 |
| 政务 → 在线访谈 | 直播控制 | 开始或结束访谈 |
| 政务 → 在线访谈 | 发布 | 发布或取消发布访谈 |
| 政务 → 在线访谈 | 删除 | 删除访谈及其全部实录和提问 |
| 政务 → 在线访谈 | 实录管理 | 发布、修改和删除实录发言 |
| 政务 → 在线访谈 | 提问审核 | 审核提问、批量采用或拒绝提问、查看提问详情 |
| 政务 → 在线访谈 | 提问编辑 | 修改提问人和提问内容,通过接口录入提问 |
| 政务 → 在线访谈 | 提问删除 | 删除提问 |
| 配置 → 站点设置 | 在线访谈设置 | 开启功能,设置提问是否需要登录 |
勾选“在线访谈”下的任一权限项时,系统会同时授予访谈、实录和提问列表的读取权限,并启用“管理”按钮。对话框内的具体操作仍受相应权限限制。所有操作仅针对当前站点,不能处理其他站点的访谈。
控制台中的访谈管理、实录管理和提问审核等操作会生成操作日志,可在日志 → 操作日志中查看。日志按以下模块归类:
| 日志模块 | 记录的操作 |
|---|---|
| 在线访谈管理 | 访谈的新增、修改、开始、结束、发布、取消发布和删除 |
| 访谈实录管理 | 实录发言的新增、修改和删除 |
| 访谈提问管理 | 提问的新增、修改、审核、采用、拒绝和删除 |
| 站点设置 | 在线访谈设置的修改 |
网民在前台提交提问不属于控制台操作,不记入操作日志。
八、主题模板与接口(供技术人员参考)
8.1 页面模板
在线访谈的两个前台页面使用主题 templates/ 目录下的以下模板。默认主题已提供这些文件;自定义主题也需包含同名模板,否则对应页面无法正常打开。
| 模板 | 页面 |
|---|---|
sys_ | 在线访谈首页,包含“访谈直播与预告”和“往期访谈” |
sys_ | 访谈详情页,模板变量 interview 表示当前访谈 |
模板中可使用 ${dy} 生成当前站点的链接,使用 ${api} 作为接口地址前缀。采用模板渲染时,${api} 对应使用会话认证的 /frontend 接口前缀。提交类请求需携带页面 _csrf 元标签中的令牌,默认主题的 window.request 已自动处理,无需另行添加。
系统提供以下六个标签用于读取访谈数据。其中,*List 返回列表,*Page 返回分页对象。
| 标签 | 参数 | 默认排序 |
|---|---|---|
InterviewList / InterviewPage | siteId、status(多个值用逗号分隔)、isPublished、isAllSite | 按开始时间从新到旧 |
InterviewMessageList / InterviewMessagePage | interviewId(必填)、siteId、isAllSite、minId(只返回 ID 大于该值的发言) | 按发言 ID 从小到大,即发言时间从早到晚 |
InterviewQuestionList / InterviewQuestionPage | interviewId(必填)、siteId、status、isAllSite | 按提问 ID 从大到小,即提问时间从新到旧 |
以下示例取自默认主题:
[#-- 首页:预告与直播中的访谈,按开始时间从早到晚 --]
[@InterviewList isPublished='true' status='0,1' orderBy='beginDate' limit='6'; list]
…
[/@InterviewList]
[#-- 首页:往期访谈分页 --]
[@InterviewPage isPublished='true' status='2' limit='10'; pagedList]
…
[/@InterviewPage]
[#-- 详情页:实录与已采用的提问 --]
[@InterviewMessageList interviewId=interview.id limit='500'; list] … [/@InterviewMessageList]
[@InterviewQuestionList interviewId=interview.id status='1' limit='100'; list] … [/@InterviewQuestionList]编写模板时,请注意以下事项:
- 控制公开范围:公开页面只应读取已发布的访谈(
isPublished=)和已采用的提问('true' status='1')。InterviewQuestionList返回完整的提问对象,包含提问人完整姓名、IP 地址和会员账号。页面只应输出脱敏姓名(${bean.)、提问内容、答复内容和提问时间。maskedName} - 保留文本转义:实录发言和提问内容均为纯文本。输出时应保持转义,不要使用
[#noescape];可通过 CSS 的white-space: pre-line保留换行。 - 避免 ID 精度丢失:访谈、实录和提问的 ID 均为长整型,模板中应写作
${bean.id?c};在 JavaScript 中应始终按字符串处理,不要转换为数字。 - 自动更新与数量限制:默认主题的详情页在访谈“直播中”时,每 15 秒通过
minId参数获取新发言、重新获取已采用的提问,并检查访谈是否结束。新增内容通过textContent写入页面,避免 XSS 风险。详情页初次渲染时最多显示 500 条实录和 100 条提问,超出部分需自行实现分页。
8.2 公开接口
采用前后端分离方式的站点(如 Nuxt 示例站)可调用以下接口。当前站点未开启在线访谈功能时,这些接口均返回 403(禁止访问)。
| 方法与地址 | 用途 | 说明 |
|---|---|---|
GET / | 获取访谈列表 | 只返回已发布的访谈,不含访谈介绍富文本;status 的取值为 0(预告)、1(直播中)、2(已结束),多个值用逗号分隔;分页接口为 GET / |
GET / | 获取访谈详情 | 包含访谈介绍富文本;访谈未发布或不属于当前站点时返回 404 |
GET / | 获取访谈实录 | 按发言 ID 升序返回;传入 minId 时,只返回 ID 大于该值的发言,可用于直播轮询;limit 最大为 1000 |
GET / | 获取网友提问 | 只返回已采用的提问,姓名已脱敏,按提问时间从新到旧排列;不支持增量获取,轮询时需整体重新读取 |
POST / | 提交提问 | 请求体为 { interviewId, name, text, captcha, captchaToken };开启“提问需登录”后,未登录调用返回 401;验证码错误、访谈已关闭提问或已结束时返回 400;访谈未发布时返回 404 |
调用时需注意:
- 验证码:提交提问前,需通过
GET /获取验证码,每个验证码只能使用一次。api/ captcha - 站点识别:接口根据访问域名确定站点;域名未匹配任何站点时,使用默认站点。只有列表和分页接口支持
siteId参数。详情、实录、提问和提交提问接口均要求访谈属于按域名确定的站点,否则返回 404。 - 子目录站点:采用子目录方式部署且没有独立域名的站点,可能因接口识别的站点与访谈所属站点不一致,导致详情页无法自动更新、提问无法提交。请为需要使用在线访谈的站点配置独立域名。
- ID 类型:接口返回的 ID 均为字符串,前端应保留其字符串类型。
- 模板渲染:上述访谈接口在模板渲染场景下对应的前缀为
/frontend/。interview
如需录入电话、信函等线下提问,可调用后台接口 POST /。该操作需“提问编辑”权限,请求体包含 interviewId、name 和 text,录入后的提问状态为“待审核”。
九、常见问题
访问 /interview 页面时提示“禁止访问”,怎么办?
进入配置 → 站点设置 → 在线访谈,检查“是否开启”开关。多站点环境下,需为各站点分别开启。
新增访谈后,前台看不到,打开详情页也提示“页面不存在”,是什么原因?
新建访谈默认未发布。请在控制台列表中查看“是否发布”列,勾选访谈后,在“发布”下拉菜单中选择“发布”。已结束的访谈显示在“往期访谈”列表中,不再出现在“访谈直播与预告”区域。
已到开始时间,访谈仍显示“预告”,怎么办?
系统不会按设定时间自动开始访谈。请打开该访谈的“管理”界面,点击“开始访谈”。
直播中发布了发言,前台没有显示,怎么办?
请依次检查:
- 访谈是否处于“直播中”状态。其他状态的页面不会自动更新,需手动刷新。
- 网民是否在访谈开始前就打开了页面。“预告”阶段打开的页面不会自动进入直播,需手动刷新。
- 是否已等待一个更新周期。自动更新间隔为 15 秒,请稍候查看。
修改或删除已有实录后,已打开的页面不会自动同步,网民需手动刷新才能看到变化。
网民已提交提问,为什么前台看不到?
提问实行“先审后发”。新提交的提问为“待审核”状态,暂不公开显示。请打开该访谈的“管理”界面,在右侧“网友提问”一栏中审核;采用后,提问才会在前台显示。
网民无法提交提问,或看不到提问表单,怎么办?
请依次确认:
- 当前站点已开启在线访谈,且该访谈已发布。
- 访谈尚未结束,编辑对话框中的“开放提问”已开启。
- 如站点开启了“提问需登录”,网民已登录会员账号。
- 必填项已填写,验证码正确且未使用过。提交失败后,需按新图片重新填写验证码。
开启“提问需登录”后,未登录的网民仍能看到表单,能否先提示登录?
默认主题不会根据登录要求隐藏表单,而是在提交时校验登录状态。如需提前提示登录或隐藏表单,请由主题开发人员修改 sys_,根据站点设置和登录状态调整表单显示。
误点“结束访谈”后,如何继续直播?
打开“管理”界面,再次点击“开始访谈”,即可恢复“直播中”状态。已停止自动更新的详情页需由网民手动刷新,才能继续接收新实录。
访谈还在进行,想提前停止征集提问,如何操作?
在访谈编辑对话框中关闭“开放提问”。系统会停止接收新提问,已收到的提问仍可审核,访谈可正常进行。网民重新打开或刷新页面后,提问表单将不再显示。
删除访谈后,实录和提问也消失了,能否恢复?
不能。删除访谈会同时删除其全部实录和提问。如只需从前台撤下访谈,请使用“取消发布”。
能否进行视频直播,或在实录中插入图片?
系统提供文字直播,实录发言为纯文本,不支持图片和富文本,也不提供视频直播或视频嵌入功能。访谈背景、嘉宾照片等可放在支持富文本的“访谈介绍”中;如需视频直播,可由主题开发人员在详情页模板中接入第三方播放器。
子目录站点的详情页不自动更新,提问也提交失败,是什么原因?
自动更新和提问提交通过接口完成,接口仅按访问域名识别站点。子目录站点没有独立域名时,接口可能识别为域名对应的站点或默认站点,与访谈所属站点不一致,因而返回 404。请为该站点配置独立域名,详见“公开接口”一节。
使用自定义主题,开启功能后页面报错,怎么办?
检查主题的 templates/ 目录中是否包含 sys_ 和 sys_。如有缺失,可从默认主题复制相应模板,再按需调整样式和相关依赖。
相关文档
- 《政府网站与政务新媒体检查指标》(国办秘函〔2019〕19号)
- 旗舰版其他功能:依申请公开、领导信箱、网站普查