Ticket #4619: 4619.2.patch

django/views/generic/date_based.py

@@ -8 +8 @@
 def archive_index(request, queryset, date_field, num_latest=15,
         template_name=None, template_loader=loader,
         extra_context=None, allow_empty=False, context_processors=None,
-        mimetype=None, allow_future=False):
+        template_object_name='object', mimetype=None, allow_future=False):
     """
     Generic top-level archive of date-based objects.
 
@@ -37 +37 @@
     t = template_loader.get_template(template_name)
     c = RequestContext(request, {
         'date_list' : date_list,
-        'latest' : latest,
+        '%s_list' % template_object_name : latest,
     }, context_processors)
     for key, value in extra_context.items():
         if callable(value):

docs/generic_views.txt

@@ -193 +193 @@
     * ``context_processors``: A list of template-context processors to apply to
       the view's template. See the `RequestContext docs`_.
 
+    * ``template_object_name``:  Designates the name of the template variable
+      to use in the template context. By default, this is ``'object'``. The
+      view will append ``'_list'`` to the value of this parameter in
+      determining the variable's name.
+
     * ``mimetype``: The MIME type to use for the resulting document. Defaults
       to the value of the ``DEFAULT_CONTENT_TYPE`` setting.
 
@@ -221 +226 @@
       years that have objects available according to ``queryset``. These are
       ordered in reverse. This is equivalent to
       ``queryset.dates(date_field, 'year')[::-1]``.
-    * ``latest``: The ``num_latest`` objects in the system, ordered descending
-      by ``date_field``. For example, if ``num_latest`` is ``10``, then
-      ``latest`` will be a list of the latest 10 objects in ``queryset``.
 
+    * ``object_list``: The ``num_latest`` objects in the system, ordered
+      descending by ``date_field``. For example, if ``num_latest`` is ``10``,
+      then ``object_list`` will be a list of the latest 10 objects in
+      ``queryset``. This variable's name depends on the
+      ``template_object_name`` parameter, which is ``'object'`` by default. If
+      ``template_object_name`` is ``'foo'``, this variable's name will be
+      ``foo_list``.
+
 .. _RequestContext docs: ../templates_python/#subclassing-context-requestcontext
 
 ``django.views.generic.date_based.archive_year``