ecサイトを一人でパパッと作る必要性が生じたので、パッケージやフレームワークをフル活用すればパパッとECサイトが完成する（はず）。てことで、ウェブフレームワークにDjango、ECパッケージにOscarを使用を決定。決めたのはいいですが日本語資料が少ない。英語版の公式ドキュメントも「詳しくはSandboxとgithubで」と優しくないうえに分かりにくい。
この記事は一通りECサイトを構築した気分にするまでの手順を示します。基本的にdjango-oscarのdjango-oscar/Building your own shopをなぞっているだけですが参考に。
最終的に決済機能のないECサイトを構築します。また、これはあくまでもチュートリアルです。
開発環境
- Mac OS X
- Python==3.8.0
- Django==2.2.9
- django-oscar==2.0.4
Setup
ドキュメントでは、mkvirtualenvかvirtualenvを使ってますが、今回は自分のパソコンに元から入っていたAnacondaを活用します。
Anacondaで仮想環境を構築する。まず、python 3.8環境を構築。
$ conda create -n py38 python=3.8
仮想環境を有効化。
$ conda info -e #環境確認
$ conda activate py38
django-oscarをpipでインストール。
$ pip install django-oscar
一部足りないパッケージがあるので、それもインストール。
$ pip install sorl-thumbnail
$ pip install pysolr
なお、2020年1月時点だと、バージョンは以下の通り
- pysolr==3.8.1
- sorl-thumbnail==12.5.0
Djangoプロジェクトを作成する
$ django-admin startproject frobshop
Django設定(settings.py)
frobshop.frobshop.settings.pyの行頭に以下を追記。Oscarのデフォルト設定がインポートされる。
from oscar.defaults import *
Oscarのcontext processorsをテンプレートに追加。
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'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.checkout.context_processors.checkout',
'oscar.apps.customer.notifications.context_processors.notifications',
'oscar.core.context_processors.metadata',
],
},
},
]
INSTALLED_APPSを以下のように書き換え、SITE_IDも設定。
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'django.contrib.sites',
'django.contrib.flatpages',
'oscar',
'oscar.apps.analytics',
'oscar.apps.checkout',
'oscar.apps.address',
'oscar.apps.shipping',
'oscar.apps.catalogue',
'oscar.apps.catalogue.reviews',
'oscar.apps.partner',
'oscar.apps.basket',
'oscar.apps.payment',
'oscar.apps.offer',
'oscar.apps.order',
'oscar.apps.customer',
'oscar.apps.search',
'oscar.apps.voucher',
'oscar.apps.wishlists',
'oscar.apps.dashboard',
'oscar.apps.dashboard.reports',
'oscar.apps.dashboard.users',
'oscar.apps.dashboard.orders',
'oscar.apps.dashboard.catalogue',
'oscar.apps.dashboard.offers',
'oscar.apps.dashboard.partners',
'oscar.apps.dashboard.pages',
'oscar.apps.dashboard.ranges',
'oscar.apps.dashboard.reviews',
'oscar.apps.dashboard.vouchers',
'oscar.apps.dashboard.communications',
'oscar.apps.dashboard.shipping',
# 3rd-party apps that oscar depends on
'widget_tweaks',
'haystack',
'treebeard',
'sorl.thumbnail',
'django_tables2',
]
SITE_ID = 1
oscar.apps.basket.middleware.BasketMiddlewareとdjango.contrib.flatpages.middleware.FlatpageFallbackMiddlewareをMIDDLEWAREの設定に追加。
MIDDLEWARE = (
...
'oscar.apps.basket.middleware.BasketMiddleware',
'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware',
)
メールアドレスで認証できるようにAUTHENTICATION_BACKENDSの設定を追加。
AUTHENTICATION_BACKENDS = (
'oscar.apps.customer.auth_backends.EmailBackend',
'django.contrib.auth.backends.ModelBackend',
)
日本対応
日本向け対応するには以下のように、言語コードと時間帯を書き換える。
LANGUAGE_CODE = 'ja'
TIME_ZONE = 'Asia/Tokyo'
通貨設定と通貨のフォーマットを設定（oscarのデフォルトのフォーマットだと小数点第二位まで表示してしまうため。）
OSCAR_DEFAULT_CURRENCY = 'JPY'
OSCAR_CURRENCY_FORMAT = '¤#,##0'
URLs
frobshop.frobshop.urls.pyを以下のように書き換える。
from django.apps import apps
from django.urls import include, path # > Django-2.0
from django.contrib import admin
urlpatterns = [
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.
path('admin/', admin.site.urls), # > Django-2.0
path('', include(apps.get_app_config('oscar').urls[0])), # > Django-2.0
]
Search backend
検索システムを設定する。とりあえず試したい場合は以下の設定をする。
HAYSTACK_CONNECTIONS = {
'default': {
'ENGINE': 'haystack.backends.simple_backend.SimpleEngine',
},
}
Apache Solrを設定する場合は事前にApache Solrをセットアップした上で、以下をfrobshop.frobshop.settings.pyに追記。
HAYSTACK_CONNECTIONS = {
'default': {
'ENGINE': 'haystack.backends.solr_backend.SolrEngine',
'URL': 'http://127.0.0.1:8983/solr',
'INCLUDE_SPELLING': True,
},
}
データベース
すぐにでも動作確認したい場合はデータベースにsqliteを使う。frobshop.frobshop.settings.pyを編集してDATABASESの設定を以下のように書き換える。
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
'USER': '',
'PASSWORD': '',
'HOST': '',
'PORT': '',
'ATOMIC_REQUESTS': True,
}
}
サイトの起動確認
マイグレーションを実施。
$ python manage.py migrate
サーバーを起動してサイトが起動できるかどうかを確認。
$ python manage.py runserver
初期データ
ここまでだと、商品も登録ユーザーも存在しないECサイトが構築される。諸々の設定を行なって、ECサイトっぽくしていきます。
国モデル
国モデル ( address_country ) に249カ国の初期データを入れる。
$ pip install pycountry
$ python manage.py oscar_populate_countries
249カ国は多すぎるので、登録国を日本のみにする。まず、DBへの接続してから、is_shipping_country を Japan のみ 1に、他は 0 にする。住所登録時に国名選択が出てこなくなる(日本がデフォルトになる)
$ python manage.py dbshell
SQLite version 3.30.1 2019-10-10 20:19:45
Enter ".help" for usage hints.
sqlite> UPDATE address_country SET is_shipping_country = 0 WHERE printable_name != 'Japan';
ユーザーデータ
モデルに対する初期データを投入するを参考にデータを投入する。
まずはユーザーデータを投入する。Sandboxに登録されているユーザー情報を投入。
$ python manage.py loaddata frobshop/fixtures/auth.json
Installed 2 object(s) from 1 fixture(s)
管理者ユーザーは以下の設定になっています。
username: superuser
email: superuser@example.com
password: testing
スタッフアカウントは以下の通り。
username: staff
email: staff@example.com
password: testing
商品データ
商品データを投入する。公式のSandbox siteには二種類商品データが存在する。multi-stockrecord-product.jsonとchild_products.json。
それぞれの違いを説明する。child_products.jsonは一つの商品でも種類が違う場合（例えば、Tシャツだとサイズとか色とか）に対応したい場合の設定の仕方を示している。例えば、Tシャツの場合は、AttributesをサイズL,M,Sと設定する。
multi-stockrecord-product.jsonはecサイトを運営している場合、在庫を管理している倉庫あるいは発注先が複数存在する場合がある。複数の発注先をoscarではpartner.stockrecordで管理している。
商品データをとりあえず投入したい場合は、いずれかのjsonをデータベースに投入する。
$ python manage.py loaddata frobshop/fixtures/multi-stockrecord-product.json
oscarがどのように商品管理するのか、考え方を示したドキュメントを以下にリンクを貼っておきます。
オーダーパイプライン
ecサイト経由で注文が来た場合、どのように注文を処理するかをオーダーパイプライン(order pipeline)で設定する。例えば、settings.pyに以下を追記する。以下の例だとPendingが最初のステータスで、Pending→Being processed→Processedの順に進んでいく。途中でキャンセルされるとCancelledのステータスになることを想定している。
OSCAR_INITIAL_ORDER_STATUS = 'Pending'
OSCAR_INITIAL_LINE_STATUS = 'Pending'
OSCAR_ORDER_STATUS_PIPELINE = {
'Pending': ('Being processed', 'Cancelled',),
'Being processed': ('Processed', 'Cancelled',),
'Cancelled': (),
}
メール設定
上記の設定のままだと注文確定時（Preview orderの画面のPlace orderを押す時）にConnectionRefusedError at /checkout/preview/が出る。
Building a full ecommerce site part 5: testing directing customers to Oscar's thank-you page after paymentに理由が書いているけれど、読んでもよく分からなかった。
対処法はsettings.pyに以下のようにEMAIL_BACKENDを追記する。
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
まとめ
とりあえず、ここまで設定すればECサイトの機能が一通り網羅されます(決済機能以外)。
さらにECサイトを構築する (例えば商品に画像を追加するなど)にはGithub上のSandboxサイトの設定を参考に構築してみてください。
気が向いたら決済機能の実装を書きたいと思います。
参考サイト
以下のサイトを参考にしました。