Reference > Functions reference > Get functions > Get(InstalledFMPlugins)

Get(InstalledFMPlugins)

Returns the name, version number, and enabled state of installed plug-ins.

Format

Get(InstalledFMPlugins)

Parameters

None

Data type returned

text

Originated in

FileMaker Pro 12.0

Description

This function is useful for determining whether an installed plug-in is newer or older than a plug-in required by a file. The version number is returned if it is available.

If multiple plug-ins are installed, Get(InstalledFMPlugins) returns values for each plug-in on separate lines, separated by carriage returns.

Get(InstalledFMPlugins) returns plug-in version information only when plug-in developers have entered version information in the resource file (Windows) or the info.plist file (macOS).

macOS: Plug-ins are stored as packages.

The enabled state is returned as follows:

•Enabled – The plug-in is enabled in the FileMaker Pro Advanced preferences and can be loaded.

•Disabled – The plug-in is disabled in the FileMaker Pro Advanced preferences and cannot be loaded.

•Ignored – The plug-in failed to load, which could be due to software incompatibility.

Example 1

When:

•MyPlugin1 is installed and is enabled in the Plug-ins tab in the Preferences dialog box.

•MyPlugin2 is installed and is disabled in the Plug-ins tab in the Preferences dialog box.

•MyPlugin3 could not be loaded.

Get(InstalledFMPlugins) returns:

MyPlugin1;1.0;Enabled

MyPlugin2;1.1;Disabled

MyPlugin3; ;Ignored