msdevbytes/filament-currency-switcher

A Filament v3 plugin to add a currency switcher with automatic conversion

1.1.0 2025-07-09 09:11 UTC

This package is auto-updated.

Last update: 2025-07-09 09:11:27 UTC


README

A Filament v3 plugin to add a currency switcher with automatic rate conversion using the Fixer.io API.

🚀 Features

  • 💸 Currency dropdown in the Filament navbar
  • 🔁 Automatic rate conversion using Fixer API
  • ✅ Supports free and paid Fixer plans
  • 🎛️ Configuration via Filament settings page
  • 🌙 Dark mode ready
  • 🧩 Powered by spatie/laravel-settings

📦 Installation

1. Install via Composer

composer require msdevbytes/filament-currency-switcher

2. Run the Installer

  • Register the settings class
  • Publish the config file
php artisan currency-switcher:install

3. Run these for spatie/laravel-settings:

php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"

php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="config"
php artisan make:settings-migration CurrencySettings

4. Replace the code inside the //database/settings/2025_07_03_130553_currency_settings.php

<?php

use Spatie\LaravelSettings\Migrations\SettingsMigration;

return new class extends SettingsMigration
{
    public function up(): void
    {
        $this->migrator->add('currency.fixer_api_key', 'api-key');
        $this->migrator->add('currency.base_currency', 'USD');
        $this->migrator->add('currency.supported_currencies', config('currency-switcher.supported_currencies'));
        $this->migrator->add('currency.fixer_is_paid', false);
    }
};

5. Run Migrations (if using Spatie settings for the first time)

php artisan vendor:publish --tag=settings-migrations
php artisan migrate