Skip to main content

Signage: redaktionelle Labels pro Sprache (*ByLocale)

Was​

Optionale Objekte feldNameByLocale neben deutschen Basisfeldern in signageTemplateOptions[templateId]:

  • Kiosk: Quicklink-Labels (centerplanLabel, shopsLabel, foodLabel, servicesLabel, searchLabel, offersLabel, jobsLabel), youAreHereLabel, welcomeText, welcomeSubtext, handoffQrTitle, handoffQrText; in promoBox: titleByLocale, textByLocale; in idleTouchHint: textByLocale.
  • Global (_global): maintenanceMessageByLocale (Wartungsmodus-Hinweis); kioskLanguages (Locale-Codes für Kiosk-Sprachumschalter, z. B. ["de","en"]).
  • Companion: menuHintTitleByLocale, menuHintTextByLocale.

Deutsch bleibt das Basisfeld (z. B. shopsLabel). Englisch optional unter { "en": "…" }. Weitere Locales folgen später; Cockpit-UI aktuell nur en.

Warum​

Center mit data.languages (Website/v0) sollen Quicklinks und Handoff-Texte ohne Code-Deploy anpassen können.

Wo​

LesenSchreiben
GET …/signage-surface, GET …/signage-template-options?template=ai-premiumDashboard Stele → Bezeichnungen / Darstellung / Info-Box; Companion → Menü & Navigation; MCP cockpit_update_signage_template_options
GET …/signage-surface → languages; PUT …/signage-global-optionsDashboard Stele → Bezeichnungen → Kiosk-Sprachen; MCP cockpit_update_signage_global_options (kioskLanguages)

Mit ?orientation=portrait|landscape werden flache Felder und kiosk.byOrientation wie gewohnt gemergt; *ByLocale folgt demselben Override.

v0-Vertrag​

  1. Sprache ermitteln: Cookie app-lang, Query ?lang= (siehe Public API — languages) oder App-i18n.
  2. Anzeige:
function pickLabel(base: string | undefined, byLocale: { en?: string } | undefined, locale: string) {
const code = locale.trim().toLowerCase();
if (code === 'en' && byLocale?.en?.trim()) return byLocale.en.trim();
return (base ?? '').trim();
}
  1. Kein ByLocale → nur Basisfeld; leeres Basisfeld → v0-eigener Default (unverändert).

Referenz (Cockpit)​

Implementierung: apps/dashboard/src/lib/integration/signage-editorial-by-locale.ts (resolveSignageEditorialLabel, Sanitizer für PATCH).

Kiosk-Sprachen (Signage-only)​

Canonical für den Kiosk: GET …/signage-surface → surface.languages (gleiche Form wie public-visitor-surface → data.languages).

  • Ohne Website-Template: _global.kioskLanguages setzen (Dashboard oder MCP).
  • Mit Website: fehlt kioskLanguages, gelten Website-header.languageOptions; ist kioskLanguages gesetzt, Codes aus Kiosk mit Website-Labels gemergt.

So testen​

  1. Center alexa-berlin (Signage-only): Stele → Bezeichnungen → Kiosk-Sprachen → EN aktivieren, speichern.
  2. GET …/signage-surface?centerId=… → surface.languages mit de und en.
  3. Dashboard: Stele → Bezeichnungen → Shops (de) + Englisch (en) „Stores“ speichern.
  4. signage-surface → templateOptions.kiosk.shopsLabelByLocale.en === "Stores".
  5. v0 mit lang=en → Kachel „Stores“.

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/signage-editorial-by-locale