@motor-cms/ui-admin 1.1.0-alpha.3 → 1.1.0-alpha.5

package/app/composables/useOnboardingState.ts

@@ -0,0 +1,151 @@
+import type { User } from '@motor-cms/ui-core/app/types/auth'
+
+// Extend this union as new areas are added
+export type OnboardingArea =
+  | 'dashboard-announcements'
+  | 'notifications'
+  | 'search'
+  | 'admin-nav'
+  | 'admin-grid'
+  | 'user-profile'
+  | 'builder-pages'
+
+const STORAGE_KEY = 'motor-onboarding-completed'
+const PENDING_KEY = 'motor-onboarding-pending'
+// Written before the completeOnboarding() API call so a hard reload between
+// skip/complete and the network response does not trigger a false restart.
+// Cleared by resetAll() so "restart tour" from profile overrides any prior done state.
+const DONE_KEY = 'motor-onboarding-done'
+
+function getCompleted(): Set<string> {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY)
+    return new Set(raw ? JSON.parse(raw) : [])
+  }
+  catch {
+    return new Set()
+  }
+}
+
+function persistCompleted(ids: Set<string>) {
+  localStorage.setItem(STORAGE_KEY, JSON.stringify([...ids]))
+}
+
+export function useOnboardingState(area: OnboardingArea) {
+  const { user } = useSanctumAuth<User>()
+  const userId = computed(() => user.value?.data?.id?.toString() ?? 'anonymous')
+  const key = computed(() => `${userId.value}:${area}`)
+
+  const isCompleted = computed(() => getCompleted().has(key.value))
+
+  function markCompleted() {
+    const completed = getCompleted()
+    completed.add(key.value)
+    persistCompleted(completed)
+  }
+
+  function reset() {
+    const completed = getCompleted()
+    completed.delete(key.value)
+    persistCompleted(completed)
+  }
+
+  return { isCompleted, markCompleted, reset }
+}
+
+/**
+ * Clears all completed onboarding areas for the current user from localStorage.
+ * Also clears the skip-committed flag so a "restart tour" from profile
+ * correctly overrides any previous skip.
+ */
+export function useOnboardingResetAll() {
+  const { user } = useSanctumAuth<User>()
+  const userId = computed(() => user.value?.data?.id?.toString() ?? 'anonymous')
+
+  function resetAll() {
+    const completed = getCompleted()
+    const areas: OnboardingArea[] = [
+      'dashboard-announcements',
+      'notifications',
+      'search',
+      'admin-nav',
+      'admin-grid',
+      'user-profile',
+      'builder-pages',
+    ]
+    for (const area of areas) {
+      completed.delete(`${userId.value}:${area}`)
+    }
+    persistCompleted(completed)
+    localStorage.removeItem(`${DONE_KEY}:${userId.value}`)
+  }
+
+  return { resetAll }
+}
+
+/**
+ * Cross-page trigger: marks which onboarding area should auto-start
+ * on the next page load. Scoped by user ID to prevent cross-user leakage.
+ */
+export function usePendingOnboarding() {
+  const { user } = useSanctumAuth<User>()
+  const userId = computed(() => user.value?.data?.id?.toString() ?? 'anonymous')
+
+  function setPending(area: OnboardingArea) {
+    localStorage.setItem(`${PENDING_KEY}:${userId.value}`, area)
+  }
+
+  function getPending(): OnboardingArea | null {
+    return (localStorage.getItem(`${PENDING_KEY}:${userId.value}`) as OnboardingArea) || null
+  }
+
+  function clearPending() {
+    localStorage.removeItem(`${PENDING_KEY}:${userId.value}`)
+  }
+
+  return { setPending, getPending, clearPending }
+}
+
+/**
+ * Records that the user has intentionally ended the tour (via skip OR normal
+ * completion). Written to localStorage BEFORE the completeOnboarding() API
+ * call so the flag survives a hard reload if the browser cancels the request.
+ * DashboardOnboarding checks this flag before calling resetOnboardingState()
+ * so a stale show_onboarding=true in the sanctum auth cache never triggers a
+ * false restart. Cleared by resetAll() so "restart tour" from the profile
+ * page correctly overrides any prior done state.
+ */
+export function useOnboardingDone() {
+  const { user } = useSanctumAuth<User>()
+  const userId = computed(() => user.value?.data?.id?.toString() ?? 'anonymous')
+
+  function commitDone() {
+    localStorage.setItem(`${DONE_KEY}:${userId.value}`, '1')
+  }
+
+  function isDone(): boolean {
+    return !!localStorage.getItem(`${DONE_KEY}:${userId.value}`)
+  }
+
+  return { commitDone, isDone }
+}
+
+/**
+ * Central guard: should the onboarding tour run for this user?
+ *
+ * Returns true only when BOTH conditions are met:
+ *   1. Backend says show_onboarding=true (fresh user or "restart tour" from profile)
+ *   2. User hasn't already completed/skipped the tour in this browser (isDone=false)
+ *
+ * Use this everywhere instead of hand-rolling the check.
+ */
+export function useOnboardingEnabled() {
+  const { user } = useSanctumAuth<User>()
+  const { isDone } = useOnboardingDone()
+
+  const isEnabled = computed(() => {
+    return !!user.value?.data?.show_onboarding && !isDone()
+  })
+
+  return { isEnabled }
+}

package/app/data/footerTemplate.ts

@@ -0,0 +1,283 @@
+import { generateUuid } from '@motor-cms/ui-core/app/utils/uuid'
+
+// Types mirror @zrmdev/ui-builder/app/types/builder/page-definition. Names
+// (HeadlineParagraphComponent, ImageComponent, HeadlineAtom, ParagraphAtom,
+// ButtonAtom, ImageAtom) match the renderer registry in
+// motor-ui-components/app/builder-registry/bootstrap.ts.
+
+// ============================================
+// Local type definitions (mirror page-definition)
+// ============================================
+
+interface CssProp {
+  key: string
+  value: string
+}
+
+interface PageAtom {
+  uuid: string
+  display_name: string
+  component_name: string
+  classes: string
+  attributes: Record<string, unknown>
+  locked_attributes: string[]
+  disabled: boolean
+  visible: boolean
+  cssProps?: CssProp[]
+  admin_scss?: string
+}
+
+interface ComponentSlot {
+  uuid: string
+  name: string
+  display_name: string
+  allowedAtoms: string[]
+  atoms: PageAtom[]
+}
+
+interface PageComponent {
+  uuid: string
+  name: string
+  display_name: string
+  icon: string
+  classes: string
+  cssClassName: string
+  visible: boolean
+  disabled: boolean
+  attributes: Record<string, unknown>
+  component_slot_name: string | null
+  component_slot_prefix: string | null
+  is_removable: number
+  is_duplicatable: number
+  min_amount_in_another_component: number
+  display_viewports: string
+  slots: ComponentSlot[]
+  components: PageComponent[]
+  scorings: unknown[]
+  scoring_component_configuration: { score: number; topic_id: number; comparison_operator: string }
+  anchors: unknown[]
+  admin_scss?: string
+}
+
+interface PageColumn {
+  uuid: string
+  classes: string
+  display_name: string
+  value_as_grid_column: number
+  rows: PageRow[]
+  components: PageComponent[]
+  admin_scss?: string
+}
+
+interface PageRow {
+  uuid: string
+  display_name: string
+  classes: string
+  global_css: string
+  cols: PageColumn[]
+  admin_scss?: string
+}
+
+type PageDefinition = PageRow[]
+
+// ============================================
+// Builder helpers
+// ============================================
+
+function makeAtom(
+  display_name: string,
+  component_name: string,
+  attributes: Record<string, unknown> = {}
+): PageAtom {
+  return {
+    uuid: generateUuid(),
+    display_name,
+    component_name,
+    classes: '',
+    attributes,
+    locked_attributes: [],
+    disabled: false,
+    visible: true
+  }
+}
+
+function makeSlot(
+  name: string,
+  display_name: string,
+  allowedAtoms: string[],
+  atoms: PageAtom[]
+): ComponentSlot {
+  return {
+    uuid: generateUuid(),
+    name,
+    display_name,
+    allowedAtoms,
+    atoms
+  }
+}
+
+function makeComponent(
+  name: string,
+  display_name: string,
+  cssClassName: string,
+  slots: ComponentSlot[],
+  attributes: Record<string, unknown> = {},
+  components: PageComponent[] = []
+): PageComponent {
+  return {
+    uuid: generateUuid(),
+    name,
+    display_name,
+    icon: '',
+    classes: '',
+    cssClassName,
+    visible: true,
+    disabled: false,
+    attributes,
+    component_slot_name: null,
+    component_slot_prefix: null,
+    is_removable: 1,
+    is_duplicatable: 1,
+    min_amount_in_another_component: 0,
+    display_viewports: 's,t,m,l,xl',
+    slots,
+    components,
+    scorings: [],
+    scoring_component_configuration: { score: 0, topic_id: 0, comparison_operator: '' },
+    anchors: []
+  }
+}
+
+function makeColumn(
+  display_name: string,
+  value_as_grid_column: number,
+  components: PageComponent[]
+): PageColumn {
+  return {
+    uuid: generateUuid(),
+    classes: '',
+    display_name,
+    value_as_grid_column,
+    rows: [],
+    components
+  }
+}
+
+function makeRow(display_name: string, cols: PageColumn[], classes = ''): PageRow {
+  return {
+    uuid: generateUuid(),
+    display_name,
+    classes,
+    global_css: '',
+    cols
+  }
+}
+
+// ============================================
+// Footer template factory
+// ============================================
+
+const PLACEHOLDER_IMAGE = '/images/general/frau_mit_kind.jpeg'
+
+const TEXT_SLOT_ALLOWED = ['OverlineAtom', 'HeadlineAtom', 'ParagraphAtom', 'ButtonAtom', 'ImageAtom', 'VideoAtom']
+
+function textContentComponent(
+  display_name: string,
+  atoms: PageAtom[],
+  attributes: Record<string, unknown> = { has_background: false }
+): PageComponent {
+  return makeComponent(
+    'HeadlineParagraphComponent',
+    display_name,
+    'headline-paragraph',
+    [makeSlot('content', 'Content', TEXT_SLOT_ALLOWED, atoms)],
+    attributes
+  )
+}
+
+function headlineAtom(text: string, level: 'h2' | 'h3' | 'h4' = 'h3'): PageAtom {
+  return makeAtom('Headline', 'HeadlineAtom', {
+    text,
+    type: level,
+    displayedLevel: level,
+    weight: 'bold'
+  })
+}
+
+function paragraphAtom(text: string): PageAtom {
+  return makeAtom('Paragraph', 'ParagraphAtom', {
+    text,
+    bullet_type: 'check__default',
+    orderedlist_type: 'decimal'
+  })
+}
+
+function buttonAtom(title: string): PageAtom {
+  return makeAtom('Button', 'ButtonAtom', {
+    title,
+    link: '',
+    variant: 'dark',
+    has_arrow: false
+  })
+}
+
+function imageAtom(display_name: string): PageAtom {
+  return makeAtom(display_name, 'ImageAtom', {
+    src: PLACEHOLDER_IMAGE,
+    alt: display_name
+  })
+}
+
+function imageComponent(display_name: string, extraClasses = ''): PageComponent {
+  const c = makeComponent(
+    'ImageComponent',
+    display_name,
+    'image',
+    [makeSlot('content', 'Content', ['ImageAtom'], [imageAtom(display_name)])]
+  )
+  if (extraClasses) c.classes = extraClasses
+  return c
+}
+
+export function createFooterTemplate(): PageDefinition {
+  // ---- Row 1: 6/6 split ----
+  // Col 1: intro text (Headline + Paragraph)
+  // Col 2: three award badges, each its own ImageComponent
+  const row1 = makeRow('Row 1', [
+    makeColumn('Column 1', 6, [
+      textContentComponent('Intro', [
+        headlineAtom('Headline', 'h2'),
+        paragraphAtom('Paragraph')
+      ])
+    ]),
+    makeColumn('Column 2', 6, [
+      imageComponent('Badge 1', 'footer-badge'),
+      imageComponent('Badge 2', 'footer-badge'),
+      imageComponent('Badge 3', 'footer-badge')
+    ])
+  ])
+
+  // ---- Row 2: four 3/12 columns ----
+  // Col 1: Kontakt (pre-filled headline)
+  // Col 2-4: nav-style headline + paragraph + CTA button
+  // Row gets the white inset card chrome inside the peach FooterFrame.
+  const row2 = makeRow('Row 2', [
+    makeColumn('Column 1', 3, [
+      textContentComponent('Kontakt', [
+        headlineAtom('Kontakt', 'h3'),
+        paragraphAtom('Paragraph')
+      ])
+    ]),
+    ...['Column 2', 'Column 3', 'Column 4'].map((label) =>
+      makeColumn(label, 3, [
+        textContentComponent(label, [
+          headlineAtom('Headline', 'h3'),
+          paragraphAtom('Paragraph'),
+          buttonAtom('CTA Button')
+        ])
+      ])
+    )
+  ], 'footer-content-card')
+
+  return [row1, row2]
+}

package/app/lang/de/motor-admin/ai_system_prompts.json

@@ -7,6 +7,7 @@
   "prompt_description": "Der System-Prompt-Text, der an das KI-Modell gesendet wird",
   "create_title": "KI-System-Prompt erstellen",
   "edit_title": "KI-System-Prompt bearbeiten",
+  "view_title": "KI-System-Prompt ansehen",
   "created_success": "KI-System-Prompt erfolgreich erstellt.",
   "updated_success": "KI-System-Prompt erfolgreich aktualisiert."
 }

package/app/lang/de/motor-admin/categories.json

@@ -5,6 +5,7 @@
   "add": "Kategorie hinzufügen",
   "create_title": "Kategorie erstellen",
   "edit_title": "Kategorie bearbeiten",
+  "view_title": "Kategorie ansehen",
   "created_success": "Kategorie wurde erfolgreich erstellt",
   "updated_success": "Kategorie wurde erfolgreich aktualisiert",
   "parent": "Übergeordnete Kategorie",

package/app/lang/de/motor-admin/category_trees.json

@@ -6,9 +6,10 @@
   "add": "Kategoriebaum hinzufügen",
   "create_title": "Kategoriebaum erstellen",
   "edit_title": "Kategoriebaum bearbeiten",
+  "view_title": "Kategoriebaum ansehen",
   "created_success": "Kategoriebaum wurde erfolgreich erstellt",
   "updated_success": "Kategoriebaum wurde erfolgreich aktualisiert",
-  "children": "Kinder",
+  "children": "Kategorien",
   "children_title": "Kategorien in \"{name}\"",
   "children_subtitle": "Kategorien in diesem Baum verwalten"
 }

package/app/lang/de/motor-admin/clients.json

@@ -6,6 +6,7 @@
   "add": "Mandant hinzufügen",
   "create_title": "Mandant erstellen",
   "edit_title": "Mandant bearbeiten",
+  "view_title": "Mandant ansehen",
   "created_success": "Mandant erfolgreich erstellt.",
   "updated_success": "Mandant erfolgreich aktualisiert.",
   "slug": "Slug",
@@ -22,5 +23,20 @@
   "contact_phone": "Telefon",
   "group_address": "Adresse",
   "group_contact": "Kontakt",
-  "group_other": "Sonstiges"
+  "group_other": "Sonstiges",
+  "frontend_config_title": "Frontend-Konfiguration",
+  "global_components": {
+    "title": "Globale Komponenten",
+    "footer": "Footer",
+    "no_footer": "Kein Footer konfiguriert",
+    "create_footer": "Footer erstellen",
+    "edit_footer": "Footer bearbeiten",
+    "unlink_footer": "Verknüpfung lösen",
+    "footer_created": "Footer erfolgreich erstellt.",
+    "published": "Veröffentlicht",
+    "draft": "Entwurf",
+    "unlink_confirm": "Möchten Sie die Verknüpfung zu diesem Footer wirklich lösen?",
+    "unlink_effect": "Der Footer wird nicht gelöscht, sondern nur die Verknüpfung zum Mandanten entfernt.",
+    "no_languages": "Keine Sprachen für diesen Mandanten konfiguriert. Erstellen Sie zuerst Navigationsbäume."
+  }
 }

package/app/lang/de/motor-admin/config_variables.json

@@ -9,6 +9,7 @@
   "is_invisible": "Versteckt",
   "create_title": "Konfigurationsvariable erstellen",
   "edit_title": "Konfigurationsvariable bearbeiten",
+  "view_title": "Konfigurationsvariable ansehen",
   "created_success": "Konfigurationsvariable erfolgreich erstellt.",
   "updated_success": "Konfigurationsvariable erfolgreich aktualisiert."
 }

package/app/lang/de/motor-admin/dashboard.json

@@ -0,0 +1,83 @@
+{
+  "welcome": "Willkommen, {name}",
+  "announcement_created": "Meldung erstellt",
+  "announcement_dismissed": "Meldung ausgeblendet",
+  "stats": {
+    "pages": "Seiten",
+    "pages_total": "Gesamt",
+    "drafts": "Entwürfe",
+    "drafts_subtitle": "In Bearbeitung",
+    "scheduled": "Geplant",
+    "scheduled_subtitle": "Veröffentlichung",
+    "media": "Medien",
+    "media_subtitle": "Dateien"
+  },
+  "activity": {
+    "title": "Letzte Aktivitäten",
+    "empty": "Noch keine Aktivitäten",
+    "unknown": "Unbekannt",
+    "system": "System",
+    "verbs": {
+      "created": "erstellt",
+      "updated": "aktualisiert",
+      "deleted": "gelöscht",
+      "published": "veröffentlicht",
+      "unpublished": "offline genommen"
+    },
+    "types": {
+      "page": "Seite",
+      "navigation": "Navigation",
+      "media": "Medien",
+      "content_type": "Inhaltstyp",
+      "assistant": "Assistent",
+      "scoring": "Scoring",
+      "scheduled": "Geplant",
+      "approval": "Freigabe",
+      "seo": "SEO",
+      "search": "Suche"
+    }
+  },
+  "announcements": {
+    "title": "Meldungen",
+    "empty": "Keine Meldungen",
+    "modal_title": "Neue Meldung",
+    "field_title": "Titel",
+    "field_title_placeholder": "Meldung eingeben...",
+    "field_body": "Beschreibung",
+    "field_body_placeholder": "Optionale Details...",
+    "field_type": "Typ",
+    "field_audience": "Zielgruppe",
+    "field_users": "Nutzer auswählen",
+    "field_users_placeholder": "Nutzer suchen...",
+    "field_client": "Mandant auswählen",
+    "field_client_placeholder": "Mandant wählen...",
+    "field_link": "Verknüpfung (optional)",
+    "field_link_type_placeholder": "Typ wählen...",
+    "field_link_item": "Element",
+    "field_link_item_placeholder": "Element suchen...",
+    "field_starts_at": "Sichtbar ab",
+    "field_expires_at": "Sichtbar bis",
+    "cancel": "Abbrechen",
+    "create": "Erstellen",
+    "type_info": "Info",
+    "type_warning": "Warnung",
+    "type_error": "Fehler",
+    "audience_self": "Nur für mich",
+    "audience_users": "Bestimmte Nutzer",
+    "audience_client": "Alle im Mandanten",
+    "linkable_page": "Seite",
+    "linkable_navigation": "Navigationspunkt",
+    "linkable_file": "Datei",
+    "linkable_content_type": "Inhaltstyp"
+  },
+  "quick_actions": {
+    "title": "Schnellaktionen",
+    "new_page": "Neue Seite",
+    "upload_media": "Medien hochladen",
+    "navigation": "Navigation"
+  },
+  "publishing_queue": {
+    "title": "Geplante Veröffentlichungen",
+    "empty": "Keine geplanten Veröffentlichungen"
+  }
+}

package/app/lang/de/motor-admin/domains.json

@@ -6,6 +6,7 @@
   "add": "Domain hinzufügen",
   "create_title": "Domain erstellen",
   "edit_title": "Domain bearbeiten",
+  "view_title": "Domain ansehen",
   "created_success": "Domain erfolgreich erstellt.",
   "updated_success": "Domain erfolgreich aktualisiert.",
   "host": "Host",
@@ -14,6 +15,10 @@
   "path": "Pfad",
   "target": "Ziel",
   "parameters": "Parameter",
+  "is_preview_domain": "Vorschau-Domain",
+  "is_canonical": "Kanonische Domain für SEO",
+  "is_canonical_description": "Wenn dieser Client mehrere Domains hat (z. B. Vanity-URLs): Diese ist die kanonische Domain — Canonical-Tags zeigen darauf und konsolidieren das SEO-Signal. Nur eine Domain pro Client kann kanonisch sein.",
   "group_connection": "Verbindung",
-  "group_routing": "Routing"
+  "group_routing": "Routing",
+  "group_seo": "SEO"
 }

package/app/lang/de/motor-admin/email_templates.json

@@ -5,6 +5,7 @@
   "add": "E-Mail-Vorlage hinzufügen",
   "create_title": "E-Mail-Vorlage erstellen",
   "edit_title": "E-Mail-Vorlage bearbeiten",
+  "view_title": "E-Mail-Vorlage ansehen",
   "slug": "Slug",
   "slug_description": "URL-freundlicher Bezeichner, automatisch aus dem Namen generiert",
   "subject": "Betreff",

package/app/lang/de/motor-admin/entity_configurations.json

@@ -0,0 +1,12 @@
+{
+  "title": "Entity-Konfigurationen",
+  "config_variable": "Konfigurationsvariable",
+  "value": "Wert",
+  "add": "Konfiguration hinzufügen",
+  "save": "Speichern",
+  "saved": "Konfiguration gespeichert",
+  "removed": "Konfiguration entfernt",
+  "no_configurations": "Noch keine Konfigurationen zugeordnet.",
+  "select_variable": "Konfigurationsvariable auswählen",
+  "confirm_remove": "Diese Konfiguration entfernen?"
+}

package/app/lang/de/motor-admin/languages.json

@@ -9,6 +9,7 @@
   "native_name": "Eigenname",
   "create_title": "Sprache erstellen",
   "edit_title": "Sprache bearbeiten",
+  "view_title": "Sprache ansehen",
   "created_success": "Sprache erfolgreich erstellt.",
   "updated_success": "Sprache erfolgreich aktualisiert.",
   "iso_639_1": "ISO 639-1 Code",