Django-CMS与django-modeltranslation兼容性问题解析

问题背景

在Django-CMS 3.11.X版本与django-modeltranslation 0.19.3+版本共同使用时，开发者遇到了一个影响插件结构编辑器的严重问题。具体表现为插件系统中的allow_children和child_classes属性被忽略，且disable_child_plugins总是被设置为True，导致插件无法按预期进行嵌套和移动。

问题根源分析

经过深入调查，发现问题源于Django模板引擎与Python类型注解机制的交互方式。具体来说：

1. 模板变量解析机制：Django模板引擎在解析变量时，会先尝试字典查找，然后才查找属性。这种设计在遇到实现了__class_getitem__方法的类时会产生问题。

2. django-modeltranslation的影响：从0.19.3版本开始，django-modeltranslation引入了类型注解支持，为ModelAdmin类添加了__class_getitem__方法。这使得模板引擎在解析插件类属性时，错误地尝试了字典查找而非直接属性访问。

3. Django模板引擎的局限性：在Django 5.2之前的版本中，模板引擎无法正确处理类型注解相关的类属性访问，导致插件类的属性无法被正确获取。

技术细节

问题的核心在于Django模板引擎的变量解析逻辑。当模板中访问plugin.get_plugin_class.allow_children时：

1. 模板引擎首先尝试字典查找，调用__class_getitem__方法
2. 由于django-modeltranslation的修改，这会触发一个AttributeError（缺少admin_site属性）
3. 模板引擎未能正确处理这个异常，导致属性访问失败

解决方案

针对这一问题，社区提出了多层次的解决方案：

1. 临时解决方案：

   • 使用django-modeltranslation 0.19.8+版本，该版本包含了对这一问题的特定修复
   • 或者降级到django-modeltranslation 0.19.2版本

2. Django-CMS层面的修复：

   • 在CMSPluginBase类中添加__class_getitem__方法，明确抛出TypeError
   • 这样可以确保模板引擎能够正确回退到属性访问方式

3. 长期解决方案：

   • 升级到Django 5.2+版本，该版本已修复模板引擎对类型注解类的处理
   • 考虑使用django-parler作为替代方案，它提供了更好的语言支持且不会产生此类问题

最佳实践建议

对于正在使用或计划使用Django-CMS与多语言支持的开发者，建议：