PrestaShop Developer Conference
PrestaShop Developer Conference
Paris, France - November 6, 2024
Let's talk code, commerce and open source.

Notice: You are browsing the documentation for PrestaShop 9, which is currently in development.

You might want to read the documentation for the current version, PrestaShop 8. Read the current version of this page

TranslatableType

The TranslatableType allows you to configure multilanguage input. This multilanguage behavior is provided on top of an existing input Type.

Type options

Option Type Default Description
type string Symfony\Component\Form\Extension\Core\Type\TextType Type that you want to be translatable
options array Empty array Options for configured type
locales array Enabled shop locales (languages) Locales in which field can be translated
If you wish to use FormattedTextareaType as type, your base type must be TranslateType instead of TranslatableType. Do not forget to add the option hideTabs at true if you want to display the languages list above the WYSIWYG.

Required Javascript components

Component Description
TranslatableInput Allows toggling input for different locales
Learn more about Javascript components and how to use them

Code example

First, you have to add TranslatableType to your form.

<?php

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\TextareaType;
use PrestaShopBundle\Form\Admin\Type\TranslatableType;

class SomeType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder->add('description', TranslatableType::class, [
            // we'll have text area that is translatable
            'type' => TextareaType::class,
        ]);
    }
}

Then in Javascript you have to enable TranslatableInput component.

    import TranslatableInput from "admin-dev/themes/new-theme/js/components/translatable-input";

    // enable togging of different locales
    new TranslatableInput();

Preview example

TranslatableType rendered in form using textarea