Ticket #15829: sitemaps-item.3.diff

django/contrib/sitemaps/__init__.py

@@ -79 +79 @@
                 'location':   loc,
                 'lastmod':    self.__get('lastmod', item, None),
                 'changefreq': self.__get('changefreq', item, None),
-                'priority':   str(priority is not None and priority or '')
+                'priority':   str(priority is not None and priority or ''),
+                'item':       item,
             }
             urls.append(url_info)
         return urls

django/contrib/sitemaps/tests/basic.py

@@ -2 +2 @@
 from datetime import date
 from django.conf import settings
 from django.contrib.auth.models import User
-from django.contrib.sitemaps import Sitemap
+from django.contrib.sitemaps import Sitemap, GenericSitemap
 from django.contrib.sites.models import Site
 from django.core.exceptions import ImproperlyConfigured
 from django.test import TestCase
@@ -171 +171 @@
         """
         Site._meta.installed = False
         self.assertRaises(ImproperlyConfigured, Sitemap().get_urls)
+
+    def test_sitemap_item(self):
+        """
+        Check to make sure that the raw item is included with each 
+        Sitemap.get_url() url result.
+        """
+        user_sitemap = GenericSitemap({
+          'queryset': User.objects.all()
+        })
+        
+        item_in_url_info = all(map(
+            lambda url: isinstance(url['item'], User),
+            user_sitemap.get_urls()
+        ))
+
+        self.assertTrue(item_in_url_info)
+        
+ No newline at end of file

docs/ref/contrib/sitemaps.txt

@@ -313 +313 @@
         }),
     )
 
+Index
+-----
+
+The variable `sitemaps` is a list of absolute URLs to each of the sitemaps.
+
+Sitemap
+-------
+
+The variable `urlset` is a list of each URLs that should appear in the sitemap. Each URL exposes `changefreq`, `item`, `lastmod`, `location` and `priority`.
+
+.. versionadded:: SVN
+
+The `item` object has been added for each URL to allow for more flexible customization.
+
 Pinging Google
 ==============