Currencies

Codacy Badge StyleCI License Total Downloads Latest Stable Version

Currencies is an extension of the Laravel Enso environment, designed for the management of currencies and exchange rates.

This package works exclusively within the Enso ecosystem.

For live examples and demos, you may visit laravel-enso.com

Installation

  • install the package using composer: composer require laravel-enso/currencies

  • add the following alias in webackpack.mix.js

    .webpackConfig({
            resolve: {
                extensions: ['.js', '.vue', '.json'],
                alias: {
                     //other aliases
                    '@currencies': `${__dirname}/vendor/laravel-enso/currencies/src/resources/js`,
                },
            },
        })
    
  • in resources/js/router.js file, verify that RouteMerger is imported, or import it

    import RouteMerger from '@core-modules/importers/RouteMerger';

  • make sure routeImporter is also imported

    import routeImporter from '@core-modules/importers/routeImporter';

  • then use RouteMerger to import front-end assets using the alias defined in webpack.mix.js

    (new RouteMerger(routes))
        .add(routeImporter(require.context('./routes', false, /.*\.js$/)))
        .add(routeImporter(require.context('@currencies/routes', false, /.*\.js$/)));
    
  • in resources/js/app.js import the package's icons

import '@currencies/icons'

  • make sure hot module replacement is not active, and run yarn dev or npm run dev

Icons

The package uses the following icons:

  • coins
  • bar-chart

Features

  • handles CRUD operations for currencies and exchange rates
  • manages the default currency for your project
  • exchange rates can be input for a given day
  • comes with an included currencies seeder which can be published and further customized
  • includes front-end assets

Publishes

  • php artisan vendor:publish --tag=currency-seeder - the currency seeder

Contributions

are welcome. Pull requests are great, but issues are good too.

License

This package is released under the MIT license.