DeepL Integration verwenden

Ab Version 8.12.0 verfügt das zCMS über eine Übersetzungsschnittstelle zu DeepL. Mit Hilfe der Schnittstelle können Seiten, Nachrichten, Termine, Ordner und individuelle Seiten mit einem Klick in über 20 Sprachen automatisch übersetzt werden.

 

Aktivieren von DeepL

Sie benötigen für die Nutzung der DeepL Schnittstelle mindestens ein kostenloses DeepL API Konto und einen Authentifizierungsschlüssel für die DeepL-API. Diesen finden Sie in Ihrem DeepL API Konto unter deepl.com/pro-api.

 

 

Rufen Sie "Administration => Einstellungen => Allgemein" auf und scrollen Sie dann zu "DeepL Übersetzungen".

 

Aktivieren Sie dort die DeepL Schnittstelle, wählen Sie die Art Ihres DeepL API Kontos aus (ein normales DeepL Konto reicht nicht aus!) und tragen Sie dann den Authentifizierungsschlüssel ein, welche Sie in Ihrem DeepL API Konto finden.

 

 

Verwenden von DeepL im zCMS Assistenten

Öffnen Sie eine Seite, Nachricht, Termin, individuelle Seite oder einen Ordner und wechseln Sie in die neue Sprache. Fügen Sie dort den Text in der Originalsprache hinzu. Verwenden Sie dazu am besten die Kopierfunktion ("Kopieren der Inhalte der Standardsprache in die Sprachversion ...) oben auf der Seite. 

Nach dem Sie den Originalinhalt hinzugefügt haben, finden Sie vor den Metainformationen den Hinweis der DeepL Schnittstelle:

 

 

In dem Screenshot befinden Sie sich in der dänischen Sprachversion der Seite und können mit Klick auf "Ja" die Inhalte automatisch in dänisch übersetzen. Nachdem Sie auf "Ja" geklickt haben und alle Übersetzungen im Hintergrund ausgeführt wurden erhalten Sie eine Erfolgsmeldung:

 

 

Alle Textfelder und HTML Editoren wurden auf der Seite automatisch mit den neuen dänischen Texten ersetzt. Jetzt müssen Sie die Seite nur noch speichern!

Multi-Sprachen Assistent aktivieren

Du kannst im zCMS den Dateiassistenten so einstellen, dass du alle Sprachversionen in einem Assistenten erstellen oder bearbeiten kannst. Wähle dazu unter "Administration -> Einstellungen -> Allgemein" unter "Dateiassistent" den Eintrag "Multi-Sprachen" aus und speichere die neuen Einstellungen. Danach steht Dir beim Bearbeiten der neue Assistent zur Verfügung.

 

ZIP Version

Der "Mult-Sprachen" Datei Assistent gibt Dir auch die Möglichkeit eine ZIP-Datei mit mehreren Dateien, für die unterschiedlichen Sprachen, auf einmal hochzulanden. Dazu müssen die einzelnen Dateien nach folgendem Schema benannt werden:

 

Aufbau Dateiname
SPRACHE_DATEINAME.DATEIENDUNG

 

Beispiel mit deutscher und englischer Datei:
001_header.jpg
002_header.jpg

 

 

ZIP Version mit JSON _meta.json Datei

Wenn Du in der ZIP Datei einen "_meta.json" Datei hinzufügst, kannst Du auch alle Daten für jede Sprachversion direkt hochladen. Die JSON Datei hat folgenden Aufbau:

 

{

  "001" : {

  "file" : "DATEINAME",

  "title" : "TITEL*",

  "desc" : "BESCHREIBUNG",

  "html" : "HTML-BESCHREIBUNG",

  "hyperlink" : "HYPERLINK",

  "date" : "DATUM",

  "docType" : "DOKUMENTEN-TYP",

  "languages" : ["de","en","nl"]

},

  "002" : {

  "file" : "DATEINAME",

  "title" : "TITEL*",

  "desc" : "BESCHREIBUNG",

  "html" : "HTML-BESCHREIBUNG",

  "hyperlink" : "HYPERLINK",

  "date" : "DATUM",

  "docType" : "DOKUMENTEN-TYP",

  "languages" : ["de","en","nl"]

},

...

}

 

Mit diesen Daten werden automatisch die Felder "Titel", "Beschreibung", usw. mit den Werten der JSON Datei gespeichert.

Du kannst im zCMS jede Seite mit einer eigenen "sprechenden URL" hinterlegen. Normalerweise erstellt das zCMS URL Adressen automatisch nach dem folgenden Schema:

 

DOMAIN/SPRACHE/ID/TITEL.htm

 

Hier ein Beispiel dazu:

Wenn wir eine Seite mit dem Titel "Kontakt" auf der Domain www.newcms.de in "Deutsch" erstellen und diese Seite hat die Objekt ID "34", dann würde die automatische URL wie folgt aussehen:

 

https://www.newcms.de/de/34/kontakt.htm

 

Gegen diese URL ist nicht viel auszusetzen. Schöner wäre es aber, wenn die ID "134" nicht vorhanden wäre. Da kommen die "sprechenden URLs" in Spiel. Bei jedem Ordern oder einer Seite kannst du im Bearbeitungsmodus des Objektes im Feld "SPRECHENDE URL" deine eigene URL erstellen. Dabei hast du aber nur Zugriff auf den Bereich nach der "DOMAIN" und der "SPRACHE". Beachte dabei bitte auch die Regeln und Beschränkungen der Funktion, die unten in dem Beiträg aufgelistet sind.

 

 

Wenn du im Feld "SPRECHENDE URL" also in unserem Beispiel "kontakt.htm" einträgst, dann lautet die URL für die Seite jetzt:

 

https://www.newcms.de/de/kontakt.htm

 

Bitte beachtet auch, dass das "/de" in unseren Beispielen nur vorhanden ist, wenn Ihr unter "Administration -> Einstellungen -> Allgemein" die Option "Prefix für Sprachen aktivieren" eingeschaltet hat. Dies ist bei einsprachigen Auftritten nicht notwendig. Bei mehrsprachigen Auftritten aber Pflicht!

 

Ordnerstruktur ab 8.5

Seit der Version 8.5 können bei den "sprechenden URLs" auch Ordnerstrukturen erstellt werden. Zeigen wir die Möglichkeiten am besten an einem Beispielen:

 

Du hast einen Produktordner mit mehreren Produkten und möchtest gerne URLs wie https://www.newcms.de/de/produkte/taschenuhr.htm und https://www.newcms.de/de/produkte/armbanduhr.htm erstellen. Dafür trägst du bei "SPRECHENDE URL" einmal "produkte/taschenuhr.htm" und "produkte/armbanduhr.htm" ein. Der Teil "produkte" kann überall auch anders sein und hat nichts mit dem vielleicht vorhandenen Ordner "Produkte" zu tun. Jede "sprechende URL" ist komplett eigenständig. Dadurch hast du alle Freiheiten bei der Benennung Deiner "sprechenenden URLs".

 

Wichtige Hinweise

Für "sprechende URLs" gibt es feste Regeln. Nur dann funktionieren diese. Weiterhin ist es bei der Nichteinhaltung der Regeln möglich, dass Teile oder der gesamte Internetauftritt nicht mehr richtig erreichbar ist. Daher achtet bitte sehr darauf, diese Regeln einzuhalten:

 

1. Jede "sprechende URL" muss unique sein. Die gleiche "sprechende URL" darf nicht noch einmal verwendet werden. Auch nicht in einer anderen Sprachversion.
2. Eine "sprechende URL" darf nicht mit "/" beginnen.
3. Es dürfen/sollten in einer sprechenden URL keine Sonderzeichen oder Umlaute verwendet werden.
4. Zwischen zwei "/"und am Anfang darf keine reine Zahlenreihe stehen.
   123/produkte/armbanduhr.htm => FEHLER
produkte/123/armbanduhr.htm => FEHLER
produkte/armbanduhr123.htm => RICHTIG
5. Es dürfen keine Leerzeichen in einer "sprechenden URL vorhanden sein.
   produkte/damen uhr.htm => FEHLER
produkte/damen-uhr.htm => RICHTIG
6. Jede "sprechende URL" muss ein Dateiendung haben. Wir empfehlen .htm oder .html.
   produkte/armbanduhr => FEHLER
produkte/armbanduhr.htm => RICHTIG
7. Vermeiden Sie Groß- und Kleinschreibung. Wir empfehlen die gesamte "sprechende URL" klein zu schreiben.