68publishers/application

Base extensions and components.

v0.8.1 2017-10-10 11:55 UTC

README

Build Status Quality Score Coverage Status Total Downloads Latest Version on Packagist

This package helps you to deal with regions with different languages, currencies and countries. It could be helpful even if you have single region project.

Installation

The best way to install 68publishers/application is using Composer:

composer require 68publishers/application

and now you can enable the Environment extension using your neon config

extensions:
    environment: SixtyEightPublishers\Application\DI\EnvironmentExtension

Usage

environment:
    profile:
        europe:
            language: [sk_SK, en_GB, de_DE, pl_PL]
            currency: [EUR, PLZ, GBP]
            country: [SK, GB, DE, PL]
        north_america:
            language: en_US
            currency: USD
            country: US
            domain: [www.example.com, example.com]
            # disable: yes
        default: # If the default profile doesn't exists, the first profile is taken as default
            language: cs_CZ
            currency: CZK
            country: CZ

Bar panel

Enables and disables Tracy debugger bar panel for better debugging

environment:
    debugger: yes

Integration with Kdyby\Translation

This feature provides automatic evaluation of the locale parameter for Kdyby\Translation based on profile settings in the extension. Default profile's language can be used if setting translations.useDefault is set to TRUE. If is this setting set to FALSE default language will not be used and other resolvers will be invoked. Also if you change language via method \SixtyEightPublishers\Application\Environment\ActiveProfile::changeLanguage(), locale in Translator is changed too.

environment:
    translations:
        enable: yes
        useDefault: no

Rules for contributing

  • 1 PR per feature
  • PR with tests are more likely to be merged
  • tests and coding standard must pass
vendor/bin/tester ./tests -s
vendor/bin/php-cs-fixer fix --config=.php_cs.dist -v --dry-run