Trace: » GLPI Custom Fields Plugin

GLPI Custom Fields Plugin

General Information

The Custom Fields plugin allows administrators to add additional data fields to computers, disks, monitors, software, networks, ports, devices, printers, cartridges, consumables, phones, tracking (tickets), contacts, suppliers, contracts, and documents. If your organization needs to track information that is not included in the default GLPI fields, this plugin is the ideal solution for you.

Development of this plugin was sponsored by the Oregon Department of Administrative Services, State Data Center.

Installation

  1. Decompress the archive in the plugin folder of GLPI
  2. Log on as administrator
  3. Go to Setup > Plugins, and then click on Install
  4. Click on Activate

Basic Configuration & Usage

Next you need to add some custom fields to a device type. GLPI administrators can access the configuration screen from the Plugins > Custom Fields menu. If you want to add dropdown menus, you must first configure them by clicking Manage Custom Dropdowns found in the main configuration screen. All other fields can be added in a single step on the configuration screen for the device type. After a field has been added for a device type, you may enable that device type by clicking the Enable button on the device configuration screen.

Once custom fields have been activated, users may access the additional fields by navigating to a device, and clicking on the Custom Fields tab.

Rights

Custom fields inherit the rights (and entity) of the device type that they are associated with.

Activating Additional Functionality

By default, custom fields are integrated into the search feature. If you want to enable the ability to log changes, perform mass updates, and use the data injection plugin with your custom fields, follow the instructions found in the patch directory of this plugin.

Auto Activate

By default, when you activate custom fields for a device type, the custom fields section is automatically activated for all devices of that type. If you prefer to manually activate and deactivate custom fields on a device-by-device basis, find the following line in setup.php:

define('CUSTOMFIELDS_AUTOACTIVATE', true); and change it to define('CUSTOMFIELDS_AUTOACTIVATE', false);

Cloning Fields

It is easy to add the same custom field to several device types. First, just add the field to the first device type. Then go to the custom fields configuration screen for the second device type. Select the field you want to clone from the dropdown menu in the Clone Field area and click Add.

Upgrade Procedure

If you want to upgrade this plugin to a new version, first deactivate the plugin. Log out of GLPI and replace the old plugin files with the new plugin files. Then log into GLPI again and activate the plugin. This will update any tables that need to be upgraded.

If you applied the GLPI patch on the previous version of the plugin, you need to make one additional change. Find the following line in setup.php:

define('CUSTOMFIELDS_GLPI_PATCH_APPLIED', false); and change it to define('CUSTOMFIELDS_GLPI_PATCH_APPLIED', true);