nstcactus/craft-translations-module

The simplest way to add administrable translations to a Craft CMS site

Maintainers

Details

github.com/nstCactus/craft-translations-module

Source

Issues

Installs: 106

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

2.0.1 2024-04-21 15:37 UTC

Requires

MIT 5702ee6905adc1050472f9ce2b1dcefbc3395963

This package is auto-updated.

Last update: 2024-12-21 16:56:50 UTC

README

Getting started

  1. Install the module via composer:

    composer require nstcactus/craft-translations-module

  2. Load the module in the Craft config/app.php file:

    <?php return [
   'modules' => [
     'translations-module' => [ 
       'class' => nstcactus\craftcms\modules\translations\TranslationsModule::class,

       // Optional properties
       'translationCategory' => 'dico',
       'translatableItemsTableName' => '{{%frontend_translatable_items}}',
       'translationsTableName' => '{{%frontend_translations}}',
     ],
   ],
];

  3. Execute the migration to create the DB tables:

    ./craft migrate/up --track translations-module

  4. Add some translations in the Craft control panel: <craftUrl>/admin/translations

  5. Use translations in your templates:

    Voici une chaîne traduite : {{ 'app.translated.string'|t('dico') }}

Roadmap

  • change the database schema to be as close as possible to \yii\i18n\DbMessageSource (ideally use it instead of \nstcactus\craftcms\modules\translations\i18n\DbMessageSource)
  • refactor the module to link translations to a language (<lang>_<country>) instead of a site ID
  • improve the UI:
    • make it easier to remove translations
    • add the ability to add several translations at once
  • add the ability to import/export translations in CSV format