Django-Oscar-PayPal 项目安装与使用教程
1. 项目的目录结构及介绍
Django-Oscar-PayPal 项目的目录结构如下:
django-oscar-paypal/
├── docs/
│ ├── conf.py
│ ├── index.rst
│ └── ...
├── oscar_paypal/
│ ├── __init__.py
│ ├── express/
│ │ ├── __init__.py
│ │ ├── forms.py
│ │ ├── views.py
│ │ └── ...
│ ├── payflow/
│ │ ├── __init__.py
│ │ ├── forms.py
│ │ ├── views.py
│ │ └── ...
│ ├── settings.py
│ ├── urls.py
│ └── ...
├── tests/
│ ├── __init__.py
│ ├── test_express.py
│ ├── test_payflow.py
│ └── ...
├── .gitignore
├── LICENSE
├── MANIFEST.in
├── README.rst
├── requirements.txt
├── setup.py
└── ...
目录结构介绍
- docs/: 包含项目的文档文件,如
conf.py
用于 Sphinx 文档配置,index.rst
是文档的主索引文件。 - oscar_paypal/: 核心代码目录,包含 PayPal 集成的主要功能模块。
- express/: 包含 PayPal Express 支付功能的实现代码。
- payflow/: 包含 PayPal PayFlow Pro 支付功能的实现代码。
- settings.py: 项目的配置文件,包含 PayPal 相关的配置项。
- urls.py: URL 路由配置文件。
- tests/: 包含项目的测试代码,如
test_express.py
和test_payflow.py
。 - .gitignore: Git 忽略文件配置。
- LICENSE: 项目的开源许可证文件。
- MANIFEST.in: 用于打包项目的配置文件。
- README.rst: 项目的介绍文件。
- requirements.txt: 项目依赖的 Python 包列表。
- setup.py: 项目的安装脚本。
2. 项目的启动文件介绍
Django-Oscar-PayPal 项目的启动文件主要是 manage.py
,通常位于项目的根目录下。manage.py
是 Django 项目的管理脚本,用于执行各种管理任务,如启动开发服务器、运行测试、创建数据库迁移等。
启动开发服务器
python manage.py runserver
创建数据库迁移
python manage.py makemigrations
python manage.py migrate
运行测试
python manage.py test
3. 项目的配置文件介绍
Django-Oscar-PayPal 的配置文件主要位于 oscar_paypal/settings.py
中。以下是一些关键配置项的介绍:
PayPal 配置
# oscar_paypal/settings.py
# PayPal Express 配置
PAYPAL_API_USERNAME = 'your_paypal_api_username'
PAYPAL_API_PASSWORD = 'your_paypal_api_password'
PAYPAL_API_SIGNATURE = 'your_paypal_api_signature'
PAYPAL_API_ENDPOINT = 'https://api-3t.paypal.com/nvp'
# PayPal PayFlow Pro 配置
PAYPAL_PAYFLOW_PARTNER = 'your_paypal_payflow_partner'
PAYPAL_PAYFLOW_VENDOR = 'your_paypal_payflow_vendor'
PAYPAL_PAYFLOW_USER = 'your_paypal_payflow_user'
PAYPAL_PAYFLOW_PASSWORD = 'your_paypal_payflow_password'
其他配置
# Django 项目配置
INSTALLED_APPS = [
...
'oscar_paypal',
...
]
MIDDLEWARE = [
...
]
TEMPLATES = [
...
]
DATABASES = {
...
}
配置文件的使用
在项目的 settings.py
中,确保已经包含了 oscar_paypal
应用,并根据需要配置 PayPal 相关的参数。
# settings.py
INSTALLED_APPS += [
'oscar_paypal',
]
# 根据需要配置 PayPal 参数
from oscar_paypal.settings import *
通过以上配置,您可以成功集成 PayPal 支付功能到您的 Django-Oscar 项目中。