Django-CMS中CMSPlugin未触发pre_save/post_save信号的技术问询

我之前也踩过这个坑——django-cms的CMSPlugin模型确实不会触发Django默认的pre_save/post_save信号，这是因为它内部的保存逻辑绕开了Django标准的模型保存流程，用了自定义的管理器操作数据库。不过别担心，官方其实提供了专门的信号来处理这类场景，下面给你几个靠谱的解决方案：

1. 使用django-cms官方提供的插件信号 #

django-cms针对插件的增删改操作，提供了plugin_post_save和plugin_post_delete这两个专用信号，完全可以满足你的需求。你只需要给这两个信号注册接收器，在插件保存/删除后触发搜索索引的同步逻辑。

举个例子，假设你的业务模型和占位符是通过外键关联的（比如模型叫Article，有placeholder字段），可以这么写：

# 在你的app的signals.py文件中
from django.dispatch import receiver
from cms.signals import plugin_post_save, plugin_post_delete

@receiver(plugin_post_save)
def sync_search_on_plugin_save(sender, instance, **kwargs):
    # 获取插件所属的占位符
    placeholder = instance.placeholder
    # 通过占位符找到对应的业务模型实例
    article = placeholder.content_object
    if article and hasattr(article, 'update_search_index'):
        # 执行同步到Algolia的逻辑，比如调用你封装好的更新方法
        article.update_search_index()

@receiver(plugin_post_delete)
def sync_search_on_plugin_delete(sender, instance, **kwargs):
    # 删除插件后的逻辑和保存时一致
    placeholder = instance.placeholder
    article = placeholder.content_object
    if article and hasattr(article, 'update_search_index'):
        article.update_search_index()

2. 监听占位符的更新信号 #

如果你的业务模型直接关联了Placeholder模型，也可以监听cms.signals.placeholder_post_save信号——当占位符下的任何插件发生变化时，占位符本身会触发这个信号，同样能达到触发索引更新的目的：

from django.dispatch import receiver
from cms.signals import placeholder_post_save

@receiver(placeholder_post_save)
def sync_search_on_placeholder_update(sender, instance, **kwargs):
    article = instance.content_object
    if article and hasattr(article, 'update_search_index'):
        article.update_search_index()

3. 确保信号接收器被正确加载 #

写完信号接收器后，一定要确保Django启动时能加载到它们。最规范的做法是：

• 在你的app下创建signals.py文件存放接收器代码
• 修改apps.py，在ready()方法中导入信号：

# apps.py
from django.apps import AppConfig

class YourAppConfig(AppConfig):
    name = 'your_app_name'

    def ready(self):
        import your_app_name.signals

• 在app的__init__.py中指定默认的app配置：

# __init__.py
default_app_config = 'your_app_name.apps.YourAppConfig'

为什么默认信号不生效？ #

简单说，django-cms的CMSPlugin使用了自定义的CMSPluginManager，在保存插件时没有调用Django标准的Model.save()方法，而是直接执行数据库更新语句，导致Django默认的post_save信号没有被触发。所以必须使用官方提供的专用信号才能捕获到插件的更新事件。

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