If you are looking to manually configure your widget to your preference (always shown, remove the close option, etc.) then you came to the right place! 😎

Here's how you can configure your Tolstoy widget on your site:

1. First, find your Tolstoy ID from within your Tolstoy URL (http://player.gotolstoy.com/TOLSTOY_ID), and paste the following code on your site.

window.tolstoyWidgetId='TOLSTOY_ID'


2. Choose which of the following configurations you want for your widget, and add pieces following code.

Here's the entire piece of code, including all of the options mentioned below:

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

Here's a breakdown of the options you have to configure your widget, with the corresponding lines of code:

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

    • To enable, add: alwaysShow: true

  • loadHidden: load the widget without showing it.

    • To enable, add: loadHidden: true

  • minified: show a minified version of the preview.

    • To enable, add: minified: true

  • stopPreviewLoop: stop the preview window from endlessly looping.

    • stopPreviewLoop: true

  • noCloseOption: no option to close the widget.

    • noCloseOption: true

3. Choose the following methods you want for your widget, and add the following pieces of code to enable:

  • start()

    start the widget on expanded and plays immediately

    window.tolstoyWidget.start();

  • show()

    show the widget

    window.tolstoyWidget.show();

  • hide()

    hide the widget

    window.tolstoyWidget.hide();

  • recreate(tolstoyWidgetId, settings)

    load a new widget, settings are optional

    window.tolstoyWidget.recreate('TOLSTOY_ID');

  • on(eventType, callback)

    gives option to trigger a callback on chosen events.

    Params:

    • eventType

      supported events:

      • onWidgetOpen - triggers when the widget is opened

      • onWidgetReady - triggers when the widget is ready

    • callback

      A function to trigger.

    Example:

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


If you are looking for more advanced customization, feel free to check out our Developer Portal!

Do not hesitate to contact us at support@gotolstoy.com if you have any more questions.

Did this answer your question?