文章目录

• 快速开始
  • 下载
  • 安装
  • 基础配置
• 功能特性
  • 1. 信息卡片
    • 电影
    • 电视剧
    • 电视剧集（单季）
    • 图书
    • 游戏
    • 音乐专辑
    • 播客
    • 演出
  • 2. Shortcode 使用
    • 显示标记列表
    • 显示收藏
  • 3. 条目管理
  • 4. 标记管理与同步
  • 5. 显示设置
  • 6. 插件日志
  • 7. 自动更新
  • 8. 性能优化
• 常见问题
  • Q: 需要配置 Token 才能使用吗？
  • Q: 图片是如何处理的？
  • Q: 会自动同步我在 NeoDB 的所有标记吗？
  • Q: Shortcode 和直接嵌入链接有什么区别？
  • Q: 如何查看插件的同步记录？
• 致谢

WP-NeoDB 是一款 WordPress 插件，可以在文章中嵌入书影音游记录的信息卡片，并管理个人标记。插件支持从 NeoDB、豆瓣、TMDB 等多个数据源获取内容，并能将本地标记同步回 NeoDB。

本插件基于 @bigfa 的 wp-douban 修改而来。由于豆瓣 API 限制，本插件不保证豆瓣相关功能的长期可用性，建议优先使用NeoDB和TMDB作为数据源。

快速开始

下载

可以点击这里下载或者在GitHub Repo中下载。

安装

1. 下载插件并上传到 /wp-content/plugins/ 目录
2. 在 WordPress 后台的「插件」页面激活 WP-NeoDB
3. 进入 「WP NeoDB」 → 「参数设置」 进行基础配置

基础配置

必填项：

• NeoDB 实例地址：默认为 https://neodb.social，支持任何 NeoDB 实例

可选项：

• NeoDB Token：用于获取在 NeoDB 的个人标记并支持同步功能
  • 获取方式：在 https://neodb.social/developer/ 点击 Test Access Token 后，点击 Generate 获取。
• 豆瓣 ID：如需同步豆瓣标记，填写豆瓣 ID（功能来自原 wp-douban 插件）
• TMDB API Key：用于从 TMDB 获取影视数据

功能特性

1. 信息卡片

支持的条目类型：

• 电影
• 电视剧
• 电视剧集（单季）
• 图书
• 游戏
• 音乐专辑
• 播客
• 舞台剧/演出

使用方法：在文章编辑器中直接粘贴 NeoDB、豆瓣或 TMDB 链接，插件会自动把链接渲染成信息卡片。

卡片内容：

• 基础信息：封面图、标题、原始标题、年份、类型、评分
• 详细信息：导演/作者/艺术家、演员/译者、发行商/平台等（根据条目类型显示）
• 外部链接：自动显示关联的豆瓣、TMDB、IMDB 等外部资源链接
• 个人标记：如果标记过该条目，会在卡片右上角显示状态（想看/在看/看过/不看了）、标记时间和评分
• 短评显示：可选择用短评替代默认简介

电影

https://neodb.social/movie/5A3ZJJ6owHetOl6qPd5FXT

电影条目会显示导演和主要演员。

如果标记过该条目，可以勾选「展示短评」来显示短评，否则将显示条目简介。

电视剧

https://neodb.social/tv/36bZYD1xeEWWS3jCpJHpGu

电视剧全剧条目通常不可标记，因此只显示剧集简介和基本信息。

电视剧集（单季）

https://neodb.social/tv/season/1DJnNhyitFhsD8aCF2Fz1J

单季剧集可以单独标记。下面这个示例标记了「想看」但没有写短评，因此显示状态和简介。

图书

https://neodb.social/book/5cy3ia5WNC0Bn8VS1mXqLT

图书条目会显示作者和译者。

游戏

https://neodb.social/game/4Ixm8bYfeqJAoZkl09KKfR

游戏条目会显示开发者和发行平台。

音乐专辑

https://neodb.social/album/7APUZWwgTnkKWR1FmtDNr5

音乐专辑会显示艺术家和发行公司。

播客

https://neodb.social/podcast/6xOC8wsPCsRKtN6QCSVh9t

演出

https://neodb.social/performance/1eb9LOBuzBUnvUhCJGBBwO

2. Shortcode 使用

插件shortcode，可以在文章或页面中批量展示标记列表。演示地址

显示标记列表

[wpd types="movie,book,music" status="done"]

参数说明：

• types：指定要显示的类型，多个类型用逗号分隔。支持：movie、book、music、game、drama
• status（可选）：筛选状态。支持：mark（想看）、doing（在看）、done（看过）、dropped（不看了）

显示收藏

[wpc type="movie" status="done" style="card"]

参数说明：

• type：指定类型（单数）。支持：movie、book、music、game、drama
• style（可选）：展示样式。card为卡片流（默认），留空或其他值为年度日历样式
• start / end（可选）：按时间范围筛选，格式 Y-m-d（如 2024-01-01）
• status（可选）：筛选状态，默认为 done

3. 条目管理

在「所有条目」页面可以查看所有已抓取条目的概览。支持：

• 按类型筛选（电影、图书、音乐、游戏等）
• 按数据来源筛选（豆瓣、NeoDB、TMDB）
• 搜索和分页浏览
• 查看评分、描述等基本信息

条目编辑功能：

• 手动编辑元数据（标题、副标题、评分、海报等）
• 从豆瓣/NeoDB/TMDB 刷新最新数据
• 删除不需要的条目

4. 标记管理与同步

在「我的条目」页面可以管理所有标记过的条目。支持按状态筛选（想看/在看/看过/不看了）。

标记编辑与同步：

• 编辑观看状态、评分、短评、标记时间
• 从 NeoDB 同步到本地：点击「从 NeoDB 刷新」按钮，可将 NeoDB 上的标记信息同步到本地
• 从本地同步到 NeoDB：勾选「保存时同时同步到 NeoDB」，修改后的评价和状态会自动推送到 NeoDB（需要配置 NeoDB Token）

定时自动同步：
插件启用后会自动创建每小时一次的定时任务，从 NeoDB 和豆瓣同步标记数据到本地（需要配置对应的 Token 或豆瓣 ID）。

5. 显示设置

6. 插件日志

插件会记录所有同步、嵌入操作的历史，帮助追踪数据变化和排查问题。可在 「WP NeoDB」 → 「插件日志」 中查看。

7. 自动更新

插件内置自动更新功能，会从 GitHub 检查最新版本并提示更新，确保始终使用最新版本的插件。

8. 性能优化

1. 使用Rector把PHP兼容性提到了8.0
2. 增加了一些Primary Key来提升数据库的查询效率，并且尽可能使用批量查询。
3. 降低了部分代码的时间复杂度，如使用Hash Set来替代nested loop，达成Linear Time Complexity.（内存涨价了只能优化代码了）
4. 重构了一些渲染逻辑，将一些需要JavaScript渲染的前端页面改为后端渲染。
5. 使用WordPress Transients来设置缓存（10分钟），提高性能。

常见问题

Q: 需要配置 Token 才能使用吗？

不需要。不配置 Token 也可以嵌入 NeoDB 公开条目的信息卡片。只有在需要同步个人标记时才需要配置 NeoDB Token 或豆瓣 ID。

Q: 图片是如何处理的？

插件支持本地缓存和图片代理（豆瓣）两种方式。可在设置中选择是否下载图片到本地。未开启本地下载时，来自豆瓣的图片会使用图片代理服务避免防盗链问题。NeoDB 则没有防盗链设置。

Q: 会自动同步我在 NeoDB 的所有标记吗？

插件启用后会每小时自动从 NeoDB 同步标记到本地（需要配置 NeoDB Token）。也可以在后台手动触发「同步 NeoDB 标记」。

从本地到 NeoDB 的同步是手动的：需要在编辑标记时勾选「保存时同时同步到 NeoDB」选项。

Q: Shortcode 和直接嵌入链接有什么区别？

• 直接嵌入链接：在文章编辑器中粘贴单个条目的链接，显示该条目的详细信息卡片。
• Shortcode：使用 wpd批量展示多个标记的列表，可以创建「观影清单」或「读书列表」页面。

Q: 如何查看插件的同步记录？

进入 「WP NeoDB」 → 「插件日志」，可以查看所有同步、嵌入操作的详细记录，包括时间、类型、来源和状态。

致谢

本插件基于 @bigfa 的 wp-douban 项目修改开发，在此表示感谢。再次重申，本插件适合 NeoDB 用户使用，if you are looking for something for douban, please go to wp-douban.