craft-plugins

Craft CMS 5 — 插件参考（索引与路由）

此技能是一个路由器，而非教程。它旨在让你无论从何种任务角度（前端、PHP 后端、内容迁移、部署或配置）都能找到各插件的指南，并指引你查阅正确的参考文件。

每个插件的精选参考内容都位于 references/<plugin>.md，涵盖配置、Twig 和／或 PHP API，以及实际使用中容易遇到的问题。在实现任何特定插件功能之前，请先阅读对应的参考文件。

如何使用此技能

1. 根据任务中提到的名称、软件包或功能，确定涉及的插件。
2. 从下表中打开对应的 references/<plugin>.md。
3. 如果任务涉及后端（PHP、内容迁移、事件、部署），请特别查阅参考文件中的后端／编程相关章节——有几个插件（Formie、Feed Me、Element API、Amazon SES）尽管过去归在前端技能下，但实际上主要或很大程度上属于后端。

路由表

参考文档	插件（厂商）	主要层面	关键内容
references/formie.md	Formie (verbb)	前端和后端	表单渲染（单行／细粒度）、主题配置；在内容迁移中以编程方式创建表单、在迁移中编辑现有表单的字段、表单作为数据库元素（而非项目配置）、跨环境部署、多站点／静态翻译、覆盖 Formie 内置字符串（服务端 + 客户端 window.FormieTranslations）、原生最小／最大长度验证及其两个消息键、required+min 交互、文件上传卷宗 + 文件重命名、通知附件、验证码与缓存
references/seomatic.md	SEOmatic (nystudio107)	前端 + 配置	Meta 级联、Twig get/set API、JSON-LD、自定义元素 SEO 包、站点地图、GraphQL
references/blitz.md	Blitz (putyourlightson)	混合（前端 + 运维）	刷新模式、Twig 动态内容、驱动架构（存储／清除器／部署器）、Nginx 重写、Cloudflare 集成
references/feed-me.md	Feed Me (craftcms)	后端／运维	从 XML/JSON/CSV 导入数据、字段映射、重复项处理、CLI 自动化、定时导入
references/imager-x.md	Imager X (spacecatninja)	前端 + 配置	快捷语法、自适应 srcset、命名转换、Power Pack 标记（ppimg/pppicture）、自动生成、转换器、效果、优化器
references/image-optimize.md	ImageOptimize (nystudio107)	前端 + 字段配置	OptimizedImages 字段、imgTag()/pictureTag() 构建器、加载策略、转换方法、控制台命令
references/ckeditor.md	CKEditor (craftcms)	混合（字段配置 + 前端）	字段设置（工具栏、标题、图片模式）、嵌套条目及分块渲染和值辅助方法、链接配置、GraphQL 模式、ES 模块自定义插件、HTML Purifier、Redactor 迁移
references/sprig.md	Sprig (putyourlightson)	前端	响应式 Twig 组件（htmx）、实时搜索、加载更多、分页、筛选、无需 JS 的表单提交
references/element-api.md	Element API (craftcms)	后端／配置	通过配置文件提供 JSON API、Fractal 转换器、端点路由、分页、缓存
references/retour.md	Retour (nystudio107)	运维／配置	重定向类型（精确／正则）、404 跟踪、CSV 导入、自动创建 slug 变更重定向、配置
references/navigation.md	Navigation (verbb)	前端	节点查询、自定义渲染、活动状态、节点自定义字段、GraphQL
references/hyper.md	Hyper (verbb)	前端 + 字段配置	链接类型、getLinkAttributes()、getText()、单链接／多链接、元素访问、按钮原子集成
references/colour-swatches.md	Colour Swatches (craftpulse)	混合	调色板配置、多色样本、Tailwind 类映射、Twig 模型 API
references/password-policy.md	Password Policy (craftpulse)	后端／配置	验证规则、HIBP 检查、保留期限／到期时间、控制台命令、推荐设置
references/typogrify.md	Typogrify (nystudio107)	前端	|typogrify、|widont、|truncateOnWord、智能引号、防止孤行
references/cache-igniter.md	Cache Igniter (putyourlightson)	运维	GlobalPing 预热器、地理位置、刷新延迟、Blitz 配套插件
references/knock-knock.md	Knock Knock (verbb)	运维／配置	暂存环境密码保护、环境感知配置、URL 排除项
references/timeloop.md	Timeloop (craftpulse)	混合	重复日期字段、craft.timeloop 变量 API、recurringDates() 函数、GraphQL、周期频率
references/elements-panel.md	Elements Panel (putyourlightson)	开发工具	用于元素填充计数、重复项检测、急切加载机会的调试工具栏面板
references/sherlock.md	Sherlock (putyourlightson)	运维／配置	安全扫描、HTTP 标头、CMS 配置检查、定时扫描、IP 限制、监控
references/embedded-assets.md	Embedded Assets (spicyweb)	混合	将 oEmbed 作为一等资源、craft.embeddedAssets.get()、iframe 自定义、GraphQL
references/amazon-ses.md	Amazon SES (putyourlightson)	后端／配置	SES 邮件传输适配器、AWS 凭据配置、SNS 退信跟踪（无 Twig API）
references/warp.md	Warp (craftpulse)	前端和后端	无密码会员身份验证：魔术链接（mlToken，绝不可用 token）、电子邮件一次性代码 + 分段输入、通行密钥／WebAuthn、无密码注册、会话／设备管理。craft.warp 变量、四种流式渲染构建器（累积类 + resetClass、逐键合并 data、renderCss）、@layer warp CSS 逃逸方式、十个操作路由（returnUrl 与 Craft 的 redirect 不对称、可防枚举的响应、近期身份验证门控的通行密钥路由）、手写标记的 DOM 契约
references/vite.md	Vite (nystudio107)	前端 + 构建链	craft.vite.* Twig API（script、register、entry、asset、integrity、inline、includeCriticalCssTags、devServerRunning）、vite.php 配置键。craft-site 技能的 references/vite-buildchain.md 中详述构建链／vite.config.ts

配套技能

• craftcms — 用于插件任务所依赖的 Craft 核心 API：元素保存、事件、迁移、队列作业、字段值存储。任何插件 PHP/迁移 工作都应与此技能一起加载。
• craft-site — 用于插件输出所适配的前端模板架构（组件、布局、图像预设）。插件涉及 渲染/样式 工作时，应与此技能一起加载。
• craft-content-modeling — 用于插件与分区、字段、卷或多站点传播交互的场景。
• craft-cloud / servd — 用于插件任务涉及部署、边缘缓存或临时文件系统限制的场景。