planerama/subscriptions

Rinvex Subscriptions 是一个灵活的计划和订阅管理系统，专为 Laravel 设计，具有运行您 SAAS 服务的必要工具，以高效地管理。它简单的架构，伴随着强大的底层，为您的业务提供坚实的平台。

维护者

详情

github.com/planerama/subscriptions

源代码

问题

安装次数: 2

依赖关系: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 0

开放问题: 0

dev-master 2022-10-01 18:12 UTC

Requires

Requires (Dev)

MIT 28c70334428401f832381683dded3fdb301e9a6a

databasesubscriptionfeaturelaravelvalueplanrecurring

This package is not auto-updated.

Last update: 2024-09-16 01:42:56 UTC

README

⚠️ 此软件包已被弃用且不再维护。未建议替代软件包。⚠️

👉 如果您有兴趣成为此软件包的主要维护者，请联系我！

Rinvex Subscriptions 是一个灵活的计划和订阅管理系统，专为 Laravel 设计，具有运行您 SAAS 服务的必要工具，以高效地管理。它简单的架构，伴随着强大的底层，为您的业务提供坚实的平台。

Packagist Scrutinizer Code Quality Travis StyleCI License

注意事项

  • 本软件包不包括支付功能。
  • 您可能需要扩展一些核心模型，以防您需要覆盖某些辅助方法背后的逻辑，例如 renew()、cancel() 等。例如：在取消订阅时，您可能还想取消附加的周期性支付。

安装

  1. 通过 composer 安装软件包

    composer require rinvex/laravel-subscriptions

  2. 发布资源（迁移和配置文件）

    php artisan rinvex:publish:subscriptions

  3. 通过以下命令执行迁移

    php artisan rinvex:migrate:subscriptions

  4. 完成！

用法

将订阅添加到用户模型

Rinvex Subscriptions 是专门为 Eloquent 和简洁性设计的，与其他 Laravel 相关方面一样，对简洁性非常重视。要向您的用户模型添加订阅功能，只需使用如下所示的 \Rinvex\Subscriptions\Traits\HasPlanSubscriptions 特性

namespace App\Models;

use Rinvex\Subscriptions\Traits\HasPlanSubscriptions;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use HasPlanSubscriptions;
}

就这样，我们只需要在用户模型中使用该特性！现在，您的用户可以订阅计划。

注意：您可以在任何订阅者模型上使用 HasPlanSubscriptions 特性，它不必是用户模型，实际上任何模型都可以。

创建计划

$plan = app('rinvex.subscriptions.plan')->create([
    'name' => 'Pro',
    'description' => 'Pro plan',
    'price' => 9.99,
    'signup_fee' => 1.99,
    'invoice_period' => 1,
    'invoice_interval' => 'month',
    'trial_period' => 15,
    'trial_interval' => 'day',
    'sort_order' => 1,
    'currency' => 'USD',
]);

// Create multiple plan features at once
$plan->features()->saveMany([
    new PlanFeature(['name' => 'listings', 'value' => 50, 'sort_order' => 1]),
    new PlanFeature(['name' => 'pictures_per_listing', 'value' => 10, 'sort_order' => 5]),
    new PlanFeature(['name' => 'listing_duration_days', 'value' => 30, 'sort_order' => 10, 'resettable_period' => 1, 'resettable_interval' => 'month']),
    new PlanFeature(['name' => 'listing_title_bold', 'value' => 'Y', 'sort_order' => 15])
]);

获取计划详情

您可以使用直观的 API 查询计划以获取更多详细信息，如下所示

$plan = app('rinvex.subscriptions.plan')->find(1);

// Get all plan features                
$plan->features;

// Get all plan subscriptions
$plan->planSubscriptions;

// Check if the plan is free
$plan->isFree();

// Check if the plan has trial period
$plan->hasTrial();

// Check if the plan has grace period
$plan->hasGrace();

both $plan->features 和 $plan->planSubscriptions 都是集合，由关系驱动，因此您可以像查询任何正常的 Eloquent 关系一样查询这些关系。例如，$plan->features()->where('name', 'listing_title_bold')->first()。

获取功能值

假设您想显示上面提到的功能 pictures_per_listing 的值。您可以通过多种方式做到这一点

// Use the plan instance to get feature's value
$amountOfPictures = $plan->getFeatureBySlug('pictures_per_listing')->value;

// Query the feature itself directly
$amountOfPictures = app('rinvex.subscriptions.plan_feature')->where('slug', 'pictures_per_listing')->first()->value;

// Get feature value through the subscription instance
$amountOfPictures = app('rinvex.subscriptions.plan_subscription')->find(1)->getFeatureValue('pictures_per_listing');

创建订阅

您可以使用存在于 HasPlanSubscriptions 特性中的 newSubscription() 函数来订阅用户到计划。首先，检索您的订阅者模型实例，这通常是您的用户模型和用户订阅的计划实例。一旦您检索了模型实例，您可以使用 newSubscription 方法创建模型的订阅。

$user = User::find(1);
$plan = app('rinvex.subscriptions.plan')->find(1);

$user->newPlanSubscription('main', $plan);

传递给 newSubscription 方法的第一个参数应该是订阅的标题。如果您的应用程序提供单个订阅，您可能将其称为 main 或 primary，而第二个参数是用户订阅的计划实例，还有一个可选的第三个参数可以指定自定义的起始日期，作为 Carbon\Carbon 的实例（默认情况下，如果没有提供，它将从现在开始）。

更改计划

您可以轻松地按照以下方式更改订阅计划

$plan = app('rinvex.subscriptions.plan')->find(2);
$subscription = app('rinvex.subscriptions.plan_subscription')->find(1);

// Change subscription plan
$subscription->changePlan($plan);

如果当前计划和新计划具有相同的计费频率（例如，invoice_period 和 invoice_interval），则订阅将保留相同的计费日期。如果计划没有相同的计费频率，则订阅将具有新的计划计费频率，从变更当天开始，并且将清除订阅使用数据。另外，如果新计划有一个试用期限并且是新的订阅，则将应用试用期限。

功能选项

计划功能非常适合微调订阅，您可以多次预付费用某些功能，这样用户就只能使用这么多。功能还可以被重置，其使用也可以到期。请参见以下示例

// Find plan feature
$feature = app('rinvex.subscriptions.plan_feature')->where('name', 'listing_duration_days')->first();

// Get feature reset date
$feature->getResetDate(new \Carbon\Carbon());

订阅功能使用

有多种方法可以确定用户订阅中特定功能的用途和功能，最常见的是canUseFeature

canUseFeature方法根据多个因素返回true或false

  • 功能已启用。
  • 功能值不是0/false/NULL。
  • 或者功能还有剩余的使用次数。
$user->planSubscription('main')->canUseFeature('listings');

用户订阅实例上的其他功能方法有

  • getFeatureUsage：返回用户使用特定功能的次数。
  • getFeatureRemainings：返回特定功能的可用使用次数。
  • getFeatureValue：返回功能值。

所有方法都有相同的签名：例如$user->planSubscription('main')->getFeatureUsage('listings');。

记录功能使用

为了有效地使用能力方法，您需要跟踪每个功能的每次使用（至少是那些需要跟踪的）。您可以使用通过用户subscription()方法提供的recordFeatureUsage方法。

$user->planSubscription('main')->recordFeatureUsage('listings');

recordFeatureUsage方法接受3个参数：第一个是功能的名称，第二个是要添加的使用量（默认为1），第三个表示添加是否是递增的（默认行为），当禁用时，使用量将由提供的数量覆盖。例如

// Increment by 2
$user->planSubscription('main')->recordFeatureUsage('listings', 2);

// Override with 9
$user->planSubscription('main')->recordFeatureUsage('listings', 9, false);

减少功能使用

减少功能使用几乎与增加它相同。这里我们只是从实际使用中减去一个给定的数量（默认为1）

$user->planSubscription('main')->reduceFeatureUsage('listings', 2);

清除订阅使用数据

$user->planSubscription('main')->usage()->delete();

检查订阅状态

要考虑订阅为活动状态，以下之一必须为true

  • 订阅有一个活动的试用。
  • 订阅的ends_at日期在未来。
$user->subscribedTo($planId);

或者您可以使用订阅模型中提供的以下方法

$user->planSubscription('main')->active();
$user->planSubscription('main')->canceled();
$user->planSubscription('main')->ended();
$user->planSubscription('main')->onTrial();

具有活动试用或ends_at日期在未来的已取消订阅被认为是活动的。

续订订阅

要续订订阅，您可以使用订阅模型中提供的renew方法。这将根据所选计划设置新的ends_at日期，并且将清除订阅的使用数据。

$user->planSubscription('main')->renew();

已结束期限的已取消订阅无法续订。

取消订阅

要取消订阅，只需在用户的订阅上使用cancel方法。

$user->planSubscription('main')->cancel();

默认情况下，订阅将保持活动状态直到周期结束，您可以传递true以立即结束订阅。

$user->planSubscription('main')->cancel(true);

作用域

订阅模型

// Get subscriptions by plan
$subscriptions = app('rinvex.subscriptions.plan_subscription')->byPlanId($plan_id)->get();

// Get bookings of the given user
$user = \App\Models\User::find(1);
$bookingsOfSubscriber = app('rinvex.subscriptions.plan_subscription')->ofSubscriber($user)->get(); 

// Get subscriptions with trial ending in 3 days
$subscriptions = app('rinvex.subscriptions.plan_subscription')->findEndingTrial(3)->get();

// Get subscriptions with ended trial
$subscriptions = app('rinvex.subscriptions.plan_subscription')->findEndedTrial()->get();

// Get subscriptions with period ending in 3 days
$subscriptions = app('rinvex.subscriptions.plan_subscription')->findEndingPeriod(3)->get();

// Get subscriptions with ended period
$subscriptions = app('rinvex.subscriptions.plan_subscription')->findEndedPeriod()->get();

模型

Rinvex Subscriptions使用4个模型

Rinvex\Subscriptions\Models\Plan;
Rinvex\Subscriptions\Models\PlanFeature;
Rinvex\Subscriptions\Models\PlanSubscription;
Rinvex\Subscriptions\Models\PlanSubscriptionUsage;

路线图

寻找贡献者！

以下是一组待改进的限制或寻找贡献者实施的功能请求，所有PR都欢迎😉

  • 允许为同一计划的多次发生支付费用（例如，月度计划，用户可以支付6个月的该计划费用）(#64)
  • 数据库中的计划按比例字段未被使用，应实施以统一扩展日期和价格（#68）
  • 将功能改为与计划建立多对多关系。多个计划可以拥有相同的功能，许多计划也可以拥有许多功能（#101）
  • 数据库中计划订阅时区字段未被使用，应实施以尊重日期计算中的时区（例如，starts_at、ends_at、trial_ends_at）（#78）
  • 将试用功能从订阅周期中分离出来，并相应调整订阅。用户应该在没有任何订阅的情况下也能拥有试用周期（#67）

变更日志

有关项目的完整历史，请参阅变更日志。

支持

以下支持渠道随时可用

贡献与协议

感谢您考虑为这个项目做出贡献！贡献指南可以在CONTRIBUTING.md中找到。

欢迎提交错误报告、功能请求和拉取请求。

安全漏洞

如果您在此项目中发现安全漏洞，请发送电子邮件至help@rinvex.com。所有安全漏洞都将得到及时处理。

关于Rinvex

Rinvex是一家成立于2016年6月的开罗，埃及的软件解决方案初创公司，专注于为中小企业提供集成企业解决方案。我们相信，我们的动力在于价值、影响力和影响力，这是我们与众不同的地方，通过软件的力量释放我们哲学的无穷可能性。我们喜欢称之为“生活速度的创新”。这就是我们如何为人类进步做出贡献的方式。

许可证

本软件根据MIT许可证（MIT）发布。

(c) 2016-2022 Rinvex LLC，部分权利保留。