👋 Available on iTop Hub & Molkobain I/O!

iTop extension: molkobain-console-tooltips

• Description
• Compatibility
• Downloads
• Installation
• Configuration
• Change log

Support

If you like this project, you can buy me beer, always appreciated! 🍻😁

Description

Display a tooltip on object's attributes (console only). A ? is added next to the attribute's label to indicate that a description is available for an attribute.

Works with all objects (standard / from extensions / custom made), but only attributes for which a description exists will be affected.

Can be set on any field, to provide a long description to explain the usage of a particular field. This description can be more explicit to explain the meaning and expected usage of the field.

Description comes from iTop's dictionary entry 'Class:<CLASS_NAME>/Attribute:<ATTRIBUTE_CODE>+' => 'Some description about the attribute'.

As part of the standard datamodel, only few fields have such description documented, especially because it is specific to the way an organization uses iTop. But with this extension, it's a good opportunity to enrich your dictionnary with business tooltips for online guidance to your users.

Note: By default iTop has not much descriptions, if you want to add some, you have to add dictionary entries.

Compatibility

Compatible with iTop 2.3+

Dependencies

• Module molkobain-handy-framework/1.3.0
• Module molkobain-newsroom-provider/1.0.1

Note: All dependencies are included in the dist/ folder, so all you need to do is follow the installation section below.

Downloads

Stable releases can be found either on the releases page, iTop Hub or on Molkobain I/O.

Downloading it directly from the Clone or download will get you the version under development which might be unstable.

Installation

• Unzip the extension
• Copy the molkobain-console-tooltip folder under <PATH_TO_ITOP>/extensions folder of your iTop
• Run iTop setup & select extension Attributes description tooltip

Your folders should look like this

Configuration

No configuration needed, the extension can be used out of the box!

Parameters

Some configuration parameters are available from the Configuration editor of the console:

• enabled Enable or disable extension. Possible values are true or false, default is true.
• decoration_class Change tooltip icon by setting any Font Awesome 5 icon classes (see here for examples). Default is fas fa-question.

Example:

'molkobain-console-tooltips' => array (
  'enabled' => true,
  'decoration_class' => 'fas fa-question',
),

Licensing

This extension is under AGPLv3.

Third party libs

This extension embeds the Font Awesome 5.0.6 library. For more information visit its website.