与插件集成

主题与插件集成时，应把插件能力视为可选增强：插件未安装、未启用或版本不兼容时，主题的导航和主要内容仍应可用。

本页说明主题侧的适配方式；插件开发者如何选择 Finder、模板、公开 API 和渲染扩展点，请参考插件侧的与主题集成。

检查插件是否可用

pluginFinder.available 只有在插件已安装并处于启用状态时才返回 true。参数应使用插件 plugin.yaml 中的 metadata.name，而不是显示名称。

<button
  th:if="${pluginFinder.available('PluginSearchWidget')}"
  type="button"
  onclick="SearchWidget.open()"
>
  搜索
</button>

上例只在搜索组件插件可用时调用它提供的 SearchWidget API。不要在条件块外提前调用插件提供的全局变量、Finder 或模板片段。

如果主题依赖插件某个版本才提供的能力，应同时检查版本范围：

<th:block th:if="${pluginFinder.available('PluginSearchWidget', '>=1.0.0')}">
  <!-- 只在版本满足要求时使用对应能力 -->
</th:block>

版本范围遵循 Semantic Version 范围表达式。完整方法说明请参考 PluginFinder。

评论区域应使用 Halo 提供的组合条件 haloCommentEnabled，不要绑定到某一个评论插件：

<div th:if="${haloCommentEnabled}">
  <halo:comment
    group="content.halo.run"
    kind="Post"
    th:attr="name=${post.metadata.name}"
  />
</div>

公共布局的页脚中应保留 <halo:footer />，让 Halo 设置和插件可以注入所需内容：

<footer>
  <!-- 主题页脚内容 -->
  <halo:footer />
</footer>

参数和支持的评论主体请参考自定义标签。

从 Halo 2.26.0 开始，主题可以提供 templates/layout.html 的 html(head, content) 片段，让插件前台页面复用主题外壳。该能力是可选的，不应影响主题自身页面；具体契约和回退行为请参考页面布局契约。

发布前至少覆盖以下状态：