actuel-inactuel/site/plugins/loop/docs/03-multi-language.md

title
Multi-Language

Kirby Loop provides comprehensive support for multi-language Kirby sites, including automatic language detection and customizable UI translations.

How Multi-Language Support Works

The plugin automatically detects and adapts to your Kirby site's language configuration. No additional configuration is required - the plugin works automatically with Kirby's multi-language setup.

• Single-language sites: Uses the en translations
• Multi-language sites: Detects the current page language and adapts accordingly

UI Language Override

Forcing a Specific UI Language

By default, loop UI adapts to the current page language. You can override this behavior:

// Always show German UI regardless of page language
'moinframe.loop.language' => 'de',

// Always show English UI regardless of page language
'moinframe.loop.language' => 'en',

Use Cases for Language Override

Consistent Editor Experience:

// Editors prefer English UI even on German pages
'moinframe.loop.language' => 'en',

Single-Language website with non english content:

// German content site with German-speaking editors
'moinframe.loop.language' => 'de',

Built-in Translations

The plugin includes complete translations for:

• English (en) - Default
• German (de)

Custom Translations

Adding New Languages

To add support for additional languages, create or extend your Kirby language files:

// site/languages/fr.php
<?php

return [
    'code' => 'fr',
    'default' => false,
    'direction' => 'ltr',
    'locale' => 'fr_FR',
    'name' => 'Français',
    'translations' => [
        // UI Elements
        'moinframe.loop.ui.header.title' => 'Commentaires',
        ...
    ]
];

Overriding Existing Translations

Customize existing translations by adding them to your language files:

// site/languages/en.php - Override English defaults
return [
    'code' => 'en',
    'default' => true,
    'translations' => [
        'moinframe.loop.ui.header.title' => 'Page Feedback',
        'moinframe.loop.ui.comment.placeholder' => 'What needs attention?',
        'moinframe.loop.ui.welcome.headline' => 'Welcome to Our Review Tool',
    ]
];

Translation Key Reference

For a complete list of available translation keys, see the plugin's index file.