Difference between revisions of "Plug-In Installation Locations"

From 360Works Product Documentation Wiki
Jump to navigation Jump to search
Line 89: Line 89:
 
| FileMaker Pro[Advanced]
 
| FileMaker Pro[Advanced]
 
| .fmx
 
| .fmx
| '''(New)''' C:\Documents and Settings\'''[user_name]'''\LocalSettings\ApplicationData\FileMaker\FileMaker Pro'''[Advanced]'''\'''[version]'''\Extensions<br>
+
| '''(New)''' C:\Users\'''[user_name]'''\AppData\Local\FileMaker\FileMakerPro'''[Advanced]'''\'''[version]'''\Extensions<br>
 
'''(Old)''' C:\Users\'''[user_name]'''\AppData\Local\FileMaker\Extensions\<br>
 
'''(Old)''' C:\Users\'''[user_name]'''\AppData\Local\FileMaker\Extensions\<br>
 
'''(Legacy)''' C:\Program Files (x86)\FileMaker\FileMaker Pro '''[Version] [Advanced]'''\Extensions
 
'''(Legacy)''' C:\Program Files (x86)\FileMaker\FileMaker Pro '''[Version] [Advanced]'''\Extensions

Revision as of 20:09, 3 March 2015

There are two ways to install FileMaker Plugins. You can manually install the plugins by placing them into the Extensions Folder or if you are using FileMaker 12+ you can use the Install Plugin File script step.

Manual Installation

If you want to install manually there are four different locations that you can install FileMaker plugins, depending on where you need them to run. If you manually install while FileMaker Pro is open, you will have to restart FMP in order for the plugins to load. Please read the notes below the table for additional information on the different locations.

Platform FileMaker Version FileMaker Product File Type Installation Location
Windows XP
Windows Server 2003
FileMaker 11 FileMaker Pro[Advanced] .fmx C:\Documents and Settings\[user_name]\LocalSettings\ApplicationData\FileMaker\Extensions

(Legacy) C:\Program Files (x86)\FileMaker\FileMaker Pro [Version] [Advanced]\Extensions

FileMaker Server .fmx C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions
Web Publishing .fmx C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins
Custom Web Publishing .fmx C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\cwpc\Plugins
FileMaker 12 FileMaker Pro[Advanced] .fmx (New) C:\Documents and Settings\[user_name]\LocalSettings\ApplicationData\FileMaker\FileMaker Pro[Advanced]\[version]\Extensions

(Old) C:\Documents and Settings\user_name\Local Settings\Application Data\FileMaker\Extensions\
(Legacy) C:\Program Files (x86)\FileMaker\FileMaker Pro [Version] [Advanced]\Extensions

FileMaker Server .fmx C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions
WPE/WPE x64 .fmx/.fmx64 C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins
Custom Web Publishing .fmx64 C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\cwpc\Plugins
Windows Vista
Windows 7
Windows 8
Windows Server 2008
Windows Server 2008 R2
Windows Server 2012
FileMaker 11 FileMaker Pro[Advanced] .fmx C:\Users\[user_name]\AppData\Local\FileMaker\Extensions

(Legacy) Macintosh HD/Applications/FileMaker Pro 11 [Advanced]/Extensions/

FileMaker Server .fmx C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions
Web Publishing .fmx C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins
Custom Web Publishing .fmx C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\cwpc\Plugins
FileMaker 12 FileMaker Pro[Advanced] .fmx (New) C:\Users\[user_name]\AppData\Local\FileMaker\FileMakerPro[Advanced]\[version]\Extensions

(Old) C:\Users\[user_name]\AppData\Local\FileMaker\Extensions\
(Legacy) C:\Program Files (x86)\FileMaker\FileMaker Pro [Version] [Advanced]\Extensions

FileMaker Server .fmx C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions
WPE/WPE x64 .fmx/.fmx64 C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins
Custom Web Publishing .fmx64 C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\cwpc\Plugins
FileMaker 13 FileMaker Pro[Advanced] .fmx (New) C:\Users\[user_name]\AppData\Local\FileMaker\FileMakerPro[Advanced]\[version]\Extensions

(Old) C:\Users\[user_name]\AppData\Local\FileMaker\Extensions\
(Legacy) C:\Program Files (x86)\FileMaker\FileMaker Pro [Version] [Advanced]\Extensions

FileMaker Server .fmx64 C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions
Custom Web Publishing .fmx64 C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\cwpc\Plugins
Mac OS X FileMaker 11 FileMaker Pro [Advanced] .fmplugin Macintosh HD/Users/[user_name]/Library/Application Support/FileMaker/Extensions

(Legacy) Macintosh HD/Applications/FileMaker Pro 11 [Advanced]/Extensions/

FileMaker Server .fmplugin Macintosh HD/Library/FileMaker Server/Database Server/Extensions
Web Publishing .fmplugin Macintosh HD/Library/FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins
Custom Web Publishing .fmplugin Macintosh HD/Library/FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins
FileMaker 12 FileMaker Pro [Advanced] .fmplugin (New) Macintosh HD/Users/[user_name]/Library/Application Support/FileMaker/FileMaker Pro [Advanced]/[version]/Extensions

(Old) Macintosh HD/Users/[user_name]/Library/Application Support/FileMaker/Extensions/
(Legacy) Macintosh HD/Applications/FileMaker Pro 12 [Advanced]/Extensions/

FileMaker Server .fmplugin Macintosh HD/Library/FileMaker Server/Database Server/Extensions
Web Publishing .fmplugin Macintosh HD/Library/FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins
Custom Web Publishing .fmplugin Macintosh HD/Library/FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins
FileMaker 13 FileMaker Pro [Advanced] .fmplugin (New) Macintosh HD/Users/[user_name]/Library/Application Support/FileMaker/FileMaker Pro [Advanced]/[version]/Extensions

(Old) Macintosh HD/Users/[user_name]/Library/Application Support/FileMaker/Extensions/
(Legacy) Macintosh HD/Applications/FileMaker Pro 13 [Advanced]/Extensions/

FileMaker Server .fmplugin Macintosh HD/Library/FileMaker Server/Database Server/Extensions
Custom Web Publishing .fmplugin Macintosh HD/Library/FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins

Notes

New, Old, and Legacy Locations

All three locations will be checked for plug-ins in current versions of FileMaker Pro and FileMaker Pro Advanced. However, the "Install Plug-In File" script step supports only the New locations listed above.

The order in which the installation of plug-ins is checked is as follows:

Legacy Location
New Location
Old Location

If an installed plug-in does not work as expected, verify that multiple versions of the same plug-in have not been installed in multiple places on your system. In most cases, it is only necessary to have a single version of a plug-in installed for a given version of FileMaker Pro or FileMaker Pro Advanced.

FileMaker Web Publishing Engine (Windows or Mac)

You would install plugins on the Web Publishing Engine in order to invoke them from Instant Web Publishing. On FileMaker Server 9 (and later versions), the Plugins folder may not exist - just create it and put the plugin there. Do not confuse this folder with the already existing "Extensions" folder. All 360Works plugins will run in the Web Publishing Engine. When installing manually, you should stop the Web Publishing Engine, install, and start the Web Publishing Engine. This can be done in the Admin Console.

FileMaker Custom Web Publishing (Windows or Mac)

You would install plugins for Custom Web Publishing to use the FileMaker API for PHP if you want more control over the way your data displays in web browsers.

If you are running FMS 12v2 or later and have a 64-bit Windows machine, you should use the .fmx64 plug-in included with the download. For any other Windows installation, use the .fmx plug-in included with the download. If you are running FMS 12v2 or later on a Mac machine, you should use the .fmplugin plug-in included with the download.

When installing manually, you should stop the Web Publishing Engine, install, and start the Web Publishing Engine. This can be done in the Admin Console.

FileMaker Server (Windows or Mac)

For most plugins, the primary reason to install them on FileMaker Server (this is NOT the same thing as the Web Publishing Engine) is to use them with scheduled scripts in FileMaker Server 9 or later (this feature is not available in earlier versions of FileMaker Server). There are a few plugins, such as AdminAnywhere, which perform other functions on the server. All 360Works plugins can be used with scheduled scripts in FileMaker Server. Do not confuse the "Database Server" folder with the "Database Server x64" folder sometimes found with installations of FileMaker Server.

if installing manually, you should stop the Database engine, install, and start the Database engine. This can be done in the Admin Console. If you don't want to disconnect any users you can use the command "fmsadmin restart fmse" in the terminal to restart the script engine.

All Plugins

360 Works plug-ins require a 32-bit Java Runtime Environment in order to run. FileMaker Pro will prompt you on startup to download the appropriate software if it is not found on your computer. But FileMaker Server has no such prompt, and you may be required to manually download a 32-bit JRE if you do not already have one. On Windows, you will need a 32-bit version of Java 7 from Oracle. On Mac, you will need the latest Java 6 update from Apple. For Mac OS 10.6, click here. For Mac OS 10.7+, click here

Install Plugin File - FileMaker Script Step

In order to use the "Install Plugin File" script step, you must be using FM12+.

  1. On a layout, create a container field that will hold the appropriate plugin for your operating system (.fmplugin(Mac), .fmx(Windows) , .fmx64(Windows 64-bit).
  2. Place the plugin in the container field
  3. Create a script that utilizes the "Install Plug In File" script step, save the script, and run it

The plugin should now be installed in the appropriate extensions folder. Where the plugin is physically installed depends on the context from which the script is executed (e.g., FileMaker Pro, FileMaker Server Scripting Engine, FileMaker Server Custom Web Publishing, FileMaker Server IWP/Web Direct). You can install several plugins at the same time by having separate containers on your layout and "Install Plugin File" script steps for each plug in in your script.