add kirby-loop plugin with French translations

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

@@ -0,0 +1,94 @@
+---
+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:
+
+```php
+// 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:**
+```php
+// Editors prefer English UI even on German pages
+'moinframe.loop.language' => 'en',
+```
+
+**Single-Language website with non english content:**
+```php
+// 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:
+
+```php
+// 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:
+
+```php
+// 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](https://github.com/moinframe/kirby-loop/blob/main/index.php).