Skip to end of metadata
Go to start of metadata

Introduction

Card Viewer Datalist Formatter plugin can display datalist records in a form of cards.

Get started

The easiest way to see how the Card Viewer Datalist Formatter works is to create a simple Application. Here are the steps:

StepsScreens (Click To View)

Steps To Import This Plugin

  1. Go to the Joget Marketplace plugin page here: https://marketplace.joget.org/jw/web/userview/mp/mpp/_/vad?id=cardviewer_datalist_formatter.

  2. Click "Download" on this plugin screen (It will be a .jar file).

  3. Go to your Joget server, and login as admin.

  4. Navigate to "Admin Bar > Settings > Manage Plugins" and click "Upload Plugins" button.

  5. In "Upload Plugin", select the plugin .jar file you just downloaded, then click "Upload".

  6. Depending on the plugin type, you can now use the new plugin in your form or datalist or userview.

  7. The Joget Knowledge Base has more information on managing and developing plugins.

  8. Alternatively, you can click Download from Marketplace from the App Center and search for Card Viewer Datalist Formatter plugin to install it.


Steps to use the Plugin:

  1. Start the Joget server and open the App Center.

  2. Login as admin and click on Design New App (See Figure 1) or click on existing application.

  3. For new application, fill up the App ID with camel case, App Name and click on Save button. (See Figure 2)

  4. Create New Form, fill up Form Details and click on Save button. (See Figure 3)

  5. In the form, drag two Text Fields and an Image Upload to upload image. (See Figure 4)

  6. Fill up the Text Fields and File Upload, for example:
    1. First textfield field with id = 'name'
    2. Second textfield field with id = 'desc'
    3. File Upload field with id = 'image'

  7. Click save and generate a CRUD. (See Figure 5)

  8. Edit the newly created datalist and edit the Name column to add the Card Viewer Datalist Formatter. (See Figure 6)

  9. Configure the Card Viewer Datalist Formatter by referring to Figure 7.

  10. After making sure that you are only displaying the Name column in the datalist, save the datalist.

  11. Next, go to the userview builder and add a new form element. (See Figure 8)

  12. After that, edit the CRUD and remove the Form (Edit) and save the userview. (See Figure 9)

  13. If you have followed steps that have been provided, you can click on Preview but nothing will be showed because no data were keyed in the Form yet.

  14. Therefore, you need to fill in the Form that you have been created, for example:
    a. Fill in the Name with 'Alex'
    b. Fill in the Description with 'Working as IT Support'
    c. Upload an image to be displayed in the card.

  15. Finally, you can see the final result in the Userview. (See Figure 10)

Figure 1


Figure 2

Figure 3

Figure 4

Figure 5

Figure 6

Figure 7

Figure 8


Figure 9


Figure 10

Card Viewer Datalist Formatter Properties

Configure Card Viewer Datalist Formatter

NameDescriptionScreen ( Click to view)
TitleColumn to map values as the card titles. This is a mandatory field.





Description

Column to map values as the description in the card, which will be displayed below the Title textThis is a mandatory field.

HTML is accepted here.

If no valid column detected from data binder, this will be literal string with support for hash variable and syntax like {columnName} to map column IDs from data binder.

URL

Column to map values as the URL to be redirected to when users click the card.

If no valid column detected from data binder, this will be a literal link with support for hash variables and syntax like {columnName} to map column IDs from data binder.

Form to retrieve image from

Select which Form to obtain the image files/paths from.
ImageField from the selected form in Form to retrieve image from property, to map images stored as the card images.

Customize Card Viewer Properties

NameDescription

Screen (Click to view)

URL Target

Select where to display the URL of the Card.

  • Current Window
  • New Tab
  • Popup Dialog


Download Demo App

APP_card_viewer_kb_dx.jwa




  • No labels