如何在Django代理模型中添加额外字段？以Tag模型为例

Got it, let's sort out how to add that type field properly. First, a quick heads-up: since you're using a proxy model (marked with proxy=True), you can't add new database fields directly—proxy models share the exact same database table as the original Tag model, so they only let you modify behavior, not add fields. Here's the correct approach to make this work:

Step 1: Replace the Proxy Model with a Custom Tag Model #

Instead of using a proxy, we'll extend Django Taggit's Tag (which Wagtail uses under the hood) directly, then add your type field to this new model:

from django.db import models
from taggit.models import Tag as TaggitTag
from wagtail.snippets.models import register_snippet
from wagtail.search import index

@register_snippet
class ArticleTag(index.Indexed, TaggitTag):
    type = models.CharField(
        max_length=50,
        blank=True,
        help_text="Enter the type of this tag (e.g., 'Topic', 'Category')"
    )

    class Meta:
        verbose_name = "Article Tag"
        verbose_name_plural = "Article Tags"

    search_fields = [
        index.SearchField('name', partial_match=True),
        index.SearchField('slug', partial_match=True),
        index.SearchField('type', partial_match=True),  # Include type in search if needed
    ]

    def __str__(self):
        return f"{self.name} ({self.type})" if self.type else self.name

Step 2: Update Your Article Model to Use the Custom Tag #

If you have an Article model that uses tags, update the taggable manager to point to your new ArticleTag model:

from taggit.managers import TaggableManager
from .models import ArticleTag

class Article(models.Model):
    # ... your existing fields ...
    tags = TaggableManager(
        through='taggit.TaggedItem',
        to=ArticleTag,
        blank=True
    )

    # ... rest of your model logic ...

Step 3: Run Migrations #

Since we're adding a new database field, you'll need to generate and apply migrations:

python manage.py makemigrations
python manage.py migrate

Key Notes #

• Why ditching the proxy? Proxy models can't add database fields because they don't create a new table. By extending TaggitTag directly, we create a new table that includes all original Tag fields plus our custom type.
• Existing tags? If you already have tags in your database, you can write a data migration to copy them from the original Tag table to your new ArticleTag table.
• Snippet interface: Wagtail's snippet editor will automatically display the type field—no extra configuration needed!

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