LiSA Social Commerce
Developers
Developers
  • Developers
  • Guides
    • Integration Guide
      • Web Integration
      • App Integration
        • Android
          • Communication
          • Storage
          • File Downloads
          • Theming
        • iOS
          • Communication
          • Storage
          • File Downloads
          • Theming
        • React Native
          • Communication
          • Storage
          • File Downloads
          • Theming
        • Picture in Picture
      • Entrypoints
        • Query Parameter (v1)
    • Player Communication
      • Message API Reference
        • App
          • App — Heartbeat
          • App — Message Acknowledge
          • App — Message Error
          • App — Listen
        • CTA
          • CTA — Link in Comments
          • CTA — Sponsor Badge
        • Cart — View Cart
        • Comments — Join
        • Media
          • Media — Complete
          • Media — Pause
          • Media — Progress
          • Media — Resume
        • Media Item
          • Media Item — Emoji
          • Media Item — Impression
        • Player
          • Player — Dismiss
          • Player — Native Picture-in-Picture (PiP)
          • Player — Pass Visual Viewport
          • Player — Request Visual Viewport
          • Player — UI Transition
        • Products
          • Products — Add to Cart
          • Products — Add to Wishlist
          • Products — Click
          • Products — Close Product List
          • Products — Emoji
          • Products — Emoji State Update
          • Products — Impression
          • Products — Open Product List
        • Stickers
          • Stickers — Activate
          • Stickers — Click
          • Stickers — Expire
          • Stickers — Impression
          • Stickers — Publish
          • Stickers — Unlock
          • Stickers — Unpublish
          • Stickers — Update
          • Stickers — Voucher Claim
        • Visitor — Pass User Context
        • Shared Legacy Message Properties
    • Products
      • Product Update Notification API
  • Widgets
    • Content Hub
    • Quick Start Guide
    • Appearance
      • Markup
      • Responsive design
    • Configuration options
      • Autoplay
      • Channel
      • Client
      • Data
      • Debug
      • Host node
      • Layout
      • Language
      • On
      • Player
      • Query string
      • Quick view
      • Sections
      • Store
      • Template
    • API reference
      • Library API reference
      • Player API reference
      • Quick View API reference
    • Customisations
      • Template
      • Bring your own template
      • Type definitions
    • Examples
    • Type definitions
      • Asset
      • Product
      • Other
    • Promo Widget
      • Quick Start Guide
      • Configuration options
        • Autoplay
        • Channel
        • Countdown (deprecated)
        • Enabled
        • Image modifier
        • Lead time
        • Live (deprecated)
        • Position
        • Replay (deprecated)
        • Show ID
        • URL
  • Media Player Introduction
    • Picture-in-Picture Mode
  • Analytics
  • REST API
    • Authentication
    • Rate limits
    • Response status and error codes
    • API Documentation
Powered by GitBook
On this page
  • Required markup / CSS selectors
  • Custom helpers
  1. Widgets
  2. Customisations

Bring your own template

Not happy with a default template provided with the LiSA Library? — No worries, bring your own template! As long as you're familiar with Handlebars.js.

Required markup / CSS selectors

When implementing a custom template, LISA Library gives you all the freedom you need to create the perfect library experience for your storefront or website. Yet there are a few markup elements and CSS selectors required:

Launch show Call to Action

While initializing the library using its default or your custom template, LiSA Library searches for elements decorated with the class name lisa__show-cta-play. It will attach an event listener to that element, in order to launch a show upon a click or touch event.

Show class name and identifier data attribute

In order to launch a show in response to a click or touch event on the launch call to action (CTA) element, LiSA needs to find the respective show's identifier. To find the show id LiSA traveses the CTA's ancestor nodes of the DOM tree until it finds an element, that has the class name lisa__show assigned to it — typically, this is the show's container element. This element also requires a data-attribute data-lisa-show-id, which stores the show's id.

Custom helpers

#eq

Block helper that renders a block if a is equal to b. If an inverse block is specified it will be rendered when falsy. You may optionally use the compare="" hash argument for the second value.

Params

a {String}

b {String}

options {Object} — Handlebars provided options

object returns {String} — Block, or inverse block if specified and falsy.

#neq

Block helper that renders a block if a is not equal to b. If an inverse block is specified it will be rendered when falsy. You may optionally use the compare="" hash argument for the second value.

Params

a {String}

b {String}

options {Object} — Handlebars provided options object

returns {String} — Block, or inverse block if specified and falsy.

PreviousTemplateNextType definitions

Last updated 1 year ago