Fixed #13524 -- Added backwards compatibility and feature notes regarding...

passed through to ``inlineformset_factory`` when creating the formset for this

inline.

.. _ref-contrib-admin-inline-extra:

``extra``

~~~~~~~~~

.. versionadded:: 1.2

Extra forms for inlines will be hidden and replaced with a link to dynamically

add any number of new inlines for users with Javascript enabled.

For users with JavaScript-enabled browsers, an "Add another" link is

provided to enable any number of additional inlines to be added in

addition to those provided as a result of the ``extra`` argument.

The dynamic link will not appear if the number of currently displayed

forms exceeds ``max_num``, or if the user does not have JavaScript

enabled.

.. _ref-contrib-admin-inline-max-num:

``max_num``

~~~~~~~~~~~

only time this should ever be an issue is if you were expecting printing the

``repr`` of a ``BooleanField`` to print ``1`` or ``0``.

Changes to the interpretation of``max_num`` in FormSets

-------------------------------------------------------

As part of enhancements made to the handling of FormSets, the default

value and interpretation of the ``max_num`` parameter to the

:ref:`django.forms.formsets.formset_factory() <formsets-max-num>` and

:ref:`django.forms.models.modelformset_factory()

<model-formsets-max-num>` functions has changed slightly. This

change also affects the way the ``max_num`` argument is :ref:`used for

inline admin objects <ref-contrib-admin-inline-max-num>`

Previously, the default value for ``max_num`` was ``0`` (zero).

FormSets then used the boolean value of ``max_num`` to determine if a

limit was to be imposed on the number of generated forms. The default

value of ``0`` meant that there was no default limit on the number of

forms in a FormSet.

Starting with 1.2, the default value for ``max_num`` has been changed

to ``None``, and FormSets will differentiate between a value of

``None`` and a value of ``0``. A value of ``None`` indicates that no

limit on the number of forms is to be imposed; a value of ``0``

indicates that a maximum of 0 forms should be imposed. This doesn't

necessarily mean that no forms will be displayed -- see the

:ref:`ModelFormSet documentation <model-formsets-max-num>` for more

details.

If you were manually specifying a value of ``0`` for ``max_num``, you

will need to update your FormSet and/or admin definitions.

.. seealso::

    :ref:`1.2-js-assisted-inlines`

.. _deprecated-features-1.2:

Features deprecated in 1.2

        sr_qs = SpatialRefSys.objects.using('my_spatialite').filter(...)

        gc_qs = GeometryColumns.objects.using('my_postgis').filter(...)

Language code ``no``

--------------------

The currently used language code for Norwegian Bokmål ``no`` is being

replaced by the more common language code ``nb``.

What's new in Django 1.2

========================

included with Django's and is no longer

hosted separately at `geodjango.org <http://geodjango.org/>`_.

Deprecation of old language code ``no``

---------------------------------------

.. _1.2-js-assisted-inlines:

The currently used language code for Norwegian Bokmål ``no`` is being

replaced by the more common language code ``nb``, which should be updated

by translators from now on.

JavaScript-assisted handling of inline related objects in the admin

-------------------------------------------------------------------

If a user has JavaScript enabled in their browser, the interface for

inline objects in the admin now allows inline objects to be

dynamically added and removed. Users without JavaScript-enabled

browsers will see no change in the behavior of inline objects.

    :ref:`Creating formsets from models with model formsets <model-formsets>`.

.. _formsets-max-num:

Limiting the maximum number of forms

------------------------------------

.. versionchanged:: 1.2

If the value of ``max_num`` is geater than the number of existing related

If the value of ``max_num`` is greater than the number of existing

objects, up to ``extra`` additional blank forms will be added to the formset,

so long as the total number of forms does not exceed ``max_num``.

forms displayed. Please note that the default value of ``max_num`` was changed

from ``0`` to ``None`` in version 1.2 to allow ``0`` as a valid value.

.. versionadded:: 1.2

The dynamic "Add Another" link in the Django admin will not appear if

``max_num`` is less than the number of currently displayed forms.

Formset validation

------------------

.. versionchanged:: 1.2

As with regular formsets, you can use the ``max_num`` parameter to

``modelformset_factory`` to limit the number of extra forms displayed.

As with regular formsets, you can use the ``max_num`` and ``extra`` parameters

to ``modelformset_factory`` to limit the number of extra forms displayed.

``max_num`` does not prevent existing objects from being displayed::

>>> AuthorFormSet = modelformset_factory(Author, max_num=None, extra=3)

>>> formset = AuthorFormSet(queryset=qs)

>>> len(formset.forms)

6

>>> len(formset.extra_forms)

3

>>> AuthorFormSet = modelformset_factory(Author, max_num=4, extra=3)

>>> formset = AuthorFormSet(queryset=qs)

>>> len(formset.forms)

4

>>> len(formset.extra_forms)

1

>>> AuthorFormSet = modelformset_factory(Author, max_num=0, extra=3)

>>> formset = AuthorFormSet(queryset=qs)

>>> len(formset.forms)

3

>>> len(formset.extra_forms)

0