Developer · Grundlagen

Übersetzungen

Texte für Menschen gehören nicht in den Code, sondern in Übersetzungen. So bleibt deine Erweiterung mehrsprachig und der Betreiber kann jeden Text im Admin anpassen.

Funktion t($key, $fallback)Dateien lang/de.php, lang/en.phpManifest "i18n"

1.Texte im Code

PHPPHP
echo t('plugin.NeofireExample.page_title', 'Beispiel-Plugin'); // mit PluginBase kürzer – Schlüssel plugin.NeofireExample.page_titleecho $this->t('page_title', 'Beispiel-Plugin');

t() sucht in der aktuellen Sprache, dann in Deutsch, dann nimmt es den Fallback.

2.Sprachdateien

lang/de.phpPHP
<?php/* * Copyright 2026 All Rights Reserved - neofire | Deutschland * Simeonscarré 2, 32423 Minden */return [    'plugin.NeofireExample.el_teaser' => 'Teaser',    'plugin.NeofireExample.el_teaser_hint' => 'Überschrift, Text und ein Knopf – Beispiel-Baustein aus dem Plugin NeofireExample.',    'plugin.NeofireExample.f_title' => 'Überschrift',    'plugin.NeofireExample.f_text' => 'Text',    'plugin.NeofireExample.f_button_label' => 'Knopf-Text',    'plugin.NeofireExample.f_button_link' => 'Knopf-Link',    'plugin.NeofireExample.page_title' => 'Beispiel-Plugin',    'plugin.NeofireExample.page_shop' => 'Shop',    'plugin.NeofireExample.page_hits' => 'Aufrufe dieser Seite',    'plugin.NeofireExample.page_json' => 'Als JSON ansehen',    'plugin.NeofireExample.test_ok' => '%1$d Aufrufe gezählt. Endpunkt: %2$s',    'plugin.NeofireExample.test_no_table' => 'Die Tabelle fehlt. Bitte das Plugin erneut installieren.',];
  • Geladen werden die Dateien aller aktiven Erweiterungen.
  • Reihenfolge: Datenbank vor Kern vor Plugin-Datei – deine Datei füllt Lücken, sie überschreibt keine Kern-Texte und keine Änderungen des Betreibers.

3.Texte aus plugin.json

Beim Installieren und bei jedem Update legt der Kern die Texte des Manifests als Übersetzungen an – Deutsch direkt aus label, description, Reitern, Karten und Feldern, weitere Sprachen aus i18n:

plugin.jsonJSON
"i18n": {    "en": {        "label": "Example plugin",        "tab.allgemein": "General",        "field.greeting.label": "Greeting",        "field.greeting.help": "Returned by the endpoint as message."    }}
Gut zu wissenDie Schlüssel für Reiter und Karten entstehen aus dem Namen in Kleinbuchstaben, alles außer a–z und 0–9 wird zu _. Aus „Begrüßung“ wird also begr_ung. Vorhandene Texte werden nie überschrieben.

Fragen zur Entwicklung?

Wenn du nicht weiterkommst oder dir ein Hook fehlt, helfen wir dir gerne weiter.
Erstelle ein Ticket mit deiner Frage.

Ticket erstellen