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

Reviews Badge Widget

PreviousMedia Carousel WidgetNextReviews Modal Trigger

Last updated 4 months ago

Overview

An authoritative trust-mark that builds social proof and establishes credibility in the minds of prospective shoppers, the Reviews Badge shows the total number of published reviews and the aggregated average of all star ratings.

Installation

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

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

    <div data-oke-badge></div>
  3. Copy the following snippet and place it in your Theme Code where you would like the widget to appear: {% render 'okendo-reviews-badge' %}

Styling

The preferred method of configuring the Reviews Badge 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 reviews badge widget will only show aggregate review data 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 reviews badge widget will only show aggregate review data for the specified group of products.

string

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

data-oke-url

Used to hyperlink the badge on click so that it directs the user to a custom absolute URL.

string

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 descibed in the table above.

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

Customize your snippet with the data attributes listed .

here
here
Understanding Okendo Groups | Okendo Help Center
Logo