Le logo par défaut BlueMind, visible sur l'écran de connexion et dans le bandeau de navigation de BlueMind peut désormais être personnalisé et remplacé par une image de votre choix.

Résultat de la personnalisation

Une fois le logo personnalisé, il se présente comme suit dans les différentes parties de BlueMind :

• sur la page d'accueil, en lieu et place du logo BlueMind, apparaît le nouveau logo encadré de blanc. Le logo BlueMind est alors toujours visible sous le formulaire de connexion :
  
• dans le bandeau, une fois connecté, le logo personnalisé apparaît en haut à gauche.
  Le logo BlueMind est partiellement présent à sa gauche, lorsque l'utilisateur passe la souris dessus, le logo se déroule et informe sur la version actuelle de BlueMind :
  

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.

La couleur de fond est le bleu foncé, ainsi toutes les zones transparentes de l'image apparaîtront bleu foncé aux utilisateurs. Pour une autre couleur de fond, remplacez les zones transparentes de votre image par la couleur souhaitée.

Mise en œuvre

Mettre en place un nouveau logo

Tapez la commande suivante :

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --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, lui seul peut modifier l'image.

  Astuce
  le token peut être trouvé dans le fichier /etc/bm/bm-core.tok

• @/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.

  Remarque
  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 'Accept: application/json' --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. Si le token est incorrect, une erreur "PERMISSION DENIED" est retournée

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

Enregistrer

Enregistrer

Enregistrer

The default BlueMind logo, which can be seen on the application's log in screen and in the navigation bar, can now be customized and replaced by any image you choose.

Customization results

The screenshot below shows how the custom logo will look like in BlueMind:

• on the homepage, instead of the BlueMind logo, the new logo is shown in a white frame. The BlueMind logo still appears below the log in form:
  
• in the navigation bar, once online, the custom logo is shown in the top left corner.
  Part of the BlueMind logo can still be seen on the left, and when the user hovers over it the BlueMind logo expands showing the version number being used:
  

Image prerequisites

The logo must be:

• in PNG format
• 140x40 pixels in resolution
  If these dimension requisites are not met, the image will be resized automatically to fit within the set space, which is why we recommend that you pay extra attention to image size.

The background is dark blue, which means that all transparent areas in the picture will show as dark blue. If you want a different background color, make sure you replace any transparent areas in your picture by the desired color.

Implementation

Adding a new logo

Enter the following command:

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' --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'

Replacing:

• TOKEN_ADMIN0: only the admin0 token can modify the image.

  Astuce
  This token can be found in /etc/bm/bm-core.tok

• @/path/to/logo.png: the path to the image file.
  This can be a local path (the file is located on the server on which the operation is being performed) or a remote one.

  Remarque
  You must always keep the @ symbol before the path when using a local path.

• mail.bluemind.loc: the relevant BlueMind url.

Reverting to the original BlueMind logo

To revert to the default BlueMind logo, simply delete the customized logo:

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

Replacing:

• TOKEN_ADMIN0: only the admin0 token can modify the image. If the token is incorrect you will get a "PERMISSION DENIED" warning

• mail.bluemind.loc: the relevant BlueMind url.

Enregistrer