Loading docs/ref/models/options.txt +18 −10 Original line number Diff line number Diff line Loading @@ -173,11 +173,11 @@ Django quotes column and table names behind the scenes. .. attribute:: Options.order_with_respect_to Marks this object as "orderable" with respect to the given field. This is almost always used with related objects to allow them to be ordered with respect to a parent object. For example, if an ``Answer`` relates to a ``Question`` object, and a question has more than one answer, and the order of answers matters, you'd do this:: Makes this object orderable with respect to the given field, usually a ``ForeignKey``. This can be used to make related objects orderable with respect to a parent object. For example, if an ``Answer`` relates to a ``Question`` object, and a question has more than one answer, and the order of answers matters, you'd do this:: from django.db import models Loading Loading @@ -218,12 +218,20 @@ Django quotes column and table names behind the scenes. >>> answer.get_previous_in_order() <Answer: 1> .. admonition:: Changing order_with_respect_to .. admonition:: ``order_with_respect_to`` implicitly sets the ``ordering`` option ``order_with_respect_to`` adds an additional field/database column named ``_order``, so be sure to make and apply the appropriate migrations if you add or change ``order_with_respect_to`` after your initial :djadmin:`migrate`. Internally, ``order_with_respect_to`` adds an additional field/database column named ``_order`` and sets the model's :attr:`~Options.ordering` option to this field. Consequently, ``order_with_respect_to`` and ``ordering`` cannot be used together, and the ordering added by ``order_with_respect_to`` will apply whenever you obtain a list of objects of this model. .. admonition:: Changing ``order_with_respect_to`` Because ``order_with_respect_to`` adds a new database column, be sure to make and apply the appropriate migrations if you add or change ``order_with_respect_to`` after your initial :djadmin:`migrate`. ``ordering`` ------------ Loading Loading
docs/ref/models/options.txt +18 −10 Original line number Diff line number Diff line Loading @@ -173,11 +173,11 @@ Django quotes column and table names behind the scenes. .. attribute:: Options.order_with_respect_to Marks this object as "orderable" with respect to the given field. This is almost always used with related objects to allow them to be ordered with respect to a parent object. For example, if an ``Answer`` relates to a ``Question`` object, and a question has more than one answer, and the order of answers matters, you'd do this:: Makes this object orderable with respect to the given field, usually a ``ForeignKey``. This can be used to make related objects orderable with respect to a parent object. For example, if an ``Answer`` relates to a ``Question`` object, and a question has more than one answer, and the order of answers matters, you'd do this:: from django.db import models Loading Loading @@ -218,12 +218,20 @@ Django quotes column and table names behind the scenes. >>> answer.get_previous_in_order() <Answer: 1> .. admonition:: Changing order_with_respect_to .. admonition:: ``order_with_respect_to`` implicitly sets the ``ordering`` option ``order_with_respect_to`` adds an additional field/database column named ``_order``, so be sure to make and apply the appropriate migrations if you add or change ``order_with_respect_to`` after your initial :djadmin:`migrate`. Internally, ``order_with_respect_to`` adds an additional field/database column named ``_order`` and sets the model's :attr:`~Options.ordering` option to this field. Consequently, ``order_with_respect_to`` and ``ordering`` cannot be used together, and the ordering added by ``order_with_respect_to`` will apply whenever you obtain a list of objects of this model. .. admonition:: Changing ``order_with_respect_to`` Because ``order_with_respect_to`` adds a new database column, be sure to make and apply the appropriate migrations if you add or change ``order_with_respect_to`` after your initial :djadmin:`migrate`. ``ordering`` ------------ Loading