Explain how multilang works

[dantleech]

I am confused about how persiting multilang docs in the CMF actually works..

In the MenuBundle documentation I wanted to link to the CoreBundle multilang docuemntation, and explain how to persist docs there, but then it made sense to link to the PHPCR-ODM docs which use bindTranslation.

But then the TranslatableInterface has setLocale, so do we need to call bindTranslation ? Is locale read only? Will calling setLocale do anything?

Anyway, we should make all this clear here.

[wouterj]

We want to create a book article about multilanguaging, #257 . I think these things should get discussed there

[dantleech]

@wouterj ok, but we should still document how this works here right? As the bundle provides the feature.

[lsmith77]

if there is a locale mapping and the locale is set to a different value than was used when the document was created, then phpcr odm will do an automatic bindTranslation()

[dbu]

@dantleech the reason bindTranslation exists is so that your script can save more than one locale in one flush operation. as data is copied on the flush normally, without this you would need to flush after each locale.

as for the doc, i think we should only explain the features of the CmfCoreBundle on this page and otherwise refer to the multilang book article #257. can you add a note in #257 about that if you agree?