README

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

Note: The package cannot be used outside of Enso enviroment and is not included in Laravel Enso Core packages.

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

Instalation

install the package using composer: composer require laravel-enso/currencies
adds 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

Publishes

you can publish the currency seeder and customize it to your liking

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

Icons

The package uses the following icons:

coins
bar-chart

Contributions

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

License

This package is released under the MIT license.

cgdsoftware / currencies

Maintainers

Details