如何可靠重命名DjangoCMS插件？含数据库迁移操作指引

核心修改步骤 #

你提到的修改CMSPlugin的plugin_type是关键操作，但还有几个不可遗漏的环节，以下是完整的可靠流程：

1. 更新插件注册配置 #

找到插件注册文件（通常是cms_plugins.py），将注册时的name参数替换为新名称，同时确保关联的模型是你已重命名后的新模型：

from cms.plugin_base import CMSPluginBase
from cms.plugin_pool import plugin_pool
from .models import NewMyPlugin  # 已重命名的模型

class NewMyPluginPlugin(CMSPluginBase):
    model = NewMyPlugin
    name = "NewMyPlugin"  # 替换原有的OldMyPlugin
    # 保留其他原有配置（如render_template、cache_timeout等）

plugin_pool.register_plugin(NewMyPluginPlugin)

2. 数据库层面更新插件类型记录 #

通过Django迁移执行批量更新，避免手动操作数据库：

1. 生成空迁移文件：

   python manage.py makemigrations your_app_name --empty
   

2. 编辑生成的迁移文件，添加RunPython操作执行更新：

   from django.db import migrations
   from cms.models import CMSPlugin
   
   def update_plugin_type(apps, schema_editor):
       # 替换为你的旧插件名和新插件名
       CMSPlugin.objects.filter(plugin_type='OldMyPlugin').update(plugin_type='NewMyPlugin')
   
   class Migration(migrations.Migration):
       dependencies = [
           ('your_app_name', '之前的迁移文件名'),  # 替换为实际的依赖迁移
       ]
   
       operations = [
           migrations.RunPython(update_plugin_type),
       ]
   

3. 执行迁移：

   python manage.py migrate your_app_name
   

3. 清理系统缓存 #

DjangoCMS会缓存插件元信息，修改后必须清理缓存确保后台加载新名称：

python manage.py clearcache

如果使用了Redis、Memcached等第三方缓存服务，需同步清理对应缓存。

注意事项 #

• 检查模板或代码中是否有硬编码的旧插件名称，一并替换
• 迁移前务必备份数据库，防止操作失误导致数据丢失
• 若插件有自定义权限、信号或其他关联逻辑，需检查是否存在硬编码的旧名称并更新

内容的提问来源于stack exchange，提问作者fabien-michel