Branding

Was zum Branding gehört#

Alle drei Angaben sind freiwillig. Das Branding wird einmal festgelegt und überall verwendet, wo die Plattform sich zeigt.

Bei der Installation#

Die Installation fragt nach Firmenname, Logo und Favicon, aber nur, wenn noch keine der drei Angaben gesetzt ist. Für eine automatisierte Installation gibst du sie direkt mit:

sudo aictl install --brand-name "Muster AG" \
  --brand-logo-url https://firma.ch/logo.png \
  --brand-favicon-url https://firma.ch/favicon.png

Ohne Terminal und ohne diese Optionen bleibt das Branding leer. Schlägt das Herunterladen der Bilder fehl, läuft die Installation trotzdem weiter. Die Plattform startet dann ohne Bilder, und aictl empfiehlt, die Adresse zu korrigieren und brand edit erneut auszuführen.

Branding anzeigen#

sudo aictl brand show

Der Befehl zeigt Name, Logo und Favicon. Für jedes Bild siehst du die Adresse, von der es stammt, und die Kopie auf dem Server mit Grösse und Abrufzeitpunkt. Zusätzlich weist er auf diese Fälle hin:

• «not fetched yet»: Das Bild ist noch nicht heruntergeladen. Führe sudo aictl apply aus.
• «copy is from …»: Die Kopie stammt noch von einer früheren Adresse. Führe sudo aictl apply aus.

Ist nichts eingerichtet, erscheint «No brand configured.».

Branding ändern#

Ohne Optionen fragt der Befehl jede Angabe einzeln ab, vorausgefüllt mit dem aktuellen Wert:

sudo aictl brand edit

• Enter übernimmt den angezeigten Wert.
• Leerst du ein Feld, wird die Angabe entfernt.
• Adressen müssen mit http:// oder https:// beginnen.

Für Skripte gibst du nur das an, was sich ändern soll:

sudo aictl brand edit --logo-url https://firma.ch/logo.png
sudo aictl brand edit --clear-favicon

Eine geänderte Adresse wird sofort heruntergeladen. Eine falsche Adresse fällt also gleich auf und nicht erst später. Damit die Erweiterungen und die Anmeldeseite das neue Branding erhalten, führst du danach aus:

sudo aictl apply

Anforderungen an die Bilder#

• Öffentliche Adresse: Logo und Favicon gibst du als Internetadresse an. Die Plattform lädt sie auf den Server herunter. Du musst nichts von Hand kopieren.
• Nur PNG oder JPEG. Massgebend ist, als was der Webserver die Datei ausliefert, nicht die Dateiendung in der Adresse. Liefert dein Webserver ein PNG zum Beispiel als allgemeine Binärdatei aus, wird es abgelehnt.
• Kein SVG. Das Logo landet auch in erzeugten Word-Dokumenten, und diese können kein SVG einbetten. Am Bildschirm sähe alles richtig aus, aber in jedem Dokument, das dein Team verschickt, würde das Logo fehlen.
• Höchstens 5 MB und nicht leer.
• Ein Logo für alles: Es gibt nur ein Logo für alle Bereiche, und alle Bereiche sind hell. Die Anmeldeseite ist fest auf das helle Erscheinungsbild eingestellt, damit sie zu den Erweiterungen passt. Wähle also ein Logo, das auf weissem Hintergrund gut lesbar ist.

Typische Fehlermeldungen:

Wo die Bilder liegen#

Die heruntergeladenen Kopien liegen unter /var/lib/aictl/brand. Anmeldeseite und Erweiterungen zeigen beide diese Kopie. Ist die ursprüngliche Adresse später nicht mehr erreichbar, bleibt alles, wie es ist, und die Browser deines Teams laden das Logo nie von deiner Website, sondern immer vom eigenen Server.

Bilder aktualisieren#

apply und update laden ein Bild nur neu herunter, wenn sich seine Adresse ändert oder die Kopie fehlt. Ersetzt du die Datei auf deinem Webserver unter derselben Adresse, führe sudo aictl brand edit aus und bestätige die Werte mit Enter. brand edit lädt die Bilder immer neu. Bis dahin zeigen Anmeldeseite und Erweiterungen weiter das bisherige Logo, aber immer dasselbe.

Sonderfälle#

• Falsche Adresse: brand edit lädt die Bilder, bevor es die Einstellungen speichert. Schlägt der Abruf fehl, bleibt alles, wie es war.
• Abruf scheitert bei apply oder update: Die Plattform behält die Kopien, die sie schon hat, und warnt. Prüfe den Stand mit sudo aictl brand show.
• Entfernen: Leerst du Name, Logo oder Favicon in aictl, zeigt die Anmeldeseite nach apply wieder den Standard. Was du in der Benutzerverwaltung von Hand gesetzt hast, bleibt stehen.
• Chat: Der Chat zeigt nur den Firmennamen, ergänzt um den Namen der Chat-Software in Klammern. Logo und Favicon des Chats bleiben unverändert, das verlangt die Lizenz der Chat-Software.
• Anmeldeseite ohne Firmen-Login: Die Anmeldeseite wird nur gestaltet, wenn der Firmen-Login veröffentlicht ist. Siehe Benutzer und Anmeldung.
• Backup: Die Adressen sind Teil der Einstellungen und damit im Backup. Die heruntergeladenen Bilder sind es nicht. Die Wiederherstellung holt sie erneut von den gespeicherten Adressen.