Spree Digital 技术文档

1. 安装指南

首先，确保您的项目中已经安装了Spree。根据您使用的Spree版本，在Gemfile文件中添加以下代码：

• 对于Spree版本 >= 3.1：

  gem 'spree_digital', github: 'spree-contrib/spree_digital'
  

• 对于Spree版本 3.0 和 Spree 2.x：

  gem 'spree_digital', github: 'spree-contrib/spree_digital', branch: 'X-X-stable'
  

  请确保branch选项与您使用的Spree版本相匹配。

然后执行以下命令来安装gem：

bundle install

接下来，运行以下命令来拷贝和执行迁移：

bundle exec rails g spree_digital:install

最后，重启您的服务器以确保能正确加载资源。

2. 项目使用说明

Spree Digital 是一个Spree扩展，用于支持可下载产品（如电子书、MP3、视频等）。您只需将文件附加到产品（或该产品的变体）上，当人们购买它时，他们将通过电子邮件收到一个可以下载一次的链接。

• 不会修改spree_core的表结构，spree_digital与spree_core并行存在，仅添加两个新表。
• 下载链接将通过电子邮件在订单确认（或从管理部分“重发”）中发送。链接不会出现在客户看到的订单“概览”中。
• 如果需要在OrdersController#show中添加下载按钮，可以参考这个gist。
• 订单结账后，下载链接会立即发送（即在订单确认中）。如果需要支持“延迟”支付（如可计费账户），则需要修改系统。
• 需要根据数字交付计算类型创建一个配送方式。默认数字配送费用为0，但可以定义一个固定费率（也可以为每个项目创建数字配送费）。
• 如果客户购买多个相同的数字产品，他们将收到多个链接，允许他们合法购买多份产品并可能赠送给朋友。
• 可以设置用户下载次数和链接有效期。

3. 项目API使用文档

目前未提供具体的API使用文档。建议查看项目的源代码和配置选项以获取更多详细信息。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明。简要步骤如下：

1. 在Gemfile中添加Spree Digital的依赖。
2. 使用Bundler安装gem。
3. 执行迁移脚本。
4. 重启服务器。

确保按照上述步骤操作，以便正确安装和配置Spree Digital。