@directus-labs/seo-plugin

中文文档
1.2.1发布于 2026/11/04MITES Module构建来源已验证近 30 天下载 4972

Directus 的 SIO 插件

中文使用文档
文档目录14 节
  1. 关键特性 QQ
  2. SEO数据
  3. 数据结构
  4. 使用量
  5. 1. SEO接口
  6. 2. SEO 显示
  7. 配置 {}
  8. 接口选项
  9. 翻译内容
  10. 翻译
  11. 显示选项
  12. 安装
  13. 路线图
  14. 捐款额

SEO 插件

SEO Interface thumbnail

一个强大的SEO管理扩展,帮助您优化搜索引擎和社交媒体共享的内容,就在Directus内部. 它包括一个管理元数据的综合界面和一个显示组件,用于监测标准电子数据状况.

关键特性 QQ

  • 标题和元描述( 有模板支持)
  • 视觉搜索结果预览
  • 重点关键词分析 (新来
  • 社会媒体形象和 预览 (新来
  • 子项目配置
  • 搜索引擎索引控制
  • 自定义 SIO 字段支持( 类似 Canonic URL,自定义元标记, JSON- LD等)
  • 使用从布局视图中预览的悬浮状态监视

接口 (在项目视图中显示)

SEO Interface 注意:界面现在使用标签来更好的组织(Basic, Advance, C自定义字段, keyword).

显示 (在布局视图中显示)

SEO Display

SEO数据

  • 标题(原始内容存档于2018-03-26) (英语). The most successive SEO number. 应具有说服力并包含您的主要关键词(建议长度:45-60个字符)
  • 元描述:您页面的搜索结果摘要. 使其参与提高点击率(建议长度:130-160个字符)

关键词分析( New!)

SEO Interface Keyphrase

  • 焦点键句: 您希望页面排列的主要关键词或短语.
  • 分析: 提供关键词在标题,元描述,URL sult,以及主要内容字段中的存在和用法的反馈. 突出问题,改进,取得好成绩.

社会媒体

  • OG 图像: 在社交媒体上共享页面时出现的图像 。 增强社会参与至关重要.
  • 社会预览:可视化不同平台共享的内容将如何外观.

搜索引擎控制器

  • 无索引: 告诉搜索引擎在搜索结果中不要显示此页面
  • 无跟随: 防止搜索引擎在页面上跟踪链接

项目设置

  • 更改频率: 网页的更新频率(选项:始终、小时、每日、每周、每月、每年、永远)
  • 优先权: 相对于其他页面的页面重要性(0.0至1.0,默认:0.5)

其他字段

  • 其他字段:针对特定需要自定义 SEO 字段( 如 Cononic URL,自定义元标记, JSON- LD等)

数据结构

SEO数据作为JSON存储,以简单和灵活.

OG 图像存储文件 filename_disk (单位:千美元)<uuid>.<ext>) (中文(简体) ). 和一个裸体的UUID工作 /assets/<value>,因为资产端点读取前36个字符为文件ID.

{
    "title": "This is the Directus SEO Plugin.",
    "meta_description": "A powerful SEO management extension that helps you optimize your content for search engines and social media sharing, right within Directus. It includes a comprehensive interface for managing metadata and a display component for monitoring SEO status.",
    "og_image": "f5d20d13-e86a-4aaa-ab1c-241925b89ea3.jpg",
    "focus_keyphrase": "Directus SEO",
    "additional_fields": {
        "canonical_url": "https://directus.io/",
        "custom_meta_tag": "This is a custom meta tag"
    },
    "sitemap": {
        "change_frequency": "monthly",
        "priority": "0.5"
    },
    "no_index": false,
    "no_follow": false
}

使用量

SEO插件由两个部分组成:

1. SEO接口

界面为管理标准电子数据元数据提供了一个综合表格,分为标签:

  • 基本标签数字 :
    • 有字符计数和最佳长度验证的页标题字段(45-60个字符)
    • 有验证的元描述 (130-160个字符)
    • 搜索结果预览
    • 社交媒体打开图形( OG) 上传图像
    • 社交媒体共享预览(新!)
  • 高级标签数字 :
    • 搜索引擎能见度控制( 无索引, 无跟随)
    • 项目配置选项
  • 自定义字段标签数字 :
    • 支持添加自定义 SEO 相关字段( 如 Cononic URL,自定义元标记)
  • 键口标签 (新语:
    • 焦点密钥词输入
    • 详细分析标题、说明、流言和内容中的关键词用法
    • 反馈分为问题、改进和良好结果

SEO Interface Progress Bar

Page Title 和 meta 描述字段显示一个进度栏来帮助您根据 SIO 最佳做法跟踪字符计数和最佳长度 .

要填充标题或元描述字段,请使用模板 Apply Template 按钮将模板应用到字段.

SEO Interface Template

2. SEO 显示

紧凑状态指标显示:

  • 社会平等局总体健康状况
  • 快速概述缺失或无效的字段
  • 悬浮时搜索预览( 可选)
  • 所需领域和可选领域的现状

SEO Display Layout

SEO Display Ideal

SEO Display Hidden

图标的解释:

  • 绿色检查标记:所有配置的字段都有效.
  • 黄色警告:一些已配置的字段无效 .
  • 红色错误 : 至少缺少一个需要的字段(包括根据需要标记的附加字段)
  • 有斜线图标的灰眼: 没有启用此项的索引字段隐藏在搜索引擎中

配置 {}

要使用 SEO 插件, 请在您想要管理 SEO 的任何( 和所有) 收藏中添加一个新字段( 例如帖子、 文章或页面) 。 字段类型应该是 json。为外地推荐的密钥只是 seo 但你可以使用任何你想要的钥匙.

接口选项

SEO Interface Configuration

  • 类型数字 : json
  • 组数字 : standard
  • 选项: 可配置模板、 OG 图像、 站点映射设置、 自定义字段和 焦点密钥句设置 (新来

界面可以配置如下选项:

  1. 标题模板

    • 配置 SIO 标题的模式, 这样您就可以使用项目中的字段生成标题
    • 使用 {{fieldName}} 语法
  2. 说明模板

    • 配置元描述的图案, 以便您使用项目中的字段生成描述
    • 使用 {{fieldName}} 语法
  3. 社交媒体形象

    • 切换以启用/禁用 Open Graph 图像上传和社交媒体预览 .
    • 默认禁用
  4. 焦点键句

    • 切换到启用/失效密钥句分析选项卡 .
    • 默认禁用
    • 粘结字段: 选择您收藏中包含 URL sult 进行分析的字段.
    • 内容字段:选择一个或多个包含主要内容进行分析的字段(如:WYSIWYG,Markdown).
  5. 搜索引擎控制器

    • 切换到在高级标签中显示/ hide noindex/ no follow 选项.
    • 默认禁用
  6. 项控件

    • 切换到高级标签中启用/失效的站点映射配置 .
    • 启用时,包括:
      • 默认更改频率( 预设为"每周" )
      • 默认优先级( 预设为" 0. 0" )
    • 编辑 SEO 字段后, 默认会随项一同保存 。 从未被触摸过 SIO 字段的项目 null,因此在前端应用相同的默认值.
    • 默认禁用
  7. 自定义 SEO 字段

    • 切换到启用/禁用自定义字段标签 .
    • 默认禁用
    • 标记字段 需求 显示星号、 自定义字段标签上的错误图标并显示 SIO 显示中的错误。 他们不会阻碍储蓄,因为价值 生活在一个JSON领域。 要执行,请使用屏蔽的流程 items.create 编号 : items.update 检查 seo.additional_fields。 。 。 .

翻译内容

要保持每个语言的SEO,请在您的翻译收藏中添加SEO字段(例如翻译界面创建的翻译字段). articles_translations) (中文(简体) ). 模板 密钥句分析 和弹道检查 然后使用该语言的字段.

在列表中查看每种语言的最低限度就业标准状况:

  • 建议: ,选择核心 翻译 显示并添加到其模板中(例如:. {{seo}}) (中文(简体) ). 单元格显示默认语言或用户语言的状态,并按其状态盘旋列出每一种语言.
  • A 类 translations.seo 栏也起作用。 它显示一个芯片,在各种翻译中状况最差;徘徊列出每个翻译的状况. 它无法显示语言名称,因为显示器不接受该列的语言字段.

翻译

界面和显示都遵循每个用户的Directus语言. 包括:英语,德语,西班牙语,法语,意大利语,日语,朝鲜语,荷兰语,波兰语,葡萄牙语(巴西),越南语,汉语(简化后). 区域变体如: es-MX, (中文(简体) ), fr-CA,以及 pt-PT 使用最近的一个。 添加或修补语言,编辑或添加文件 src/lang/ 键与 en-US.ts 并登记在 src/lang/index.ts。缺失的密钥返回英语.

显示选项

SEO Display Configuration

  • 类型数字 : json
  • 图标数字 : search
  • 选项: 搜索预览切换

显示组件可以配置为:

  1. 显示搜索预览
    • 切换以启用/ 无法在悬浮时预览搜索结果
    • 显示页面在搜索结果中的显示方式
    • 默认禁用

安装

从 Directus 市场安装扩展 。 见 正式指南 更多信息.

或者如果您喜欢手动安装 :

npm install @directus-labs/seo-plugin

路线图

计划:

  • 支持翻译标题和元描述字段
  • 外地标签和说明翻译

也许:

  • 在模板中添加对关系字段的支持

捐款额

欢迎捐款! 请在提交公关前添加一个问题,描述您想要添加的功能.

版本与发布记录

@directus-labs/seo-plugin 共发布 6 个版本,首次发布于 2025/02/13;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.1latest2026/11/048 天前
1.2.02026/10/2914 天前
1.1.12026/02/128 个月前
1.1.02025/04/241.6 年前
1.0.12025/02/221.7 年前
1.0.02025/02/131.7 年前

关于 @directus-labs/seo-plugin 的常见问题

@directus-labs/seo-plugin 是什么?

Directus 的 SIO 插件

如何安装 @directus-labs/seo-plugin?

在项目目录运行 npm install @directus-labs/seo-plugin,或使用 pnpm add / yarn add / bun add。

@directus-labs/seo-plugin 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/directus-labs__seo-plugin 是否存在。

@directus-labs/seo-plugin 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@directus-labs/seo-plugin 可以商用吗?

@directus-labs/seo-plugin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@directus-labs/seo-plugin 的下载量有多少?

根据 npm 官方下载统计,@directus-labs/seo-plugin 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,972 次,日均约 166 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@directus-labs/seo-plugin 还在维护吗?

最新版本 1.2.1 发布于 2026/11/04(8 天前);至今共发布 6 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/02/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。