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. imagina/icurrency-module

ActiveAsgard-module

imagina/icurrency-module
========================

This module manages currencies and conversions

1.0.6(6y ago)057463MITPHPPHP &gt;=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 4d 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 75% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity57

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

477d ago

Major Versions

1.0.6 → v10.x-dev2025-01-23

PHP version history (2 changes)1.0.0PHP &gt;=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

[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching

Instant switching between user accounts in WordPress and WooCommerce.

19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/user-plugin

User plugin for October CMS

11954.3k13](/packages/rainlab-user-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
