Personnaliser le logo de l'application

Le logo par défaut visible dans le bandeau de navigation des applications BlueMind peut être personnalisé et remplacé par une image de votre choix :

Environnement mutualisé / multi-domaines

Le logo concerne une installation, c'est donc le même logo qui apparaitra quel que soit le domaine.

Préparation de l'image

Le nouveau logo doit respecter les prérequis suivants :

• Format : PNG
• Dimensions (l,h) : 140x40 pixels
  ⚠️ Si les dimensions ne sont pas respectées, l'image sera automatiquement redimensionnée afin de pouvoir être intégrée dans l'espace défini. Il est donc recommandé de porter une attention particulière aux proportions de l'image.
• Couleur de fond : la couleur de fond du bandeau est le bleu foncé, ainsi toutes les zones transparentes de l'image apparaîtront bleu foncé aux utilisateurs.

  💡 code hexadécimal : #0a2a86

Mise en œuvre

Mettre en place un nouveau logo

Tapez la commande suivante :

curl -X PUT --header 'X-BM-ApiKey: TOKEN_ADMIN0' -H "Content-Type: application/octet-stream" --data-binary "@/path/to/logo.png" 'https://mail.bluemind.loc/api/system/installation/logo'

En remplaçant :

• TOKEN_ADMIN0 : le token de l'admin0 ou une de ses clés API, lui seul peut modifier l'image.

  💡 Le token se trouve dans le fichier /etc/bm/bm-core.tok
   
  NB : Si le token est incorrect, une erreur PERMISSION DENIED est retournée

• @/path/to/logo.png : le chemin vers le fichier image. Il peut s'agir d'un chemin local (le fichier se trouve sur la machine sur laquelle est effectuée la manipulation) ou distant.

  💡 Il faut toujours conserver le symbole @ devant le chemin en cas d'utilisation d'un chemin local.

• mail.bluemind.loc : l'url du BlueMind concerné

Revenir au logo initial

Pour revenir au logo par défaut de BlueMind, il suffit de supprimer le logo personnalisé :

curl -X DELETE --header 'X-BM-ApiKey: TOKEN_ADMIN0' 'https://mail.bluemind.loc/api/system/installation/logo'

En remplaçant :

• TOKEN_ADMIN0 : le token de l'admin0, lui seul peut modifier l'image.

  NB : Si le token est incorrect, une erreur PERMISSION DENIED est retournée

• mail.bluemind.loc : l'url du BlueMind concerné