如何自定义Django CMS插件？自定义Card插件遇报错求助

核心问题分析 #

你的代码存在几个关键错误，导致插件无法正常加载：

1. 插件类未关联自定义表单CustomForm，而是误用了原生CardForm
2. 自定义表单引用了未定义的CustomCard模型
3. 渲染模板存在语法错误（多余的}）
4. 未创建与自定义插件对应的模型（需继承原生Card模型）

修正步骤及代码 #

1. 创建自定义模型（models.py）

先定义继承自原生Card的模型，用于存储新增字段：

from django.db import models
from djangocms_frontend.contrib.card.models import Card

class CustomCard(Card):
    title = models.CharField(max_length=255, blank=True, null=True, verbose_name="标题")

2. 修正自定义表单（cms_forms.py）

确保表单关联正确模型，继承原生CardForm的所有字段：

from django import forms
from djangocms_frontend.contrib.card.forms import CardForm
from .models import CustomCard

class CustomCardForm(CardForm):
    class Meta:
        model = CustomCard
        fields = "__all__"

3. 修正插件类（cms_plugins.py）

关联自定义表单与模型，继承原生CardPlugin复用基础逻辑：

from cms.plugin_pool import plugin_pool
from djangocms_frontend.contrib.card.cms_plugins import CardPlugin
from .models import CustomCard
from .cms_forms import CustomCardForm

class CustomCardPlugin(CardPlugin):
    form = CustomCardForm
    name = "自定义卡片"
    model = CustomCard
    render_template = "siteindex/card_render.html"
    cache = False

plugin_pool.register_plugin(CustomCardPlugin)

4. 修正渲染模板（card_render.html）

移除多余的语法符号：

{{ instance.title }}

5. 执行数据库迁移

修改模型后，同步数据库：

python manage.py makemigrations
python manage.py migrate

额外说明 #

• 继承原生CardPlugin可直接复用原有卡片插件的所有功能，无需重新实现基础逻辑
• 若无需修改原生字段属性，自定义表单仅需关联模型即可，无需重复定义字段
• 如果不需要自定义修改表单的UI，可直接省略change_form_template配置，使用原生模板

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