68publishers/translation-bridge

Bridges between integrations of translation component and '68publishers bundles.

v2.1.0 2024-08-06 00:35 UTC

This package is auto-updated.

Last update: 2024-11-06 01:33:03 UTC


README

Checks Coverage Status Total Downloads Latest Version PHP Version

About

The package contains bridges for the following integrations of symfomy/translation into Nette Framework:

Why? Because we want to keep our bundles independent of specific integrations so applications can use any of the integrations mentioned above and will be still compatible with our bundles.

Installation

The best way to install 68publishers/translation-bridge is using Composer:

$ composer require 68publishers/translation-bridge

Configuration

extensions:
    # if you are using contributte/translation:
    translation_bridge: SixtyEightPublishers\TranslationBridge\Bridge\Nette\DI\ContributteTranslationBridgeExtension

Usage

Translation Resources Provider

Extensions can provide paths with translation resources.

use Nette\DI\CompilerExtension;
use SixtyEightPublishers\TranslationBridge\Bridge\Nette\DI\TranslationProviderInterface;

final class MyBundleExtension extends CompilerExtension implements TranslationProviderInterface
{
    public function getTranslationResources(): array
    {
        return [
            __DIR__ . '/translations',
        ];
    }
}

Translator Aware

All services that implement an interface TranslatorAwareInterface will automatically receive the Translator instance.

<?php

use SixtyEightPublishers\TranslationBridge\TranslatorAwareTrait;
use SixtyEightPublishers\TranslationBridge\TranslatorAwareInterface;

final class MyService implements TranslatorAwareInterface
{
    use TranslatorAwareTrait;

    public function doSomething(): void
    {
        $this->translator->translate('....');
    }
}

Prefixed Translator Factory

The Container contains an autowired service of type PrefixedTranslatorFactoryInterface for creating prefixed translators.

<?php

use Nette\Localization\Translator;
use SixtyEightPublishers\TranslationBridge\PrefixedTranslatorFactoryInterface;

final class MyService
{
    private Translator $translator;

    public function __construct(PrefixedTranslatorFactoryInterface $prefixedTranslatorFactory)
    {
        $this->translator = $prefixedTranslatorFactory->create('MyService');
    }
}

Translator Localizer

The Container contains the service of type TranslatorLocalizerInterface for manipulating with the Translator locale.

use SixtyEightPublishers\TranslationBridge\Localization\TranslatorLocalizerInterface;

final class MyService
{
    public function __construct(
        private readonly TranslatorLocalizerInterface $localizer
    ) {}

    public function doSomething(): void
    {
        # Get the current locale
        $locale = $this->localizer->getLocale();

        # Set the new locale
        $this->localizer->setLocale('cs_CZ');
    }
}

Translator Locale Resolver

The Translator's locale can be resolved with own resolvers like this:

<?php

use Nette\Localization\Translator;
use SixtyEightPublishers\TranslationBridge\Localization\TranslatorLocaleResolverInterface;

final class MyLocaleResolver implements TranslatorLocaleResolverInterface
{
    public function resolveLocale(Translator $translator) : ?string
    {
        # return a valid locale or NULL
    }
}
services:
	- MyLocaleResolver

Contributing

Before opening a pull request, please check your changes using the following commands

$ make init # to pull and start all docker images

$ make cs.check
$ make stan
$ make tests.all