Howto: change the notification subject and allow KB images in GLPI version 0.90.3
For version 1.9.2 review: https://sysengineers.wordpress.com/2017/06/27/glpi-9-1-2-fix-inline-images-kb/
GLPI released their new version 0.90.3.
With new each release two questions seem to be very persistent. These questions are:
- How can we change the default notification prefix: [GLPI ] in the email subject.
- How do we enable images in the KB articles.
In this article you will be able to read my personal opinion on the matter and how to change this GLPI behavior.
Why do you want to change the GLPI notification prefix.
The most obvious reason is to allow your customer to quickly identify your companies tickets. The rule of thumb in modern system view design is enabling users to quickly: ‘scan, select. act’ Changing the subject to something intuitive enables your customers to do so.
Another point of interest is the possibility to daisy-chain multiple installations of GLPI. By configuring the notification subjects and schemes correctly you can daisy chain multiple installations allowing cross organization enterprise environments to be set up. This is impossible when all installations identify themselfs as ‘GLPI [key].’
How to alter the code to support your custom prefix in GLPI 0.90
In order to alter the subject prefix in GLPI 0.90, firstly you need to configure your prefix in the Administration>Entities>[your entity]>notifications>Prefix for notifications. Changing this configuration field will correctly alter the prefix to that of your liking. No further code-hacks are required or advised.
Why do you want images in your KB.
Well this is -in my humble opinion- an no brainer. One images shows more detail then i can describe in a thousand words. Images also help speed up the resolution process, especially during nightly hours. It also allows the engineer to intuitively compare the version of the actual situation with the situation documented. Is it all positive then? no, there are some downsides to consider as well.
An image doesn’t replace the engineers know-how and sometimes you want to explicitly trigger this knowledge by not showing any images. Updated applications might look different, actually slowing down the resolution process. Another more technical downside is web server storage. All images need to be stored somewhere and might needlessly clutter the support-system. My point of view is that you need to decide whats best for your situation. Sadly GLPI doesnt allow you to choose yet, it forces images to be removed. If you do need image support, please apply the code-hack below.
Be aware, This wont enable image export to pdf.
How to enable images in the KB
First we need to enable the INSERT function that enables us to add images using the TinyMCE editor. In order to do this two changes need to be made.
In the inc/html.class.php file on line:3837 and line:3871 comment out ( // ) the lines that reads _html = _html.replace .. See screenshots for more details.
Optionally you can enable the ‘image’ button by adding image to the ‘theme_advanced_buttons2 : ‘ line. See images underneath for more details.
The next step is to enable the images to be shown. Without this change the HTMLAWED plugin will add a denied tag to the actual images effectivly telling the browser not to show the image. Additionally the resulting HTML code including the denied: tag will be stored in database also disabling this specific image after the next code modification. Enabling the images afterward requires an search and replace statement in the database. (See comments below).
In the file /lib/htmlawed/htmLawed.php on line 47 add ‘;src: data’ to the end of the line.
Make sure you use an screenshot tool that generates an inline HTML image on the clipboard. Greenshot is an free alternative that does this out of the box.
Posted on December 6, 2015, in Apache 2.2 Linux, GLPI, Linux, PHP, Tooling and tagged 0.90, base, custom, enable, GLPI, images, In, KB, knowledge, notification, prefix, Version. Bookmark the permalink. 26 Comments.