创建Shopware 6自定义CMS区块与元素后，如何找到并使用CMS元素？

1. 核对CMS元素注册配置 #

检查src/Resources/config/cms-element.xml的核心配置：

• 确认元素name与区块关联的元素名称完全一致
• 验证category字段设置为text-image，确保和区块所属分类匹配
• 检查component路径指向正确的Vue组件，比如component: 'sw-cms-el-my-custom-element'

2. 清理缓存并重建前端资源 #

Shopware 6的缓存和前端构建缓存可能导致元素不加载：

• 执行后端缓存清理：bin/console cache:clear
• 重新编译前端主题/资源：./psh.phar theme:compile（官方开发环境）或npm run build（自定义前端项目）
• 强制刷新浏览器缓存（Ctrl+Shift+R）

3. 在CMS编辑器中精准查找 #

进入后台CMS编辑页面后：

• 切换到text-image分类标签页
• 若未直接显示，点击编辑器的「更多元素」下拉菜单，部分自定义元素可能默认折叠在此

4. 验证数据库与权限设置 #

• 查看cms_element数据表，确认自定义元素已存在且active字段为1
• 确保当前后台用户拥有cms_element:read权限，无权限会导致元素被隐藏

5. 排查前端组件注册问题 #

如果后台仍无元素显示，检查前端组件注册：

• 确认在src/Resources/app/administration/src/main.js中已导入组件：

  import './module/sw-cms/elements/my-custom-element';
  

• 打开浏览器控制台（F12）查看是否有组件加载报错，排查Vue组件文件是否存在或语法错误

内容的提问来源于stack exchange，提问作者Templator Khan