Carousel and Card list Directive

Prerequisites

  1. URLs of the images from Orbita backend. see How do I upload an image? for more information.

  2. To render the carousel and card list, you should switch to chatbot version - v2 in Bot view template node.

Carousel

The Carousel directive lets you render the data in the form of a carousel. There are 2 types of carousels available.

Carousel

Sample flow

Copy the following code into a function node to enable the Carousel in the chatbot.

msg.payload.orbita.directive= [ { "type": "carousel", "items": [ { "reviews": { "rating": 2.5, "label": "Reviews label", "count": 20000 }, "title": "Title for Carousel Option 1", "description": "Description for Carousel Option 1", "image": { "alternateText": "OE", "url": "https://orbita.ai/wp-content/uploads/2017/08/vxhero_bg_v2.jpg" }, "detailView": { "title": "Title of detailed view", "description": "Description of detailed view", "image": { "url": "https://orbita.ai/wp-content/uploads/2017/08/vxhero_bg_v2.jpg", "alternateText": "OE" }, "buttons": [ { "text": "Button Text", "type": "link", "value": "https://yourdomain/buttonlink/" } ] }, } ] } ] return msg;

Sample Image

Bootstrap Carousel

Sample flow

Copy the following code into a function node to enable the Bootstrap Carousel in the chatbot.

msg.payload.orbita.directive= [ { "type": "bootstrapcarousel", "items": [ { "reviews": { "rating": 2.5, "label": "Reviews label", "count": 20000 }, "title": "Title for Carousel Option 1", "description": "Description for Carousel Option 1", "image": { "alternateText": "OE", "url": "https://orbita.ai/wp-content/uploads/2017/08/vxhero_bg_v2.jpg" }, "detailView": { "title": "Title of detailed view", "description": "Description of detailed view", "image": { "url": "https://orbita.ai/wp-content/uploads/2017/08/vxhero_bg_v2.jpg", "alternateText": "OE" }, "buttons": [ { "text": "Button Text", "type": "link", "value": "https://yourdomain/buttonlink/" } ] }, } ] } ] return msg;

Sample Image

The bootstrap carousel will render only one carousel item, with design changes with navigation arrows, irrespective of the page width.

Parameters used for Carousel

Property

Description

Property

Description

"type": "carousel"

This property accepts carousel, bootstrapcarousel, and card options.

"items": [{
"reviews": {...}
"title": "title",
"description": "desc",
"image": {...},
"detailView": {...}
}
}]

The items property is used to fill the carousel options. Each carousel option can have the below properties.

  • reviews

  • title

  • description

  • image

  • detailView

"title": "Title for Carousel",

The Title of the carousel option.

"reviews": {
"rating": 2.5,
"label": "Reviewslabel",
"count": 20000
}

This is an optional property. You can show the rating on the carousel options and in the detailed view using this property.

  • rating - This is the calculated rating value. The rating stars will get filled based on the number given here. (hardcoded in the sample code).

  • label - You can set a custom name to the rating icon. (Can only be seen in Detailed view)

  • count - The total number of ratings received. (Can only be seen in Detailed view)

"description": "Description for Carousel Option",

The description of the Carousel Option.

"image": {
"alternateText": "altimg",
"url": "Imageurl"
}

Paste the appropriate image URL that you uploaded to Orbita. Recommended size is 225px width and 135px height.

"detailView": {
"title": "Detailed title",
"description": "Detail Desc",
"image": {
"url": "ImgURL",
"alternateText": "OE"
},
"buttons": [{
"text": "Button Text",
"type": "link",
"value": "URL"
}]
}

Clicking on the Carousel option will open the detailed view window. The below mentioned are the properties it contains.

  • title - Title of the detailed view page.

  • description - Description of the detailed view page.

  • image - Recommended size is 620px width and 290px height.

  • buttons -You can set an optional floating button at the end of the detailed view using this property.

    • text - Button display name.

    • type - Button type (for example, “link”)

    • value - redirect link.

  • review - The review object will be rendered in the detailed view to show the rating.

Carousel options

The below image shows where each property would be rendered on a carousel.

detailedView of the carousel

The below image shows where each property would be rendered on the detailedView of the carousel.

Card

The Card directive lets you render the data in the form of a list.

Sample flow

Copy the following code into a function node to enable the Card in the chatbot.

if(!msg.payload.orbita) { msg.payload.orbita = {} } msg.payload.orbita.directive= [ { "type": "cardlist", "items": [ { "title": "Title for Card Option 1", "reviews": { "rating": 1.5, "label": "Reviews label 1", "count": 20000 }, "appointmentDetails": { "dateHeader": "Small description for your card option", "lineItems": [ { "title": "Line item 1", "description": "Line item desc 1" }, { "title": "Line item 1", "description": "Line item desc 2" } ] }, "image": { "alternateText": "OE", "url": "https://s3.amazonaws.com/orbitahealth/clients/sandbox5/assets/dynamic/images/smallimage192c03a10-384d-11ea-9e3c-4750e1188599.jpg" }, "detailView": { "title": "Title of detailed view 1", "description": "Description of detailed view 1", "image": { "url": "https://orbita.ai/wp-content/uploads/2017/08/vxhero_bg_v2.jpg", "alternateText": "OE" }, "buttons": [ { "text": "Button Text 1", "type": "link", "value": "https://yourdomain/buttonlink/" } ], }, } ] } ] return msg;

Parameters used for Card

Property

Description

Property

Description

"type": "cardlist",

The type property should be set “cardlist

"items": [{
"title": "Title for Card Option 1",
"reviews": {…},
"appointmentDetails": {…},
"image": {…},
"detailView": {…},
}]

The items property is used to fill the cards in the card list. Each card option can have the below properties.

  • title

  • reviews

  • appointmentDetails

  • image

  • detailedView

"title": "Title for Card Option",

The Title of the card option.

"image": {
"alternateText": "OE",
"url": "imageURL"
}

Paste the appropriate image URL that you uploaded to Orbita. Recommended size is 72px width and 92px height.

"appointmentDetails": {
"dateHeader": "desc for your card option",
"lineItems": [{
"title": "Line item 1",
"description": "Line item desc 1"
},
{
"title": "Line item 2",
"description": "Line item desc 2"
}]
}

Under the appointment details object, you can give the following:

  • dateHeader - The description of the card option.

  • lineItems - You can have a sectioned view in the detailed view screen using this property.

    • title - Title of the line item

    • description - Description of the line item.

"detailView": {
"title": "Detailed title",
"description": "Detail Desc",
"image": {
"url": "ImgURL",
"alternateText": "OE"
},
"buttons": [{
"text": "Button Text",
"type": "link",
"value": "URL"
}]
}

Clicking on the Carousel option will open the detailed view window. The below mentioned are the properties it contains.

  • title - Title of the detailed view page.

  • description - Description of the detailed view page.

  • image - Recommended size is 620px width and 290px height.

  • buttons - You can set an optional floating button at the end of the detailed view using this property.

    • text - Button display name.

    • type - Button type (for example, “link”)

    • value - redirect link.

"reviews": {
"rating": 2.5,
"label": "Reviewslabel",
"count": 20000
}

This is an optional property. For the card list, you can show the rating only on the detailed view.

  • rating - This is the calculated rating value. The rating stars will get filled based on the number given here. (hardcoded in the sample code).

  • label - You can set a custom name to the rating icon.

  • count - The total number of ratings received.

Card option

The below image shows where each property would be rendered on a card.

Detailed View of Card

The below image shows where each property would be rendered on a detailed view of the card.

Sample flow

  File Modified

File Card and Carousel Sample flow.json

Jan 16, 2020 by Rajkiran Alla

Related Articles