Download the PHP package netzmacht/contao-i18n without Composer
On this page you can find all versions of the php package netzmacht/contao-i18n. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 contao-i18n
Contao I18n
This extension provides a flexible way for multilingual websites where parts of the main language should be reused on the translated pages.
Install
You can install this extension using Composer.
Requirements
- PHP
^8.1 - Contao
^5.3 - Usage of terminal42/contao-changelanguage
Features
Language aware redirects
The main idea of the repository is you want to reuse modules or content from the main page in the translations. If you do so, most links or redirects would go back to the main language.
That's where this extension hooks into. It detects references to pages in another language tree. If it's the case, it tries to find the translation and manipulates the target page to the translation.
It works for all page references. No matter if you have a jumpTo in your form or module. But you stay in control. You can disable this behaviour by disable it in the page of the main language. Also the change language module is blacklisted, so you are still able to link to another language.
- Set up the pages and connect pages as usual with changelanguage.
- Set the redirect page to the fallback language.
- If you want to disable the "page translation", you may configure it in your page setting.
So you only have to define the language relations once! And you keep control if language redirects are required.
Same pages in different languages
Sometimes you have to translate your website, but some pages stay identical. If you use different page aliases in your language tree the fallback page is not loaded.
The I18n Regular page is designed to solve this issue. It simply loads all the content of the fallback page. So it's
possible to have language-aware aliases but use the same content without duplication.
On top of it the language is kept. This means that Contao uses the language defined in the page settings. This enables you to use insert tags to translate contents.
Same news, events and faqs in different languages
If you want to reuse news, events and faqs in different languages, it's supported. You only have to use the
I18n Regular page as the reader page in the translation tree. This extension automatically creates the search page
entries and sitemap entries for you.
Known limitation: The rss feed are not translated at the moment.
Translation insert tags
The two features above allow you to reduce the stupid duplication of modules or page when where is no difference. But sometimes some labels has to be translated as well.
Use the {{translate::*}} insert tag for this or even it's shortcut {{t::*}}.
Following syntax is supported:
{{t::path.to.translation}}
Try to get the translation from the page_ALIAS domain. Fallback to website domain if not translated. If the page
type is an i18n page type, the alias of the base page is used instead.
In other words, you have to create a page_ALIAS.php translation file. If you have website wide translations use the
website.php language file.
If no page alias is given, the page id is used instead. Folder aliases get escaped to underscores.
{{t::domain:path.to.translation}}
Translate from a custom domain.
Note: The dot syntax is used for the array structure of the language file. Note: Nested insert tags are supported in the translation strings.
Navigation modules
This extension provides two navigation modules which goes a step further. They does not only replace the url but the whole page. So you get an translated navigation module even if you have a reference page set in a navigation module or you use an individual navigation.
Configuration
By default, contao-i18n does not delete any articles in the contao i18n regular page. If they are not connected as page to override other pages, they are simply ignored. However, you can enable the cleanup. If cleanup is enabled all articles are deleted which are not configured as an article override.
Development
This repository contains a ddev configuration for a local test and development environment of this extension. It also provides a snapshot of the database. So it's easy to set up a local instance for yourself. For the general usage of ddev read the ddev documentation.
Following credentials are used:
Backend user
- Username:
admin - Password:
adminuser
Install tool
- Password:
adminuser
All versions of contao-i18n with dependencies
contao/core-bundle Version ^5.3
doctrine/dbal Version ^3.9
hofff/contao-root-relations Version ^3.0
menatwork/contao-multicolumnwizard-bundle Version ^3.5
netzmacht/contao-toolkit Version ^4.0
psr/log Version ^1.0 || ^2.0 || ^3.0
symfony/asset Version ^6.4 || ^7.0
symfony/config Version ^6.4 || ^7.0
symfony/dependency-injection Version ^6.4 || ^7.0
symfony/event-dispatcher Version ^6.4 || ^7.0
symfony/http-foundation Version ^6.4 || ^7.0
symfony/http-kernel Version ^6.4 || ^7.0
symfony/routing Version ^6.4 || ^7.0
symfony/security-bundle Version ^6.4 || ^7.0
symfony/translation-contracts Version ^2.3 || ^3.0
terminal42/contao-changelanguage Version ^3.7