UI Branding GLPI Plugin

This plugin is used to customize brand-related images of your GLPI instance.

📋 Functionalities

• Customization of overall used brand logos (three different logo sizes)
• Customization of the page title (shown in tab)
• Add a background image to the login page

📌 Information

This plugin got restructured completely to match GLPI 11 and (hopefully) its successors. The plugin initially emerged from https://github.com/stdonato/glpi-modifications as the original author did not continue to support the original plugin. Since the plugin was forked from the original one, all of its code was rewritten and aligned to new GLPI guidelines.

This plugin and its maintainers are not connected to the GLPI project.

📤 Migration from GLPI 10.x

Since the plugin is very lightweight and does not really do much (no database tables ecc.), we decided to not have a "real" migration (current custom images will be lost). If you want to reuse your customized images, please create a backup before installing the new version into the GLPI plugins folder. The images are located in /var/www/html/glpi/plugins/mod/resources. Additionally, please remove the current backup directory located in /var/lib/glpi/_plugins/mod/backups.

🔧 Installation

Important

For installation procedures of older versions, please have a look at the readme in the version-corresponding branch!

1. Download the latest version from https://github.com/i-Vertix/glpi-modifications/releases.

2. Extract the archive into the GLPI plugins or marketplace folder, located in your glpi root directory (when updating, make sure to delete the current mod folder first)

3. The new folder inside of plugins/marketplace must be named mod

4. The following additional permissions are required for the plugin to work properly (change apache to your webserver-related username):

   In case you installed in /plugins:

   chown -R apache: /var/www/html/glpi/public/pics
   chown -R apache: /var/www/html/glpi/plugins/mod/resources
   find /var/www/html/glpi/plugins/mod -type f -exec chmod 0644 {} \;
   find /var/www/html/glpi/plugins/mod -type d -exec chmod 0755 {} \;

   In case you installed in marketplace:

   chown -R apache: /var/www/html/glpi/public/pics
   chown -R apache: /var/www/html/glpi/marketplace/mod/resources
   find /var/www/html/glpi/marketplace/mod -type f -exec chmod 0644 {} \;
   find /var/www/html/glpi/marketplace/mod -type d -exec chmod 0755 {} \;

   All other required file permissions should already be given by a correct glpi installation (such as permissions in /var/lib ecc).

   In case you are using SELinux, you must verify that your apache/webserver user has the permission to chmod his own files (necessary to uninstall the plugin correctly). With this command you can disable SELinux for apache/webserver-related stuff (to verify):

   setsebool -P httpd_unified 1

5. In case you migrated from GLPI 10 and created a backup of your customized images you can now move the image backups to /var/www/html/glpi/plugins/mod/resources/images (or /var/www/html/glpi/marketplace/mod/resources/images)

6. Log into GLPI with a super-admin account and install the plugin

7. After the installation is completed, activate the plugin

👨‍🔧 Use the plugin

Access the UI Branding page from the Configure button on the list item of your plugin page.

This is the only page this plugin brings into your GLPI instance.

In case you want to revert to the original images, deactivate all entries under Apply Modifications. The rest is more or less self-explanatory.

If you uninstall the plugin or disable it, all backups are restored automatically.

🗿 Uninstall

Please uninstall the plugin from the GLPI plugins page before removing any plugin files! Otherwise, all backups of original files are lost. We do not take any credit for any loss of original files!

📢 Notice

The plugin is and will not be published on the GLPI marketplace.