Download the PHP package braunstetter/translated-forms without Composer
On this page you can find all versions of the php package braunstetter/translated-forms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download braunstetter/translated-forms
More information about braunstetter/translated-forms
Files in braunstetter/translated-forms
Package translated-forms
Short Description Translate your forms. Simple and easy.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package translated-forms
Translated (Symfony) Forms
This bundle gives you a translated option for your Symfony forms. So when you switch languages your forms are translated and work just fine.
It is assumed that you are using the KNP Doctrine Behaviours for your translations.
Installation
composer require braunstetter/translated-forms
Usage
Once installed this bundle lets you set an option inside your form parameter array:
When this is set to true your form will react to the current locale inside your request object.
It is important to use Proxy Translations to allow this bundle to read data by a magic method.
Why should you use this bundle?
There is the popular a2lix/translation-form-bundle. It is actively maintained and if you like it - you can stick to it.
But to use a2lix/translation-form-bundle there is some CSS and Javascript required. Also, it comes with a dedicated FormType. So you have to wrap every field inside this FormType. It provides these clickable tabs for every single translated field, which is not so handy, when you just want to translate your whole form.
braunstetter/translated-forms will just work fine with all your Symfony forms. No extra CSS no Javascript no extra FormType to implement. Your forms stay the same. Just switch the languages and even nested forms are translated.
Custom Traits
Knp Doctrine Behaviours brings some Traits to your translatable Entities and your translations.
By default, it assumes you put the translation Entity into the same folder as the translatable. This gets quite messy, as soon as you translate a lot.
So braunstetter/translated-forms bundle delivers two traits. TranslationTrait.
They work just the same way as the default one's form KNP (in fact they use it under the hood), but they put translations into a Translation folder - and they implement the magic __call method which is required for this bundle to translate your forms.
How does this magic happen?
Reading the data (mapDataToForms)
If enabled this bundle sets a new data mapper to your forms.
The default data mapper of the Symfony form component does not work with magic properties - the data mapper of this bundle does.
Writing the data (mapFormsToData)
When data of a form is going to be saved - this data mapper tries to save it the normal way.
If the field of the base entity is not writeable directly it is going to pick the current translation and is writing it into it.
All versions of translated-forms with dependencies
symfony/framework-bundle Version ^5.3|^6.0
knplabs/doctrine-behaviors Version ^2
symfony/property-access Version ^6
symfony/form Version ^6
symfony/security-bundle Version ^6.0