Magnolia富文本编辑器插入内部链接异常问题咨询

AI 小北

2026-7-31

解决Magnolia富文本字段CKEditor内部链接/DAM图片模板字符串未解析问题

核心原因

自定义CKEditor配置时遗漏了Magnolia专属的解析插件，或者字段/模板渲染环节未启用解析逻辑，导致内部链接和DAM图片的模板字符串未被替换为实际路径。

解决步骤

确保CKEditor配置包含核心解析插件
自定义CKEditor配置时，必须保留magnolialink和magnoliaimage插件，这两个插件负责处理内部链接和DAM图片的模板解析。示例配置：
```
CKEDITOR.editorConfig = function(config) {
  // 你的其他自定义配置
  config.extraPlugins = 'magnolialink,magnoliaimage'; // 必须包含这两个插件
  // 其他配置...
};
```
注意：如果使用config.plugins覆盖默认插件列表，需要把这两个插件也加入，否则会被移除。

配置字段的解析器
在富文本字段的定义YAML中，指定官方默认的链接和图片解析器：

fields:
  yourRichTextField:
    type: richText
    ckEditorConfig: /path/to/your/custom/config.js
    linkResolver:
      class: info.magnolia.ui.editor.link.DefaultLinkResolver
    imageResolver:
      class: info.magnolia.ui.editor.image.DefaultImageResolver

模板渲染时使用正确指令
在Freemarker模板中渲染富文本内容时，必须使用[#content]指令触发解析逻辑，不能直接输出字段内容：
```
[#content]${content.yourRichTextField}[/#content]
```
直接输出${content.yourRichTextField}会保留原始模板字符串，无法解析为实际路径。
清除缓存并重新发布
修改配置后，进入AdminCentral的Tools -> Cache清除所有缓存，然后重新发布相关页面和配置节点，确保新配置生效。