README

Tenant-aware currency management for Vendra applications.

Features

• Currency categories
• Currencies with buy/sell pricing and conversion rate
• Filament resources on the admin panel

Requirements

• PHP 8.2+
• Laravel 12
• Filament 5
• Livewire 4
• Pest 4
• Tailwind CSS 4
• misaf/vendra-tenant
• misaf/vendra-activity-log

Installation

composer require misaf/vendra-currency
php artisan vendor:publish --tag=vendra-currency-migrations
php artisan migrate

Optional translations publish:

php artisan vendor:publish --tag=vendra-currency-translations

The service provider and Filament plugin are auto-registered.

Usage

Create a currency category:

use Misaf\VendraCurrency\Models\CurrencyCategory;

$category = CurrencyCategory::query()->create([
 'name' => 'Fiat',
 'description' => 'Government-issued currencies',
 'slug' => 'fiat',
 'position' => 1,
 'status' => true,
]);

Create a currency:

use Misaf\VendraCurrency\Models\Currency;

Currency::query()->create([
 'currency_category_id' => $category->id,
 'name' => 'US Dollar',
 'description' => 'United States Dollar',
 'slug' => 'usd',
 'iso_code' => 'USD',
 'conversion_rate' => 1,
 'decimal_place' => 2,
 'buy_price' => 100000,
 'sell_price' => 99500,
 'is_default' => true,
 'position' => 1,
 'status' => true,
]);

Load currencies with their category:

$currencies = Currency::query()
 ->with('currencyCategory')
 ->where('status', true)
 ->get();

Filament

Resources are available in the Currencies cluster on the admin panel:

• Currency Categories
• Currencies

Testing

composer test

License

MIT. See LICENSE.