Inhaltsverzeichnis
Technische Anforderungen Magento
Die neuronale automatische Übersetzung für Magento erfordert die Verwendung des PHP-Skripts (Download siehe unten). Zur Installation des Linguise -Skripts benötigen Sie folgende Voraussetzungen:
- Führen Sie PHP 7+ aus
- Apache-, LiteSpeed-, NGINX- und IIS-Server
- Aktivieren Sie die URL-Umschreibung über die Magento -Konfiguration
- Magento 2+
- Das Stammverzeichnis von Magento /pub “. Stellen Sie sicher, dass Linguise in diesem Ordner
API-Schlüssel generieren
Der API-Schlüssel ist erforderlich, um die Übersetzung auf Ihrer Magento -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.

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

Laden Sie das Linguise Übersetzungsskript hoch und verbinden Sie es
Das Linguise Übersetzungsskript muss auf den Server hochgeladen werden, auf dem Magento 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 im Stammverzeichnis Ihrer Website befindet (dort, wo sich Ihre Magento Dateien befinden; standardmäßig im Ordner /pub
- Stellen Sie sicher, dass der Ordner seinen Standardnamen „ linguise “

Wie greife ich auf Linguise -Skriptschnittstelle zu?
Nach Abschluss der Linguise
linguise 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 wesentliche Unterschiede auf:
| Funktion | SQLite | MySQL |
|---|---|---|
| Aufstellen | Sehr einfach (SQLite-Installation erforderlich) | Serverkonfiguration erforderlich |
| Speicher | 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 WordPressverfü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 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.


Zusätzliche Magento -Konfiguration
Gehen Sie in der Admin-Sidebar zu Stores > Einstellungen > Konfiguration > Allgemein > Web > URL-Optionen und stellen Sie die Option "Shop-Code zu URLs hinzufügen" Nein ".

Greifen Sie auf den Quellcode Ihrer Website zu und öffnen Sie die Datei app/etc/env.php . Setzen Sie den Wert 'document_root_is_pub' auf true.

Stellen Sie sicher, dass Sie beide Schritte ausführen und fahren Sie mit der Einrichtung der URL-Umschreibung fort, um sicherzustellen, dass Linguise problemlos auf Ihrer Magento Website ausgeführt werden kann.
URL-Umschreibung einrichten
Gehen Sie in der Admin-Seitenleiste zu „Shops“ > „Einstellungen“ > „Konfiguration“ > „Allgemein“ > „Web“ > „Suchmaschinenoptimierung“ und aktivieren Sie die „Webserver-Rewrite verwenden“ . Weitere Informationen finden Sie in der offiziellen Magento Dokumentation

Die URL-Syntax muss in der .htaccess-Datei konfiguriert werden. Kopieren Sie einfach diesen Code nach dem Code „ RewriteEngine on “, der in der standardmäßigen Magento 2 .htaccess-Datei vorhanden ist:
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,END]
Abschließend sollte Ihre Magento .htaccess-Datei etwa so aussehen:

Sprachumschalter aktivieren
Laden Sie das Linguise JS-Skript
Sie können nun alle Ihre übersetzten Seiten über die URL laden, zum Beispiel: www.shop.com/fr/

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.
Den Code zum Kopieren und Einbinden in den Header Ihrer Website finden Sie in Ihrem Linguise Dashboard unter „Ihre Domain“ > „Einstellungen“ > Registerkarte „Skript-PHP“.

Es muss im Seitenkopf geladen werden. Magento 2 bietet Ihnen die Möglichkeit, über die Konfiguration Inhalte im Head-Bereich Ihrer Seite hinzuzufügen.

Gehen Sie im Admin-Bereich zu Inhalt > Konfiguration , bearbeiten Sie Ihre Standard-Shop-Theme-Ansicht, klicken Sie dann auf den Abschnitt HTML-Head und fügen Sie das kopierte Skript in das Feld „Skripte und Stylesheets“ ein. Speichern Sie abschließend die Konfiguration.

Installieren Sie das Magento Sicherheitsmodul
Ab Magento 2.3.5 muss ein Sicherheitsmodul hinzugefügt werden, damit Magento Dateien von Linguise Domain laden kann. Wenn Sie mit Magento vertraut sind, stellt dies kein Problem dar. Andernfalls finden Sie hier eine Schritt-für-Schritt-Anleitung:
- Laden Sie das Modul über diesen Link
- Entpacken Sie den Inhalt der ZIP-Datei in Ihr Magento -Installationsverzeichnis app/code/
- Führen Sie anschließend die folgenden Befehle aus:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Der Sprachumschalter wird standardmäßig unten rechts auf Ihrer Website angezeigt. Sie können ihn im Linguise Dashboard anpassen.

Wichtiger SEO-Hinweis: Die Anzahl der eingerichteten Sprachen hat einen großen Einfluss auf Ihre Suchmaschinenoptimierung (SEO). Wenn Sie Ihre Übersetzungssprachen einrichten und eine große Anzahl indexierter Seiten (> 500) haben, kann die Verarbeitung durch Suchmaschinen viel Zeit in Anspruch nehmen. Dies kann sich negativ auf Ihre SEO in der Originalsprache auswirken. Daher empfehlen wir, zunächst maximal 5 Sprachen hinzuzufügen. Sobald diese indexiert sind, können Sie monatlich jeweils 3 weitere Sprachen 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
Laden Sie den Sprachumschalter in Magento -Inhalten

Um den Sprachumschalter an der gewünschten Stelle im Magento -Inhalt anzuzeigen, wählen Sie die Position „Direkt einfügen“.
Nachdem Sie die Position im Linguise Dashboard festgelegt haben, können Sie den unten stehenden Shortcode hinzufügen. Klicken Sie auf den Code, um ihn in die Zwischenablage zu kopieren.
[linguise]
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 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.

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:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte