Monkeybread Software - MBS FileMaker Plugin: StoreRegistration

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 12.2 12.3 12.4 12.5 13.0 13.1 13.2 13.3 13.4 13.5 Statistic FMM Blog

StoreRegistration

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.

Component	Version	macOS	Windows	Linux	Server	iOS SDK
Plugin	3.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	✅ Yes

MBS( "StoreRegistration"; Licensee Name; component; License Type; Expire Month; Serial number ) More

Parameters

Parameter Description Example

Licensee Name This is the name of the person or organization that holds the license for the plug-in Your Name

component The component that was licensed. For example "Complete"

License Type Seats purchased. For example, "1 seat", "10 seats", "Developer" 1 Seat

Expire Month This is the month in which the serial will expire for new versions of the plug-in in YYYYMM format. Plug-in released before the end of that month will continue to work forever. New Releases after that date will require a renewal 200708

Serial number The license number your serial number

Parameter	Description	Example
Licensee Name	This is the name of the person or organization that holds the license for the plug-in	Your Name
component	The component that was licensed. For example "Complete"
License Type	Seats purchased. For example, "1 seat", "10 seats", "Developer"	1 Seat
Expire Month	This is the month in which the serial will expire for new versions of the plug-in in YYYYMM format. Plug-in released before the end of that month will continue to work forever. New Releases after that date will require a renewal	200708
Serial number	The license number	your serial number

Result

Returns OK on success.

Description

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.
This is very useful for trainings where you want to preinstall license on FileMaker installations.
Added Windows support in plugin version 4.4.

You can clear the license with ClearRegistration function.
Added Linux support for 7.5.

Saves in preferences file on Mac and Linux, saves to registry on Windows.

To store the registration on a FileMaker Server permanently, it is sufficient to call the StoreRegistration function only once by opening a file (e.g. the Registration.fmp12 file) with a OnFirstWindowOpen-Script and a single line of code like this: Set Variable [ $r; Value: MBS( "StoreRegistration"; $name; "Complete"; "5 seat"; $date; $code) ].
After opening it once and thus writing the registration file to the preference file, it can be closed and removed from the server.

Currently on Windows the key is written encrypted to the registry into the HKEY_CURRENT_USER\Software\FileMaker\RegistrationMBS entry. On macOS and iOS, we write a RegistrationMBS entry into the com.filemaker.client.pro12.plist file or for Claris Pro into the com.claris.pro.plist file.

If you use this in a vertical solution, please make sure you update the license key before updating the plugin to avoid the user seeing an error dialog about an old license. Also make sure that every major update you make calls StoreRegistration with a new key to replace the old key stored in preferences. And consider getting a multi year update from us, so you only change license key every few years.

Examples

Stores registration:

$r = MBS( "StoreRegistration"; $name; "Complete"; "5 seat"; $date; $code)

Blog Entries

This function is free to use.

Created 18th August 2014, last changed 28th November 2022

StoreKit.Transactions - SyntaxColoring.AddContextMenuCommand