Anpassungspakete (Marken-Voreinstellungen)

Anpassungspakete sind fertige Marken-Voreinstellungen, die du in composer.json deklarierst. Der Admin wählt eines davon im Branding-Tab des Vertriebskanals aus, und alle Farben, Radien und Schriftarten im Formular werden mit einem Klick auf die Werte des Pakets gesetzt. Sie sind die schnellste Möglichkeit, Kunden eine Option zum „Zurücksetzen auf Standardwerte“ zu geben oder einige ausgewählte Designs bereitzustellen (eine helle Voreinstellung, eine dunkle Voreinstellung, eine saisonale Farbpalette).

Paket zu composer.json hinzufügen

Pakete werden unter extra.theme.customizationPackages definiert. Jeder Eintrag benötigt eine id, ein label und eine branding-Map. Eine description ist optional, wird dem Admin aber angezeigt.

{
  "extra": {
    "theme": {
      "customizationPackages": [
        {
          "id": "evolution-default",
          "label": "Evolution Default",
          "description": "The original Evolution branding.",
          "branding": {
            "branding_primary":       "#175cd3",
            "branding_secondary":     "#1d1c1f",
            "branding_success":       "#2eb67d",
            "branding_danger":        "#da1e04",
            "branding_warning":       "#f2ac0d",
            "branding_body_bg":       "#f5f5f5",
            "branding_card_bg":       "#ffffff",
            "branding_border_color":  "#e5e5e6",
            "branding_border_radius": 4,
            "branding_font_family":   "Space Grotesk"
          }
        }
      ]
    }
  }
}

Die branding-Map akzeptiert jeden Schlüssel, den das Branding-Formular des Admins verwendet. Alles, was du weglässt, behält den Wert, den der Vertriebskanal bereits hatte. Unter Theme-SCSS mit Markeneinstellungen kompilieren erfährst du, welche Funktion die einzelnen Schlüssel zur Compile-Zeit haben.

Was der Admin sieht

Pakete werden als anklickbare Karten oberhalb der einzelnen Farbfelder im Branding-Tab angezeigt. Wenn der Admin auf eine Karte klickt, werden alle Eingabefelder des Formulars mit den Werten des Pakets ausgefüllt. Anschließend kann er jedes Feld vor dem Speichern bearbeiten.

Der Klick ist eine reine clientseitige Vorbelegung. Die Auswahl wird nicht gespeichert, daher speichert der Vertriebskanal nur die aufgelösten Einzelwerte und nicht die Paket-ID. Wenn der Admin den Tab erneut öffnet, sieht er die aktuellen Werte und nicht das Paket, das er zuletzt ausgewählt hat.