Dokumentation & Onboarding

Schritt 1: Zugang erhalten

Nach deiner Bestellung erhältst du eine E-Mail mit:

• Deine persönliche SmartTranslate-URL (z.B. deinshop.smarttranslate.app)
• Zugangsdaten für das Admin-Panel
• Installations-Link für deinen Shopify Store

Schritt 2: App in Shopify installieren

1. Klicke auf den Installations-Link in deiner E-Mail
2. Du wirst zu deinem Shopify Admin weitergeleitet
3. Klicke auf "App installieren"
4. Bestätige die Berechtigungen (wir brauchen Zugriff auf Produkte, Seiten und Blog-Artikel)

Schritt 3: Installation prüfen

Nach erfolgreicher Installation siehst du SmartTranslate in deinem Shopify Admin unter Apps. Klicke darauf, um die App zu öffnen.

Schritt 1: OpenAI Account erstellen

1. Gehe zu platform.openai.com/signup
2. Erstelle einen Account mit deiner E-Mail oder Google/Microsoft
3. Bestätige deine E-Mail-Adresse

Schritt 2: Zahlungsmethode hinzufügen

1. Gehe zu platform.openai.com/account/billing
2. Klicke auf "Set up paid account" oder "Add payment method"
3. Wähle "Individual" oder "Company" je nach deiner Situation
4. Gib deine Kreditkarte oder Zahlungsdaten ein
5. Setze ein monatliches Limit (z.B. 20 EUR für den Anfang)

Schritt 3: API Key erstellen

1. Gehe zu platform.openai.com/api-keys
2. Klicke auf "Create new secret key"
3. Gib einen Namen ein, z.B. "SmartTranslate"
4. Klicke auf "Create secret key"
5. Kopiere den Key sofort! Er wird nur einmal angezeigt.

Schritt 4: API Key in SmartTranslate eingeben

1. Öffne SmartTranslate in deinem Shopify Admin
2. Gehe zu "Einstellungen" (Settings)
3. Füge deinen API Key im Feld "OpenAI API Key" ein
4. Klicke auf "Speichern"

Übersetzung starten

1. Klicke im Dashboard auf "Translate Products"
2. Wähle die Zielsprache(n) aus (z.B. Englisch, Französisch)
3. Wähle aus, was übersetzt werden soll:
   • Titel
   • Beschreibung
   • URL-Handle (SEO)
   • Varianten
   • Metafelder (optional)
4. Klicke auf "Start Translation"

Fortschritt verfolgen

Im Dashboard siehst du den Status aller Übersetzungsprozesse:

• Fresh - Noch nicht gestartet
• In Progress - Wird gerade übersetzt
• Finished - Erfolgreich abgeschlossen
• Failed - Fehler aufgetreten (klicke für Details)

Ergebnis prüfen

Nach Abschluss der Übersetzung:

1. Öffne ein Produkt in deinem Shopify Admin
2. Scrolle nach unten zu "Übersetzungen" oder wechsle die Sprache
3. Die übersetzten Texte sollten jetzt sichtbar sein

Verfügbare Felder

Filter-Optionen

Du kannst Produkte nach Tags filtern, um nur bestimmte Produkte zu übersetzen:

• Filter Tags: Nur Produkte mit bestimmten Tags übersetzen
• Force: Bereits übersetzte Produkte erneut übersetzen
• Dry Run: Testlauf ohne tatsächliche Übersetzung

So funktioniert's

1. Klicke im Dashboard auf "Translate Pages"
2. Wähle die Zielsprache(n)
3. Wähle die zu übersetzenden Felder (Titel, Body, URL)
4. Starte die Übersetzung

Verfügbare Felder

• Titel: Überschrift des Artikels
• Content: Der gesamte Artikelinhalt
• URL-Handle: SEO-optimierte URL

API Konfiguration

• OpenAI API Key: Dein persönlicher API Schlüssel
• Scheduled Translation: Automatische Übersetzung neuer Produkte (wenn aktiviert)

Standard-Einstellungen

Du kannst Standardwerte für jede Übersetzungsart speichern:

• Standard-Zielsprachen
• Standard-Felder zum Übersetzen
• Filter-Tags

Diese werden automatisch vorausgefüllt, wenn du eine neue Übersetzung startest.

So startest du eine Bulk-Übersetzung

1. Gehe im Dashboard zu "Translate Products", "Translate Pages" oder "Translate Blog"
2. Wähle deine Zielsprache(n) aus (z.B. Englisch, Französisch, Spanisch)
3. Wähle die zu übersetzenden Felder (Titel, Beschreibung, etc.)
4. Klicke auf "Start Translation"
5. Alle Inhalte werden automatisch übersetzt - du kannst den Fortschritt live verfolgen!

Vorteile der Bulk-Übersetzung

• Zeitersparnis: Tausende Produkte werden in Stunden statt Wochen übersetzt
• Konsistenz: Alle Übersetzungen haben den gleichen Stil und Ton
• Einfachheit: Ein Klick startet alles - kein Produkt wird vergessen
• Übersicht: Im Dashboard siehst du den Fortschritt aller Übersetzungen

Welche Metafelder werden übersetzt?

SmartTranslate erkennt automatisch alle übersetzbaren Metafelder in deinem Shop:

• Text-Metafelder: Alle Felder vom Typ "single_line_text_field" und "multi_line_text_field"
• Rich-Text-Metafelder: HTML-formatierte Texte werden korrekt übersetzt
• Benutzerdefinierte Felder: Alle von dir oder deinem Theme erstellten Textfelder

So aktivierst du die Metafeld-Übersetzung

1. Gehe zu "Translate Products"
2. Aktiviere die Checkbox "Metafields" bei den zu übersetzenden Feldern
3. SmartTranslate erkennt alle verfügbaren Metafelder automatisch
4. Starte die Übersetzung wie gewohnt

Einrichtung des Cronjobs

Für die automatische Übersetzung muss ein sogenannter "Cronjob" eingerichtet werden. Das ist wie ein Wecker für deinen Computer, der jede Nacht sagt: "Jetzt übersetzen!"

Was wird automatisch übersetzt?

Der Cronjob übersetzt alle Inhalte, die noch nicht übersetzt wurden:

• Neue Produkte: Alle Produkte ohne Übersetzung in den Zielsprachen
• Aktualisierte Produkte: Optional: Produkte, deren Quelltext geändert wurde
• Neue Seiten: Alle neuen statischen Seiten
• Neue Blog-Artikel: Alle neuen Artikel werden übersetzt

API Key funktioniert nicht

Übersetzung hängt

Übersetzungen werden nicht angezeigt

Kontaktmöglichkeiten

Bei Support-Anfragen bitte angeben:

• Deine Shop-URL
• Beschreibung des Problems
• Screenshots wenn möglich
• Fehlermeldungen (falls vorhanden)

Wir antworten in der Regel innerhalb von 24 Stunden.