halo-plugin-friends/README.md

anian-plugin-friends

基于原作者v1.4.3代码修改

v1.4.3-6

1. 大幅优化分类查询性能
2. URL作者参数改为tag
3. 作者分类依据改为“链接”插件ID（新旧作者姓名将归为一类）

v1.4.3-5

1. 补充ui/package.json内"@rsbuild/core": "^1.4.3"依赖
2. 新增单条朋友圈页面（前端模板friend-post.html；访问地址/friends/friend-post-xxxxx）
3. 朋友圈内容可搜索并返回单条朋友圈页面链接
4. 内容（description）为空的项目将不再存入数据库

v1.4.3-4

1. 控制台新增并行处理数量、图片下载开关、图片下载位置、图片下载代理等配置
2. 修改图片列表字段为imageFiles（不再覆盖title）

v1.4.3-3

1. title字段改为微博图片列表
2. 图片列表内文件将自动下载至/upload/image-host

v1.4.3-2

1. 新增URL参数author用于查询作者
2. 模板参数新增${authors}返回所有作者

v1.4.3-1

1. 大幅增加description字段的字符数上限
2. 去除description字段内的微博视频提示

plugin-friends

1.3.4版本重构朋友圈插件 如果使用了之前版本，请清掉之前的所有数据，不然会有问题 订阅 订阅文章 数据全部清除

• 朋友圈管理插件, 支持在 Console 进行管理以及为主题端提供 /friends 页面路由。
• 提供对 RSS 链接的订阅功能，支持获取其订阅内容

朋友圈页面

后台页面

编辑器插入 RSS展示

编辑器

• 列表视图
• 网格视图

页面

• 列表视图
• 网格视图

使用方式

• 在应用市场下载并启用。
• 启用插件之后会在 Console 的左侧添加一个朋友圈的菜单项，点击即可进入朋友圈管理页面。

特性

• 内置模板，无需主题支持，但也可以通过主题自定义模板。

📃文档

https://docs.kunkunyu.com/docs/plugin-friends

主题适配

目前此插件为主题端提供了 /friends 路由，模板为 friends.html，也提供了 Finder API，可以将瞬间列表渲染到任何地方。

模板变量

路由信息

• 模板路径：/templates/friends.html
• 访问路径：/friends

变量

• friends

变量类型

• UrlContextListResult<FriendPostVo>

示例

<div>
  <div th:each="friend : ${friends.items}" th:with="spec = ${friend.spec}">
    <a th:href="${spec.postLink}" target="_blank" th:text="${spec.title}"></a>
    <div>
      <img th:src="${spec.logo}" alt="avatar">
      <a th:href="${spec.authorUrl}" target="_blank">
        <span th:text="${spec.author}"></span>
      </a>
    </div>
  </div>
  <div th:if="${friends.hasPrevious() || friends.hasNext()}">
    <a th:href="@{${friends.prevUrl}}">
      <span>上一页</span>
    </a>
    <span th:text="${friends.page}"></span>
    <a th:href="@{${friends.nextUrl}}">
      <span>下一页</span>
    </a>
  </div>
</div>

Finder API

listAll()

描述

获取全部订阅文章内容。

参数

无

返回值

List<FriendPostVo>

示例

<div>
  <div th:each="friend : ${friendFinder.listAll()}" th:with="spec = ${friend.spec}">
    <a th:href="${spec.postLink}" target="_blank" th:text="${spec.title}"></a>
    <div >
      <img th:src="${spec.logo}" alt="avatar">
      <a th:href="${spec.authorUrl}" target="_blank">
        <span th:text="${spec.author}"></span>
      </a>
    </div>
  </div>
</div>

list(page, size)

描述

根据分页参数获取订阅文章内容。

参数

• page: int - 分页页码，从 1 开始
• size: int - 分页条数

返回值

ListResult

示例

<th:block th:with="friends = ${friendFinder.list(1, 10)}">
    <div>
      <div th:each="friend : ${friends.items}" th:with="spec = ${friend.spec}">
        <a th:href="${spec.postLink}" target="_blank" th:text="${spec.title}"></a>
        <div >
          <img th:src="${spec.logo}" alt="avatar">
          <a th:href="${spec.authorUrl}" target="_blank">
            <span th:text="${spec.author}"></span>
          </a>
        </div>
      </div>
    </div>
    <div>
      <span th:text="${friends.page}"></span>
    </div>
</th:block>

类型定义

FriendPostVo

{
  "metadata": {
    "name": "string",                                         // 唯一标识
    "generateName": "string",
    "version": 0,
    "creationTimestamp": "2024-01-16T16:13:17.925131783Z",    // 创建时间
  },
  "apiVersion": "friend.moony.la/v1alpha1",
  "kind": "FriendPost",
  "spec": {
    "authorUrl": "string",                                    // 作者链接
    "author": "string",                                       // 作者名称
    "logo": "string",                                         // 作者logo
    "title": "string",                                        // 标题
    "postLink": "string",                                     // 链接
    "description": "string",                                  // 内容
    "pubDate": "date",                                        // 文章发布时间
  }
}

ListResult

{
  "page": 0,                                   // 当前页码
  "size": 0,                                   // 每页条数
  "total": 0,                                  // 总条数
  "items": "List<#FriendPostVo>",              // 订阅文章列表数据
  "first": true,                               // 是否为第一页
  "last": true,                                // 是否为最后一页
  "hasNext": true,                             // 是否有下一页
  "hasPrevious": true,                         // 是否有上一页
  "totalPages": 0                              // 总页数
}

UrlContextListResult

{
  "page": 0,                                   // 当前页码
  "size": 0,                                   // 每页条数
  "total": 0,                                  // 总条数
  "items": "List<#FriendPostVo>",              // 订阅文章列表数据
  "first": true,                               // 是否为第一页
  "last": true,                                // 是否为最后一页
  "hasNext": true,                             // 是否有下一页
  "hasPrevious": true,                         // 是否有上一页
  "totalPages": 0,                             // 总页数
  "prevUrl": "string",                         // 上一页链接
  "nextUrl": "string"                          // 下一页链接
}

开发环境

git clone git@github.com:chengzhongxue/plugin-friends.git

# 或者当你 fork 之后

git clone git@github.com:{your_github_id}/plugin-friends.git

cd path/to/plugin-friends

# macOS / Linux
./gradlew pnpmInstall

# Windows
./gradlew.bat pnpmInstall

# macOS / Linux
./gradlew haloServer

# Windows
./gradlew.bat haloServer

# macOS / Linux
./gradlew build

# Windows
./gradlew.bat build