Beispiele

ContentBlocks fields

Die folgende Beispiel-Systemeinstellung in babeltranslate.translate_resource_cb_fields verwaltet die Übersetzung von ContentBlocks-Feldern. Die ersten drei Felder basieren auf der Standardfeldkonfiguration, die mit ContentBlocks installiert werden kann. Ein Feldinhalt kann direkt mit dem Typ text zur Übersetzung freigegeben werden. Ein bestehendes oder zusätzliches Textfeld in einem ContentBlocks-Feld kann mit dem Typ single oder grid im Array fields für die Übersetzung freigegeben werden. Ein Repeater kann mit dem Typ repeater für die Übersetzung freigegeben werden. ContentBlocks Felder innerhalb eines Repeaters werden mit dem Schlüssel des jeweiligen Feldes zur Übersetzung freigegeben.

Je nach ContentBlocks Feldtyp ist der Typ text, single oder grid zu verwenden.

Die folgenden ContentBlocks Felder sind vom Typ Text:

• code
• heading
• link
• quote
• richtext
• textarea
• textfield

Die folgenden ContentBlocks-Felder sind vom Typ single:

• image_with_title

Die folgenden ContentBlocks-Felder sind vom Typ grid:

• gallery
• list
• ordered_list
• table
• file

Das folgende JSON enthält alle Beispiele für die Felder in der Standardkonfiguration von ContentBlocks (fehlende Nummern können nicht übersetzt werden):

{
  "0": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "1": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "3": {
    "type": "grid",
    "nested": "value",
    "fields": [
      "*"
    ]
  },
  "4": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "5": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "6": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "8": {
    "type": "single",
    "fields": [
      "title"
    ]
  },
  "9": {
    "type": "grid",
    "nested": "images",
    "fields": [
      "title"
    ]
  },
  "10": {
    "type": "grid",
    "nested": "items",
    "fields": [
      "value"
    ]
  },
  "11": {
    "type": "grid",
    "nested": "items",
    "fields": [
      "value"
    ]
  },
  "12": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "13": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "14": {
    "type": "text",
    "fields": [
      "value"
    ]
  },
  "16": {
    "type": "grid",
    "nested": "files",
    "fields": [
      "title"
    ]
  },
  "17": {
    "type": "layout"
  }
}

Wenn Sie die Standardkonfiguration eines Feldes verwenden möchten, müssen Sie lediglich die Feld-ID gefolgt von einem leeren Objekt hinzufügen. BabelTranslate kümmert sich um den Rest:

{
  "1": {
  }
}

Wenn Sie die Settings eines Feldes übersetzen möchten, dann können Sie die Felder der Settings in einem settings array übergeben:

{
  "8": {
    "fields": [
      "title"
    ],
    "settings": [
      "<setting name>"
    ]
  }
}

Repeater

Wenn Sie alle Felder in Repeater-Zeilen übersetzen wollen, müssen Sie nur den Typ repeater in der Feldkonfiguration hinzufügen:

{
  "<field-id>": {
    "type": "repeater"
  }
}

Ausgewählte Textfelder in Repeater-Zeilen

Wenn Sie ausgewählte Textfelder in Repeater-Zeilen übersetzen wollen, müssen Sie die Feldnamen in das Array repeater der Feldkonfiguration aufnehmen. Die anderen Felder bleiben unübersetzt:

{
  "<field-id>": {
    "type": "repeater",
    "repeater": [
      "<text_field_1_name>",
      "<text_field_2_name>"
    ]
  }
}

ContentBlocks-Eingabetyp in Repeater-Zeilen

Wenn Sie einen ContentBlocks-Eingabetyp (außer Repeater und Layout) in Repeater-Zeilen übersetzen wollen, können Sie jedes Feld im Konfigurations-Array repeater konfigurieren (in diesem Fall einen File-Eingabetyp). Wenn Sie das Konfigurations-Array weglassen, erkennt BabelTranslate die Eingabetypen automatisch und übersetzt jedes Textfeld darin:

{
  "<field-id>": {
    "type": "repeater",
    "repeater": {
      "file": {
        "type": "grid",
        "nested": "files",
        "fields": [
          "title"
        ]
      }
    }
  }
}

ContentBlocks-Repeater-Eingabetyp in Repeater-Zeilen

Wenn Sie einen ContentBlocks-Repeater-Eingabetyp in Repeater-Zeilen übersetzen möchten, können Sie die Textfelder im rows Array repeater im Konfigurations-Array konfigurieren. Wenn Sie das Konfigurations-Array weglassen, erkennt BabelTranslate dies automatisch und übersetzt jedes Textfeld darin:

{
  "<field-id>": {
    "type": "repeater",
    "repeater": {
      "<nested_repeater_name>": {
        "type": "repeater",
        "rows": [
          "<nested_text_field_name>"
        ]
      }
    }
  }
}

ContentBlocks-Layout-Eingabetyp in Repeater-Zeilen

Wenn Sie einen ContentBlocks-Layout-Eingabetyp in Repeater-Zeilen übersetzen möchten, können Sie das verschachtelte Layout im repeater Konfigurations-Array konfigurieren. Die Felder im verschachtelten Layout müssen eigenständig mit ihrer Feldkonfiguration konfiguriert werden und können nicht innerhalb dieser Konfiguration konfiguriert werden. Wenn Sie die Konfiguration des verschachtelten Layouts weglassen, wird es von BabelTranslate automatisch erkannt:

{
  "<field-id>": {
    "type": "repeater",
    "repeater": {
      "<nested_layout_name>": {
        "type": "layout"
      }
    }
  }
}

ContentBlocks Layout-Einstellungen

Die folgende Beispiel-Systemeinstellung in babeltranslate.translate_resource_cb_layouts verwaltet die Übersetzung von ContentBlocks-Layout-Einstellungen.

{
  "<layout-id>": {
    "settings": [
      "<setting_name>"
    ]
  }
}

Wenn setting die Zeichenkette "*" enthält, werden alle Einstellungen dieses Layouts übersetzt.

{
  "<layout-id>": {
    "settings": "*"
  }
}

Template-Variablen

Die folgende Beispiel-Systemeinstellung in babeltranslate.translate_resource_tvs verwaltet die Übersetzung von Template-Variablenfeldern. Der Inhalt einer Template-Variablen kann direkt mit dem Typ text zur Übersetzung freigegeben werden. Eine bestehende verschachtelte Template-Variable Text kann mit dem Typ single oder grid im fields-Array zur Übersetzung freigegeben werden. Eine benutzerdefinierte Template-Variable kann mit dem Typ custom und einem Plugin im Ereignis OnBabelTranslateCustomTV für die Übersetzung freigegeben werden.

Je nach Typ der Template-Variable ist der Typ text, single oder grid zu verwenden.

Die meisten Template-Variablen-Typen sind vom Typ text.

Die folgenden Template-Variablen-Typen sind vom Typ single:

• imageplus

Die folgenden Template-Variablen-Typen sind vom Typ grid:

• grid

{
  "rte": {
    "type": "text"
  },
  "migx": {
    "type": "grid",
    "fields": [
      "title",
      "description"
    ]
  },
  "imageplus": {
    "type": "single",
    "fields": [
      "title",
      "description"
    ]
  },
  "special": {
    "type": "custom"
  }
}