PHPackages victoravelar/laravel-dashboard-exchange-rates-tile - 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. [Utility & Helpers](/categories/utility) 4. / 5. victoravelar/laravel-dashboard-exchange-rates-tile ActiveLibrary[Utility & Helpers](/categories/utility) victoravelar/laravel-dashboard-exchange-rates-tile ================================================== It allows you to display a list of selected currencies and it's exchange rate to a base currency of your choice. v0.2.0(3y ago)074MITPHPPHP ^8.0|^7.4 Since Sep 11Pushed 3y ago1 watchersCompare [ Source](https://github.com/VictorAvelar/laravel-dashboard-exchange-rates-tile)[ Packagist](https://packagist.org/packages/victoravelar/laravel-dashboard-exchange-rates-tile)[ Docs](https://github.com/VictorAvelar/laravel-dashboard-exchange-rates-tile)[ RSS](/packages/victoravelar-laravel-dashboard-exchange-rates-tile/feed)WikiDiscussions master Synced yesterday READMEChangelog (2)Dependencies (5)Versions (3)Used By (0) Exchange rates display for your laravel dashboard. ================================================== [](#exchange-rates-display-for-your-laravel-dashboard) [![Latest Version on Packagist](https://camo.githubusercontent.com/faed6fcbded68cadfe95089d3a9f31167259fe1da99e502c232355add68bb8c0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f566963746f724176656c61722f6c61726176656c2d64617368626f6172642d65786368616e67652d72617465732d74696c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/VictorAvelar/laravel-dashboard-exchange-rates-tile)[![GitHub Tests Action Status](https://camo.githubusercontent.com/51e109cc7ff46358b4a3ddf311ffc41f16064afe3c7825b7c8d9df208f744a8f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f566963746f724176656c61722f6c61726176656c2d64617368626f6172642d65786368616e67652d72617465732d74696c652f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/VictorAvelar/laravel-dashboard-exchange-rates-tile/actions?query=workflow%3Arun-tests+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/e8538ae17d028ad214fe8c22132a046b15f0c748c2dc8e7e3adbc2e60ba6a679/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f566963746f724176656c61722f6c61726176656c2d64617368626f6172642d65786368616e67652d72617465732d74696c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/VictorAvelar/laravel-dashboard-exchange-rates-tile) It allows you to display a list of selected currencies and it's exchange rate to a base currency of your choice. This tile can be used on [the Laravel Dashboard](https://docs.spatie.be/laravel-dashboard). Installation ------------ [](#installation) You can install the package via composer: ``` composer require VictorAvelar/laravel-dashboard-exchange-rates-tile ``` Usage ----- [](#usage) #### Exchange rates tile [](#exchange-rates-tile) Depending on your provider, this tile will show the most recent exchange rate for the symbols listed in your configuration. In your dashboard view you use the `livewire:dashboard-exchange-rates-tile` component. ``` ``` ##### Example [](#example) [![Exchange rates example](./media/exchange-rates.png)](./media/exchange-rates.png) #### Exchange rate converter [](#exchange-rate-converter) The conversion of a certain amount in your base currency to each symbol in your configuration is displayed on this tile. In your dashboard view you use the `livewire:dashboard-exchange-converter-tile` component. ``` ``` ##### Example [](#example-1) [![Exchange rates example](./media/currency-conversion.png)](./media/currency-conversion.png) #### Fetching exchange rates [](#fetching-exchange-rates) In `app\Console\Kernel.php` you should schedule the `Avelar\ExchangeRates\UpdateCurrencyExchangeRatesCommand` to run. ``` // in app/console/Kernel.php protected function schedule(Schedule $schedule) { // ... $schedule->command(Avelar\ExchangeRates\UpdateCurrencyExchangeRatesCommand::class)->everyMinute(); } ``` #### Customzing the views [](#customzing-the-views) ``` php artisan vendor:publish --provider="Avelar\ExchangeRates\ExchangeRatesTileServiceProvider" --tag="dashboard-exchange-rates-views" ``` ### Configuration [](#configuration) ``` // in config/dashboard.php return [ // other settings 'tiles' => [ // other tiles ... 'exchange_rates' => [ /* |-------------------------------------------------------------------------- | Exchange rates provider. |-------------------------------------------------------------------------- | | Value for the exchange rates provider you prefer to use, the tile was | build using exchangerate.host which is free but it is also fully | compatible with fixer.io which has a freemium model. | | Accepted values are: "exchangerates.host" and "fixer.io". | */ 'provider' => 'exchangerate.host', /* |-------------------------------------------------------------------------- | Base currency. |-------------------------------------------------------------------------- | | The currency you want to use as base for the exchange rates display. | | Any currency is accepted as base as long as it is supported by your | exchange rate provider. | */ 'base' => 'EUR', /* |-------------------------------------------------------------------------- | Symbols to track. |-------------------------------------------------------------------------- | | An array of exchange rate(s) symbols you wish to track. | | Example: ['USD', 'JPY', 'MXN'] | */ 'symbols' => ['GBP', 'USD'], /* |-------------------------------------------------------------------------- | Crypto assets to track. |-------------------------------------------------------------------------- | | An array of crypto assets(s) you wish to track. | | The support for this feature depends on the provider you are using and | the crypto exchanges/assets this provider tracks. | | Currently only exchangerates.host is available as crypto provider and | the list of available assets can be found here: | https://api.exchangerate.host/cryptocurrencies | | Example: ['BTC'] | */ 'crypto' => ['BTC'], /* |-------------------------------------------------------------------------- | Fixer.io API key. |-------------------------------------------------------------------------- | | When using fixer.io as provider you need to privide a valid API key | in order to access the API. | */ 'api_key' => env('FIXER_API_KEY', ''), /* |-------------------------------------------------------------------------- | Tile refresh interval (optional). |-------------------------------------------------------------------------- | | How often should the dashboard refresh your tile. | | If none set, it defaults to 60s. | */ 'refresh_interval_in_seconds' => 60, /* |-------------------------------------------------------------------------- | Converter value. |-------------------------------------------------------------------------- | | An amount to track against the specified symbols and crypto assets. | | Example: 500 | | This will display a list in a similar fashion than the one tracking the | exchange rates, the content will refer to the amount in X currency | you will get by converting n amount of the base currency. | */ 'convert_value' => 500, ], ], ]; ``` Testing ------- [](#testing) ``` composer test ``` Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 22 — LowBetter than 21% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity43 Maturing project, gaining track record 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 ~39 days Total 2 Last Release 1353d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1d916828232fe3106f3bc593b97ceef46f2b4285b4867a59d6277495e2a6fbf6?d=identicon)[VictorAvelar](/maintainers/VictorAvelar) --- Top Contributors [![VictorAvelar](https://avatars.githubusercontent.com/u/7926849?v=4)](https://github.com/VictorAvelar "VictorAvelar (23 commits)") --- Tags laravelexchange rateslaravel-dashboard ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/victoravelar-laravel-dashboard-exchange-rates-tile/health.svg) ``` [![Health](https://phpackages.com/badges/victoravelar-laravel-dashboard-exchange-rates-tile/health.svg)](https://phpackages.com/packages/victoravelar-laravel-dashboard-exchange-rates-tile) ``` ### Alternatives [florianv/laravel-swap Drop-in Laravel currency conversion: auto-discovered service provider, facade, and config. Multi-provider exchange rates. 3402.2M3](/packages/florianv-laravel-swap)[spatie/laravel-dashboard-time-weather-tile A tile for Laravel Dashboard that displays the time and the weather 1212.6k1](/packages/spatie-laravel-dashboard-time-weather-tile) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)