Saleor 是一個快速發展的開源電子商務平臺，基于 Python 和 Django開發，且持續更新中，一點不用擔心版本過舊的問題。

它的特點如下：

1. GraphQL API ：基于GraphQL實現的前后端分離，屬于最前沿的技術。
2. 儀表板 ：管理員可以完全控制用戶、流程和產品。
3. 訂單 ：訂單、發貨和退款的綜合系統。
4. 購物車 ：高級付款和稅收選項，支持折扣和促銷活動
5. 支付 ：靈活的 API 架構允許集成任何支付方式。
6. 地理自適應 ：自動支持多國家的結賬體驗。
7. 支持云部署 ：支持Docker部署。
8. 支持谷歌分析 ：集成了谷歌分析，可以很方便地分析流量去留。

Saleor 倉庫地址：
https://github.com/mirumee/saleor

1.部署指南

Saleor支持多種運行方式，你可以采用手動安裝并運行的方式，也可以使用Docker進行運行，下面介紹全平臺通用且最簡單的Docker部署方案。

在按照以下說明操作之前，你需要安裝Docker Desktop和Docker Compose，如果你沒安裝過，可以看看這篇教程：
https://www.runoob.com/docker/docker-tutorial.html

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 由三個重要組件組成：

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提供了兩種添加功能的方式：

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 的開發模式還是很不錯的。