Download the PHP package r3h6/form-translator without Composer
On this page you can find all versions of the php package r3h6/form-translator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download r3h6/form-translator
More information about r3h6/form-translator
Files in r3h6/form-translator
Package form-translator
Short Description Provides a backend module and cli for translating forms.
License GPL-2.0-or-later
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 form-translator
form_translator
This extension provides a backend module for translating TYPO3 form framework forms and a cli for creating a source xliff file for a given form.
Installation
Either from TYPO3 TER or through composer $ composer req r3h6/form-translator.
Integration
If you like use machine translation by LibreTranslate you must only configure an api host in the extension configuration. See available mirrors.
How it works
The extensions adds a translation file path to the *.form.yaml file when localize through the backend module.
Customized validation error messages are translated by overriding the form definition
at runtime using the afterBuildingFinished hook from the form framework.
Upgrade
From v2 an TYPO3 v12
Rename language files prefixed with a locale like de_DE.locallang.xlf
to the corresponding TYPO3 language de.locallang.xlf
or setup a custom language.
From v2 an TYPO3 v11
No changes required.
Known issues
Transalte to English overrides the original form labels
Scenario: German is used as default language and your form definition labels are in German too.
When you translate a form to English, English will override your original labels even on the German version of your site.
You have following options:
- Create a (duplicated) German translation of the form
- Add the English locale without charset to the extension configuration
typo3LanguageWhitelist
Background: Beginning with v12, TYPO3 uses the locale configured for the site to determine the language.
For English, TYPO3 uses the file named xyz.xlf, it does not load a file named en.xyz.xlf, but it does for en_US.xyz.xlf.
Resources
Develpment
Events
| Name | Description |
|---|---|
| AfterParseFormEvent | Allows to change the translatable items of a form |
| FinalizeTypo3LanguagesEvent | Allows to change the available languages |
Local setup
Setup libretranslate:
docker run -ti --rm -p 5000:5000 -e LT_LOAD_ONLY='en,de' libretranslate/libretranslate
LibreTranslate host:
http://host.docker.internal:5000/
Contribution
Pull request are welcome!
Please note: I will not include other translation api's than LibreTranslate in this extension.
If you need an other service, you can create your own by implementing TranslationServiceInterface.
All versions of form-translator with dependencies
softcreatr/jsonpath Version ^0.9
typo3/cms-core Version ^12.4 || ^13.4
typo3/cms-form Version ^12.4 || ^13.4