PHPackages                             rlaravel/plans - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. rlaravel/plans

ActiveLibrary

rlaravel/plans
==============

Crear planes y suscripciones

v1.2.2(6y ago)04MITPHPCI failing

Since Jan 1Pushed 5y ago1 watchersCompare

[ Source](https://github.com/rlaravel/plans)[ Packagist](https://packagist.org/packages/rlaravel/plans)[ RSS](/packages/rlaravel-plans/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (2)Versions (7)Used By (0)

Instalación
===========

[](#instalación)

Composer
--------

[](#composer)

```
$ composer require rlaravel/plans

```

Service Provider
----------------

[](#service-provider)

Agregue `RLaravel\Plans\Providers\PlansServiceProvider::class` a su archivo de proveedores de servicios de aplicaciones: `config/app.php`.

```
'providers' => [
    /**
     * Third Party Service Providers...
     */
    RLaravel\Plans\Providers\PlansServiceProvider::class,
];
```

Config archivo y migraciones
----------------------------

[](#config-archivo-y-migraciones)

Publique el archivo de configuración del paquete y las migraciones con el siguiente comando:

```
$ php artisan vendor:publish --provider="RLaravel\Plans\Providers\PlansServiceProvider"
```

Luego ejecuta las migraciones:

```
$ php artisan migrate
```

Traits y Contratos
------------------

[](#traits-y-contratos)

Agregue el rasgo `RLaravel\Plans\Traits\PlanSubscriber` y el contrato `RLaravel\Plans\Contracts\PlanSubscriberInterface` a su modelo de `User`.

Vea el siguiente ejemplo:

```
namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use RLaravel\Plans\Contracts\PlanSubscriberInterface;
use RLaravel\Plans\Traits\PlanSubscriber;

class User extends Authenticatable implements PlanSubscriberInterface
{
    use PlanSubscriber;
```

Uso
===

[](#uso)

Crear un Plan
-------------

[](#crear-un-plan)

```
use RLaravel\Plans\Models\Plan;
use RLaravel\Plans\Models\PlanFeature;

$plan = Plan::create([
    'name' => 'Pro',
    'description' => 'Pro plan',
    'price' => 9.99,
    'interval' => 'month',
    'interval_count' => 1,
    'trial_period_days' => 15,
    'sort_order' => 1,
]);

$plan->features()->saveMany([
    new PlanFeature(['code' => 'listings', 'value' => 50, 'sort_order' => 1]),
    new PlanFeature(['code' => 'pictures_per_listing', 'value' => 10, 'sort_order' => 5]),
    new PlanFeature(['code' => 'listing_duration_days', 'value' => 30, 'sort_order' => 10]),
    new PlanFeature(['code' => 'listing_title_bold', 'value' => 'Y', 'sort_order' => 15])
]);
```

Acceso a las características del plan
-------------------------------------

[](#acceso-a-las-características-del-plan)

En algunos casos, necesita acceder a una función particular en un plan particular, puede lograr esto utilizando el método ` getFeatureByCode` disponible en el modelo ` Plan`.

Ejemplo:

```
$feature = $plan->getFeatureByCode('pictures_per_listing');
$feature->value // Obtener el valor de la característica
```

Crear una Suscripción
---------------------

[](#crear-una-suscripción)

Primero, recupere una instancia de su modelo de suscriptor, que normalmente será su modelo de usuario y una instancia del plan al que se está suscribiendo. Una vez que haya recuperado la instancia del modelo, puede usar el método ` newSubscription` (disponible en el rasgo ` PlanSubscriber`) para crear la suscripción del modelo.

```
use Auth;
use RLaravel\Plans\Models\Plan;

$user = Auth::user();
$plan = Plan::find(1);

$user->newSubscription('main', $plan)->create();
```

El primer argumento pasado al método ` newSubscription` debe ser el nombre de la suscripción. Si su aplicación ofrece una suscripción única, puede llamar a este ` main` o ` primary`. El nombre de la suscripción no es el nombre del Plan, es un identificador de suscripción \* único \*. El segundo argumento es la instancia de plan a la que se está suscribiendo el usuario.

Resolución de suscripciones
---------------------------

[](#resolución-de-suscripciones)

Cuando utilice el método `subscription()` (es decir, `$user->subscription('main')`) en el modelo suscriptor para recuperar una subscripción, recibirá la última suscripción creada por el suscriptor y el nombre de la suscripción. Por ejemplo, si se suscribe **Jane Doe** a **Free plan** y, posteriormente, a **Pro plan**, el paquete devolverá la suscripción con el **Pro plan** porque es la suscripción más reciente disponible. Si tiene un requisito diferente, puede usar su propia resolución de suscripción vinculando una implementación de ` RLaravel\Plans \Contracts\SubscriptionResolverInterface` al `service container`\_\_; al igual que:

```
/**
 * Register the application services.
 *
 * @return void
 */
public function register()
{
    $this->app->bind(SubscriptionResolverInterface::class, CustomSubscriptionResolver::class);
}
```

Habilidad de la suscripción
---------------------------

[](#habilidad-de-la-suscripción)

Hay varias formas de determinar el uso y la capacidad de una característica en particular en la suscripción del usuario, la más común es ` canUse`:

El método ` canUse` devuelve ` true` o ` false` dependiendo de múltiples factores:

- La característica *is enabled*
- El valor de la característica no es `0`.
- O la característica tiene usos restantes disponibles

```
$user->subscription('main')->ability()->canUse('listings');
```

**Hay otras formas de determinar la capacidad de una suscripción:**

- `enabled`: devuelve ` true` cuando el valor de la característica es una *positive word* listada en el archivo de configuración.
- `consumed`: devuelve la cantidad de veces que el usuario ha usado una característica en particular.
- `remainings`: devuelve los usos disponibles para una característica en particular.
- `value`: devuelve el valor de la característica.

Todos los métodos comparten la misma firma: `$user->subscription('main')->ability()->consumed('listings');`.

Registro de uso de funciones
----------------------------

[](#registro-de-uso-de-funciones)

Para utilizar de manera efectiva los métodos de habilidad, deberá realizar un seguimiento de cada uso de las funciones basadas en el uso. Puedes usar el método `record` disponible a través del método `SubscribeUsage ()` del usuario:

```
$user->subscriptionUsage('main')->record('listings');
```

El método ` record` acepta 3 parámetros: el primero es el código de la función, el segundo es la cantidad de usos para agregar (el valor predeterminado es `1`), y el tercero indica si el uso debe incrementarse (`true`: comportamiento predeterminado) o sobrescrito (`false`).

Vea el siguiente ejemplo:

```
// Incremento por 2
$user->subscriptionUsage('main')->record('listings', 2);

// Anular con 9
$user->subscriptionUsage('main')->record('listings', 9, false);
```

Reducir el uso de características
---------------------------------

[](#reducir-el-uso-de-características)

Reducir el uso de la función es \*casi \* lo mismo que aumentarla. En este caso solo \* restamos \* una cantidad dada (el valor predeterminado es `1`) para el uso real:

```
// Reducir en 1
$user->subscriptionUsage('main')->reduce('listings');

// Reducir en 2
$user->subscriptionUsage('main')->reduce('listings', 2);
```

Borrar los datos de uso de la suscripción
-----------------------------------------

[](#borrar-los-datos-de-uso-de-la-suscripción)

En algunos casos, tendrá que borrar todos los usos en una suscripción de usuario particular, puede lograr esto utilizando el método `clear`:

```
$user->subscriptionUsage('main')->clear();
```

Verificar el estado de la suscripción
-------------------------------------

[](#verificar-el-estado-de-la-suscripción)

Para que una suscripción se considere **active** la suscripción debe tener una versión de prueba activa o la suscripción `ends_at` está en el futuro.

```
$user->subscribed('main');
$user->subscribed('main', $planId); // Compruebe si la suscripción está activa Y utilizando un plan particular
```

Alternativamente, puede usar los siguientes métodos disponibles en el modelo de suscripción:

```
$user->subscription('main')->isActive();
$user->subscription('main')->isCanceled();
$user->subscription('main')->isCanceledImmediately();
$user->subscription('main')->isEnded();
$user->subscription('main')->isOnTrial();
```

.. caution:: **Suscripciones** canceladas **con** una prueba activa o `ends_at` en el futuro se consideran activas.

Renovar una suscripción
-----------------------

[](#renovar-una-suscripción)

Para renovar una suscripción, puede utilizar el método `renew` disponible en el modelo de suscripción. Esto establecerá una nueva fecha `ends_at` basada en el plan seleccionado y **borrará los datos de uso** de la suscripción.

```
$user->subscription('main')->renew();
```

.. caution:: Las suscripciones canceladas con un período finalizado no se pueden renovar.

El evento `RLaravel\Plans\Events\SubscriptionRenewed` se activa cuando una suscripción se renueva con el método `renew`.

Cancelar una suscripción
------------------------

[](#cancelar-una-suscripción)

Para cancelar una suscripción, simplemente use el método `cancel` en la suscripción del usuario:

```
$user->subscription('main')->cancel();
```

De forma predeterminada, la suscripción permanecerá activa hasta que finalice el período. Pase `true` a *immediately* cancelar una suscripción.

```
$user->subscription('main')->cancel(true);
```

Eventos
=======

[](#eventos)

Los siguientes son los eventos disparados por el paquete:

- `RLaravel\Plans\Events\SubscriptionCreated`: Se activa cuando se crea una suscripción.
- `RLaravel\Plans\Events\SubscriptionRenewed`: Se activa cuando una suscripción se renueva con el método `renew()`.
- `RLaravel\Plans\Events\SubscriptionCanceled`: Se activa cuando se cancela una suscripción utilizando el método `cancel()`.
- `RLaravel\Plans\Events\SubscriptionPlanChanged`: Se dispara cuando se cambia el plan de suscripción; se activará una vez que se guarde el modelo `PlanSubscription`. El cambio de plan se determina comparando el valor original y actual de `plan_id`.

Eloquent Scopes
===============

[](#eloquent-scopes)

```
use RLaravel\Plans\Models\PlanSubscription;

// Obtenga suscripciones por plan:
$subscriptions = PlanSubscription::byPlan($plan_id)->get();

// Obtener suscripción por usuario:
$subscription = PlanSubscription::byUser($user_id)->first();

// Obtenga suscripciones con prueba que termina en 3 días:
$subscriptions = PlanSubscription::findEndingTrial(3)->get();

// Obtenga suscripciones con prueba finalizada:
$subscriptions = PlanSubscription::findEndedTrial()->get();

// Obtenga suscripciones con período que termina en 3 días:
$subscriptions = PlanSubscription::findEndingPeriod(3)->get();

// Obtenga suscripciones con período finalizado:
$subscriptions = PlanSubscription::findEndedPeriod()->get();
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~19 days

Recently: every ~13 days

Total

6

Last Release

2225d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/63375897?v=4)[Rafael Moreno](/maintainers/rlaravel)[@rlaravel](https://github.com/rlaravel)

---

Top Contributors

[![morenorafael](https://avatars.githubusercontent.com/u/6283260?v=4)](https://github.com/morenorafael "morenorafael (16 commits)")

### Embed Badge

![Health badge](/badges/rlaravel-plans/health.svg)

```
[![Health](https://phpackages.com/badges/rlaravel-plans/health.svg)](https://phpackages.com/packages/rlaravel-plans)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k84.2M225](/packages/laravel-horizon)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[stancl/tenancy

Automatic multi-tenancy for your Laravel application.

4.3k6.6M40](/packages/stancl-tenancy)[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k12.2M45](/packages/knuckleswtf-scribe)[google/cloud

Google Cloud Client Library

1.2k16.2M53](/packages/google-cloud)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)