Texte übersetzen, die Theme und Plugins in wp_options speichern

Erfahren Sie, wie Sie Texte, die in der Tabelle wp_options gespeichert sind, übersetzbar machen und Objekt-IDs automatisch konvertieren.

Themes und Plugins fügen manchmal Texte als Teil der Optionen ein, die sie in der Tabelle wp_options speichern. WPML ermöglicht es Ihnen, solche Texte zu übersetzen, indem get_option-Aufrufe durch die Übersetzungen ersetzt werden, die Sie in der Datei wpml-config.xml angeben.

Die Datei wpml-config.xml ist ein Konfigurationsdokument, das WPML anweist, welche Strings in den gespeicherten Optionen übersetzt werden müssen.

Diese Anleitung richtet sich an Entwickler, die eigene Themes und Plugins erstellen. Wenn Sie versuchen, Strings von Drittanbieter-Themes und -Plugins zu übersetzen, lesen Sie unsere Seite über das Finden von Strings, die nicht auf der Seite String-Übersetzung erscheinen.

Müssen Sie eine Datei wpml-config.xml generieren? Besuchen Sie unsere Schritt-für-Schritt-Anleitung zum automatischen Generieren einer Konfigurationsdatei mit dem Plugin Multilingual Tools.

Strings in der Tabelle wp_options übersetzen

Wenn Themes und Plugins get_option verwenden, lesen sie Werte aus der Tabelle wp_options. WPML kann diese Aufrufe filtern und Übersetzungen für die Werte dieser Optionen bereitstellen.

Dies funktioniert, wenn der Datensatz wp_option ein einfacher String ist, aber auch, wenn es sich um ein serialisiertes Array handelt.

Um eine einzelne Option zu übersetzen, fügen Sie einen key-Eintrag unter admin-texts hinzu. Um ein serialisiertes Array zu übersetzen, fügen Sie mehrere Keys unter einem key hinzu, wie Sie im folgenden Beispiel bei my_plugin_options sehen können.

Admin-Texte in der Sprachkonfigurationsdatei

<wpml-config>
  <admin-texts>
    <key name="my_plugins_options">
      <key name="option_name_1" />
      <key name="option_name_2" />
    <key name="options_group_1">
      <key name="sub_option_name_11" />
      <key name="sub_option_name_12" />
    </key>
      <key name="options_group_2">
      <key name="sub_option_name_21" />
    <key name="sub_option_name_22" />
    </key>
    </key>
  <key name="simple_string_option"/>
</admin-texts>
 
</wpml-config>

Es ist möglich, den Platzhalter * in Sub-Keys zu verwenden, wie im folgenden Fall.

Beispiel für die Verwendung des Platzhalters

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="*"/>
    </key>
  </admin-texts>
</wpml-config>

Dies entspricht dem folgenden Code:

Der äquivalente Code

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="sub_key_1"/>
      <key name="sub_key_2">
        <key name="sub_sub_21">
          <key name="sub_sub_211"/> 
        </key> 
        <key name="sub_sub_21"/>
        </key>
      <key name="more_sub_keys"/>
    </key>
  </admin-texts>
</wpml-config>

Bitte beachten Sie, dass der Platzhalter * in übergeordneten Keys NICHT funktioniert:

Der Platzhalter funktioniert nicht in übergeordneten Keys

<wpml-config>
  <admin-texts>
    <key name="some_option_*" />
    <key name="*"/>
  </admin-texts>
</wpml-config>

Objekt-IDs in Admin-Texten automatisch konvertieren

Ab WPML 4.8 können Sie deklarieren, dass bestimmte Admin-Texte Objekt-IDs wie Beitrags-, Produkt- oder Taxonomie-IDs enthalten. WPML konvertiert diese IDs im Frontend der Website automatisch.

Dies ist eine Erweiterung der bestehenden Funktionalität zum automatischen Konvertieren von Shortcode-IDs und verwendet dieselbe Syntax.

In key-Einträgen unter admin-texts verwenden Sie:

type, um anzugeben, welches Objekt referenziert wird, z. B. post-ids oder taxonomy-ids
sub-type (optional), wenn Sie die spezifische Entität deklarieren möchten (z. B. product)

Die Attribute Type und sub-type können auf jeder Verschachtelungsebene hinzugefügt werden.

WPML kann IDs in diesen Formaten erkennen und konvertieren:

Eine einzelne ID (z. B. 123)
Ein Array (und codiertes Array) von IDs (z. B. [123,456,789])
Eine durch Kommas getrennte Liste von IDs (z. B. „123,456,789“)

Beispiel für die Deklaration von Objekt-IDs in Admin-Texten

<wpml-config>
  <admin-texts>
    <key name="admin_text_option_key" type="post-ids" sub-type="product" />
    <key name="admin_text_with_nested_ids">
      <key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_subkey">
        <key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
          </key>
      </key>
  </admin-texts>
</wpml-config>

Zusätzliche Ressourcen

Um mehr über die Datei wpml-config.xml zu erfahren, besuchen Sie die Anleitung Sprachkonfigurationsdateien.

Informationen zum Anpassen weiterer Elemente mithilfe der Datei wpml-config.xml finden Sie in unseren zusätzlichen Anleitungen: