[1.7.x] Fixed #14481 -- Documented implicit "through" class created by ManyToManyField.

Thanks to jonathanmorgan for the report and initial patch.

Backport of de90129070 from master
This commit is contained in:
Jorge C. Leitão 2014-06-16 21:30:26 +02:00 committed by Tim Graham
parent 1d9f308fa1
commit 807aadaaad
1 changed files with 13 additions and 0 deletions

View File

@ -1349,6 +1349,19 @@ that control how the relationship functions.
:ref:`extra data with a many-to-many relationship
<intermediary-manytomany>`.
If you don't specify an explicit ``through`` model, there is still an
implicit ``through`` model class you can use to directly access the table
created to hold the association. It has three fields:
* ``id``: the primary key of the relation.
* ``<containing_model>_id``: the ``id`` of the model that declares the
``ManyToManyField``.
* ``<other_model>_id``: the ``id`` of the model that the
``ManyToManyField`` points to.
This class can be used to query associated records for a given model
instance like a normal model.
.. attribute:: ManyToManyField.through_fields
.. versionadded:: 1.7