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 version 

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 preferences and can be loaded.

Disabled – The plug-in is disabled in the FileMaker Pro 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

Related topics 

Installing plug-ins

Setting plug-in preferences

Plug-in update example

Functions reference (category list)

Functions reference (alphabetical list)

About formulas

About functions

Defining calculation fields

Using operators in formulas