Locastic Api Translation Bundle

Translation bundle for ApiPlatform based on Sylius translation

Installation:

Implementation:

Translatable entity:

• Extend your model/resource with Locastic\ApiTranslationBundle\Model\AbstractTranslatable

• Add createTranslation() method which returns new object of translation Entity. Example:

• Add a translations-property. Add the translations serializations group and make a connection to the translation entity:

• Add virtual fields for all translatable fields, and add read serialization group. Getters and setters must call getters and setters from translation class. Example:

Translation entity:

• Add entity with all translatable fields. Name needs to be name of translatable entity + Translation
• Extend Locastic\ApiPlatformTranslationBundle\Model\AbstractTranslation
• Add serialization group translations to all fields and other read/write groups. Example Translation entity:

Api resource

• Add translation.groups filter if you would like to have option to return all translation objects in response. If you don't use translations group, response will return only requested locale translation or fallback locale translation.
• Add translations to normalization_context for PUT and POST methods to make sure they return all translation objects.
• Example:

Usage:

Language param for displaying single translation:

?locale=de

Or use Accept-Language http header

Accept-Language: de

Serialization group for displaying all translations:

?groups[]=translations

POST translations example

EDIT translations example

Contribution

If you have idea on how to improve this bundle, feel free to contribute. If you have problems or you found some bugs, please open an issue.

Support

Want us to help you with this bundle or any Api Platform/Symfony project? Write us an email on [email protected]