Django-Oscar电商框架配置详解

概述

Django-Oscar作为一个功能强大的电商框架，提供了丰富的配置选项来满足不同电商场景的需求。本文将全面解析Django-Oscar的核心配置项，帮助开发者更好地定制自己的电商平台。

显示相关配置

商店基本信息

OSCAR_SHOP_NAME 和 OSCAR_SHOP_TAGLINE 分别用于设置商店名称和标语，这些信息会显示在网站的显著位置。

主页设置

OSCAR_HOMEPAGE 定义了网站首页的URL，默认指向商品目录页。如果你的首页由其他应用提供，可以在此修改。

用户账户相关

OSCAR_ACCOUNTS_REDIRECT_URL 控制用户点击"我的账户"后的跳转目标，默认是用户资料页。

最近浏览商品

• OSCAR_RECENTLY_VIEWED_PRODUCTS: 存储最近浏览商品的数量
• OSCAR_RECENTLY_VIEWED_COOKIE_LIFETIME: 浏览历史cookie的存活时间
• OSCAR_RECENTLY_VIEWED_COOKIE_NAME: 浏览历史cookie的名称

分页设置

Oscar为各种列表视图提供了统一的分页配置，包括商品、优惠、评论等，默认每页显示20条记录。

搜索配置

OSCAR_SEARCH_FACETS 是一个重要配置，它定义了搜索结果的筛选条件(面)。包含两种类型：

1. 字段型面(field facets): 基于商品字段的筛选
2. 查询型面(query facets): 基于自定义查询的筛选

例如价格区间筛选就是典型的查询型面。

订单处理配置

订单状态管理

Oscar使用状态管道(Status Pipeline)来管理订单生命周期：

• OSCAR_INITIAL_ORDER_STATUS: 订单初始状态
• OSCAR_ORDER_STATUS_PIPELINE: 定义状态及允许的转换
• OSCAR_ORDER_STATUS_CASCADE: 定义状态变化的级联行为

订单行状态

类似地，OSCAR_LINE_STATUS_PIPELINE 管理订单行项目的状态流转。

结账配置

OSCAR_ALLOW_ANON_CHECKOUT 控制是否允许匿名用户结账。如果设为False，用户必须登录才能完成购买。

商品评价配置

• OSCAR_ALLOW_ANON_REVIEWS: 是否允许匿名评价
• OSCAR_MODERATE_REVIEWS: 评价是否需要审核后才显示

通信设置

邮件通知

• OSCAR_EAGER_ALERTS: 是否立即发送库存提醒
• OSCAR_SEND_REGISTRATION_EMAIL: 是否发送注册欢迎邮件
• OSCAR_FROM_EMAIL: 系统邮件的发件地址

优惠配置

价格计算

OSCAR_OFFERS_INCL_TAX 决定优惠计算是基于含税价还是不含税价。

优惠类型

OSCAR_OFFERS_IMPLEMENTED_TYPES 限制可用的优惠类型，目前支持站点优惠和优惠券两种。

购物车配置

• OSCAR_BASKET_COOKIE_LIFETIME: 购物车cookie有效期
• OSCAR_MAX_BASKET_QUANTITY_THRESHOLD: 购物车最大商品数量限制

货币与价格

• OSCAR_DEFAULT_CURRENCY: 默认货币
• OSCAR_CURRENCY_FORMAT: 货币格式化选项，支持Babel库的格式设置

图片上传与处理

图片存储

OSCAR_IMAGE_FOLDER 定义商品图片在MEDIA_ROOT下的存储路径，支持日期格式。

缩略图处理

Oscar支持多种缩略图生成方式：

• OSCAR_THUMBNAILER: 选择缩略图生成器(Sorl或EasyThumbnails)
• OSCAR_THUMBNAIL_DEBUG: 缩略图调试模式

其他重要配置

Slug生成

• OSCAR_SLUG_FUNCTION: 自定义slug生成函数
• OSCAR_SLUG_MAP: slug字符替换映射
• OSCAR_SLUG_BLACKLIST: 需要过滤的单词列表

杂项

• OSCAR_GOOGLE_ANALYTICS_ID: Google Analytics跟踪ID
• OSCAR_CSV_INCLUDE_BOM: CSV文件是否包含BOM头
• OSCAR_URL_SCHEMA: 生成绝对URL时使用的协议

最佳实践建议

1. 生产环境中应设置 OSCAR_MODERATE_REVIEWS=True 以审核用户评价
2. 对于大型电商站点，考虑设置 OSCAR_EAGER_ALERTS=False 并使用定时任务发送库存提醒
3. 根据目标市场正确配置货币和税率相关设置
4. 缩略图处理建议使用Sorl或EasyThumbnails，根据项目需求选择

通过合理配置这些选项，开发者可以打造出符合业务需求的个性化电商平台。