Metadata-Version: 2.4
Name: django-oscar-promotions
Version: 1.0.0b1
Summary: Promotions for Django Oscar
Home-page: https://github.com/oscaro/django-oscar-promotins
Author: Oscar Team
Author-email: sasha@metaclass.co
License: BSD
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: django<2.3,>=1.11
Requires-Dist: django-oscar>=2.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: summary

=======================
Django Oscar Promotions
=======================

Django Oscar Promotions is an app for Dashboard-editable promotional content
in Oscar. It was formerly a part of Oscar core, but has now been separated into
a standalone app.

Installation
~~~~~~~~~~~~

Add the following entries to ``INSTALLED_APPS``:

.. code-block:: python

    INSTALLED_APPS = [
        ...,
        'oscar_promotions.apps.PromotionsConfig',
        'oscar_promotions.dashboard.apps.PromotionsDashboardConfig',
    ]


And the following URL patterns to your project's URL configuration:

.. code-block:: python

    urlpatterns = [
        ...,
        path("", apps.get_app_config("oscar_promotions").urls),
        path("dashboard/promotions/", apps.get_app_config("oscar_promotions_dashboard").urls),
    ]


You can, if you prefer, include the dashboard URLs inside the URL configuration
of your forked dashboard app.

If you want the dashboard views to be accessible from the dashboard menu,
add them to ``OSCAR_DASHBOARD_NAVIGATION``. The snippet below will add two
menu items to the Content menu.

.. code-block:: python

    OSCAR_DASHBOARD_NAVIGATION[5]['children'] += [
        {
            'label': 'Content blocks',
            'url_name': 'oscar_promotions_dashboard:promotion-list',
        },
        {
            'label': 'Content blocks by page',
            'url_name': 'oscar_promotions_dashboard:promotion-list-by-page',
        },
    ]

Add the promotions context processor to your ``TEMPLATES`` setting:

.. code-block:: python

    TEMPLATES = {
        'context_processors': [
            ...
            'oscar_promotions.context_processors.promotions',
        ]
    }
