misaf/vendra-currency

Multi-currency support system with translatable content and hierarchical currency categories

dev-master 2026-02-26 05:24 UTC

Requires

• php: ^8.2
• awcodes/filament-badgeable-column: ^3.0
• filament/filament: ^4.7.0
• filament/spatie-laravel-media-library-plugin: ^4.7.0
• illuminate/support: ^11.0|^12.0
• misaf/vendra-activity-log: dev-master
• misaf/vendra-tenant: ^12.0
• mokhosh/filament-jalali: ^5.1
• spatie/eloquent-sortable: ^4.5.2
• spatie/laravel-package-tools: ^1.92
• spatie/laravel-sluggable: ^3.7.5
• staudenmeir/belongs-to-through: ^2.17

Requires (Dev)

• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.9.2
• laravel/boost: ^2.0.6
• laravel/pint: ^1.27
• misaf/vendra-testing: dev-master
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.8.3
• orchestra/testbench: ^10.9
• pestphp/pest: ^4.3.2
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-profanity: ^4.2.1
• pestphp/pest-plugin-type-coverage: ^4.0.3

MIT

• Ehsan Mahmoodi

• currency
• laravel
• filamentphp
• vendra
• misaf

README

Tenant-aware currency management for Laravel + Filament.

Features

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

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Filament 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.