Widget-Referenz
Alles, was Sie brauchen, um eine Website mehrsprachig zu machen, den Sprachumschalter anzupassen und festzulegen, was übersetzt wird.
Installation
Legen Sie Ihre Website im Dashboard an und fügen Sie anschließend ihr Snippet in den <head> jeder Seite ein, am besten möglichst weit oben:
<script src="https://alinio.de/widget.js" data-key="YOUR_SITE_KEY"></script>
Wird das Skript ohne defer im <head> geladen, sehen wiederkehrende Besucherinnen und Besucher ihre Sprache, bevor die Seite zum ersten Mal dargestellt wird. Das Skript ist klein und wird vom Browser zwischengespeichert. Alternativ funktionieren auch defer oder async; die Seite erscheint dann kurz in ihrer Originalsprache.
Plugins für WordPress, Drupal und andere Systeme
Mit einem Plugin brauchen Sie kein Snippet. Kopieren Sie den geheimen Schlüssel aus dem Kasten „Plugins“ Ihrer Website im Dashboard in die Plugin-Einstellungen. Das Plugin bringt eine eigene Kopie des Widgets mit und fragt alinio von Ihrem Webserver aus an. Der Schlüssel erscheint deshalb nie in Ihren Seiten, und die Browser Ihrer Besucherinnen und Besucher verbinden sich nie mit alinio. Ihr Server sendet den Seitentext, den Pfad der Seite und die Sprache. IP-Adressen, Browserdaten und Cookies Ihrer Besucherinnen und Besucher erreichen alinio nicht.
Schritt für Schritt: alinio in WordPress einrichten.
Geben Sie den geheimen Schlüssel nicht weiter: Er funktioniert von jedem Server aus, die erlaubten Domains gelten für ihn nicht. Ist er bekannt geworden, erstellen Sie in den Einstellungen der Website einen neuen und tragen ihn im Plugin ein.
Andere Systeme binden Sie genauso an. Ihr Server sendet Authorization: Bearer IHR_GEHEIMER_SCHLÜSSEL an https://alinio.de/api/v1/server/config, /api/v1/server/translations/{lang}?path=… und /api/v1/server/translate/{lang} und liefert das Widget mit data-endpoint statt data-key aus. Das Widget ruft diesen Endpunkt dann mit ?op=config, ?op=translations&lang=…&path=… und ?op=translate&lang=… auf.
Optionen
Das Widget konfigurieren Sie über Attribute am Script-Tag:
| Attribut | Werte | Zweck |
|---|---|---|
data-key | Ihr Website-Schlüssel | Pflichtangabe. Identifiziert Ihre Website. |
data-position | bottom-right, bottom-left, top-right, top-left, inline, none | Wo der Umschalter erscheint. Hat Vorrang vor der Einstellung im Dashboard. none blendet ihn aus, etwa wenn Sie einen eigenen bauen. |
data-container | CSS-Selektor | Zeigt den Umschalter in diesem Element an statt schwebend über der Seite, z. B. #language. Ein Element mit der Klasse website-translator wird automatisch verwendet. |
data-de, data-fr, … | URL | Sie haben für diese Sprache bereits eine eigene Website: Wer sie auswählt, wird dorthin weitergeleitet, statt dass die Seite an Ort und Stelle übersetzt wird, z. B. data-de="https://www.example.de/". |
Über Links lässt sich eine Seite mit dem Parameter alinio_lang direkt in einer bestimmten Sprache öffnen, z. B. https://www.example.com/?alinio_lang=fr. Der Parameter wird aus der Adresszeile entfernt und die Auswahl gespeichert.
Eigene Sprachschaltflächen
Jedes Element mit dem Attribut data-alinio-lang wird zu einer Sprachschaltfläche. Ein leerer Wert schaltet zurück zur Originalsprache. Das Attribut aria-pressed wird laufend aktualisiert, sodass Sie es für die Gestaltung nutzen können.
<button type="button" data-alinio-lang="de">Deutsch</button>
<button type="button" data-alinio-lang="fr">Français</button>
<button type="button" data-alinio-lang="">English</button>
Einfache und Leichte Sprache
Jede Sprache, auch die Originalsprache Ihrer Website, können Sie zusätzlich in zwei vereinfachten Fassungen anbieten, für alle, denen der Originaltext schwerfällt. Sie wählen sie in den Einstellungen Ihrer Website in den Reitern Einfache Sprache und Leichte Sprache aus; jede Fassung zählt als eine Sprache Ihres Tarifs.
| Fassung | Code | Für wen |
|---|---|---|
| Einfache Sprache | de-x-plain, en-x-plain, … | Für alle: kurze Sätze, Alltagswörter, Fachbegriffe werden erklärt. Alle Informationen bleiben erhalten. |
| Leichte Sprache | de-x-easy, en-x-easy, … | Für Menschen mit Lernschwierigkeiten oder sehr geringen Sprachkenntnissen: eine Aussage pro Satz, die einfachsten Wörter, schwierige Wörter werden erklärt. Sie können diese Texte jederzeit prüfen lassen, zum Beispiel von Menschen aus der Zielgruppe, und im Übersetzungseditor korrigieren. |
Die Codes funktionieren überall, wo ein Sprachcode erwartet wird, zum Beispiel für einen Link im Kopfbereich Ihrer Website:
<button type="button" data-alinio-lang="de-x-easy">Leichte Sprache</button>
Die automatische Spracherkennung wählt nie eine vereinfachte Fassung; Besucher wählen sie selbst aus.
Inhalte von der Übersetzung ausnehmen
Kennzeichnen Sie Elemente mit dem Standardattribut translate="no" oder der Klasse notranslate. Codeblöcke, Formularfelder, Skripte und Styles werden nie übersetzt. Markennamen und andere Begriffe können Sie außerdem in den Einstellungen Ihrer Website unter „Erweitert“ bei „Nicht übersetzen“ eintragen; sie bleiben dann überall unverändert.
Zahlen, Datums- und Uhrzeitangaben am Ende eines Textes werden nicht übersetzt: Läuft ab in 20:33
wird einmal als Läuft ab in
übersetzt, und dahinter bleibt der Wert, den Ihre Seite gerade zeigt, wie oft er sich auch ändert. Zahlen an anderen Stellen gehören zur Übersetzung; kennzeichnen Sie sie mit translate="no", wenn sie sich ändern.
JavaScript-API
Das Widget stellt window.alinio bereit:
alinio.setLanguage('fr') | Übersetzt die Seite in eine Sprache, die für Ihre Website aktiviert ist. |
alinio.restore() | Zeigt wieder die Originalsprache an. |
alinio.language | Der aktuelle Sprachcode oder null für die Originalsprache. |
alinio.refresh() | Übersetzt Inhalte, die Sie eingefügt haben, ohne dass dabei DOM-Mutationen ausgelöst wurden (selten nötig). |
Ereignisse werden auf document ausgelöst: alinio:change, wenn sich die Sprache ändert, und alinio:status mit detail.state busy, done oder error.
Content Security Policy
Wenn Ihre Website einen Content-Security-Policy-Header sendet, erlauben Sie darin das Skript und seine API-Anfragen:
script-src … https://alinio.de;
connect-src … https://alinio.de;
Erlaubte Domains
Neue Übersetzungen werden nur für Anfragen von den Domains erstellt, die in den Einstellungen Ihrer Website eingetragen sind. Tragen Sie jede Domain ein, über die Ihre Seiten ausgeliefert werden, auch Staging-Domains. *.example.com erlaubt alle Subdomains.
Neue Texte prüfen wir zusätzlich gegen Ihre Seite. Bevor alinio einen Text zum ersten Mal übersetzt, ruft es die Seite von Ihrer Website ab (User-Agent alinio-pagecheck) und übersetzt nur die Texte, die es im HTML findet. So kann niemand Ihren Website-Schlüssel für eigene Texte verwenden. Texte, die JavaScript nach dem Laden einfügt, stehen nicht in diesem HTML. alinio übersetzt sie trotzdem, wenn sie zur Seite gehören: wenn der Rest der Seite zum HTML passt oder wenn es die Texte in den Skripten findet, die Ihre Website mit der Seite ausliefert. Für solche Texte gilt eine Tagesmenge an neuem Text pro Seite und pro Website. Bei einer großen Website, die ihre Seiten mit JavaScript aufbaut, kann es deshalb einige Tage dauern, bis jeder Text übersetzt ist. Seiten hinter einem Login kann alinio nicht abrufen. Nutzen Sie dafür, oder wenn Sie alles sofort brauchen, ein Plugin oder die Server-API, oder schreiben Sie uns, dann schalten wir die Prüfung für Ihre Website aus. Blockiert eine Firewall oder ein Bot-Schutz unbekannte Clients, geben Sie den User-Agent alinio-pagecheck frei.
Datenschutzerklärung
Besucherinnen und Besucher müssen darüber informiert werden, was der Sprachumschalter übermittelt und speichert. Übernehmen Sie diesen Abschnitt in Ihre Datenschutzerklärung. Er ist eine Vorlage und keine Rechtsberatung. Passen Sie ihn an Ihre Website an.
Englisch
<h3>Website translation with alinio</h3>
<p>This website uses the translation service <a href="https://alinio.app">alinio</a>. When you open a page, your browser loads the alinio script and the language settings of this website from the servers of alinio; as with every request to a web server, your IP address and technical request data (time, requested address, browser type) are transmitted. When a language is selected (by you, or automatically based on your browser's language settings), the page text, the page path and the selected language are also transmitted. alinio sets no cookies and creates no user profiles.</p>
<p>The language switcher stores its settings, the selected language and translations in the local storage of your browser. This is strictly necessary for the language selection; you can delete the data at any time in your browser settings.</p>
<p>We use alinio based on our legitimate interest in making our website available to visitors in their language (Art. 6 (1) (f) GDPR). alinio processes the data on our behalf (Art. 28 GDPR). More information: <a href="https://alinio.app/privacy">privacy policy of alinio</a>.</p>
Deutsch
<h3>Übersetzung der Website mit alinio</h3>
<p>Diese Website nutzt den Übersetzungsdienst <a href="https://alinio.de">alinio</a>. Beim Aufruf einer Seite lädt Ihr Browser das Skript von alinio und die Spracheinstellungen dieser Website von den Servern von alinio; wie bei jedem Abruf eines Webservers werden dabei Ihre IP-Adresse und technische Daten der Anfrage (Zeitpunkt, abgerufene Adresse, Browsertyp) übertragen. Wird eine Sprache ausgewählt (von Ihnen oder automatisch anhand der Spracheinstellungen Ihres Browsers), werden zusätzlich der Seitentext, der Pfad der Seite und die gewählte Sprache übermittelt. alinio setzt keine Cookies und erstellt keine Nutzerprofile.</p>
<p>Der Sprachumschalter speichert seine Einstellungen, die gewählte Sprache und Übersetzungen im lokalen Speicher (Local Storage) Ihres Browsers. Das ist für die Sprachauswahl unbedingt erforderlich (§ 25 Abs. 2 Nr. 2 TDDDG); Sie können die Daten jederzeit in den Einstellungen Ihres Browsers löschen.</p>
<p>Rechtsgrundlage ist unser berechtigtes Interesse, unsere Website Besucherinnen und Besuchern in ihrer Sprache zugänglich zu machen (Art. 6 Abs. 1 lit. f DSGVO). alinio verarbeitet die Daten in unserem Auftrag (Art. 28 DSGVO). Weitere Informationen: <a href="https://alinio.de/privacy">Datenschutzerklärung von alinio</a>.</p>
Englisch, mit einem Plugin
<h3>Website translation with alinio</h3>
<p>This website uses the translation service <a href="https://alinio.app">alinio</a>. When a language is selected (by you, or automatically based on your browser's language settings), our web server sends the page text, the page path and the selected language to alinio and receives the translations. Your browser does not connect to alinio: your IP address and the data of your browser are not transmitted to alinio. alinio sets no cookies and creates no user profiles.</p>
<p>The language switcher stores its settings, the selected language and translations in the local storage of your browser. This is strictly necessary for the language selection; you can delete the data at any time in your browser settings.</p>
<p>We use alinio based on our legitimate interest in making our website available to visitors in their language (Art. 6 (1) (f) GDPR). alinio processes the data on our behalf (Art. 28 GDPR). More information: <a href="https://alinio.app/privacy">privacy policy of alinio</a>.</p>
Deutsch, mit einem Plugin
<h3>Übersetzung der Website mit alinio</h3>
<p>Diese Website nutzt den Übersetzungsdienst <a href="https://alinio.de">alinio</a>. Wird eine Sprache ausgewählt (von Ihnen oder automatisch anhand der Spracheinstellungen Ihres Browsers), sendet unser Webserver den Seitentext, den Pfad der Seite und die gewählte Sprache an alinio und erhält die Übersetzungen zurück. Ihr Browser verbindet sich nicht mit alinio: Ihre IP-Adresse und die Daten Ihres Browsers werden nicht an alinio übertragen. alinio setzt keine Cookies und erstellt keine Nutzerprofile.</p>
<p>Der Sprachumschalter speichert seine Einstellungen, die gewählte Sprache und Übersetzungen im lokalen Speicher (Local Storage) Ihres Browsers. Das ist für die Sprachauswahl unbedingt erforderlich (§ 25 Abs. 2 Nr. 2 TDDDG); Sie können die Daten jederzeit in den Einstellungen Ihres Browsers löschen.</p>
<p>Rechtsgrundlage ist unser berechtigtes Interesse, unsere Website Besucherinnen und Besuchern in ihrer Sprache zugänglich zu machen (Art. 6 Abs. 1 lit. f DSGVO). alinio verarbeitet die Daten in unserem Auftrag (Art. 28 DSGVO). Weitere Informationen: <a href="https://alinio.de/privacy">Datenschutzerklärung von alinio</a>.</p>
Suchmaschinen
Die Übersetzungen werden im Browser angewendet, deshalb indexieren Suchmaschinen Ihre Originalsprache. Sollen übersetzte Seiten in den Suchergebnissen erscheinen, verwenden Sie eine eigene mehrsprachige Lösung.
Support
Fragen oder Probleme? Schreiben Sie uns.