为什么 MyPage._meta.get_field("title").verbose_name 更改了 Wagtail 中所有标题的标签？

Question

我的 Wagtail 项目中有一些应用程序，其中之一是包含 News(Page) 的“新闻”。我想在管理员中将标题的标签“title”覆盖为“headline”。

News._meta.get_field("title").verbose_name = "Headline"

结果，我在所有应用程序和页面中获得了所有标题的标签“Headline”。为什么我会有这种奇怪的效果？

更新：

# news/models.py

class NewsDetails(Page):
    template = "news/news_details.html"

    news_text = RichTextField(features=['h2', 'h3', 'bold', 'italic', 'link', 'ol', 'ul',])
    news_image = models.ForeignKey(
        "wagtailimages.Image",
        null=True,
        blank=False,
        on_delete=models.SET_NULL,
    )

    content_panels = Page.content_panels + [
        ImageChooserPanel("news_image"),
        FieldPanel("news_text")
    ]

    class Meta:
        verbose_name = "News"

    parent_page_types = ['news.NewsList']


NewsDetails._meta.get_field("title").verbose_name = "Headline"

Answer 1

对内森的答案稍作修改，解决了瓦莱里verbose_name不工作的问题。设置title.label而不是title.verbose_name：

class NewsDetailsForm(WagtailAdminPageForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        # Manually edit the default form's title attributes:
        title = self.fields['title']
        title.label = "Headline"
        title.help_text = "Some headline..."

原因是我们现在处理的是 django.forms.Field 而不是 django.db.models.Field。请参阅以下代码django.db.models.Field.formfield()：

    def formfield(self, form_class=None, choices_form_class=None, **kwargs):
        """Return a django.forms.Field instance for this field."""
        defaults = {
            'required': not self.blank,
            'label': capfirst(self.verbose_name),
            'help_text': self.help_text,
        }

        ...

        return form_class(**defaults)

Answer 2

这种方法的问题在于，当您运行django-admin.py makemigrations命令时，Django 将为 Wagtail 核心生成迁移（即使它是通过 pip 安装的）。

为避免这种情况，最好base_form_class在NewsDetails模型中使用自定义。这种方法也适用于更改其他属性，例如help_text：

from wagtail.admin.forms import WagtailAdminPageForm

class NewsDetailsForm(WagtailAdminPageForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        # Manually edit the default form's title attributes:
        title = self.fields['title']
        title.verbose_name="Headline"
        title.help_text="Some headline..."


class NewsDetails(Page):
    template = "news/news_details.html"

    news_text = RichTextField(features=['h2', 'h3', 'bold', 'italic', 'link', 'ol', 'ul',])
    news_image = models.ForeignKey(
        "wagtailimages.Image",
        null=True,
        blank=False,
        on_delete=models.SET_NULL,
    )

    content_panels = Page.content_panels + [
        ImageChooserPanel("news_image"),
        FieldPanel("news_text")
    ]

    class Meta:
        verbose_name = "News"

    parent_page_types = ['news.NewsList']

    # Important line below:
    base_form_class = NewsDetailsForm