Dokumentation
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.
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.
<a href="#" data-alinio-lang="de">Deutsch</a>
<a href="#" data-alinio-lang="fr">Français</a>
<a href="#" data-alinio-lang="">English</a>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 im Glossar in den Einstellungen Ihrer Website eintragen; sie bleiben dann überall unverändert.
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.
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 can be read in several languages with the website translation service <a href="https://alinio.app">alinio</a>. The service is provided by Alinio, Johann-Adolf-Hasse-Straße 8G, 21493 Schwarzenbek. 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.</p>
<p>When a language is selected (by you, or automatically based on the language settings of your browser), the text of the page you are reading, the page path and the selected language are sent to alinio, which returns the translation. Texts that have not been translated before are translated by an AI translation provider commissioned by alinio; only the page text is passed on, no information about you. alinio does not set cookies and does not create user profiles.</p>
<p>The language switcher stores its settings and, once a language is selected, that language and the translations received in the local storage of your browser, so that further pages appear in your language straight away. This storage is strictly necessary to provide the language selection; you can delete it 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 kann mit dem Website-Übersetzungsdienst <a href="https://alinio.de">alinio</a> in mehreren Sprachen gelesen werden. Anbieter ist Alinio, Johann-Adolf-Hasse-Straße 8G, 21493 Schwarzenbek. 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.</p>
<p>Wird eine Sprache ausgewählt (von Ihnen oder automatisch anhand der Spracheinstellungen Ihres Browsers), werden der Text der gelesenen Seite, der Pfad der Seite und die gewählte Sprache an alinio übermittelt, das die Übersetzung zurückliefert. Noch nicht übersetzte Texte werden von einem von alinio beauftragten KI-Übersetzungsdienst übersetzt; weitergegeben wird nur der Seitentext, keine Angaben zu Ihrer Person. alinio setzt keine Cookies und erstellt keine Nutzerprofile.</p>
<p>Der Sprachumschalter legt seine Einstellungen und, sobald eine Sprache ausgewählt ist, die gewählte Sprache und die erhaltenen Übersetzungen im lokalen Speicher (Local Storage) Ihres Browsers ab, damit weitere Seiten sofort in Ihrer Sprache erscheinen. Diese Speicherung ist für die Bereitstellung der 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.