README

状态：测试版

此应用程序为 Elefant CMS 提供了一个简单的购物车，销售通过 Stripe Payments 应用处理。

当前功能

• 购物车
• 基本库存跟踪
• 可配置的税费
• 运费设置，包括最大金额和“超过 x 元免费”
• 数字下载
• Stripe 支付处理
• 基本订单管理
• 折扣和“开账单”支付选项 通过回调可用

即将添加的功能

• 管理员销售仪表板
• 库存低/出通知管理员
• 货物运输跟踪
• 促销代码

安装

首先，您需要安装 Stripe Payments 应用。

安装该应用程序后，安装应用程序的最简单方法是

1. 以站点管理员身份登录 Elefant
2. 转到工具 > 设计师 > 安装应用程序/主题
3. 粘贴以下链接并点击安装

https://github.com/jbroadway/products/archive/master.zip

或者，您可以从命令行运行以下命令

cd /path/to/your/site
./elefant install https://github.com/jbroadway/products/archive/master.zip

用法

配置应用程序

在 Elefant 管理区域，转到工具 > 产品 > 设置，以自定义您的站点应用程序。还可以访问工具 > 产品 > 税费和工具 > 产品 > 类别来设置您的税费和产品类别。

将产品页面添加到您的网站

在 Elefant 管理区域，转到工具 > 导航，并将“产品”页面拖放到您的站点树中。请注意，如果已在产品应用程序设置中重命名了页面，则该页面也将重命名到网站导航中。

折扣和“开账单”支付选项的回调

以下设置可以在您的 conf/app.products.config.php 配置文件中设置，如下所示

; A callback to check for available discounts for the current user's
; membership type, specified as a percentage discount.
discount_callback = "\myapp\Callbacks::discount"

; A callback to check whether an "invoice me" option should be available
; for payments. The site owner will receive an email of the order that
; they will manually invoice for.
allow_invoice_callback = "\myapp\Callbacks::allow_invoice"

以下是一个实现两个设置基本示例的类示例

<?php // apps/myapp/lib/Callbacks.php

namespace myapp;

use User;

class Callbacks {
	/**
	 * If user is logged in, allow invoice.
	 */
	public static function allow_invoice () {
		return User::is_valid ();
	}
	
	/**
	 * Give everyone 10% off.
	 */
	public static function discount () {
		return User::is_valid () ? 10 : 0;
	}
}

在上面的示例中，它允许所有登录用户请求开账单，并给他们10%的折扣。从这里，您可以根据您的网站需求填写任何关于不同成员类型的逻辑。