Saleor 是一个快速发展的开源电子商务平台,基于 Python 和 Django开发,且持续更新中,一点不用担心版本过旧的问题。
它的特点如下:
1.GraphQL API:基于GraphQL实现的前后端分离,属于最前沿的技术。
2.仪表板:管理员可以完全控制用户、流程和产品。
3.订单:订单、发货和退款的综合系统。
4.购物车:高级付款和税收选项,支持折扣和促销活动
5.支付:灵活的 API 架构允许集成任何支付方式。
6.地理自适应:自动支持多国家的结账体验。
7.支持云部署:支持Docker部署。
8.支持谷歌分析:集成了谷歌分析,可以很方便地分析流量去留。
Saleor 仓库地址:
https://github.com/mirumee/saleor
1.Saleor 部署指南
Saleor支持多种运行方式,你可以采用手动安装并运行的方式,也可以使用Docker进行运行,下面介绍全平台通用且最简单的Docker部署方案。
在按照以下说明操作之前,你需要安装Docker Desktop和Docker Compose。
Docker 部署 Saleor 非常方便,你只需要克隆存储库并构建镜像然后运行服务即可:
# Python 实用宝典 # 克隆存储库 git clone https://github.com/mirumee/saleor-platform.git --recursive --jobs 3 cd saleor-platform # 构建Docker镜像 docker-compose build
如果你无法成功克隆 Salor 源代码仓库,请在Python实用宝典公众号回复:Saleor 下载全部源代码。
Saleor 使用共享文件夹来启用实时代码重新加载。如果你使用的是Windows或MacOS,则需要:
1.将克隆的 saleor-platform 目录放置到 Docker 的共享目录配置 (Settings -> Shared Drives or Preferences -> Resources -> File sharing)。
2.确保在 Docker 首选项中你有至少 5 GB 的专用内存(设置 -> 高级 或 首选项->资源 -> 高级)
执行数据库migrations及打包前端资源:
docker-compose run --rm api python3 manage.py migrate docker-compose run --rm api python3 manage.py collectstatic --noinput
(可选)使用示例数据填充数据库:
docker-compose run --rm api python3 manage.py populatedb
最后,为自己创建一个管理员帐户:
docker-compose run --rm api python3 manage.py createsuperuser
运行服务:
使用以下命令运行Saleor:
docker-compose up
2.Saleor 架构介绍
如果你要基于 Saleor 进行开发,那么你必须了解它的架构。
Saleor 由三个重要组件组成:
1.Saleor Core, 它是GraphQL API的后端服务器。基于Django开发,数据库采用了PostgreSQL并在Redis中储存了一些缓存信息。
2.Saleor Dashboard, 这是一个可以用来经营商店的仪表盘,它是一个静态网站,因此没有任何自己的后端代码,它是一个与Saleor Core核心服务器对话的React程序。
3.Saleor Storefront, 这是基于React实现的示例商店,你可以自定义这部分代码满足你自己的需求,也可以使用 Saleor SDK 构建自定义店面。
所有三个组件都使用 GraphQL 通过 HTTPS 进行通信。
3.Saleor 扩展开发教程
虽然你可以直接基于Saleor源代码进行开发,但是官方建议不这么做,原因是一旦你的代码和Saleor官方源代码产生冲突,你就很难跟上官方的更新,最终会导致代码没人维护的尴尬局面。
因此Saleor提供了两种添加功能的方式:
1.插件功能:插件提供了一种在Saleor Core上运行附加代码的能力,而且有访问数据库的能力。
2.APPS:基于GraphQL API和Saleor Core开发APP,还可以使用WebHooks订阅事件。
下面我们介绍如何基于插件进行扩展开发。
如上图所示,Saleor Core 提供了一种回调通知事件给插件,插件基于此事件进行相关操作,并与数据库进行交互。
开发插件,你必须继承 BasePlugin 基类,然后重写部分方法,比如下面这个例子重写了 postprocess_order_creation 方法,增加了订单创建时的一些操作:
# Python实用宝典 # custom/plugin.py from django.conf import settings from urllib.parse import urljoin from ..base_plugin import BasePlugin from .tasks import api_post_request_task class CustomPlugin(BasePlugin): def postprocess_order_creation(self, order: "Order", previous_value: Any): # 订单创建时的操作 data = ... transaction_url = urljoin(settings.CUSTOM_API_URL, "transactions/createoradjust") api_post_request_task.delay(transaction_url, data)
加载插件, 需要在 setup.py 进行配置来自动发现已安装的插件。要使插件可被发现,你需要设置 entry_points 的 saleor_plugins 字段, 并使用这个语法定义插件:package_name = package_name.path.to:PluginClass.
示例如下:
# setup.py from setuptools import setup setup( ..., entry_points={ "saleor.plugins": [ "my_plugin = my_plugin.plugin:MyPlugin" ] } )
如果你的插件是 Django 应用程序,包名(等号前的部分)将被添加到 Django 的 INSTALLED_APPS 中,以便你可以利用 Django 的功能,例如 ORM 集成和数据库迁移。
注意到我们前面订单创建时的操作使用了 .delay 的语法,这是 Celery 的异步任务。因为有些插件的操作就应该异步完成,Saleor 使用 Celery 并将发现 tasks.py 在插件目录中声明的所有异步任务:
# custom_plugin/tasks.py import json from celery import shared_task from typing import Any, Dict import requests from requests.auth import HTTPBasicAuth from django.conf import settings @shared_task def api_post_request( url: str, data: Dict[str, Any], ): try: username = "username" password = "password" auth = HTTPBasicAuth(username, password) requests.post(url, auth=auth, data=json.dumps(data), timeout=settings.TIMEOUT) except requests.exceptions.RequestException: return
上面这个 api_post_request 函数就是前面插件用到的异步任务,在插件调用delay方法后,这个任务将被塞到队列中异步执行。
好了,上面就是一个简单的插件开发例子,个人认为Saleor的开发模式还是很不错的。如果大家有需要,可以采用这个项目构建一个属于自己的商城。
我们的文章到此就结束啦,如果你喜欢今天的 Python 教程,请持续关注Python实用宝典。
有任何问题,可以在公众号后台回复:加群,回答相应验证信息,进入互助群询问。
原创不易,希望你能在下面点个赞和在看支持我继续创作,谢谢!
Python实用宝典 ( pythondict.com )
不只是一个宝典
欢迎关注公众号:Python实用宝典