Wagtail 4.1.1股票价格实体按钮不显示，请求协助排查

核心排查方向 #

1. 实体注册与编辑器配置关联 #

检查wagtail_hooks.py中是否完成实体的完整注册：

• 确认通过register_rich_text_features钩子将实体插件注册到Draftail编辑器
• 必须将实体的标识（如stock）添加到编辑器默认features列表，或在RichTextField的features参数中显式声明
  示例代码参考：

from wagtail import hooks
from wagtail.admin.rich_text.editors.draftail import features as draftail_features
from .stock_entity import StockEntityFeature

@hooks.register('register_rich_text_features')
def register_stock_entity_feature(features):
    features.register_editor_plugin(
        'draftail',
        'stock',
        StockEntityFeature(),
    )
    # 将实体加入默认富文本功能集
    features.default_features.append('stock')

2. 前端资源加载与插件实现 #

• 检查实体对应的JS文件是否正确实现Draftail实体插件，并通过钩子注入后台：
  在wagtail_hooks.py中添加前端资源注入：

  from django.utils.html import format_html
  from django.templatetags.static import static
  
  @hooks.register('insert_global_admin_js')
  def insert_stock_entity_js():
      return format_html(
          '<script src="{}"></script>',
          static('js/stock-entity.js')
      )
  

• 确认JS文件中正确注册实体类型、工具栏按钮与交互逻辑，比如：

  const StockEntity = Draftail.Entity.extend({
      getProps(props) {
          return { symbol: props.symbol };
      },
  });
  
  const stockPlugin = {
      type: 'STOCK',
      label: '📈',
      description: 'Stock Price',
      entity: StockEntity,
      addToolbarButton(editor) {
          return () => editor.insertEntity('STOCK', { description: 'Stock symbol' }, { symbol: 'AAPL' });
      },
  };
  
  Draftail.registerPlugin(stockPlugin);
  

• 执行python manage.py collectstatic确保静态资源被正确收集到指定目录

3. 实体类的完整性 #

检查自定义StockEntityFeature类是否实现了必要方法：

• get_config()需返回包含type、label、icon等核心配置的字典
• 确保实体的后端处理类（如StockEntityElementHandler）正确注册到register_rich_text_features的converter_rule中

4. 缓存与权限验证 #

• 强制刷新浏览器缓存（Ctrl+Shift+R），避免旧前端资源干扰
• 确认当前管理员账号拥有页面编辑权限
• 重启Django开发服务器，确保代码修改已生效

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