Publica 公共门户
Publica 是一款面向机构、企业、团队、社区及公共服务场景的 Halo 门户主题，适合用于搭建
组织官网、内容门户、服务平台和专题站点。
主题内置首页与单页可视化编排能力，同时提供新闻、资源、归档、分类、标签、搜索、文章详情
和错误页面等完整内容模板。
主题定位
Publica 侧重清晰的信息层级、稳定的内容展示和便捷的后台维护。主题不限定具体行业，站点管理者
可以通过可视化模块、分类内容和品牌设置，将其配置为企业门户、机构官网、公共服务站点或专题网站。
适合以下场景：
- 企业、机构或团队官方网站。
- 新闻动态、通知公告和政策资料门户。
- 服务介绍、项目展示和资源下载站点。
- 招聘、活动、专题和联系我们等落地页面。
- 希望通过 Halo Console 完成页面编排，而不直接修改模板代码的站点。
功能特性
- 首页可视化编排：支持添加、删除、排序和重复使用模块，并提供完整门户、内容资讯、
服务展示三套布局预设。 - 可视化单页：内置关于介绍、政策法规、产品服务、人才招聘、活动专题和联系我们六套页面预设。
- 丰富的页面模块：包括图文介绍、数据指标、标题、内容卡片、图标卡片、时间线、流程、
办事预约、团队成员、合作伙伴、常见问题、资源下载、政策法规、服务地点、招聘职位、联系信息
和在线留言。 - 分类内容联动：新闻动态、资源中心、通知公告和专题聚焦可以直接选择 Halo 分类并读取已发布文章。
- 内容模板完整：覆盖文章、单页、归档、分类、标签、作者、搜索和错误页面。
- 响应式设计：适配桌面、平板和移动设备，包含移动端导航和触控友好的交互。
- 插件适配：适配 Halo 官方搜索组件、评论组件和联系表单插件。
- 本地预设资源：主题预设图片随安装包本地分发，前台运行时不依赖 Unsplash 在线图片地址。
环境要求
| 项目 | 要求 |
|---|---|
| Halo | >= 2.25.0 |
插件支持
Publica 可以在不安装下列插件时正常启用，但对应功能需要插件支持：
| 插件 | 用途 |
|---|---|
| 搜索组件 | 提供导航栏搜索弹窗；主题同时保留 /search 搜索结果页 |
| 评论组件 | 为允许评论的文章和单页提供评论区 |
| 联系表单 | 为“联系信息”和“在线留言”模块提供表单展示、提交与数据管理 |
安装
从应用市场安装
- 进入 Halo Console 的“主题”页面。
- 点击右上角“主题管理”，在应用市场中搜索“Publica 公共门户”。
- 完成安装后选择 Publica，点击“启用”。
应用市场地址：https://www.halo.run/store/apps/app-ifci1oro
手动安装
- 从应用市场版本页面或主题提供方获取可安装的主题 ZIP。
- 进入 Halo Console 的“主题”页面，点击“主题管理”。
- 点击“安装主题”，上传 ZIP 文件。
- 安装完成后选择 Publica，点击“启用”。
Halo 主题安装、预览和切换方式可参考官方主题文档。
快速开始
1. 设置品牌与全站信息
进入 Publica 主题详情页，依次完成以下设置：
- 品牌与导航：顶部公告、服务热线和搜索提示。
- 内容页面：内页横幅、分类说明、空状态文字和搜索热门关键词。
- 页脚：站点介绍、联系信息、备案信息和页脚链接。
- 样式：品牌主色、强调色、辅助色和页面背景色。
主导航需要在 Halo Console 的“外观 → 菜单”中维护。
2. 配置内容分类
如需使用新闻和资源专用模板，请先在“文章 → 分类”中创建分类：
| 内容类型 | 分类自定义模板 | 分类文章模板 |
|---|---|---|
| 新闻动态 | 新闻动态 | 新闻文章 |
| 资源资料 | 资源中心 | 资源文章 |
分类文章模板会应用于该分类下未单独指定模板的文章。
3. 编排首页
在 Console 左侧打开“编排”，通过页面选择器进入首页：
- 选择完整门户、内容资讯或服务展示预设，也可以从当前内容开始编辑。
- 添加、删除或排序首页模块。
- 为新闻动态、资源中心、通知公告和专题聚焦选择对应分类。
- 配置服务入口、介绍图片、重点内容、开放机会、合作伙伴和联系信息。
- 使用桌面端或移动端预览检查页面，确认后保存。
首页可使用以下模块：首屏横幅、数据概览、新闻动态、服务入口、资源中心、介绍模块、重点内容、
通知公告、专题聚焦、开放机会、合作伙伴和联系信息。
4. 创建可视化单页
在“编排”页面的页面选择器中新建页面，或者打开已有可视化单页。主题提供以下预设：
- 关于介绍
- 政策法规
- 产品服务
- 人才招聘
- 活动专题
- 联系我们
页面标题、摘要、封面、可见性和评论开关由页面设置管理；页面正文通过可视化模块编排。
普通 SinglePage 仍然可以继续使用 Halo 自带的富文本编辑器。
政策法规列表用于展示手工维护的政策条目，目前不提供分类筛选和分页；招聘职位用于展示手工维护的
岗位条目，目前不提供岗位搜索。需要这些能力时，应在内容和数量上进行适合单页展示的控制。
5. 配置联系表单
“联系信息”和“在线留言”模块都直接使用联系表单插件，不在主题内重复维护表单字段和提交逻辑：
- 安装并启用联系表单插件。
- 在插件中创建并发布表单模板。
- 从表单模板列表复制类似
form-template-xxxx的模板 ID。 - 在可视化编排中打开“联系信息”或“在线留言”模块，填写“联系表单 ID”并保存。
未填写 ID 时，“联系信息”仍会展示电话、邮箱、地址和交通指引，右侧表单区域不显示；独立的
“在线留言”模块不显示。表单字段、校验、通知和提交记录均在联系表单插件中维护。
内容模板
| 场景 | 入口或模板 | 用途 |
|---|---|---|
| 新闻分类 | 新闻动态 | 展示新闻、动态和资讯列表 |
| 资源分类 | 资源中心 | 展示资料、指南和专题列表 |
| 新闻文章 | 新闻文章 | 展示资讯正文和相关新闻 |
| 资源文章 | 资源文章 | 展示资料、指南和专题正文 |
| 可视化单页 | “编排”中新建页面 | 使用模块编排独立的门户型页面 |
没有选择专用模板的内容会继续使用主题提供的通用文章、分类和单页样式。主题同时覆盖归档、分类、
标签、作者、搜索和错误页等 Halo 标准页面。
升级
- 通过应用市场安装的主题可以在主题列表中直接检查并安装更新。
- 手动安装的主题可以在主题详情页右上角的更多操作中选择“升级”，上传新版 ZIP。
- 升级前建议备份 Halo 数据，并记录重要的主题配置。
- 如果新版调整了设置项，请在主题更多操作中执行“重载主题配置”。
不要通过“卸载并删除配置”完成升级，否则现有主题配置会被删除。
卸载
- 先在主题管理中启用其他主题。
- 在 Publica 所在行打开更多操作，选择“卸载”。
- 如需保留配置以便以后重新安装，请只选择“卸载”；只有确定不再使用时才选择“卸载并删除配置”。
主题卸载不会替代站点备份。执行卸载前，建议先备份 Halo 数据。
常见问题
首页的新闻、资源、公告或专题没有内容
确认模块已经选择分类，并且分类中存在已发布文章。草稿、已删除内容或未选择分类时，模块会显示空状态。
导航栏没有搜索按钮
确认已经安装并启用官方搜索组件。即使没有安装搜索组件，仍然可以通过菜单链接访问主题内置的
/search 页面。
文章或页面没有评论区
确认评论组件已经安装并启用，同时检查对应文章或页面的“允许评论”设置。
安装后 Console 左侧没有“编排”入口
确认 Publica 已经启用，然后刷新 Halo Console。如果主题刚刚升级，还可以尝试重载主题配置后再次刷新。
修改内容后前台没有更新
先确认可视化编辑器已经保存成功，再刷新前台页面。若使用了反向代理或 CDN，还需要清理对应页面缓存。
联系信息或在线留言没有显示表单
确认联系表单插件已经安装并启用、表单模板已经发布，并且模块中填写的是表单模板 ID，而不是表单
显示名称。独立“在线留言”模块在未填写 ID 时会隐藏，这是预期行为。
问题反馈
使用过程中如遇到问题，请在提交反馈时附上 Halo 版本、主题版本、复现步骤和相关截图：
第三方资源
主题预设照片来自 Unsplash，已下载到主题并随安装包本地分发，使用时请遵循
Unsplash License。正式上线前建议将演示图片和示例内容替换为站点自有素材。