ParentalManyToManyField()的中文文档与使用示例

ParentalManyToManyField（父母多对多字段）是Django框架中的一个自定义字段，用于在模型中表示父母关系。

该字段继承自ManyToManyField，但添加了一些特殊功能，以便更方便地处理父母关系。

使用ParentalManyToManyField可以方便地在模型中定义父母关系，同时提供一些方便的方法来查询、添加和删除关联的父母。

在使用ParentalManyToManyField时，我们需要在settings.py文件中配置正确的数据库信息，并在models.py文件中导入ParentalManyToManyField。

接下来，我们可以通过以下方式使用ParentalManyToManyField：

1. 定义模型：

   from django.db import models
   from wagtail.core.models import Orderable
   from wagtail.core.fields import ParentalManyToManyField
   from wagtail.admin.edit_handlers import FieldPanel
   
   class Person(models.Model):
       name = models.CharField(max_length=255)
       parents = ParentalManyToManyField('self', through='PersonRelation', symmetrical=False)
   
       panels = [
           FieldPanel('name'),
           FieldPanel('parents')
       ]
   
       def __str__(self):
           return self.name
   
   class PersonRelation(Orderable):
       relation_type = models.CharField(max_length=255)
       from_person = models.ForeignKey(Person, on_delete=models.CASCADE, related_name='from_people')
       to_person = models.ForeignKey(Person, on_delete=models.CASCADE, related_name='to_people')
   
       panels = [
           FieldPanel('relation_type'),
           FieldPanel('from_person'),
           FieldPanel('to_person')
       ]
   

上述代码中，我们定义了一个Person模型，其中包含一个名为parents的ParentalManyToManyField字段。该字段通过PersonRelation模型进行关联，并且symmetrical参数设置为False，意味着父母关系可以不对称。

PersonRelation模型表示两个Person之间的关系类型，其中from_person和to_person都是外键字段，指向Person模型。

通过FieldPanel可以将字段添加到Wagtail CMS中的编辑界面中。

2. 进行迁移：

   python manage.py makemigrations
   python manage.py migrate
   

3. 创建父母关系：

   dad = Person.objects.create(name='Dad')
   mom = Person.objects.create(name='Mom')
   son = Person.objects.create(name='Son')
   daughter = Person.objects.create(name='Daughter')

   dad.parents.add(son)
   mom.parents.add(son)
   dad.parents.add(daughter)
   mom.parents.add(daughter)
   

以上代码创建了两个父母Dad和Mom，以及两个孩子Son和Daughter，并通过父母关系将Son和Daughter与Dad和Mom关联起来。

4. 查询父母关系：

   son = Person.objects.get(name='Son')
   parents = son.parents.all()
   for parent in parents:
       print(parent)
   

以上代码查询Son的所有父母，并打印出它们的名字。

输出：

   Dad
   Mom
   

5. 删除父母关系：

   son.parents.remove(dad)
   

以上代码删除Son和Dad之间的父母关系。

通过上述示例，我们可以看到，使用ParentalManyToManyField可以很方便地处理父母关系，并提供了一些方便的方法。但需要注意的是，在使用ParentalManyToManyField时，需要在模型定义和数据库迁移之后才能正常使用。