Ticket #13984: 0002-template_name-as-optional-return-value-of-django.temp.diff

django/template/loader.py

@@ -185 +185 @@
         context_instance = Context(dictionary)
     return t.render(context_instance)
 
-def select_template(template_name_list):
+def select_template(template_name_list, return_template=False):
     "Given a list of template names, returns the first that can be loaded."
     for template_name in template_name_list:
         try:
-            return get_template(template_name)
+            if return_template:
+                return get_template(template_name), template_name
+            else:
+                return get_template(template_name)
         except TemplateDoesNotExist:
             continue
     # If we get here, none of the templates could be loaded

docs/ref/templates/api.txt

@@ -525 +525 @@
     the template with the given name. If the template doesn't exist, it raises
     ``django.template.TemplateDoesNotExist``.
 
-.. function:: django.template.loader.select_template(template_name_list)
+.. function:: django.template.loader.select_template(template_name_list, return_name=False)
 
     ``select_template`` is just like ``get_template``, except it takes a list
     of template names. Of the list, it returns the first template that exists.
+    If the optional argument return_name is set to True, it will also return
+    the selected templates name.
 
 For example, if you call ``get_template('story_detail.html')`` and have the
 above :setting:`TEMPLATE_DIRS` setting, here are the files Django will look for,