django-oscar学习笔记（一）

    近期所做工作有关电商项目开发，准备使用django-oscar技术，而官方文档为英文，其GitHub项目地址也难以快速阅读，因此特别在阅读官方文档的过程中将过程记录下来，以供学习。其内容为本人自学的过程，不一定完全正确，仅供参考，有错误欢迎指正。

    django-oscar简单来说就是一个电商框架，不再多说明。

    接下来按步骤说明如何构建一个oscar项目。

• 安装Oscar以及它的依赖项

    由于目前手头只有一台电脑，配置相当低，系统为Windows，因此所做工作目前是在Windows下完成，后期将全面移植到Linux中。

    Python版本为3.7，且已安装anaconda，开发工具使用Pycharm Community，Django版本是2.1.8。

    首先，打开cmd，执行 mkvirtualenv oscar命令。大多数电脑未安装此命令，会报错，本人在网上找到了这篇博客，找到了解决方案，即通过

pip install virtualenvwrapper-win

     进行安装，安装起来比较慢的话，建议切换到国内pip镜像源，切换方法自行百度即可。

    接下来，执行以下命令

$ mkvirtualenv oscar
$ pip install django-oscar
$ django-admin.py startproject frobshop

    将会惊喜的发现，虚拟环境建立成功了，而且安装好了oscar（安装慢的话，同样建议切换到国内镜像源），第3行命令将会建立一个django项目。

    这个时候django项目就建立好了

---

• Django设置

    使用Pycharm打开刚建立好的“frobshop”项目，为方便，打开terminal，接下来的操作将在Pycharm编辑器的terminal里执行。

在terminal里输入

workon oscar

并回车执行，这行命令是启用虚拟环境，不明白的可以查看上边文中附带的博客链接，讲解的比较详细。

接下来修改代码，打开settings.py文件，添加下面这行代码。（这行代码后来也没有用到，是灰色的，我也不知道为什么要添加这一行）

from oscar.defaults import *

接下来，继续修改settings.py，添加引用，并修改TEMPLATES为下面代码块所示（目的是包含主Oscar模板目录并添加额外的上下文处理器）：

from oscar import OSCAR_MAIN_TEMPLATE_DIR

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.template.context_processors.i18n',
                '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',
            ],
        },
    },
]

接下来，还是修改settings.py文件，将INSTALLED_APPS修改为（注意这里和官方文档不完全一致，官方文档里边有一行省略号，我摸索并查了以后才把错误解决）：

from oscar import get_core_apps
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django.contrib.flatpages',
    'django.contrib.sites',
    'widget_tweaks',
] + get_core_apps()

SITE_ID = 1

    接下来设置settings.py中的MIDDLEWARE项，添加'oscar.apps.basket.middleware.BasketMiddleware',以及'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware',变更为：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'oscar.apps.basket.middleware.BasketMiddleware',
    'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware',
]

    接下来在settings.py中添加后端验证方式，允许用户使用电子邮件地址登录，代码为：

AUTHENTICATION_BACKENDS = (
    'oscar.apps.customer.auth_backends.EmailBackend',
    'django.contrib.auth.backends.ModelBackend',
)

---

• URLs设置

    修改urls.py文件，修改为如下代码（注意注释，django的版本不同则代码不同）：：

from django.conf.urls import include, url  # 小于 Django-2.0用该行，否则注释
# from django.urls import include, path  # 大于 Django-2.0用该行，否则注释
from django.contrib import admin
from oscar.app import application

urlpatterns = [
    url(r'^i18n/', include('django.conf.urls.i18n')),  # 小于2.0版本用该行，否则注释
    # path('i18n/', include('django.conf.urls.i18n')),  # 大于 Django-2.0用该行，否则注释

    # The Django admin is not officially supported; expect breakage.
    # Nonetheless, it's often useful for debugging.

    url(r'^admin/', admin.site.urls),  # 小于2.0版本用该行，否则注释
    # path('admin/', admin.site.urls),  # 大于 Django-2.0用该行，否则注释

    url(r'', application.urls),  # 小于2.0版本用该行，否则注释
    # path('', application.urls),  # 大于 Django-2.0用该行，否则注释
]

• 搜索设置

    在settings.py中添加如下代码段，提供了两种，一种普通的，一种Apache Solr，我选的第一种，先把项目跑起来再说

HAYSTACK_CONNECTIONS = {
    'default': {
        'ENGINE': 'haystack.backends.simple_backend.SimpleEngine',
    },
}

# 根据实际需要，这两个代码段任选其一

HAYSTACK_CONNECTIONS = {
    'default': {
        'ENGINE': 'haystack.backends.solr_backend.SolrEngine',
        'URL': 'http://127.0.0.1:8983/solr',
        'INCLUDE_SPELLING': True,
    },
}

---

• 数据库设置

    数据库在官方文档中选用了SQLite，将settings.py中的DATABASES块修改为如下代码：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': 'db.sqlite3',
        'USER': '',
        'PASSWORD': '',
        'HOST': '',
        'PORT': '',
        'ATOMIC_REQUESTS': True,
    }
}

---

• 创建数据库

    这一步就是Django的常规操作了，数据库创建加项目运行，命令如下：

$ python manage.py migrate
$ python manage.py runserver

    这个时候就能够通过浏览器进行访问了，以上完成了项目的基本配置和运行，接下来进行一些额外操作。

---

• 填充国家数据库表

    使用pycountry包自动填充数据，执行以下命令：

$ pip install pycountry
[这里等待pycountry安装完，我一开始用的清华源，安装太慢，切换到豆瓣源安装就很迅速]
$ python manage.py oscar_populate_countries

---

• Product Classes以及Fulfillment Partners创建

    不知道具体怎么翻译，总之按官方文档说法就是每个Oscar都需要至少一个product class和一个fulfillment partner（英文不好，见谅），可以访问http://127.0.0.1:8000/dashboard/进行创建，需要注意的是在这之前需要创建一个超级管理员用户，命令为“python manage.py createsuperuser”，创建以后使用“python manage.py runserver”命令启动项目。

---

• 定义订单管道

    这个翻译不知道是不是准确，在settings.py中添加以下代码段，通过在项目中定义这三个设置，将能够在order management仪表板中看到不同的状态。

OSCAR_INITIAL_ORDER_STATUS = 'Pending'
OSCAR_INITIAL_LINE_STATUS = 'Pending'
OSCAR_ORDER_STATUS_PIPELINE = {
    'Pending': ('Being processed', 'Cancelled',),
    'Being processed': ('Processed', 'Cancelled',),
    'Cancelled': (),
}

---

以上对应官方文档第一章，建议和官方文档对比着看，因为水平实在有限，网上资料又太少，建议以官方文档为主并欢迎指正。