Translation reference

Text

Translates simple text or string properties. This is the most common type.

Type	text
Class	Enhavo\Bundle\TranslationBundle\Translation\Type\TextTranslationType
Parent	Enhavo\Bundle\TranslationBundle\Translation\Type\TranslationType
Options	html, allow_fallback, allow_auto_translate, overwrite, context_groups

Attribute

#[Translate('text')]
private ?string $title = null;

#[Translate('text', ['html' => true, 'allow_fallback' => true])]
private ?string $description = null;

YAML

properties:
    title:
        type: text
    description:
        type: text
        html: true
        allow_fallback: true

allow_fallback

type: boolean default: false

Whether to fall back to the default locale if no translation exists.

allow_auto_translate

type: boolean default: true

Only if true, the auto-translation will be applied to this property.

html

type: boolean default: false

Whether the content should be treated as HTML. This is useful for auto translation.

overwrite

type: boolean default: false

Set to true to overwrite existing translations during auto-translation.

context_groups

type: array default: ['endpoint', 'translation_context']

Use a serialization group to generate an output that is used as a context for auto translation.

Slug

Extends text and is specialized for URL slugs. Supports all options from text.

Type	slug
Class	Enhavo\Bundle\TranslationBundle\Translation\Type\SlugTranslationType
Parent	Enhavo\Bundle\TranslationBundle\Translation\Type\TextTranslationType

Attribute

#[Translate('slug', ['allow_fallback' => true])]
private ?string $slug = null;

YAML

properties:
    slug:
        type: slug
        allow_fallback: true

Route

Translates route objects.

Type	route
Class	Enhavo\Bundle\TranslationBundle\Translation\Type\RouteTranslationType
Parent	Enhavo\Bundle\TranslationBundle\Translation\Type\TranslationType
Options	allow_null

Attribute

#[Translate('route')]
private ?Route $route = null;

YAML

properties:
    route:
        type: route

allow_null

type: boolean default: false

Whether null routes are allowed.

File

Translates file or media associations, so different files can be used per locale.

Type	file
Class	Enhavo\Bundle\TranslationBundle\Translation\Type\FileTranslationType
Parent	Enhavo\Bundle\TranslationBundle\Translation\Type\TranslationType

Attribute

#[Translate('file')]
private ?File $image = null;

YAML

properties:
    image:
        type: file

Model

Recursively translates nested model objects and collections. Use this for related entities that themselves contain translatable properties, such as content blocks or tree structures.

Type	model
Class	Enhavo\Bundle\TranslationBundle\Translation\Type\ModelTranslationType
Parent	Enhavo\Bundle\TranslationBundle\Translation\Type\TranslationType

Attribute

#[Translate('model')]
private Collection $content;

YAML

properties:
    content:
        type: model