Inhaltsverzeichnis
Technische Anforderungen von Craft CMS
Die für Craft CMS zu verwendende neuronale automatische Übersetzung erfordert die Nutzung des PHP-Skripts (kann unten heruntergeladen werden). Für die Installation des Linguise-Skripts benötigen Sie die folgenden Voraussetzungen:
- Führen Sie PHP 7+ aus
- Apache-, LiteSpeed-, NGINX- und IIS-Server
- Stellen Sie sicher, dass die URL-Umschreibung auf Ihrem Server aktiviert ist
- Craft CMS 3 oder 4 und höher
- Typischerweise ist das Stammverzeichnis von Craft CMS’s auf “/web” Ordner.
1. API-Schlüssel generieren
Nach Ihrer Verbindung oder Registrierung zu Ihrem Linguise-Dashboard, Sie’ll müssen zuerst eine neue Domain einrichten und deren Einstellungen speichern, um den API-Schlüssel zu erhalten.
Wählen Sie einfach die Craft CMS-Plattform aus, um den richtigen Link zu dieser Dokumentation sowie zu den Quell- und Zielsprache zu erhalten.
Danach erhalten Sie:
- Der API-Schlüssel, der Ihre Mitgliedschaft bestätigt
- Der Link zum Linguise-Skript für den Sprachumschalter
Der API-Schlüssel ist erforderlich, um die Übersetzung auf Ihrer Craft CMS-Website zu aktivieren. Im Grunde prüft der API-Schlüssel, welche Sprache auf Ihrer Domain aktiviert ist, und ermöglicht die automatische Übersetzung des Inhalts.
Sie können den API-Schlüssel vorerst kopieren und in Ihrer Zwischenablage speichern.
2. Laden Sie das Linguise-Übersetzungsskript hoch und verbinden Sie es
Das Linguise-Übersetzungsskript muss auf Ihrem Server hochgeladen werden, auf dem Craft CMS installiert ist:
Nachdem das Skript heruntergeladen wurde, entpacken Sie es und laden Sie es in den Stammordner hoch, in dem Craft CMS installiert ist.
- Stellen Sie sicher, dass es’s an der Root-Ebene Ihrer Website (wo Ihre Craft CMS-Dateien gespeichert sind, standardmäßig befindet es’s innerhalb /web Ordner)
- Stellen Sie sicher, dass der Ordner seinen Standardnamen behält “linguise”
Wie greife ich auf die Linguise-Skriptschnittstelle zu?
Nach Abschluss der Linguise-Installation können Sie über Ihre Website mit folgender URL auf das Dashboard zugreifen:
https://www.domain.com/linguise
Ändern Sie die Domainadresse entsprechend Ihrer Website-Adresse.*
Stellen Sie sicher, dass Linguise über die erforderlichen Lese- und Schreibrechte verfügt.*
Passwort und Datenbankverbindung einrichten
Sobald Sie auf die Skriptschnittstelle zugreifen, wird Ihnen ein Einrichtungsbildschirm angezeigt, auf dem Sie ein Passwort erstellen und eine Verbindung zu Ihrer bevorzugten Datenbank herstellen können.
Du kannst:
- Legen Sie ein Passwort fest, das für den zukünftigen Zugriff auf diese Benutzeroberfläche erforderlich ist.
- Wählen Sie Ihren Datenbanktyp – entweder MySQL oder SQLite, je nach Ihren Einstellungen und Präferenzen.
Diese Ersteinrichtung gewährleistet einen sicheren Zugriff und ermöglicht es Ihnen, das Skript an Ihre Umgebung anzupassen.
MySQL-Datenbankverbindung
Wenn Sie MySQL auswählen, erscheint eine andere Benutzeroberfläche, auf der Sie nach den folgenden Verbindungsdetails der MySQL-Konfigurationsfelder gefragt werden:
Stellen Sie sicher, dass die Informationen korrekt sind, um eine erfolgreiche Verbindung zu Ihrer MySQL-Datenbank herzustellen.
MySQL vs SQLite – Was ist der Unterschied?
Sowohl MySQL als auch SQLite sind beliebte Datenbanksysteme, die zum Speichern und Verwalten von Daten für Websites und Anwendungen verwendet werden. Sie sind jedoch für unterschiedliche Anwendungsfälle konzipiert und weisen einige wichtige Unterschiede auf:
| Besonderheit | SQLite | MySQL |
|---|---|---|
| Aufstellen | Sehr einfach (SQLite-Installation erforderlich) | Serverkonfiguration erforderlich |
| Lagerung | Einzeln | Verwaltet vom MySQL-Server |
| Leistung | Ideal für kleine Apps | Besser geeignet für große Systeme mit hohem Verkehrsaufkommen |
| Anwendungsfall | Lokale Apps, Tests, kleine Websites | Webanwendungen, E-Commerce, Unternehmenssysteme |
Linguise Script Interface: Einrichtung für die PHP-Plattform
Das Linguise-Übersetzungs-Dashboard, das bisher nur für Joomla und WordPress verfügbar war, unterstützt nun auch PHP und weitere Plattformen. Dank dieses Updates können Benutzer Spracheinstellungen – wie Anzeigeoptionen, Flaggenstile und Erscheinungsbildanpassungen – unabhängig von ihrem CMS oder Framework nahtlos über eine einheitliche Oberfläche konfigurieren.
Administratoren können die Linguise-Einstellungen effizienter verwalten, dank einheitlicher Funktionen wie Sprachauswahl-Popups, Schatteneffekten und regionsspezifischen Flaggenvarianten. Das Dashboard behält sein benutzerfreundliches Design bei und bietet gleichzeitig eine breitere Kompatibilität für verschiedene Webumgebungen.
3. Einrichtung der URL-Umschreibung für Craft CMS
Standardmäßig ist die URL-Umschreibung in Craft CMS aktiv. Wenn das’s nicht der Fall ist, können Sie sie bei Ihrem Hosting-Anbieter aktivieren.
Die URL nach Sprache muss in der .htaccess konfiguriert werden. Kopieren Sie einfach den untenstehenden Code nach dem Code “RewriteEngine on” verfügbar im Standard- Craft CMS .htaccess.
<IfModule mod_rewrite.c>RewriteEngine auf RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|f i|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky| lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|s d|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_lingual=$1&original_url=$2 [L,QSA]</IfModule>
Schließlich sollte Ihre Craft CMS .htaccess etwa so aussehen:
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA] # Sende mögliche 404-Anfragen an Craft RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC] RewriteRule (.+) index.php?p=$1 [QSA,L] </IfModule>
Sie können nun alle Ihre übersetzten Seiten über die URL laden, zum Beispiel:www.shop.com/fr/
Laden wir nun den Sprachumschalter.
4. Sprachumschalter aktivieren
4.1 Laden Sie das Linguise JS-Skript
Der Linguise‑JS‑Skript‑Link muss auf allen Ihren Craft‑CMS‑Seiten geladen werden, um den Sprachumschalter mit Flaggen und alternativen URLs in Ihren HTML‑Headern anzuzeigen (für SEO‑Zwecke).
Um den Skriptlink zu kopieren, gehen Sie im Linguise-Dashboard zu den Domäneneinstellungen und kopieren Sie den Skriptlink.
Der einfachste Weg, diesen Code in Craft CMS zu laden, besteht darin, ihn zu Ihrem Vorlagen‑Index hinzuzufügen. Öffnen Sie das /template Ordner und bearbeiten Sie die Indexdatei, um den Skript‑Link im Header‑Abschnitt einzufügen.
Der Sprachumschalter ist das Auswahlfenster, in dem Sie die gewünschte Sprache auswählen können. Um ihn zu laden, müssen Sie den Code am Ende der Website-Konfiguration in den Head-Bereich Ihrer HTML-Seite kopieren. Der Sprachumschalter wird dann automatisch geladen.
Der Sprachumschalter wird standardmäßig oben rechts auf Ihrer Website angezeigt. Sie können ihn, wie im nächsten Kapitel beschrieben, anpassen.
SEO wichtige Anmerkung: Die Anzahl der von Ihnen eingerichteten Sprachen hat einen großen Einfluss auf SEO. Wenn Sie Ihre Übersetzungssprachen einrichten und Sie eine große Menge indizierter Seiten (>500) haben, kann die Suchmaschine viel Zeit benötigen, um sie zu verarbeiten. Es kann Ihr SEO in Ihrer Originalsprache beeinträchtigen. Das’s warum wir empfehlen, zunächst maximal 5 Sprachen hinzuzufügen, dann, wenn es’s indiziert, können Sie Sprachen in einer Charge von 3 pro Monat hinzufügen.
Sprachumschalter einrichten
Die Sprachauswahl kann im Linguise-Dashboard unter „Einstellungen“ > „Sprachflaggenanzeige“ angepasst werden. Jede hier vorgenommene Änderung wird auf der Website angezeigt.
Auf der rechten Seite des Bildschirms sehen Sie die Vorschau des Sprachumschalters. Folgende Elemente können Sie einstellen:
- 3 Layouts: nebeneinander, Dropdown oder Popup
- Die Sprachumschalterposition
- Der Sprachumschalterinhalt
- Sprachbezeichnungen in Englisch oder in der jeweiligen Muttersprache
- Flaggenformen und -größen
- Farben und Schlagschatten
Lade den Sprachumschalter im Craft CMS-Inhalt
Um den Sprachumschalter an der gewünschten Stelle im Craft CMS-Inhalt anzuzeigen, sollten Sie die Position auf “In place” setzen.
Nachdem Sie die Position im Linguise-Dashboard festgelegt haben, können Sie den untenstehenden Shortcode hinzufügen, um ihn einzubinden. Klicken Sie auf den untenstehenden Code, um ihn in die Zwischenablage zu kopieren.
<div>[linguise]</div>
Sobald der Code hinzugefügt wurde, werden Ihnen im Frontend die Flagge und die Sprachnamen in dem HTML-Bereich angezeigt, in dem Sie den Code eingefügt haben.
Aktivieren Sie die Option „Lokales Cache-System“
Optional können Sie ein lokales Cachesystem aktivieren, das URLs und die zugehörigen mehrsprachigen Inhalte speichert, um die Seiten schneller auszuliefern. Der lokale Cache reduziert den Datentransfer zwischen dem Linguise-Server und Ihrem Webserver. Er wird nur verwendet, wenn eine Seite bereits übersetzt und nicht aktualisiert wurde. Priorität hat der Cache der am häufigsten aufgerufenen mehrsprachigen Seiten.
Ergänzend dazu können Sie die Größe des im Cache gespeicherten Speichers in MB festlegen. Im folgenden Beispiel ist der Cache aktiviert und die Größe des zu speichernden Caches beträgt 500 MB.
/** Grundkonfiguration **/ public $cache_enabled = true; public $cache_max_size = 500; // In Megabyte
Automatische Übersetzung auf Windows IIS-Servern
Fügen Sie die Zeile, die Ihrem Website-Builder entspricht, in Ihre Web.config-Datei ein.
Sie sollte vor allen anderen Weiterleitungen, insbesondere der Weiterleitung zu Ihrer PHP-Hauptdatei, eingefügt werden:
<rule name="Linguise" stopProcessing="true"> <match url="^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$" ignoreCase="false" /> <conditions logicalGrouping="MatchAll" trackAllCaptures="false" /> <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" /> </rule>
Automatische Übersetzung auf NGINX-Servern
umschreiben ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl| fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky| lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 last;