@geins/ralph-module-streamify

Streamify module for Geins PWA Storefront Ralph

A module for Geins PWA Storefront Ralph that adds streamify liveshopping streams to your storefront.

Pre-requisites

• Geins Account and PWA Storefront Ralph. Get a free trial here
• Streamify Account. Get a one here

Description

This module enables you to add streamify liveshopping streams to your storefront in seconds. You can add past, present or future streams.

Module can be used in any page of your storefront and is configuerd to work with Geins Cart out-of-box. Module can be added via Geins CMS or any CMS of your choice.

Installation

1. Install the module

npm i @geins/streamify-module

2. Add the module to your Geins PWA Storefront Ralph

Add the module to your Geins PWA Storefront Ralph by adding the following line to your nuxt.config.json file:

...
  modules: [
    [
        '@geins/ralph-module-streamify',
        {
            enabled: true,
            debug: true,
            apiToken: 'your-streamify-api-token',
        }
    ]
  ],

3. CaWidgetJson

3. If you already have overridden the CaWidgetJson

Module Options

Add extra options to module configuration in nuxt.config.json file.

Parameter	Default	Example
enabled	true	Enables the module
debug	false	Enables debug info to console
apiToken	none	Your token to use Streamify API
apiBaseUrl	https://api.streamify.io'	Base Url to API
apiEndpointGetStreams	/live/broadcast?type=upcoming&direction=asc&per_page=1	API Endpoint to list streams

Usage

Add component to desired page of your storefront. Either by cms or as a component. You can add id to the component to show a specific stream. If no id is added the component will show the next upcoming or live stream.

Component

Component name is CaWidgetStreamify.

Events

The component emits events that translates to your Geins Cart.

Properties

The properties of the component are one to one with the Streamify Floating Player API. You can add any property to the component and it will be passed to the API.

Property	Type	Default Value	Required	Description
configuration	Object	-	No	Configuration object to set properties for the widget
id	String	-	Yes	The ID of the stream
orientation	String	'landscape'	No	The orientation of the player. Possible values: 'landscape' or 'portrait'
playButton	Boolean	false	No	Determines whether to show the play button
autoStart	Boolean	false	No	Opens the minified player if the broadcast is live
persistent	Boolean	true	No	Determines whether the player is persisted as a mini-player while navigating between pages
googleAnalytics	Boolean	true	No	Enables Google Analytics integration
buttonText	String	-	No	The text to customize the button in the banner. Defaults to the broadcast title if not set or used
hideButton	Boolean	false	No	Determines whether to hide the play button in the banner
hideCalendar	Boolean	false	No	Determines whether to hide the calendar in the banner
hideTitle	Boolean	false	No	Determines whether to hide the title in the banner
infoButton	Boolean	true	No	Determines whether to display an info button if the broadcast has a description

The configuration object will be overriden by any property added to the component.

Use with Geins CMS

Add a JSON Widget to your page in the Geins CMS. Add the following JSON to your widget. Replace your-stream-id with the id of the stream you want to show. You can find the id in the Streamify App or in the Streamify.

{
  "renderWidget": "CaWidgetStreamify",
  "data": {
    "id": "your-stream-id",
    "orientation": "landscape",
    "autostart-if-live": "true",
    "button-text": "Watch the UNBOXING of the new iPhone",
    "ga": "true"
  }
}

All properties of the Stremify Floating Player JS can be added to the JSON. Read documentation here. Use the same name as in the streamify documentation to add properties to the JSON. The data part of the JSON is passed to the component as the configuration property.

If you want to show the next upcoming or live stream, remove the id property from the JSON.

As a component or with any CMS

Add the component to your page. Add the id of the stream you want to show as a property to the component. You can find the id in the Streamify App or in the Streamify.

<CaStreamify id="your-stream-id" />

Tips!

• Add the component without an id and you can always start a live stream by adding a new stream in Streamify or starting a spontanius stream form your Streamify App.

• Add the id of the stream to the component to keep past streams available on PDP pages.