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; inpromoBox:titleByLocale,textByLocale; inidleTouchHint: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
| Lesen | Schreiben |
|---|---|
GET …/signage-surface, GET …/signage-template-options?template=ai-premium | Dashboard Stele → Bezeichnungen / Darstellung / Info-Box; Companion → Menü & Navigation; MCP cockpit_update_signage_template_options |
GET …/signage-surface → languages; PUT …/signage-global-options | Dashboard 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
- Sprache ermitteln: Cookie
app-lang, Query?lang=(siehe Public API — languages) oder App-i18n. - 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();
}
- 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.kioskLanguagessetzen (Dashboard oder MCP). - Mit Website: fehlt
kioskLanguages, gelten Website-header.languageOptions; istkioskLanguagesgesetzt, Codes aus Kiosk mit Website-Labels gemergt.
So testen
- Center alexa-berlin (Signage-only): Stele → Bezeichnungen → Kiosk-Sprachen → EN aktivieren, speichern.
GET …/signage-surface?centerId=…→surface.languagesmitdeunden.- Dashboard: Stele → Bezeichnungen → Shops (de) + Englisch (en) „Stores“ speichern.
signage-surface→templateOptions.kiosk.shopsLabelByLocale.en === "Stores".- v0 mit
lang=en→ Kachel „Stores“.
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/signage-editorial-by-locale