jfinn
/
edan_f0


			
				
					
						
						
							12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
							=======================
How to customise a view
=======================

Oscar has many views. This How-to describes how to customise one of them for
your project.  It builds upon the steps described in
:doc:`/topics/customisation`. Please read it first and ensure that you've:

* Created a Python module with the the same label
* Added it as Django app to ``INSTALLED_APPS``
* Use custom ``app.py``

Example
-------

Create a new homepage view class in ``myproject.promotions.views`` - you can subclass
Oscar's view if you like::

    from oscar.apps.promotions.views import HomeView as CoreHomeView

    class HomeView(CoreHomeView):
        template_name = 'promotions/new-homeview.html'

In this example, we set a new template location but it's possible to customise the view
in any imaginable way.

If you want to change the template, create the alternative template
``new-homeview.html``.  This could either be
in a project-level ``templates`` folder that is added to your ``TEMPLATE_DIRS``
settings, or a app-level ``templates`` folder within your 'promotions' app.  For
now, put something simple in there, such as::

    <html>
        <body>
            <p>You have successfully overridden the homepage template.</p>
        </body>
    </html>

Now you can hook it up in your local ``app.py``::

    # myproject/promotions/app.py
    from oscar.apps.promotions.app import PromotionsApplication as CorePromotionsApplication

    from myproject.promotions.views import HomeView

    class PromotionsApplication(CorePromotionsApplication):
        home_view  = HomeView

    application = PromotionsApplication()