avoo/serializer-translation

Translation component for JMS Serializer

SerializerTranslation

, _(*1)

This is a PHP library based on JMS Serializer, and add translation option configuration for any properties., _(*2)

• Installation
• Default Usage
• With custom parameters
  • XML
  • YAML
  • Annotations

Installation

Require avoo/serializer-translation-bundle into your composer.json file:, _(*3)

``` json { "require": { "avoo/serializer-translation-bundle": "@dev-master" } }, <sub>(*4)</sub>

Register the bundle in `app/AppKernel.php`:

``` php
// app/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Avoo\SerializerTranslationBundle\AvooSerializerTranslationBundle(),
    );
}

Default Configuration

``` yaml, <sub>(*5)</sub>

app/config/config.yml

avoo_serializer_translation: metadata: cache: file file_cache: dir: %kernel.cache_dir%/avoo, <sub>(*6)</sub>

Default Usage
-------------

For example, you want to translate `acme.foo.bar` from BDD.

#### Default activation

Into your translation file:

``` yaml
# Acme/DemoBundle/Resources/translations/messages.en.yml

acme:
    foo.bar: "Welcome."

<?xml version="1.0" encoding="UTF-8" ?>
<serializer>
    <class name="Acme\DemoBundle\Entity\Sample" exclusion-policy="ALL" xml-root-name="sample" xmlns:a="https://github.com/avoo/SerializerTranslationBundle">
        <property name="property" expose="true" type="string">
            <a:translate />
        </property>
    </class>
</serializer>

YAML

Acme\DemoBundle\Entity\Sample:
    exclusion_policy: ALL
    xml_root_name: sample
    properties:
        property:
            expose: true
            type: string
            translate: true

Annotations

Important: The annotation need to be defined., <sub>(*7)</sub>

use Avoo\SerializerTranslation\Configuration\Annotation as AvooSerializer;

/**
 * @var string $property
 *
 * @AvooSerializer\Translate()
 */
 protected $property;

Json output sample

{
    "property": "welcome."
}

With custom parameters

With custom parameters

Into your translation file:, <sub>(*8)</sub>

``` yaml, <sub>(*9)</sub>

Acme/DemoBundle/Resources/translations/messages.en.yml

acme: foo.bar: "welcome %foo%", <sub>(*10)</sub>

### XML

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<serializer>
    <class name="Acme\DemoBundle\Entity\Sample" exclusion-policy="ALL" xml-root-name="sample" xmlns:a="https://github.com/avoo/SerializerTranslationBundle">
        <property name="property" expose="true" type="string">
            <a:translate domain="messages" locale="en">
                <a:parameter name="%foo%" value="expr(object.getProperty())" />
            </a:translate>
        </property>
    </class>
</serializer>

YAML

Acme\DemoBundle\Entity\Sample:
    exclusion_policy: ALL
    xml_root_name: sample
    properties:
        property:
            expose: true
            type: string
            translate:
                parameters:
                    %foo%: expr(object.getProperty())
                locale: en
                domain: messages

Annotations

use Avoo\SerializerTranslation\Configuration\Annotation as AvooSerializer;

/**
 * @var string $property
 *
 * @AvooSerializer\Translate(
 *     parameters = {
 *         "%foo%" = "expr(object.getProperty())"
 *     },
 *     domain = "messages",
 *     locale = "en"
 * )
 */
 protected $property;

Json output sample

{
    "property": "welcome Superman",
}

License

This bundle is released under the MIT license. See the complete license in the bundle:, <sub>(*11)</sub>

License, <sub>(*12)</sub>