lian/coupon

一个公用的优惠券管理工具

0.0.2 2018-08-29 02:04 UTC

This package is auto-updated.

Last update: 2024-09-29 05:02:07 UTC


README

Image text

一个公用的优惠券管理工具.

Build Status StyleCI build status codecov Codacy Badge Latest Stable Version Total Downloads Latest Unstable Version License

安装

$ composer require lian/coupon -vvv

使用

发布 migration 文件

php artisan vendor:publish --provider="Lian\CouponCouponServiceProvider" --tag="migrations"

发布 config 文件

php artisan vendor:publish --provider="Lian\CouponCouponServiceProvider" --tag="config"

修改配置文件

config/coupon.php

<?php

return [
    'model' => \App\User::class, //修改成自己的 User 模型 eg. \App\Models\User::class
    
    'distance' => 7,

    'title' => 'coupon',
];

增加 trait

<?php

use Lian\Coupon\Traits\HasCoupon;
...
use HasCoupon;

可以使用的方法

<?php

// 用户创建优惠券
$user->addCoupon([
    'title' => 'this is a title',
    'amount' => 1.00,
    'start_time' => now(),
    'end_time' -> now()->addDays(7)
]);

// or
$user->addCouponOnce(1.00); // 默认 7 天

$user->addCouponOnce(1.00, 7); // 默认标题 coupon

$user->addCouponOnce(1.00, 7, 'this is a title');

// 用户领取优惠券
$user->receiveCoupon($coupon);

// 判断优惠券是否使用
$coupon->isBeUsed();

// 判断优惠券是否过期
$coupon->isBeOverdue();

// 使用优惠券
$coupon->apply();

// 获取优惠券到期时间
$coupon->distanceEndTime();

测试

$ composer test

贡献

你可以通过以下三种方式之一进行贡献

  1. 使用问题跟踪器提交错误报告。
  2. 问题跟踪器上回答问题或修复错误。
  3. 贡献新功能或更新wiki。

代码贡献过程并不非常正式。你只需要确保遵循PSR-0、PSR-1和PSR-2编码指南。任何新的代码贡献都必须附有适用的单元测试。

许可

MIT