Trakli Cloud Plugin

This plugin controls whether the Trakli webservice operates in free or paid mode. It manages the subscription functionality, pricing plans, and feature access based on the current mode.

Features

• Toggle between free and paid service modes
• Configurable pricing plans when in paid mode
• Simple API endpoints for checking service status and plans
• Environment-based configuration

Installation

1. Clone or download this plugin into your plugins/cloud directory.

2. Publish the configuration file:

   php artisan vendor:publish --tag=cloud-config

   Or manually copy the config file:

   cp plugins/cloud/config/cloudplans.php config/cloudplans.php

3. The configuration will be available at config/cloudplans.php where you can customize the settings.

4. If you modify the configuration, clear the config cache:

   php artisan config:clear
   php artisan cache:clear

Configuration

Service Modes

1. Free Mode (default):

   • All features are available without payment
   • No subscription required
   • Set CLOUD_FREE_PLAN_ENABLED=true

2. Paid Mode:

   • Requires subscription after trial period
   • Configure pricing and plans
   • Set CLOUD_FREE_PLAN_ENABLED=false

Environment Variables

# Enable/disable free mode (when true, all features are free)
CLOUD_FREE_PLAN_ENABLED=true

# Pricing (in cents, only used when FREE_PLAN_ENABLED=false)
CLOUD_PLAN_MONTHLY_PRICE=500    # $5.00
CLOUD_PLAN_YEARLY_PRICE=5000    # $50.00 (about 17% off monthly)

Regions

Currently supported regions:

• US (United States)
• EU (Europe)
• UK (United Kingdom)

All regions use USD as the currency.

API Endpoints

Get Plans

Get plans for a specific region

GET /api/cloud/plans?region=us

Get plans for all regions

GET /api/cloud/plans

Query Parameters:

• region (optional):
  • If provided: Returns plans for the specified region (us, eu, uk). Falls back to 'us' if invalid.
  • If omitted: Returns plans for all available regions.

Example Response:

{
    "region": "United States",
    "currency": "USD",
    "trial_days": 3,
    "free_plan_enabled": true,
    "plans": [
        {
            "id": "monthly",
            "name": "Monthly",
            "interval": "month",
            "price_cents": 500,
            "currency": "USD",
            "trial_days": 3,
            "features": ["..."]
        },
        {
            "id": "yearly",
            "name": "Yearly",
            "interval": "year",
            "price_cents": 5000,
            "currency": "USD",
            "trial_days": 3,
            "features": ["..."]
        }
    ]
}

Get Benefits

GET /api/cloud/benefits

Example Response:

{
    "overview": {
        "title": "Why Create a Trakli Cloud Account?",
        "description": "..."
    },
    "benefits": [
        {
            "title": "Access Anywhere",
            "description": "..."
        }
    ],
    "trial_days": 3
}

Development

Configuration

Edit config/cloudplans.php to modify:

• Plan features
• Benefits
• Trial period
• Region settings

Adding New Regions

1. Add a new entry to the regions array in config/cloudplans.php
2. The region key should be a 2-3 letter code (e.g., 'ca' for Canada)
3. Set the name and currency for the region

Testing

Run the test suite:

php artisan test

License

This plugin is open-source software licensed under the MIT License.