IU-DATA

Side Menu



1 - Presentation & features

This "add-on" extension allows you to create custom navigation menus for your FileMaker Pro applications. Using our custom functions, it is possible to create a menu tree on 2 levels, an element can be unfolded to display its linked elements. It is possible to use a configuration by layout and object or to centralize the configuration by saving it in a field. In addition to being able to centralize menu management,the Side Menu has the advantage of allowing vertical scrolling on its height, thus the size of your layout is independent of the size of your navigation menu.
Items can be associated with FileMaker scripts and can be personalized with icons and text. You can also change the display mode of the menu to present only the icons.

Main features :


2 - Installation

2.1 Automatic

To make it quicker and easier for you, IU-DATA provides a small FileMaker solution beside each add-ons that directly install the add-on inside the right directory of your computer.

  1. Run the file

  2. Click on Instal the Add-on

  3. In FileMaker Pro, open the solution in which you want to add the Add-On

  4. In layout mode, open the left side panel on the Add-ons tab, click on the add button  

  5. Under the IU-DATA category, select Side Menu then click on Choose  

  6. Drag and drop the Side Menu add-on on the layout

2.2 Manual

  1. Close FileMaker Pro

  2. Copy the IUD_SideMenu folder to the following directory :

     - macOs : ~/Library/Application Support/FileMaker/Extensions/AddonModules/
     - Windows : AppData\Local\FileMaker\Extensions\AddonModules\
    
  3. In FileMaker Pro, open the solution in which you want to add the Add-On

  4. In layout mode, open the left side panel on the Add-ons tab, click on the add button  

  5. Under the IU-DATA category, select Side Menu then click on Choose  

  6. Drag and drop the Side Menu add-on on the layout

2.3 Configuration

The main configuration and customization instructions can be found inside the add-on web viewer's definition. Scripts and custom functions also have a whole series of information useful for the add-on configuration.

Please note : If your database on which you want to install the add-on is hosted with FileMaker Server. You might need to refresh the globale calculation field IUD_SideMenu::gct_WV_FinalCode. Otherwise the webviewer that contains the add-on will remain empty. To refresh this field, you can set the field IUD_SideMenu::WV_HTML by it's own value inside a script that is launch at the start of your application.


3 - Structures

3.1 - Tables

3.2 - Scripts

All Side Menu scripts are contained in the IUDATA - Side Menu script folder.

The description of scripts and parameters can be found in each script header

3.3 - Custom functions

The descriptions of the following functions are present in their respective calculations.

3.5 - Value lists

No Value list in this add-on.


4 - Dependencies

jQuery v3.5.1 (c) OpenJS Foundation and contributors (MIT License)

https://code.jquery.com/jquery-3.5.1.slim.min.js

Bootstrap v4.6.1 (c) The Bootstrap Authors (MIT License)

https://cdn.jsdelivr.net/npm/bootstrap@4.6.1/dist/js/bootstrap.min.js
https://cdn.jsdelivr.net/npm/bootstrap@4.6.1/dist/css/bootstrap.min.css

Font Awesome v5.15.4 (MIT License)

https://use.fontawesome.com/releases/v5.15.4/js/fontawesome.js
https://use.fontawesome.com/releases/v5.15.4/js/solid.js

Popper v1.14.0 (c) Federico Zivolo (MIT License)

https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js


5 - Compatibility

Operating systems :

FileMaker :

Claris FileMaker WebDirect :

Please note that on FileMaker Go 19 the Side Menu activation inside web viewers require a double tap.


6 - End User Licence Agreement

Important Note: Please read this EULA carefully. Downloading, installing, using or modifying this add-on signifies that the end user and their organization accept this EULA.

Definitions :

Contract terms :
IU-DATA authorizes the end user and his organization or household to use, modify, copy the add-on at their convenience. IU-DATA authorizes the end user and his organization to use for commercial purposes the add-on, when the add-on is an integral part of a solution whose spectrum of use is much wider than that defined by the functionalities of the add-on alone. On the other hand, IU-DATA does not authorize the end user and his organization to use for commercial or distribution purposes the add-on, modified or not as a final product.

The end user and his organization / household have free assistance for a period of 2 months from the date of purchase of this add-on, for any questions related to the use and configuration of this add-on.
Full access to FileMaker sources as well as to the source code used in the web viewer gives to the end user and his organization / household full control over modifying this add-on. It is therefore natural that we cannot intervene free of charge on the add-on whose code has been altered compared to the original version that IU-DATA delivered. Likewise, IU-DATA cannot be held responsible for any malfunction of any libraries mentioned in paragraph 4 - Dependencies, as well as malfunctions of the add-on following use on an operating system or a FileMaker platform other than those mentioned in paragraph 5 - Compatibilities.

Contact :
For any questions, please contact us to this address: product@iu-data.com


7 - Credits

Creation and development :

Icon design :


8 - Change Log

01/04/2022 - Side Menu v1.0.0 - 1st release



© IU-DATA 2021