Use Marketplace Content in Studio Pro

Last update: Edit

1 Introduction

This how-to covers the basics of accessing the Marketplace from Studio Pro and provides examples of how to add a widget and a module to your application.

This how-to will teach you how to do the following:

  • Download content from the Marketplace via Studio Pro
  • Use content (for example, widgets, modules, and others) downloaded from the Marketplace in Studio Pro

2 Prerequisites

Before starting this how-to, make sure you have completed the following prerequisites:

3 Downloading Content from the Marketplace

To download a component from the Marketplace via Studio Pro, follow these steps:

  1. Open Studio Pro and sign in with your Mendix credentials.

  2. Open the app in which you want to install the component from the Marketplace.

  3. Click the Marketplace icon in the top menu bar to open it in Studio Pro:

    Marketplace icon

  4. On the Marketplace overview page, find the component to use in your app. The Categories menu item gives you an overview of which types of content you can download. You can use the Search bar to find the component.

    Search result for rating

  5. Click the component or Read more to view the details of the component.

    Details of Rating widget

  6. Click Download to download the component to your app.

    Make sure that you download the correct version. The version must be compatible with the Studio Pro version that you use. Do check the Mendix Version on the Overview tab. Do not download a compontent that requires a higher Mendix version than the Studio Pro that you use. You can download older versions of the component on the All Versions tab.

    All Versions tab

After you download a component:

  • If the component is an app, it is created on your hard drive and is opened in Studio Pro
  • If the component is not an app, it is downloaded directly into your app

4 Using Content in Studio Pro

After you download a component, you can use the component in your app.

Documentation tab

4.1 Using a Widget

You can download a widget from the Marketplace and use it in your app. We will use the Rating widget as an example. You can follow the steps to use any widget from the Marketplace.

4.1.1 Adding the Widget

To add the Rating widget from the Marketplace via Studio Pro, follow these steps:

  1. Download the Rating widget from the marketplace to your app.

  2. Click Add widget. The Select Widget dialog box opens.

    Add widget

  3. In the Filter bar, enter Rating. The downloaded widget is found in the Add-on widgets category.

    Rating widget highlighted in Select Widget dialog box

  4. Click the Rating widget and then click Select.

  5. In the page of your app, click where you want to drop the widget. After you release the mouse button, the widget is placed in the page.

    Rating widget in the page

4.1.2 Configuring a Widget

After you place a widget in your page, some new errors can appear in the Errors pane. That is because you still need to configure the widget.

To configure the widget, follow these steps:

  1. Go to the Errors pane and check the error message. This error shows after you drop the Rating widget into the page:

    Errors pane

  2. In the page, double-click the Rating widget. The Edit Rating dialog box opens and the Attribute field shows (none) – this means that no attribute is assigned, which causes the error.

    Edit Rating dialog box

  3. Click Select to select an attribute. In this example, we select the attribute ProductRating. This is the attribute of an entity that we already created.

    ProductRating selected in Select Attribute dialog box

  4. In the Edit Rating dialog box, click OK. The error in the Errors pane should disappear.

4.2 Using a Module

You can also download an entire module from the Marketplace. A module includes the whole functionality and integration that can be very helpful when you are building your application.

In this section, we will use the Email with Templates module as an example. You can follow the steps to use any module from the Marketplace.

4.2.1 Adding the Module

To add the Email with Template module from the Marketplace via Studio Pro, follow these steps:

  1. Download the Email with Templates module from the marketplace to your app. The Import Module dialog box opens.

  2. Select one of these options:

    • Add as a new module – if you select this option, new entities are created in your app
    • Replace existing module – if you select this option, you need to specify which Module to replace

    Import Module dialog box

  3. In the Import Module dialog box, click Import.

  4. Wait until a pop-up window states that the module was successfully imported. Click OK.

  5. Open the App Explorer and find the EmailTemplate module.

    EmailTemplate module

Unlike a widget, you can see a module in your App Explorer. A module contains a domain model, pages, and microflow logic. A module downloaded from the Marketplace stores files if the module contains files (for example, files that are contained in the userlib or resource folders). In addition, a module downloaded from the Marketplace has a light blue icon to differentiate it from the development modules.

4.2.2 Configuring the Module

Each module that you download from the Marketplace is different. Some modules can cause errors because they are connected to other modules. For example, when you download the Email with Templates module, you also need to download the Mx Model Reflection module and Encryption module to make the errors disappear. If you run into any problems, always check the Documentation tab on the page of this module in the Marketplace for installation guidelines and details on any dependencies.

For details on configuring the Email with Templates module in Studio Pro, see Email with Templates.

4.3 Using an App or Layout

Downloading an app or layout will create a new app structure in the location that you enter. After you click Download, a window will appear where you can specify how the app should be created.

4.4 Using a Theme

Downloading a theme is very similar to downloading a widget. Like a widget, a theme is added to the app structure – in the theme folder of your app. A theme downloaded from the Marketplace will immediately be set as the active theme for your app. You can find out which theme is active for your app in the app Settings.

5 Read More