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