PHPackages imagina/icurrency-module - 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. imagina/icurrency-module ActiveAsgard-module[Utility & Helpers](/categories/utility) imagina/icurrency-module ======================== This module manages currencies and conversions 1.0.6(6y ago)057463MITPHPPHP >=7.0.0CI failing Since Jan 14Pushed 1y ago3 watchersCompare [ Source](https://github.com/imagina/imaginacms-icurrency)[ Packagist](https://packagist.org/packages/imagina/icurrency-module)[ RSS](/packages/imagina-icurrency-module/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependencies (4)Versions (10)Used By (3) Icurrency đŸ’± =========== [](#icurrency-) Installation ------------ [](#installation) `composer require imagina/icurrency` `php artisan module:migrate Icurrency` `php artisan db:seed --class=\\Modules\\Icurrency\\Database\\Seeders\\CurrencyTableSeederTableSeeder` Add middleware in `acms/app/Http/Kernel.php` ``` protected $middleware = [ // ... \Modules\Icurrency\Http\Middleware\CurrencyMiddleware::class, // ... ]; ``` *Note: This middleware expects the currency configuration within the object or from the request filter object. Example:**`api/iquote/v1/products?setting={"currency":"COP"}` o `api/iquote/v1/products?filter={"currency":"COP"}`, 'settings' have higher priority.* Add command for updates TRM in `acms/app/Console/Kernel.php` ``` protected $commands = [ // ... Modules\Icurrency\Console\UpdateCurrencies::class // ... ]; ``` Add .env your Api Key Get your api key in [currencyconverterapi](https://www.currencyconverterapi.com/) *Free Forex API Rate Limits* Currency Pairs per Request: 2 Number of Requests per Hour: 100 ``` CURRCONV_APIKEY=apikye ``` Run the following command the first time after making the migration to synchronize the currencies at the current exchange rate, after this they will be updated automatically with cron job. ``` php artisan currencies:update ``` Add command in schedule Laravel in `acms/app/Console/Kernel.php` ``` protected function schedule(Schedule $schedule) { // ... $schedule->command(Modules\Icurrency\Console\UpdateCurrencies::class)->dailyAt('01:00'); // ... } ``` ### Default Currencies Available [](#default-currencies-available) NAMECODEUnited States DollarUSDColombian PesoCOPAustralian dollarAUDMexican PesoMXNEuroEUR### Use Facade Currency [](#use-facade-currency) Add follow line on the class that you need use this Facade: ``` use Modules\Icurrency\Support\Facades\Currency; ``` Methods Available - Convert a value: ``` /* Example */ Currency::convert(1000): ``` - Convert a value from one currency to another currency: ``` /* Example */ Currency::convertFromTo(1000, 'COP', 'AUD'); ``` - Get the current currency: ``` /* Example */ Currency::getLocaleCurrency(); ``` - Set current currency: ``` /* Example */ Currency::setLocaleCurrency('COP'); ``` - Get array with all current supported: ``` /* Example */ Currency::getSupportedCurrencies(); ``` End Points ---------- [](#end-points) Route Base: `https://yourhost/api/icurrency/v1/` - #### Currencies [](#currencies) - Attributes NAMETYPENULLABLETRANSLATABLEnameString☐☑codeString☐☐symbol\_leftString☐☐symbol\_rightString☐☐decimal\_placechar☐☐valuedouble☐☐statustinyInteger☐☐default\_currencyboolean☐☐optionstext☐☐ - Create. - Method: `POST` - Requires Authentication: ☑ - Routes: - `/currencies` - Post params (Example): ``` { attributes:{ name: 'name', code: 'code', symbol_left: 'symbol_left', symbol_right: 'symbol_right', decimal_place: 'decimal_place', value: 'value', status: 'status', default_currency: 'default_currency', } } ``` - Read - Method: `GET` - Requires Authentication: ☐ - Routes: - `/currencies` - `/currencies/id` - Filters searchdateorder - Update - Method: `PUT` - Requires Authentication: ☑ - Routes: - `/currencies/id` - Delete - Method: `DELETE` - Requires Authentication: ☑ - Routes: - `/currencies/id` ### Health Score 33 — LowBetter than 72% of packages Maintenance31 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community18 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 89.3% 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 ~262 days Recently: every ~459 days Total 8 Last Release 525d ago Major Versions 1.0.6 → v10.x-dev2025-01-23 PHP version history (2 changes)1.0.0PHP >=7.0.0 v10.x-devPHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/2bc4bd5d733cfbe7e145670fbb1539bdb8d33f43c2cca4f26a119d37dfbad62f?d=identicon)[imagina](/maintainers/imagina) --- Top Contributors [![YeisonTapia](https://avatars.githubusercontent.com/u/10624544?v=4)](https://github.com/YeisonTapia "YeisonTapia (25 commits)")[![JCEC007](https://avatars.githubusercontent.com/u/7571125?v=4)](https://github.com/JCEC007 "JCEC007 (3 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/imagina-icurrency-module/health.svg) ``` [![Health](https://phpackages.com/badges/imagina-icurrency-module/health.svg)](https://phpackages.com/packages/imagina-icurrency-module) ``` ### Alternatives [helsingborg-stad/municipio A bootstrap theme for creating municipality sites. 4028.5k10](/packages/helsingborg-stad-municipio)[mautic/core Mautic Open Source Distribution 10.0k2.6k9](/packages/mautic-core)[mediawiki/maps Adds various mapping features to MediaWiki 84152.3k3](/packages/mediawiki-maps)[starcitizentools/citizen-skin A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki. 3376.6k](/packages/starcitizentools-citizen-skin)[civicrm/civicrm-drupal-8 Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 19251.4k3](/packages/civicrm-civicrm-drupal-8)[altis/core Core module for Altis 19228.0k3](/packages/altis-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)