Chapters

36 Chapters | 2:42:17 |

01

Initialize the Bundle

5:03
02

The Bundle Class

2:12
03

Install our Bundle Locally

2:30
04

Bundle Service Class

3:35
05

"Wiring Up" our Bundle Service

5:17
06

Entities in a Bundle

3:14
07

Configuring our Bundle's Entity

4:09
08

Extending our Bundle's Entity

1:43
09

Bundle Configuration

3:18
10

Bundle Configuration Validation

4:14
11

Using Bundle Configuration

2:40
12

Translated Object Wrapper

4:13
13

Unit Testing `TranslatedObject`

4:52
14

TDD Getter Behaviour

2:51
15

TDD `TranslatedObject` Translations

6:45
16

Translatable Mapping

5:19
17

Translation Logic

5:54
18

Fetch the Object ID with Doctrine

2:46
19

`translate_object` Twig Filter

4:32
20

Performance Optimization 1: Memoization

3:21
21

Performance Optimization 2: Caching

4:32
22

Cache Configuration

6:39
23

Refactoring `ObjectTranslator`

4:46
24

Cache Warmup Command

6:04
25

Warmup Command Configuration

5:26
26

Export Translations Command

4:42
27

Translations Import Command

6:00
28

Bundle Dependencies

4:16
29

Integration Testing

4:53
30

Doctrine Tests

4:14
31

Testing with Multiple Symfony Versions

7:01
32

Metadata & PHP CS Fixer

4:48
33

Static Analysis with PHPStan

4:31
34

CI with GitHub Actions

5:49
35

Publish to Packagist and Release

3:36
36

Symfony Flex Recipe

6:32

> Symfony > Symfony Bundle Development: Share the Love

Buy Access to Course Buy Access

26.

Export Translations Command

|

|

Autoplay

Keep on Learning!

If you liked what you've learned so far, dive in! Subscribe to get
access to this tutorial plus video, code and script downloads.

Start your All-Access Pass

Previous Challenge

Next Chapter

With a Subscription, click any sentence in the script to jump to that part of the video!

Login Subscribe

Login or Register to check out the script

5 Comments

Sort By

Login or Register to join the conversation

Davy 4 days ago

Hi Kevin,

Could you please explain how to implement a FormType that can be used in an admin interface (for example, EasyAdmin)?

I can create a form for editing existing translations, but how should I handle creating a new translation for a given object? I need a way to retrieve the type and ID of the passed object - which TranslatableMappingManager handles - but this class isn't autowirable and is marked as internal.

I'm a bit confused.... Maybe I'm missing something?

Thanks
Davide

|

kbond SFCASTS Davy 4 days ago

Davide,

I've created a PR to add a FormType to the bundle and some docs on integrating with EasyAdmin.

|

kbond SFCASTS Davy 4 days ago

Hi Davide,

You're not missing anything. TranslatableMappingManager is internal on purpose, and until now there wasn't a public way to do this. I just released v1.2.0, which adds a TranslationManager service for exactly this case. It's autowirable and works with the object directly, so you never deal with the type/id yourself.

Creating and editing work the same way. The form below always has every translatable field for the given locale, prefilled where a translation already exists and empty where it doesn't. Filling in an empty field creates the translation, because saveTranslationsFor() upserts. To add a whole new language, open the same form with a new $locale.

A rough sketch: an unmapped form with one field per translatable property, prefilled with the existing values:

public function translate(Product $product, string $locale, Request $request, TranslationManager $manager): Response
{
    $builder = $this->createFormBuilder($manager->findTranslationsFor($product, $locale));

    foreach ($manager->translatableFieldsFor($product) as $field) {
        $builder->add($field, TextareaType::class, ['required' => false]);
    }

    $form = $builder->getForm();
    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $manager->saveTranslationsFor($product, $locale, array_filter($form->getData()));

        // redirect...
    }

    // render...
}

In EasyAdmin you could wire this up as a custom action on your CRUD controller. translatableTypes() lists all your translatable classes if you want something generic, and translationStatusFor() is handy for showing which fields still need translating.

Let me know how it goes!

Kevin

|

Davy kbond 4 days ago

Version 1.2.0 is not yet available on https://packagist.org/packages/symfonycasts/object-translation-bundle
Could you please check this?

|

kbond SFCASTS Davy 4 days ago

Thanks for reporting. Fixed now.

|

Symfony 7.3

What PHP libraries does this tutorial use?

// composer.json
{
    "require": {
        "php": ">=8.2",
        "ext-ctype": "*",
        "ext-iconv": "*",
        "doctrine/dbal": "^3.10.0", // 3.10.0
        "doctrine/doctrine-bundle": "^2.15", // 2.15.0
        "doctrine/doctrine-migrations-bundle": "^3.4.2", // 3.4.2
        "doctrine/orm": "^3.5.0", // 3.5.0
        "league/commonmark": "^2.7.1", // 2.7.1
        "symfony/asset": "7.3.*", // v7.3.0
        "symfony/asset-mapper": "7.3.*", // v7.3.0
        "symfony/console": "7.3.*", // v7.3.1
        "symfony/crowdin-translation-provider": "7.3.*", // v7.3.0
        "symfony/dotenv": "7.3.*", // v7.3.0
        "symfony/flex": "^2.8.1", // v2.8.1
        "symfony/framework-bundle": "7.3.*", // v7.3.1
        "symfony/runtime": "7.3.*", // v7.3.1
        "symfony/stimulus-bundle": "^2.28", // v2.28.0
        "symfony/translation": "7.3.*", // v7.3.1
        "symfony/twig-bundle": "7.3.*", // v7.3.1
        "symfony/yaml": "7.3.*", // v7.3.1
        "symfonycasts/object-translation-bundle": "@dev", // dev-_tuts/bundle/3-install-our-bundle
        "symfonycasts/tailwind-bundle": "^0.10.1", // v0.10.1
        "twig/extra-bundle": "^2.12|^3.21", // v3.21.0
        "twig/markdown-extra": "^3.21", // v3.21.0
        "twig/string-extra": "^3.21", // v3.21.0
        "twig/twig": "^2.12|^3.21.1" // v3.21.1
    },
    "require-dev": {
        "phpunit/phpunit": "^9.6.23", // 9.6.23
        "symfony/browser-kit": "7.3.*", // v7.3.0
        "symfony/css-selector": "7.3.*", // v7.3.0
        "symfony/debug-bundle": "7.3.*", // v7.3.0
        "symfony/maker-bundle": "^1.64", // v1.64.0
        "symfony/monolog-bundle": "^3.10", // v3.10.0
        "symfony/phpunit-bridge": "^7.3.1", // v7.3.1
        "symfony/stopwatch": "7.3.*", // v7.3.0
        "symfony/web-profiler-bundle": "7.3.*", // v7.3.1
        "zenstruck/browser": "^1.9.1", // v1.9.1
        "zenstruck/foundry": "^2.6.1" // v2.6.1
    }
}

Previous Challenge

Next Chapter