Okendo
  • Introduction
  • Merchant REST API
    • Quick Start
    • Endpoints
  • On Site
    • On Site Widgets
      • Reviews Widget
      • Star Rating
      • Questions Widget
      • Reviews Carousel Widget
      • Media Grid Widget
      • Media Carousel Widget
      • Reviews Badge Widget
      • Reviews Modal Trigger
    • Storefront Javascript API
      • Widget Plus Window API
      • Surveys - Connect Window API
      • Quizzes - Connect Window API
      • Referrals Window API
      • Inspiration
    • Storefront REST API
      • Quick Start
      • Endpoints
    • Advanced Widget Installs
      • Installing Widget Plus on Headless Instances
      • Installing Connect Surveys on Headless Instances
      • Stores Running an Existing Vue App
      • Installing Quizzes on Headless Instances
  • Okendo Shopify Hydrogen Support
Powered by GitBook
On this page
  • Overview
  • Installation
  • Styling
  • Data Attributes
  • Examples
  • Giving The Widget A Data Source
  1. On Site
  2. On Site Widgets

Media Carousel Widget

PreviousMedia Grid WidgetNextReviews Badge Widget

Last updated 3 months ago

Overview

Bring reviews to life with a stand-alone media carousel that displays customer-generated photos and videos submitted in published product reviews. Shoppers can hover over photos/videos to quickly see the review star rating and click to bring up a modal with the full review. An excellent addition to the product page to increase shopper engagement.

Installation

Instructions for a Shopify Online Store 2.0 installation can be found here.

  1. Create a new liquid snippet in the snippets folder with the following name: snippets/okendo-reviews-media-carousel.liquid

  2. Inside your newly created liquid file, add the following HTML snippet:

    <div data-oke-media-carousel></div>

  3. Customize your snippet with the data attributes listed here.

  4. Copy the following snippet and place it in your Theme Code where you would like the widget to appear: {% render 'okendo-reviews-media-carousel' %}

Styling

The preferred method of configuring the Media Carousel is via the Okendo Admin which can be accessed in the Okendo app via Reviews -> On-Site Displays:

Data Attributes

Data Attribute
Description
Value Type
Supported Values
Required

data-oke-reviews-product-id

Used to specify a Shopify Product ID with the word shopify- in front of it. The media carousel widget will only show media for the specified product.

string

Any valid product ID in the format shopify- e.g. shopify-1234567.

data-oke-reviews-group-id

Used to specify an Okendo Group ID so that the media carousel widget only shows media for the specified group of products.

string

Any valid product group ID in a GUID format e.g. 69d2e67d-b980-4333-97b7-30411807a7b1

Examples

Giving The Widget A Data Source

Without specifying a data source for the media, the widget will show all media for your store. You can provide either a Product ID or a Group ID to use that as the data source for the media.

Product Widget

If you are using liquid use the following snippet:

<div data-oke-carousel data-oke-reviews-product-id="shopify-{{ product.id }}"></div>

The general format for other frameworks is:

<div data-oke-carousel data-oke-reviews-product-id="shopify-<PRODUCT_ID>"></div>

Group Widget

Learn more about Okendo Groups here:

If you are using liquid or general frameworks use the following snippet:

<div data-oke-carousel data-oke-reviews-group-id="<GROUP_ID>"></div>

Group ID is found in the Okendo Admin URL for a given group as described in the table above.

LogoUnderstanding Okendo Groups | Okendo Help Center