Portal Cards

The portal widget Portal Cards displays cards with the redirection links to the specified portal pages. You can configure the card title, description, image, and the order of the cards in the widget.

In the "out-of-the-box" solution, the Portal Cards widget is placed on the main page of the portal.

Read more about the page and widget instances creation and their configuration in the Page Structure article.

Configure the widget

---

To configure the values of the widget options, complete the following steps:

1. Ensure that the Simple application is selected in the Admin preferences.
2. Navigate to Portal Structure → Widget Instances.
3. Create or find the required instance of the Portal Cards widget and open its form.
4. Configure the value of the widget options in the Schema option values field. Note that a maximum of three cards can fit in a single row of the widget.
5. Click Save or Save and exit.

Available options:

Name	Type	Description
isShowImage	Boolean	Set the value to true to display images in the widget card bodies.
orientation	String	Specify text and image alignment in the card. Available values: left center
collapseOptions	Object	Specify how many rows must be displayed by default. If there are more rows than specified, the Hide and Show all buttons appear in the widget. tabletCountRow – the number of rows that is displayed on tablets (991px–768px). mobileCountRow – the number of rows that is displayed on mobile devices (<576px). desktopCountRow – the number of rows that is displayed on desktops (>992px).
isShowDescription	Boolean	Set the value to true to display card description.
cardsStructure	String	Specify the tree the widget is available for.

Configure the value of the widget options

{
   "cardsStructure":"portal",
   "isShowImage": true,
   "orientation": "left",
   "collapseOptions": {
      "mobileCountRow": 3,
      "tabletCountRow": 2,
      "desktopCountRow": 2
      },
   "isShowDescription": true
}

Create cards on the portal

---

To create a card, do the following:

1. Navigate to System Settings → All Tables. Find the Portal cards (portal_cards) table and click its title to open its form.
2. Click Create record and fill in the fields.
3. Click Save or Save and exit to apply the changes.

Portal Card form fields

Field	Mandatory	Description
Name	Y	Specify the card title.
Order	Y	Specify the display order of cards in the widget. By default, the system sets the order equal to The highest order among existing records + 10.
Description	Y	Add the card description. The description is displayed on the card if the isShowDescription parameter is set to true.
Active	Y	Select the checkbox to display the card in the widget.
Link	Y	Specify a link to redirect the user after they click the card.
Image	N	Add an image file. All images are automatically resized to 48 × 48 pixels.
Tree	Y	Specify the tree that the card is associated with.