Update getting started documentation for Django 1.8

The TEMPLATE_DIRS and TEMPLATE_CONTEXT_PROCESSORS are no longer separate
settings thus given an example for the new TEMPLATES setting.

Also note that the user should include widget_tweaks in the
INSTALLED_APPS setting.

docs/source/internals/getting_started.rst

@@ -47,29 +47,46 @@ recommended to install Oscar in a virtualenv.
 Django settings
 ===============
 
-Edit your settings file ``frobshop.frobshop.settings.py`` to specify
-``TEMPLATE_CONTEXT_PROCESSORS``:
+Edit your settings file ``frobshop.frobshop.settings.py`` to  modify your 
+``TEMPLATES`` to include the main Oscar template directory and add the extra
+context processors.
 
 .. code-block:: django
 
-    TEMPLATE_CONTEXT_PROCESSORS = (
-        "django.contrib.auth.context_processors.auth",
-        "django.core.context_processors.request",
-        "django.core.context_processors.debug",
-        "django.core.context_processors.i18n",
-        "django.core.context_processors.media",
-        "django.core.context_processors.static",
-        "django.core.context_processors.tz",
-        "django.contrib.messages.context_processors.messages",
-        'oscar.apps.search.context_processors.search_form',
-        'oscar.apps.promotions.context_processors.promotions',
-        'oscar.apps.checkout.context_processors.checkout',
-        'oscar.apps.customer.notifications.context_processors.notifications',
-        'oscar.core.context_processors.metadata',
-    )
+    TEMPLATES = [
+        {
+            'BACKEND': 'django.template.backends.django.DjangoTemplates',
+            'DIRS': [
+                os.path.join(BASE_DIR, 'templates'),
+                OSCAR_MAIN_TEMPLATE_DIR
+            ],
+            'APP_DIRS': True,
+            'OPTIONS': {
+                'context_processors': [
+                    'django.template.context_processors.debug',
+                    'django.template.context_processors.request',
+                    'django.contrib.auth.context_processors.auth',
+                    'django.contrib.messages.context_processors.messages',
+
+                    'oscar.apps.search.context_processors.search_form',
+                    'oscar.apps.promotions.context_processors.promotions',
+                    'oscar.apps.checkout.context_processors.checkout',
+                    'oscar.apps.customer.notifications.context_processors.notifications',
+                    'oscar.core.context_processors.metadata',
+                ],
+            },
+        },
+    ]
+
+.. attention::
+    
+   Before Django 1.8 this setting was split between 
+   ``TEMPLATE_CONTEXT_PROCESSORS`` and ``TEMPLATE_DIRS``. 
+
 
-Next, modify ``INSTALLED_APPS`` to be a list, add ``django.contrib.sites``, ``django.contrib.flatpages`` and ``compressor``
-and append Oscar's core apps. Also set ``SITE_ID``:
+Next, modify ``INSTALLED_APPS`` to be a list, add ``django.contrib.sites``, 
+``django.contrib.flatpages``, ``compressor`` and ``widget_tweaks`` and append 
+Oscar's core apps. Also set ``SITE_ID``:
 
 .. code-block:: django
 
@@ -85,6 +102,7 @@ and append Oscar's core apps. Also set ``SITE_ID``:
         'django.contrib.flatpages',
         ...
         'compressor',
+        'widget_tweaks',
     ] + get_core_apps()
 
     SITE_ID = 1
@@ -98,11 +116,12 @@ More info about installing ``flatpages`` is in the `Django docs`_.
 
 .. tip::
 
-    Oscar's default templates use django-compressor_ but it's optional really.
-    You may decide to use your own templates that don't use compressor.  Hence
-    why it is not one of the 'core apps'.
+    Oscar's default templates use django-compressor_ and django-widget-tweaks_ 
+    but it's optional really.  You may decide to use your own templates that 
+    don't use either.  Hence why they are not in the 'core apps'.
 
 .. _django-compressor: https://github.com/jezdez/django_compressor
+.. _django-widget-tweaks: https://github.com/kmike/django-widget-tweaks
 
 Next, add ``oscar.apps.basket.middleware.BasketMiddleware`` and
 ``django.contrib.flatpages.middleware.FlatpageFallbackMiddleware`` to
@@ -137,20 +156,7 @@ files from a remote storage (e.g. Amazon S3), you must manually copy a
 .. _`configured correctly`: https://docs.djangoproject.com/en/1.7/howto/static-files/
 .. _sandbox settings: https://github.com/django-oscar/django-oscar/blob/3a5160a86c9b14c940c76a224a28cd37dd29f7f1/sites/sandbox/settings.py#L99
 
-Modify your ``TEMPLATE_DIRS`` to include the main Oscar template directory:
 
-.. code-block:: django
-
-    import os
-    from oscar import OSCAR_MAIN_TEMPLATE_DIR
-
-    location = lambda x: os.path.join(
-        os.path.dirname(os.path.realpath(__file__)), x)
-
-    TEMPLATE_DIRS = (
-        location('templates'),
-        OSCAR_MAIN_TEMPLATE_DIR,
-    )
 
 The last addition to the settings file is to import all of Oscar's default settings: