Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Übersetzungen und Sprachen

Für CMS-Entwickler, die mehrsprachige Websites bauen. Die Seite behandelt Inhaltssprachen gegenüber Oberflächensprachen, Übersetzungen als Teil eines Objekts, übersetzbare und gemeinsame Felder, SiteLanguageList und…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/cms-developers/translations-and-languages.md

On this page

This page is a translation. Read the English original

Übersetzungen und Sprachen

Diese Seite richtet sich an Entwickler, die eine Website in mehr als einer Sprache bauen. In Exponential ist eine Übersetzung keine Kopie einer Seite: Sie ist eine weitere Sprache desselben Objekts; Relationen, Platzierungen, Berechtigungen und der Baum werden also von allen Sprachen geteilt, und nur die Texte unterscheiden sich.

Inhalt

  1. Zwei Arten von Sprache
  2. Übersetzungen gehören zum Objekt
  3. Welche Felder übersetzt werden
  4. Welche Sprache ein Besucher sieht
  5. Immer verfügbare Objekte
  6. Ein Siteaccess je Sprache
  7. Template-Texte
  8. Übersetzungen aus Code
  9. Caches nach Sprachänderungen

Zwei Arten von Sprache

InhaltsspracheOberflächensprache
Wasdie Sprache, in der Objekte geschrieben sinddie Texte der Templates und der Administration
Gespeichertin der Datenbank, je Objektin .ts-Übersetzungsdateien (share/translations/<locale>/, translations/ einer Erweiterung)
Gewählt übersite.ini [RegionalSettings] SiteLanguageList[] des Siteaccess[RegionalSettings] Locale des Siteaccess

Sie sind voneinander unabhängig: Ein Siteaccess kann deutsche Inhalte mit einer englischen Oberfläche zeigen (Inhaltssprachen, Abschnitt 1).

Übersetzungen gehören zum Objekt

Inhaltssprachen werden unter Setup > Sprachen hinzugefügt, bevor jemand in sie übersetzt. Jede Sprache ist ein Bit in einer Maske (2 für die erste, 4 für die zweite und so weiter), und jedes Objekt vermerkt seine Sprachen in seiner eigenen Maske; "Objekte auf Deutsch" ist also auf jeder Datenbank ein einziger Bit-Test. Jedes Objekt hat eine Hauptsprache, die, in der es angelegt wurde, und die sich nicht entfernen lässt, solange sie die Hauptsprache ist. Wie die Speicherung funktioniert und die Grenze von 62 Sprachen: Inhaltssprachen, Abschnitt 2.

Weil alle Übersetzungen Versionen eines Objekts sind, erzeugt das Veröffentlichen einer deutschen Übersetzung eine neue Version des Objekts, und der englische Text in dieser Version bleibt unverändert (Versionen, Entwürfe und Veröffentlichen).

Welche Felder übersetzt werden

Jedes Klassenattribut hat ein Kennzeichen übersetzbar (can_translate). Entfernen Sie es für Werte, die in jeder Sprache gleich sein müssen: Daten, Preise, E-Mail-Adressen, Bilder ohne Text, Relationen zu gemeinsam genutzten Objekten. Übersetzer sehen dann den Wert der Hauptsprache und können ihn nicht je Sprache ändern. Auch Klassen haben übersetzbare Namen und Beschreibungen, die Redakteure im Menü zum Anlegen sehen (Inhaltsklassen und Attribute).

Welche Sprache ein Besucher sieht

Je Siteaccess, in settings/siteaccess/<name>/site.ini.append.php:

[RegionalSettings]
Locale=ger-DE
ContentObjectLocale=ger-DE
SiteLanguageList[]
SiteLanguageList[]=ger-DE
SiteLanguageList[]=eng-US
ShowUntranslatedObjects=disabled
TextTranslation=enabled

Ein Objekt wird in der ersten Sprache aus SiteLanguageList[] angezeigt, die es hat. Mit ShowUntranslatedObjects=disabled (dem mitgelieferten Wert) werden Objekte, die in keiner der aufgeführten Sprachen vorliegen, ausgeblendet, sofern sie nicht immer verfügbar sind. Die leere Zeile SiteLanguageList[] löscht, was andere Dateien setzen. Jede Einstellung: Inhaltssprachen, Abschnitt 5.

Fetches folgen denselben Regeln: Eine deutsche Liste zeigt deutsche Titel, fällt auf Englisch zurück und lässt weg, was keins von beiden hat. Der Fetch list hat die Parameter language und only_translated für Listen, die davon abweichen müssen (Inhalte in Templates abrufen).

Immer verfügbare Objekte

Immer verfügbar ist ein Kennzeichen je Objekt (Bit 0 seiner Maske): Ein solches Objekt wird in seiner Hauptsprache angezeigt, wo keine aufgeführte Sprache vorhanden ist. Ordner, Benutzer, Benutzergruppen und Medien sind meist immer verfügbar, sodass eine deutsche Website trotzdem den Bilderordner und den Autor eines Artikels findet. Eine Klasse legt den Standard für neue Objekte fest (always_available) (Inhaltssprachen, Abschnitt 6).

Ein Siteaccess je Sprache

Eine mehrsprachige Website hat meist einen öffentlichen Siteaccess je Sprache, zugeordnet über ein URL-Element (/de/) oder einen Hostnamen, mit einer gemeinsamen Datenbank und aufgeführt in [SiteAccessSettings] RelatedSiteAccessList[]. Jede Sprache hat eigene URL-Aliase für denselben Knoten (URL-Aliase und Routing). Für Links zwischen den Sprachfassungen einer Seite nennt [RegionalSettings] TranslationSA[] die Siteaccesses der Übersetzungen, und der Template-Operator language_switcher mit dem Modul switchlanguage/to baut die Links. Einrichtung im Installationsbuch: 10.14 Mehrsprachige Websites und Siteaccesses und Multisite.

Template-Texte

Feste Texte in Ihren Templates werden mit dem Operator i18n und einem Kontext übersetzt:

<a href={'/content/search'|ezurl}>{'Search'|i18n( 'extension/exp_mysite' )}</a>

Die Übersetzungen liegen in translations/<locale>/translation.ts Ihrer Erweiterung, und die Erweiterung ist in site.ini [RegionalSettings] TranslationExtensions[] aufgeführt (Template-Texte übersetzen, Übersetzungen in einer Erweiterung).

Übersetzungen aus Code

eZContentFunctions::updateAndPublishObject() nimmt einen Parameter language, sodass ein Import einem vorhandenen Objekt eine Übersetzung hinzufügt, statt ein zweites Objekt anzulegen. Importieren Sie zuerst die Hauptsprache, dann jede Übersetzung in dasselbe Objekt, gefunden über seine Remote-ID (Inhalte aus PHP, Inhalte abbilden: Übersetzungen).

Caches nach Sprachänderungen

php bin/php/ezcache.php --clear-tag=ini --allow-root-user        # after changing [RegionalSettings]
php bin/php/ezcache.php --clear-tag=content --allow-root-user    # lists and pages drawn again
php bin/php/ezcache.php --clear-tag=i18n --allow-root-user       # after changing a .ts file

Mit Velocity zusätzlich ./console exp:velocity cache clear --apply. Die vollständige Liste, einschließlich des Neuaufbaus der URL-Aliase: Inhaltssprachen, Abschnitt 10.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x