README

RewardfulSpark是一个小型库，允许您以最少的配置将Laravel Spark应用与Rewardful集成。

安装

首先，使用Composer要求RewardfulSpark包

composer require rewardful/rewardful-spark "3.*"

发布包

您可以通过运行此命令单独发布配置。

php artisan vendor:publish --tag=rewardful-config --force

您也可以使用此命令发布Vue组件

php artisan vendor:publish --tag=rewardful-vue --force

配置

在使用RewardfulSpark之前，您需要配置API密钥。将以下行添加到您的.env文件中。

REWARDFUL_API_KEY=<API_KEY>

前端

为了使Rewardful能够捕获您的推荐信息，您需要对views和vue文件进行轻微调整。

Blade布局

在您的blade布局中，您需要包含此blade指令，以确保它反映在所有页面上。这将确保我们的JavaScript库正在监控所有您的推荐。例如，在app.blade.php的底部添加以下行，在</body>标签之前。

@rewardful_js

Vue组件

RewardfulSpark附带了一些Vue组件，这些组件与register-stripe和subscribe-stripe组件混合。根据您的配置，您可能需要更新这些文件。

Laravel Spark 7.0+

信用卡预付

如果您要求用户在注册时输入他们的信用卡详细信息（即预先）

将vue模块包含到您的resources/js/spark-components/auth/register-stripe.js中。假设股票文件没有更改，您的文件应该看起来像这样。

var base = require('auth/register-stripe');
// include the module
var rewardful = require('../../rewardful/rewardful-register');

Vue.component('spark-register-stripe', {
	// add the module as mixing along with the base component
    mixins: [base, rewardful]
});

不预先输入信用卡

如果您不需要用户预先输入信用卡，并且提供GenericTrial，那么您需要确保在订阅期间捕获referral代码。

将vue模块包含到您的resources/js/spark-components/settings/subscription/subscribe-stripe.js中。假设股票文件没有更改，您的文件应该看起来像这样。

var base = require('settings/subscription/subscribe-stripe');
// include the module
var rewardful = require('../../../rewardful/rewardful-register');

Vue.component('spark-subscribe-stripe', {
	// add the module as mixing along with the base component
    mixins: [base, rewardful]
});

Laravel Spark 5 & 6

信用卡预付

如果您要求用户在注册时输入他们的信用卡详细信息（即预先）

将vue模块包含到您的resources/assets/js/spark-components/auth/register-stripe.js中。假设股票文件没有更改，您的文件应该看起来像这样。

var base = require('auth/register-stripe');
// include the module
var rewardful = require('../../../../js/rewardful/rewardful-register');

Vue.component('spark-register-stripe', {
	// add the module as mixing along with the base component
    mixins: [base, rewardful]
});

不预先输入信用卡

如果您不需要用户预先输入信用卡，并且提供GenericTrial，那么您需要确保在订阅期间捕获referral代码。

将vue模块包含到您的resources/assets/js/spark-components/settings/subscription/subscribe-stripe.js中。假设股票文件没有更改，您的文件应该看起来像这样。

var base = require('settings/subscription/subscribe-stripe');
// include the module
var rewardful = require('../../../../../js/rewardful/rewardful-register');

Vue.component('spark-subscribe-stripe', {
	// add the module as mixing along with the base component
    mixins: [base, rewardful]
});

编译您的资源

为了使更改生效，您需要编译您的资源。运行与您的环境相关的命令。假设生产构建

npm run production

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

致谢

Mina Abadir

许可证

MIT许可证（MIT）。请参阅许可证文件以获取更多信息。