> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🌍 Appointment Bookings — Übersetzung

> ℹ️ **Note:** Dieser Artikel wurde automatisch mit AI übersetzt und kann Ungenauigkeiten enthalten. Wenn etwas falsch aussieht, kontaktieren Sie bitte unser Support-Team.

Hoppy Appointments ermöglicht es dir, den für Kunden sichtbaren Text zu übersetzen, der im gesamten Buchungserlebnis angezeigt wird. Dazu gehören Schaltflächenbeschriftungen, Formularfelder, Kalendertext, Erfolgsmeldungen, Wartelistenwortlaut und sogar die Beschriftungen integrierter E-Mail-Blöcke.

Wenn dein Shop in mehreren Sprachen verkauft, helfen dir Übersetzungen, Kunden in der Sprache bedienen zu können, in der sie gerade browsen. Wenn du in nur einer Sprache verkaufst, lassen dich Übersetzungen dennoch den Standardwortlaut an deine Marke anpassen – zum Beispiel von „Book Now" zu „Reserve My Spot" 🎯

Diese Anleitung erklärt, wie das Übersetzungssystem funktioniert, wo du es konfigurierst und was jede Gruppe von Einstellungen steuert.

---

# **⚠️ Bevor du beginnst**

Übersetzungen werden verwaltet unter:

**Hoppy Appointments → Settings (Einstellungen) → Translations (Übersetzungen)**

Bevor du etwas übersetzt, stelle sicher:

* Die Hoppy Appointments-App ist installiert  
* Du hast mindestens einen Service erstellt  
* Die gewünschten Sprachen sind bereits in deinem Shopify-Shop hinzugefügt

ℹ️ Sprachen müssen zuerst in Shopify hinzugefügt werden, bevor sie in Hoppy Appointments angezeigt werden.

Um Shop-Sprachen hinzuzufügen oder zu verwalten, gehe zu:

**Shopify Admin → Settings (Einstellungen) → Languages (Sprachen)**

💡 Wenn eine Sprache in Shopify nicht konfiguriert ist, ist sie in den Übersetzungs-Dropdowns nicht verfügbar.

---

# **🌐 Multi-Language Settings (Mehrsprachige Einstellungen)**

Oben auf der Seite **Translations (Übersetzungen)** steuert die Karte **Multi-language settings (Mehrsprachige Einstellungen)**, welche Sprachen das Buchungs-Widget verwendet.

---

## **Default Language (Standardsprache)**

Dies ist die Sprache, die verwendet wird, wenn:

* Mehrere Sprachen **ausgeschaltet** sind  
* Ein Kunde in einer Sprache besucht, die du nicht aktiviert hast

Betrachte sie als deine Fallback-Sprache. Die App fällt immer auf diese Sprache zurück, wenn etwas nicht in der Sprache des Kunden angezeigt werden kann.

---

## **Enable Multiple Languages (Mehrere Sprachen aktivieren)**

Schalte dies ein, um mehr als eine Sprache in deinem Shop-Frontend zu unterstützen.

Wenn aktiviert, erscheinen zwei zusätzliche Einstellungen:

### **Language Detection Mode (Spracherkennungsmodus)**

Wähle aus, wie die App entscheidet, welche Sprache angezeigt werden soll:

* **Store language (Shop-Sprache)** → Verwendet die aktive Shopify-Shopfront-Sprache aus der Browsersitzung des Kunden  
* **Browser language (Browsersprache)** → Verwendet die Browsersprache des Kunden

Die meisten Händler verwenden **Store language (Shop-Sprache)**, weil es dem Sprachwechsel von Shopify entspricht.

---

### **Enabled Languages (Aktivierte Sprachen)**

Wähle aus, welche Sprachen das Buchungs-Widget unterstützen soll. Nur in Shopify hinzugefügte Sprachen erscheinen in dieser Liste.

⚠️ Wichtig:

* Die **Default Language (Standardsprache)** ist automatisch in der aktivierten Liste enthalten  
* Wenn du die Sprache entfernst, die aktuell im Editor ausgewählt ist, wechselt die Vorschau automatisch zurück zur Standardsprache

---

# **📝 The Translation Editor (Der Übersetzungs-Editor)**

Unter den mehrsprachigen Einstellungen ist der Übersetzungs-Editor in zwei Tabs unterteilt:

* **Calendar Translations (Kalenderübersetzungen)** → Globaler Text, der in allen Services verwendet wird  
* **Service Translations (Service-Übersetzungen)** → Pro-Service-Überschreibungen für Services mit aktivierter **Advanced configuration (Erweiterte Konfiguration)**

Ein Sprachumschalter erscheint über den Tabs, wenn mehrere Sprachen aktiviert sind. Verwende ihn, um jeweils eine Sprache zu übersetzen.

Der Tab **Calendar Translations (Kalenderübersetzungen)** enthält auch ein Live-Vorschau-Panel, sodass du während der Bearbeitung sehen kannst, wie Änderungen auf Desktop und Mobilgeräten aussehen.

---

# **📅 Calendar Translations Tab (Kalenderübersetzungen-Tab)**

Dieser Tab steuert den Standardtext, der im gesamten Buchungs-Widget, auf der Umbuchungsseite, der Stornierungsseite und in den E-Mail-Block-Beschriftungen angezeigt wird.

Der Text ist in Gruppen organisiert. Hier ist, was jede Gruppe steuert.

---

## **Product Page (Produktseite)**

* **Product page button label (Beschriftung der Produktseiten-Schaltfläche)** → Der Text auf der Schaltfläche, die **Add to Cart (In den Warenkorb)** auf buchbaren Produktseiten ersetzt

   Standard: „Book Now"

---

## **General Calendar Texts (Allgemeine Kalendertexte)**

Dies sind die Hauptbeschriftungen und Nachrichten im Buchungs-Widget:

* **Time needed (Benötigte Zeit)** → Die Überschrift über den Daueroptionen, z. B. „How long do you need?"  
* **When do you want to book ?** → Die Überschrift über der Zeitfensterliste, z. B. „What time works best?"  
* **Confirm booking title (Buchungstitel bestätigen)** → Die Überschrift im Bestätigungsschritt  
* **Back button label (Zurück-Schaltflächenbeschriftung)**, **Confirm button label (Bestätigen-Schaltflächenbeschriftung)**, **Continue button (Weiter-Schaltfläche)** → Navigationsschaltflächen  
* **Confirm button label when submitting (Bestätigen-Schaltflächenbeschriftung beim Absenden)** → Die Absendeversion der Bestätigen-Schaltfläche  
* **Time not found message / sub-message (Zeit nicht gefunden – Nachricht / Unter-Nachricht)** → Wird angezeigt, wenn keine Zeitfenster verfügbar sind  
* **Teammate selector label (Teammitglied-Auswahl-Beschriftung)** → Beschriftung für die Auswahl eines Teammitglieds  
* **No preference label (Keine Präferenz-Beschriftung)** → Option, wenn jedes Teammitglied in Ordnung ist  
* **Success title / description / CTA / CTA Link (Erfolg – Titel / Beschreibung / CTA / CTA-Link)** → Der Bildschirm, den Kunden nach einer bestätigten kostenlosen Buchung sehen

und viele mehr.

---

## **Calendar Form (Kalenderformular)**

Beschriftungen und Validierungsmeldungen für die Standard-Buchungsformularfelder:

* **First name field label (Vorname-Feld-Beschriftung)**  
* **Last name field label (Nachname-Feld-Beschriftung)**  
* **Email field label (E-Mail-Feld-Beschriftung)**  
* **Phone field label (Telefon-Feld-Beschriftung)**  
* **Required message (Erforderlich-Nachricht)** → Wird angezeigt, wenn ein erforderliches Feld leer ist  
* **Email error message (E-Mail-Fehlermeldung)** → Wird angezeigt, wenn eine E-Mail-Adresse ungültig ist

---

## **Rescheduling Page (Umbuchungsseite)**

Text, den Kunden sehen, wenn sie eine Buchung über ihren E-Mail-Link umbuchen:

* **Reschedule booking heading (Überschrift Umbuchung)**  
* **Rescheduling button (Umbuchungsschaltfläche)**  
* **Rescheduled booking button (Umbuchte Buchung – Schaltfläche)**  
* **Rescheduled booking message (Nachricht zur umgebuchten Buchung)**

---

## **Meeting Details (Besprechungsdetails)**

* **Meeting details title (Titel der Besprechungsdetails)** → Die Überschrift über dem Ort oder Besprechungslink auf dem Bestätigungsbildschirm

---

## **Booking Status Messages (Buchungsstatus-Nachrichten)**

Nachrichten, die angezeigt werden, wenn eine Buchung in der Warteschleife oder storniert ist:

* **On-hold title/message (In-Warteschleife-Titel/Nachricht)**  
* **Cancelled title/message (Storniert-Titel/Nachricht)**  
* **Cancel booking title/button (Buchung stornieren – Titel/Schaltfläche)**

Diese sind besonders nützlich für Services, die eine manuelle Genehmigung erfordern.

---

## **Multiday Calendar Texts (Mehrtägige Kalendertexte)**

Beschriftungen für Aufenthalte und Vermietungen:

* **Start date label (Startdatum-Beschriftung)**, **End date label (Enddatum-Beschriftung)**  
* **Pick date text (Datum-auswählen-Text)**  
* **Duration text (Dauer-Text)**  
* **Minimum selection label (Mindestauswahl-Beschriftung)** → Verwendet dynamische Variablen `{count}` und `{unit}`

---

## **Bundle Bookings Texts (Paketbuchungs-Texte)**

Beschriftungen für Sitzungspakete:

* **Number of time slots label (Anzahl Zeitfenster – Beschriftung)**

---

## **Partial Payment (Teilzahlung)**

Beschriftungen, die angezeigt werden, wenn Anzahlungen aktiviert sind:

* **Partial payment label (Teilzahlungs-Beschriftung)** → Die Beschriftung der Anzahlungs-Checkbox  
* **Pay full amount label (Gesamtbetrag-zahlen-Beschriftung)** → Die Beschriftung der Vollzahlungs-Checkbox

💡 Diese Beschriftungen sind im Shop-Frontend nur sichtbar, wenn Teilzahlungen für einen kostenpflichtigen Service aktiviert sind.

---

## **Units (Einheiten)**

Kurze Beschriftungen für Dauer- und Datumsformatierung:

* **Min**, **Hour**, **Hours**, **Day**, **Days**, **Night**, **Nights**  
* **Date label (Datumsbeschriftung)**

Diese werden bei der Anzeige von Dauern wie „60 min" oder „2 nights" verwendet.

---

## **Months & Days of Week (Monate & Wochentage)**

Übersetze die 12 Monatsnamen und die 7 Wochentagsnamen. Es gibt zwei Sätze:

* **Days of week (Wochentage)** → Vollständige Namen wie Monday, Tuesday  
* **Days of week short (Wochentage kurz)** → Kurznamen wie Mon, Tue  
* **Month names (Monatsnamen)** → Vollständige Namen wie January, February

Diese werden im Kalenderkopf und in den Datumsauswahlfeldern verwendet.

---

## **Email Blocks (E-Mail-Blöcke)**

Diese steuern die integrierten Beschriftungen in deinen E-Mail-Vorlagen:

* **Header labels (Header-Beschriftungen)** → Confirmed, Cancelled, Updated, On Hold, Declined, Waitlist  
* **Action labels (Aktionsbeschriftungen)** → Reschedule, Cancel  
* **Calendar link labels (Kalender-Link-Beschriftungen)** → Add to Google Calendar, Add to Apple Calendar, Add to Outlook Calendar  
* **Section labels (Abschnittsbeschriftungen)** → Location, Order, Teammates

ℹ️ Diese Beschriftungen werden von den vorgefertigten E-Mail-Blöcken verwendet. Der benutzerdefinierte Text, den du in **Email Settings (E-Mail-Einstellungen)** in Betreffzeilen und Texten schreibst, wird nicht automatisch übersetzt – er wird genau so gesendet, wie du ihn geschrieben hast.

Weitere Informationen zur Anpassung von E-Mail-Vorlagen findest du in der Dokumentation **Email Notifications (E-Mail-Benachrichtigungen)**.

---

## **Waitlist (Warteliste)**

Text, der angezeigt wird, wenn Kunden der Warteliste beitreten oder mit ihr interagieren:

* Formulartitel und -beschreibung  
* **Join waitlist (Warteliste beitreten)** – Schaltflächenbeschriftung  
* Inline-Linktext oberhalb der Zeitfensterliste  
* Erfolgsmeldung nach dem Beitritt  
* Absenden-Schaltflächentext

---

# **🛠️ Service Translations Tab (Service-Übersetzungen-Tab)**

Dieser Tab ermöglicht es dir, globale Übersetzungen für einzelne Services zu überschreiben.

ℹ️ Nur Services mit aktivierter **Advanced configuration (Erweiterte Konfiguration)** erscheinen hier. Wenn kein Service die erweiterte Konfiguration verwendet, erklärt ein Info-Banner, wie du sie aktivierst.

Für jeden aufgeführten Service kannst du übersetzen:

* **Title (Titel)** → Der Kunden angezeigte Servicetitel  
* **Description (Beschreibung)** → Die Kunden angezeigte Beschreibung  
* **Floating action button label (Schwebende Aktions-Schaltflächenbeschriftung)** → Wenn der Service eine schwebende **Book Now**-Schaltfläche verwendet  
* **Product page button label (Produktseiten-Schaltflächenbeschriftung)** → Überschreibe den globalen Schaltflächentext nur für diesen Service  
* **Back button label (Zurück-Schaltflächenbeschriftung)**, **Confirm button label (Bestätigen-Schaltflächenbeschriftung)**  
* **Time needed text (Benötigte-Zeit-Text)**, **Book text (Buchungs-Text)**, **Confirm booking text (Buchung bestätigen – Text)**

💡 Service-Übersetzungen haben Vorrang vor globalen **Calendar Translations (Kalenderübersetzungen)**. Das ist nützlich, wenn ein Service eine andere Formulierung benötigt – zum Beispiel eine „Rent Now"-Schaltfläche für Vermietungen, während alles andere „Book Now" sagt.

Der Tab **Service Translations (Service-Übersetzungen)** enthält kein Live-Vorschau-Panel, da Überschreibungen an bestimmte Services gebunden sind.

---

# **🖥️ How Translations Appear on the Storefront (So erscheinen Übersetzungen im Shop-Frontend)**

Die App entscheidet anhand dieser Logik, welche Sprache angezeigt wird:

1. Wenn **mehrere Sprachen deaktiviert** sind, verwendet das Widget immer die **Default Language (Standardsprache)**  
2. Wenn **mehrere Sprachen aktiviert** sind:  
   * **Store language (Shop-Sprache)**-Modus → Verwendet die aktive Shopify-Shopfront-Sprache  
   * **Browser language (Browsersprache)**-Modus → Verwendet die Browsersprache des Kunden  
3. Wenn die erkannte Sprache nicht in deiner aktivierten Liste enthalten ist, fällt die App auf die **Default Language (Standardsprache)** zurück  
4. Wenn ein bestimmter Übersetzungsschlüssel fehlt, fällt die App auf Englisch zurück

Wo übersetzter Text erscheint:

* Die Schaltfläche **Book Now** auf Produktseiten  
* Der Buchungs-Widget-Kalender, das Formular und die Schaltflächen  
* Erfolgs-, Warteschleifen-, Umbuchungs- und Stornierungsseiten  
* Wartelistenformular und Bestätigungsnachrichten  
* Integrierte E-Mail-Block-Beschriftungen in Benachrichtigungs-E-Mails

---

# **🧮 Dynamic Variables (Dynamische Variablen)**

Einige Übersetzungsfelder unterstützen dynamische Platzhalter. Entferne diese Variablen nicht – sie werden automatisch basierend auf der Buchung ersetzt.

### **Minimum selection label (Mindestauswahl-Beschriftung)**

Verwende `{count}` für die Mindestanzahl und `{unit}` für die Tages- oder Nachteinheit.

Beispiel:

`Minimum stay: {count} {unit}`

Wird zu:

`Minimum stay: 2 nights`

---

# **⚠️ Important Notes & Limitations (Wichtige Hinweise & Einschränkungen)**

* **Füge Sprachen zuerst in Shopify hinzu.** Hoppy Appointments zeigt nur Sprachen an, die bereits in deinen Shopify-Shopeinstellungen vorhanden sind.

* **Browsersprache ist vereinfacht.** Wenn du die Erkennung **Browser language (Browsersprache)** verwendest, nutzt die App den primären Sprachcode. Zum Beispiel wird `pt-BR` zu `pt`. Wenn du nur `pt-BR` aktiviert hast, passt die Browsererkennung möglicherweise nicht.

* **Service-Übersetzungen erfordern die erweiterte Konfiguration.** Du musst **Advanced configuration (Erweiterte Konfiguration)** für einen Service aktivieren, bevor er im Tab **Service Translations (Service-Übersetzungen)** erscheint.

* **Benutzerdefinierter E-Mail-Text wird nicht automatisch übersetzt.** Der Betreff und Text, den du in **Email Settings (E-Mail-Einstellungen)** eingibst, werden in allen Sprachen genau so gesendet, wie geschrieben. Nur die integrierten Block-Beschriftungen werden automatisch übersetzt.

* **POS-Erweiterung-Lokalisierung ist eingeschränkt.** Die POS-Erweiterung unterstützt in erster Linie Englisch. Mehrsprachige Shop-Frontend-Übersetzungen gelten nicht innerhalb des POS-Buchungsablaufs.

* **Admin-Oberfläche nur auf Englisch.** Die Hoppy Appointments-Admin-Oberfläche ist derzeit unabhängig von deiner Shop-Sprache nur auf Englisch verfügbar.

* **Speichern nach Änderungen der Sprachen.** Übersetzungsänderungen werden im Shop-Frontend wirksam, sobald sie gespeichert sind.

* **Zurückfallen auf Englisch ist normal.** Wenn eine Übersetzung für eine Sprache leer oder fehlt, zeigt die App die englische Version an, damit Kunden nie defekten Text sehen.

---

# **💡 Common Use Cases (Häufige Anwendungsfälle)**

## **Single-language store with custom wording (Einsprachiger Shop mit benutzerdefiniertem Wortlaut)**

* Halte **Enable multiple languages (Mehrere Sprachen aktivieren)** ausgeschaltet  
* Setze die **Default language (Standardsprache)** auf deine Shop-Sprache  
* Bearbeite **Calendar Translations (Kalenderübersetzungen)**, um Standardbeschriftungen zu ändern

Beispiel: Ändere „Book Now" in „Reserve My Spot" für alle Services.

---

## **Multi-language storefront (Mehrsprachiges Shop-Frontend)**

* Füge Sprachen in **Shopify Admin → Settings (Einstellungen) → Languages (Sprachen)** hinzu  
* Aktiviere in Hoppy Appointments **Enable Multiple Languages (Mehrere Sprachen aktivieren)**  
* Wähle die Erkennung **Store language (Shop-Sprache)**  
* Wähle die Sprachen aus, die du unterstützen möchtest  
* Übersetze jede Sprache im Tab **Calendar Translations (Kalenderübersetzungen)**

Ergebnis: Kunden, die auf Französisch buchen, sehen französische Beschriftungen, während Kunden, die auf Englisch buchen, englische Beschriftungen sehen.

---

## **Per-service button override (Schaltflächenüberschreibung pro Service)**

* Aktiviere **Advanced configuration (Erweiterte Konfiguration)** für einen Vermietungs-Service  
* Gehe zu **Service Translations (Service-Übersetzungen)**  
* Ändere die **Product page button label (Produktseiten-Schaltflächenbeschriftung)** für diesen Service zu „Rent Now"

Ergebnis: Nur dieser Service zeigt „Rent Now". Alle anderen Services behalten die globale „Book Now"-Beschriftung bei.

---

# **🎉 Final Result (Endergebnis)**

Sobald deine Übersetzungen konfiguriert sind:

✅ Kunden sehen Buchungsbeschriftungen in ihrer Shop-Sprache  
✅ Schaltflächentext, Formularbeschriftungen und Kalendertext entsprechen deiner Markenstimme  
✅ Mehrsprachige Shops wechseln automatisch die Sprache basierend auf Shopify- oder Browsereinstellungen  
✅ Service-Überschreibungen ermöglichen es einzelnen Services, benutzerdefinierte Formulierungen zu verwenden  
✅ Integrierte E-Mail-Block-Beschriftungen werden automatisch übersetzt  
✅ Fehlende Übersetzungen fallen sicher auf deine Standardsprache oder Englisch zurück

Mit eingerichteten Übersetzungen fühlt sich dein Buchungserlebnis für jeden Kunden natürlich an, ganz egal, welche Sprache er spricht 🌍

---