https://github.com/h4kuna/exchange-nette

Exchange extension for Nette framework.
https://github.com/h4kuna/exchange-nette

extension nette

Last synced: about 2 months ago
JSON representation

Exchange extension for Nette framework.

• Host: GitHub
• URL: https://github.com/h4kuna/exchange-nette
• Owner: h4kuna
• Created: 2017-08-14T14:02:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-09-27T07:44:56.000Z (3 months ago)
• Last Synced: 2024-11-13T14:23:19.061Z (about 2 months ago)
• Topics: extension, nette
• Language: PHP
• Size: 52.7 KB
• Stars: 0
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
Exchange extension for Nette framework

-------

[![Downloads this Month](https://img.shields.io/packagist/dm/h4kuna/exchange-nette.svg)](https://packagist.org/packages/h4kuna/exchange-nette)

[![Latest Stable Version](https://poser.pugx.org/h4kuna/exchange-nette/v/stable?format=flat)](https://packagist.org/packages/h4kuna/exchange-nette)

[![Coverage Status](https://coveralls.io/repos/github/h4kuna/exchange-nette/badge.svg?branch=master)](https://coveralls.io/github/h4kuna/exchange-nette?branch=master)

[![Total Downloads](https://poser.pugx.org/h4kuna/exchange-nette/downloads?format=flat)](https://packagist.org/packages/h4kuna/exchange-nette)

[![License](https://poser.pugx.org/h4kuna/exchange-nette/license?format=flat)](https://packagist.org/packages/h4kuna/exchange-nette)

This library is extension for Nette Framework and for this [Exchange](//github.com/h4kuna/exchange).

## Installation

Simple via composer 

```sh

composer require h4kuna/exchange-nette

```

optional dependencies

```sh

composer require h4kuna/exchange-nette guzzlehttp/guzzle malkusch/lock nette/application nette/caching

```

## Registration

First step is registration extension and set tempDir.

```neon

extensions:

    exchangeExtension: h4kuna\Exchange\DI\ExchangeExtension 

```

Extension is ready to use other configuration are optionally. Default is defined three currencies CZK, EUR and USD. Currencies has default format by [h4kuna/number-format](//github.com/h4kuna/number-format), where is documentation.

## Configuration

Format options for currency read [h4kuna/number-format](//github.com/h4kuna/number-format)

```neon

exchangeExtension:

    currencies:

            czk: # upper / lower code of currency is not important

                decimals: 3

                decimalPoint: '.'

                thousandsSeparator: ','

                zeroIsEmpty: true

                emptyValue: '-'

                zeroClear: true

                mask: '1U'

                showUnitIfEmpty: false 

                nbsp: true

                unit: Kč

                round: h4kuna\Format\Number\Round::BY_CEIL

                

            usd:

                unit: '$'

            gbp: [] # use default format 

            foo: null # disable

    driver: # string class of h4kuna\Exchange\Driver\Driver default is Cnb\Day

    session: false # save info about currencies to session, default is only to cookie 

    vat: 21 # add number like percent

    strict: true # default enabled, download only defined currencies, example: ['CZK', 'EUR']

    defaultFormat: null # how format currency if format is not defined, value is array like above "currencies.czk" 

    managerParameter: 'currency' # is parameter for query, cookie and session if is available

    tempDir: %tempDir% # temporary directory for cache

    filters: # extension define frour filter for latte, you can rename

        currency: currency

        currencyTo: currencyTo

        vat: vat

        vatTo: vatTo

```

## Latte

Now we have four new filters.

```latte

{=100|currency}

{=100|vat}

{=100|currencyTo}

{=100|vatTo}

```

## Request

Create url with parameter currency and change value and check cookie.

```url

/?currency=USD

```