Configuration

Learn how to configure your Tolstoy widget to perform different functions on your site.

Settings

We support the following additional configurations:

• alwaysShow: In case a user closed the widget and you want to keep showing it to him.

  • alwaysShow: true

• loadHidden: load the widget without showing it.

  • loadHidden: true

• stopPreviewLoop: stop the preview window from endlessly looping.

  • stopPreviewLoop: true

• noCloseOption: no option to close the widget.

  • noCloseOption: true

Add the following code to the page in oder to set the settings:

window.tolstoySettings = { 
  alwaysShow: true,
  loadHidden: true,
  stopPreviewLoop: true,
  noCloseOption: true,
};

start()

Start the widget, open it expanded and plays immediately

window.tolstoyWidget.start();

startPart(partNumber)

Start the widget at a specific part number, open it expanded and plays immediately. If the widget is already open it will start to play the given part.

window.tolstoyWidget.startPart(partNumber);

closePlayer()

Close the player if it was opened, does not hide the widget bubble

window.tolstoyWidget.closePlayer();

show()

Show the widget bubble if it was loaded hidden or closed

window.tolstoyWidget.show();

hide()

Hide the widget bubble from screen

window.tolstoyWidget.hide();

recreate(tolstoyWidgetId, settings)

Load a new widget with a different Tolstoy Id, remember to replace the {{TOLSTOY_ID}}

window.tolstoyWidget.recreate('{{TOLSTOY_ID}}');

on(eventType, callback)

Trigger a callback on a specific event

Params:

• eventType

  supported events:

  • onWidgetOpen - triggers when the widget is opened

  • onWidgetClose - triggers when the widget is closed

  • onWidgetReady - triggers when the widget is ready

• callback

  A function to trigger

window.tolstoyWidget.on('onWidgetOpen', () => { console.log('Widget Opened') });