laravel-liberu/currencies

v3.0.7 2023-10-14 08:38 UTC

Requires

• laravel-liberu/api: ^1.3
• laravel-liberu/core: ^8.0
• laravel-liberu/countries: ^2.0
• laravel-liberu/forms: ^4.0
• laravel-liberu/helpers: ^2.0
• laravel-liberu/migrator: ^2.0
• laravel-liberu/select: ^4.0
• laravel-liberu/tables: ^4.0

Requires (Dev)

• rector/rector: ^0.17.0

MIT

• Ionut-Catalin Sandu
• Adrian Ocneanu

• currencies
• currency-converter
• vue-bulma
• laravel-liberu

README

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

Note: The package cannot be used outside of Liberu enviroment and is not included in Laravel Liberu 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-liberu/currencies
• adds the following alias in webackpack.mix.js

.webpackConfig({
        resolve: {
            extensions: ['.js', '.vue', '.json'],
            alias: {
                 //other aliases
                '@currencies': `${__dirname}/vendor/laravel-liberu/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.