Developer Tools

Studio

The Studio tools allow you to customise the information shown in the modules and how it is displayed.

See the dedicated Studio guide for more information on how to use the Studio tools.

Rename Modules

Use this panel to rename a SuiteCRM module. For example, you may wish to rename Accounts as Businesses.

Rename modules

Click on the module you wish to rename. Enter the new singular and plural labels for the module and click SAVE.

Enter new singular and plural labels

The new module label will now appear on menus and headings throughout SuiteCRM.

Module Builder

This section is to be completed.

History Subpanel

History subpanel settings

Display Modules and Subpanels

Control which modules and subpanels are visible in SuiteCRM by dragging and dropping modules or subpanels between the Displayed and Hidden columns.

This will show or hide modules in SuiteCRM for all users. Should you wish to control access to particular modules, this can be done using Role Management. See Roles and Security Groups for more information.

Allow users to select modules to apppear in the navigation bar

Selecting this option allows users to customise which module tabs are visible from their User Settings.

Display Modules and Subpanels

Module Loader

Module Loader allows you to install and manage custom modules or plugins for your SuiteCRM instance.

Custom module packages that have been created and modified in Module Builder will be displayed in Module Loader once they have been deployed.

For more information on producing packages that can be uploaded using Module Loader, see the Developer Guide

Module Loader

Modules and packages that are already installed are listed in the top pane. The lower panel is used to upload packages and will list any package that is uploaded but not yet installed.

Upload and Install a Package

Click Choose File and browse for the package .zip file. Click UPLOAD

Once uploaded, the package details will appear in the lower pane, including the version number, a short description and whether or not the module can be uninstalled.

UNINSTALL and DELETE PACKAGE options will appear.

Click INSTALL to install the module.

Module Loader

On the next screen, if there are no problems detected with the package and it is ready to install you will be asked to click COMMIT to complete the installation.

If any errors occur during installation, they will be displayed here. Otherwise, clicking the Display Log link will detail the steps taken in the installation process.

Module Loader

Click BACK TO MODULE LOADER to return to the Module Loader screen where the newly installed package will appear in the list of installed extensions.

Module Loader

Uninstall a Package

For a package to be uninstallable it needs to be defined as uninstallable in the package manifest file. For more information regarding the manifest file see the Developer Guide

Unistall a package by clicking the buttons next to the package name.

As with the install procedure, you will be asked to confirm the uninstall on the next screen. If the package added any tables to your database, you will be asked to if you wish to keep these, and any data within them, for example if you are replacing an older version of a module with a new one.

Click COMMIT to uninstall the package.

If any errors occur during the uninstall they will be displayed here. Otherwise, clicking the Display Log link will detail the process.

Click BACK TO MODULE LOADER to return to the Module Loader screen where the newly installed package will appear in the list of installed extensions.

An uninstalled module will be listed in the lower panel from where it can be re-installed or deleted.

Module Loader

Configure Module Menu Filters

Use this section to configure the module menus on the top navigation bar.

Configure Module Menu Filters

Drag modules from the list to the required menu, or delete an item by dragging it to the wastepaper bin icon. Edit the menu name by clicking the pencil icon next to the module name. Delete a menu entirely by clicking the wastepaper bin icon next to the module name.

A new custom menu can be added by clicking ADD FILTER Add menu items by dragging and dropping as before

Any changes made will not take effect until you click SAVE & DEPLOY

Dropdown Editor

The Dropdown Editor shows all the dropdown lists currently installed on the system.

Click on the dropdown name to edit it. If you are unsure which dropdown you require, it can be easier to edit via Studio where you can find the dropdown by its field name. See the Studio guide for full instructions on adding or editing a dropdown list.

Dropdown Editor

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.