jijunair / laravel-referral

Laravel 优惠系统包

v1.0.0 2023-07-13 06:42 UTC

This package is auto-updated.

Last update: 2024-09-05 09:05:15 UTC


README

Heading of Laravel Referral

Latest Version on Packagist Total Downloads License

"jijunair/laravel-referral"包是一个自定义的Laravel包,为您的Laravel应用程序提供推荐码功能。它允许您生成推荐码,将它们与用户关联起来,根据推荐码检索用户,以及所有相关的功能。

安装

您可以通过运行以下命令通过Composer安装此包

composer require jijunair/laravel-referral

配置

该包提供了一个配置文件,允许您自定义其行为。您应该使用以下命令发布迁移和config/referral.php配置文件

php artisan vendor:publish --provider="Jijunair\LaravelReferral\Providers\ReferralServiceProvider"

发布后,您可以在config/referral.php中找到配置文件。

这些配置选项有助于自定义Laravel应用程序中推荐系统行为。您可以根据自己的喜好和需求调整这些值!

迁移

在配置和迁移已发布并配置后,您可以通过运行以下命令创建此包的表

 php artisan migrate

添加特性

将必要的特性添加到您的User模型中

use Jijunair\LaravelReferral\Traits\Referrable;

class User extends Model
{
    use Referrable;
}

用法

为现有用户生成推荐账号

要为现有用户生成推荐账号,您可以访问以下URL

https://:8000/generate-ref-accounts

这将为您应用程序中的所有现有用户生成推荐码。

获取用户的推荐者

要获取用户的推荐者,您可以使用以下代码

use Illuminate\Support\Facades\Auth;

$user = Auth::user();
$referrer = $user->referralAccount->referrer;

这将检索与用户关联的推荐者。

通过推荐码获取推荐者

要通过推荐码获取推荐者,您可以使用以下代码

use Jijunair\LaravelReferral\Models\Referral;
use Illuminate\Support\Facades\Cookie;

$referralCode = Cookie::get(config('referral.cookie_name'));
$referrer = Referral::userByReferralCode($referralCode);

这将根据存储在cookie中的推荐码检索推荐者。

检查用户是否有推荐账号

要检查用户是否有推荐账号,您可以使用以下代码

$user->hasReferralAccount();

如果用户有推荐账号,则返回true,否则返回false

为用户创建推荐账号

要为用户创建推荐账号,您可以使用以下代码

$user->createReferralAccount($referrer->id);

这将通过创建推荐账号将用户与提供的推荐者关联起来。

获取用户的全部推荐

要获取用户下的全部推荐,您可以使用以下代码

$referrals = $user->referrals;

这将检索与用户关联的所有推荐。

获取用户的推荐链接

要获取用户的推荐链接,您可以使用以下代码

$referralLink = $user->getReferralLink();

这将返回与用户关联的推荐链接。

更新日志

有关最近更改的更多信息,请参阅更新日志

贡献

感谢您考虑为Laravel Referral包做出贡献!如果您有任何建议、错误报告或拉取请求,请随时在GitHub存储库中打开问题或提交拉取请求。

许可证

Laravel Referral包是开源软件,受MIT许可证的许可。