Uplink7 Automatic Translator Standalone PHP Dokumentation
Willkommen zur offiziellen Dokumentation für den Uplink7 Automatic Translator (Standalone Edition). Diese Anleitung führt Sie durch die Installation, Konfiguration, technische Einbindung und Fehlerbehebung.
1. Systemvoraussetzungen
Um die Standalone PHP Edition auszuführen, muss Ihr Webserver folgende Mindestanforderungen erfüllen:
PHP Version: PHP 7.4 oder höher (vollständig kompatibel mit PHP 8.0, 8.1, 8.2 und 8.3)
PHP Extensions:
json (Standardmäßig aktiviert)
curl (Empfohlen für den Geo-IP-Lookup)
session (Standardmäßig aktiviert)
Webserver: Apache, Nginx, LiteSpeed oder Microsoft IIS
Schreibrechte: Der PHP-Prozess benötigt Schreibrechte im Ordner des Skripts, um die Datei u7at_config.json zu erstellen und zu aktualisieren.
2. Dateistruktur & Verzeichnisrechte
Nach der Einrichtung besteht das Übersetzungssystem aus folgenden Dateien im selben Verzeichnis:
/your-website-root/
│
├── uplink7_automatic_translator_standalone_premium.php # Hauptskript (Engine & Admin-Panel)
├── u7at_config.json # Automatisch erzeugte Konfigurationsdatei
└── readme.txt # Kurzanleitung
Verzeichnisrechte (Permissions)
Stellen Sie sicher, dass das Verzeichnis, in dem translator_standalone.php liegt, die Berechtigung CHMOD 755 (oder bei manchen Hosting-Umfeldern CHMOD 777) besitzt, damit PHP die Konfigurationsdatei beschreiben kann.
3. Installation & Erstkonfiguration
Laden Sie die Datei translator_standalone.php in ein beliebiges Verzeichnis auf Ihrem Webserver hoch (z. B. Stammverzeichnis oder /assets/translator/).
Öffnen Sie Ihren Browser und rufen Sie die Administrations-Oberfläche auf:
https://ihre-domain.de/uplink7_automatic_translator_standalone_premium.php?u7at_admin=1
Melden Sie sich mit dem Standard-Passwort an:
Passwort: admin
Die Konfigurationsdatei u7at_config.json wird beim ersten Speichern oder Login automatisch generiert.
4. Admin-Bereich & Sicherheit
Passwort ändern
Es wird dringend empfohlen, das Standard-Passwort nach dem ersten Login sofort zu ändern:
Rufen Sie den Admin-Bereich (?u7at_admin=1) auf.
Scrollen Sie nach unten zum Bereich Change Password.
Geben Sie Ihr neues Passwort in beiden Feldern ein und klicken Sie auf Update Password.
Das Passwort wird als sicherer Hash (PASSWORD_DEFAULT) in der u7at_config.json abgelegt.
5. Einbindung in Websites (PHP Integration)
6. Funktionsübersicht & Einstellungen
Im Admin-Bereich stehen Ihnen folgende Konfigurationsoptionen zur Verfügung:
Einstellung
Beschreibung
Default Language
Der 2-stellige ISO-Code der Ausgangssprache Ihrer Website (z. B. de, en, fr).
Background / Text Color
Wählen Sie individuelle Farben für den Widget-Container und den Text.
Text Size / Border Radius / Width
Anpassen von Schriftgröße (in px), Eckenabrundung und Rahmenschneide.
Automatic Placement
Automatische Platzierung des Widgets im Header, Footer oder als Sticky Float (schwebender Button).
Browser Language Detection
Erkennt automatisch die Browsersprache des Besuchers und leitet die Übersetzung ein.
Geo-IP Location Detection
Ermittelt serverseitig die echte IP-Adresse des Nutzers und schaltet auf die entsprechende Landessprache um.
Native Language Names
Zeigt Sprachnamen in der jeweiligen Landessprache an (z. B. Deutsch statt German).
Display Country Flags
Fügt passende Flaggen-Emojis vor den jeweiligen Sprachoptionen ein.
SEO Hreflang Meta Tags
Generiert canonical hreflang=”x-default” Tags im HTML-Kopf.
Brand Protection
Blendung von Google Translate Logos und Bannern aus.
Smart Data Protection
Schützt sensible HTML-Attribute und Mailto-Links vor unerwünschter Übersetzung.
Excluded Paths
Pfade oder URLs (ein Pfad pro Zeile), auf denen der Übersetzer deaktiviert bleibt.
7. Fehlerbehebung (Troubleshooting)
Speichern der Einstellungen schlägt fehl
Ursache: Fehlende Schreibrechte im Ordner.
Lösung: Prüfen Sie, ob der Ordner Lese- und Schreibrechte für den Webserver besitzt. Setzen Sie die Ordnerrechte testweise auf CHMOD 755 oder 777.
Weißer Bildschirm (White Screen of Death)
Ursache: Falscher Pfad beim require_once oder PHP-Fehler.
Lösung: Stellen Sie sicher, dass der Pfad zur translator_standalone.php exakt stimmt. Nutzen Sie function_exists(‘u7at_get_widget_html’), um Aufruffehler abzufangen.
Sprache schaltet nach Reset sofort wieder um
Ursache: Aktivierte Browserspracherkennung überschreibt den Reset-Zustand.
Lösung: Die integrierte Session-Storage-Logik verhindert dies automatisch. Sollte es dennoch vorkommen, leeren Sie bitte einmalig Ihren Browser-Cache und Ihre Cookies.