Installieren Sie Linguise für die automatische Übersetzung auf PrestaShop

Inhaltsverzeichnis

Technische PrestaShop-Anforderungen

Die neuronale automatische Übersetzung, die mit PrestaShop erfordert die Verwendung des PHP‑Skripts (kann unten heruntergeladen werden). Um das Linguise‑Skript zu installieren, Sie’ll benötigen die folgenden Voraussetzungen:

  • PHP 8+ ausführen
  • Apache-, LiteSpeed-, NGINX- und IIS-Server
  • Aktivieren Sie die URL-Umschreibung über die PrestaShop-Konfiguration

Wie installiert man die PrestaShop-Übersetzung?

1. API-Schlüssel generieren

Nach Ihrer Verbindung zu Ihrem Linguise dashboard Sie’ll müssen zunächst eine neue Domain einrichten und ihre’ Einstellungen speichern, um den API‑Key zu erhalten.

Der API-Schlüssel ist erforderlich, um die Übersetzung auf Ihrer PrestaShop-Website zu aktivieren. Er prüft, welche Sprache auf welcher Domain aktiviert ist und ermöglicht die Generierung der neuronalen Übersetzungsseiten.

Kopieren Sie den API-Schlüssel und speichern Sie ihn in Ihrer Zwischenablage.

Schritt 2 von 2 ist erledigt. Sie können mit der Übersetzung beginnen!

Wenn Sie dann auf den Reiter „Script PHP“ klicken, erhalten Sie die Installationsanweisungen, die wir hier im Detail befolgen werden.

Ein Screenshot der Installationsanleitung für ein WordPress-Plugin, der die Schritte zur Installation von Social Proof auf einer Website zeigt.

2. Laden Sie das Linguise-Übersetzungsskript hoch und verbinden Sie es

Das Linguise-Übersetzungsskript muss auf den Server hochgeladen werden, auf dem PrestaShop installiert ist:

Nachdem das Skript heruntergeladen wurde, entpacken Sie es und laden Sie es in den Stammordner hoch, in dem das CMS installiert ist.

  • Stellen Sie sicher, dass es’ sich befindet auf der Root‑Ebene Ihrer Website (wo Ihre PrestaShop‑Dateien liegen)
  • Stellen Sie sicher, dass der Ordner seinen Standardnamen “linguise”
Verzeichnisauflistung eines Dateisystems mit Ordnern

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:

BesonderheitSQLiteMySQL
AufstellenSehr einfach (SQLite-Installation erforderlich)Serverkonfiguration erforderlich
LagerungEinzelnVerwaltet vom MySQL-Server
LeistungIdeal für kleine AppsBesser geeignet für große Systeme mit hohem Verkehrsaufkommen
AnwendungsfallLokale Apps, Tests, kleine WebsitesWebanwendungen, 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.

API-Schnittstelle

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.

Anzeigeschnittstelle
Erscheinungsbild-Oberfläche
Wir verstehen, dass die Konfiguration von URLs und Sprachumschaltern etwas technisch sein kann; aber gute Neuigkeiten! Wir bieten eine kostenlose Installation an

3. Sprach-URLs einrichten

Die URL‑Umleitung ist in PrestaShop normalerweise standardmäßig für SEO‑Zwecke aktiviert. Wenn das nicht der Fall ist, finden Sie die Einstellung unter Shop‑Parameter > Traffic und SEO > Friendly URL. Weitere Informationen in der offiziellen PrestaShop‑Dokumentation

Einstellungsseite für die Zwei-Faktor-Authentifizierung. Aktivieren Sie 2FA aus Sicherheitsgründen.

Die URL nach Sprache muss in der .htaccess konfiguriert werden. Kopieren Sie diesen Code einfach nach dem Code RewriteEngine onim Standard‑PrestaShop .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>
				
			

Abschließend sollte Ihre PrestaShop .htaccess-Datei etwa so aussehen:

PHP-Code mit Fehlermeldung auf dem Bildschirm
Wir verstehen, dass die Konfiguration von URLs und Sprachumschaltern etwas technisch sein kann; aber gute Neuigkeiten! Wir bieten eine kostenlose Installation an

4. Sprachumschalter aktivieren

Sie können nun alle Ihre übersetzten Seiten über die URL laden, zum Beispiel: www.shop.com/fr/

Erfassen Sie den Bildschirm einer Website mit einem Block persönlicher Texte

Der Sprachumschalter ist das Flaggen-Popup, um die gewünschte Sprache auszuwählen. Um es zu laden, müssen Sie den Code, der am Ende der Website-Konfiguration angegeben ist, in den Kopf Ihrer HTML-Seite kopieren. Der Flaggen-Sprachumschalter wird dann automatisch geladen.

Cookie-Einwilligungsbanner auf einer Website

Es muss im Seitenkopf geladen werden. In PrestaShop können Sie den Code in folgendes Verzeichnis kopieren: …/themes/your-theme/templates/_partials/head.tpl

Der Sprachumschalter wird standardmäßig oben rechts auf Ihrer Website angezeigt. Sie können ihn gerne nach Ihren Wünschen mit CSS anpassen.

Ein Dropdown-Menü zur Auswahl der Sprachen auf einer Website. Zu den verfügbaren Sprachen gehören Englisch, Deutsch, Griechisch, Spanisch, Französisch, Japanisch, Niederländisch, Russisch und Chinesisch.

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

Der Sprachumschalter kann über das Linguise-Dashboard > Einstellungen > Anzeige der Sprachflaggen angepasst werden. Jede Änderung hier wird auf der Website übernommen.

Ein Screenshot, der ein Dropdown-Menü zur Auswahl der Spracheinstellungen mit Optionen für Englisch zeigt.

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

Laden Sie den Sprachumschalter in PrestaShop-Inhalten

Flaggenposition an Ort und Stelle

Um den Sprachumschalter an der gewünschten Stelle im 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 Code unten, 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.

Lokales Cachesystem aktivieren

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.

Laravel-Übersetzungskonfigurationscodebeispiel. Konfiguration zum Einrichten von Übersetzungen.

Optional können Sie die Größe des im Cache gespeicherten Datenvolumens 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

Fügen Sie die Zeile, die Ihrem CMS entspricht, in Ihren NGINX-Serverkonfigurationsblock ein.
Sie sollte vor allen anderen Weiterleitungen eingerichtet werden, insbesondere vor der Weiterleitung in Ihrer PHP-Hauptdatei.
				
					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;