Revision as of 13:06, April 26, 2019 by Mgionet (talk | contribs) (Update with the copy of version: draft)
Jump to: navigation, search

Configuration

Description

Offers holds the configuration namespace '_genesys.widgets.offers' which contains UI options.

Example

window._genesys.widgets.offers = {

	offers: {

		mode: 'overlay',
		layout: 'leftText',
		modal: false,
		title: 'Offer Title',
		headline: 'This is the offer's headline',
		body: 'This is the offer's body',
		button: 'Accept Offer',
		cta:{
			command: 'WebChat.open',
			commandOptions: {
				'proactive': true,
				'userData': {'category': 'shoes'}
			},
			url: 'http://www.google.com',
			target: '_blank'
		},
		video: 'https://www.youtube.com/watch?v=########',
		autoplay: true,
		videoOptions:{
			autoplay: false,
			loop: true
		},
		timeout: 11000,
		styles:{
			'.cx-body': {
				'background-color': '#FFFFFF',
				'color': '#008000'
			}
		},
		position: {
			'top': '100px', 
			'right': '30px', 
			'bottom': '30px', 
			'left': '100px'
		}
	},

	downloadVideoLib: true
};

Options

Name Type Description Default Required Accepted Values
offers.mode string Selects between overlay and toaster display modes. toaster false 'overlay', 'toaster'
offers.modal boolean Controls the smokescreen support for Offers overlay mode. If set to true, the smokescreen is added behind the offers window and blocks the user interaction from other webpage contents. If set to false, the smokescreen is not added. false false n/a
offers.layout string For the 'overlay' display container, sets the text on the right or left side of the image/video. leftText false 'leftText', 'rightText', 'minimal', 'stacked'
offers.title string The title of the widget; sets the title text in the widget header.

Note: Not available for stacked and minimal layouts.

n/a false n/a
offers.headline string A headline string displayed in larger text above the body. n/a false n/a
offers.body string The main text body of the offer. n/a false n/a
offers.button string A short string to be displayed inside the CTA button. n/a false n/a
offers.cta object An object containing the URL and/or CXBus command to open when the user clicks on the image or CTA button. n/a true n/a
offers.cta.command string A CXBus command to execute when the user clicks on the image or CTA button. n/a false n/a
offers.cta.commandOptions object An object containing options related to CXBus command. n/a false n/a
offers.cta.url string The URL to open when the user clicks on the image or CTA button.

Note: The URL must be properly defined with the complete Protocol URL Address. For example, https://www.genesys.com

n/a false n/a
offers.cta.target string The value to specify where to open the cta URL. _self false '_blank', '_parent', '_self', '_top', 'framename'
offers.image string A URL of an image to be displayed in the offer. n/a false n/a
offers.video string A URL of a YouTube or Vimeo video that displays in the offer. If an image URL is present the image replaces the video. Warnings appear in the JavaScript console if the video URL is not valid. n/a false n/a
offers.timeout integer Sets a timeout, in milliseconds, after which offers widget closes if there is no interaction. The minimum value is 10 seconds (10000 ms) to prevent the offer from flashing and disappearing while the user reads it. n/a false positive integers
offers.autoplay boolean Controls the video autoplay feature. If set to true, videos start playing automatically after loading. If set to false (default), videos will not autoplay.

Note: Autoplay feature may need to be enabled in certain IOS mobile devices.

false false true/false
offers.videoOptions object An object containing the adhoc configuration options specific to the player. The JSON definition placed here will enable/disable certain controls in the player.

Note: This must have options specific to the type of player (Youtube/Vimeo)

n/a n/a n/a
offers.position object An object containing the properties for positioning the offers window. The JSON definition placed here overrides the default position of the overlay.

Note: Positioning is disabled when modal option is set to true.

n/a false 'left', 'right', 'top', 'bottom'
offers.countdownText string A countdown text that displays before the countdown timer. If not set, the timer alone is displayed. n/a false n/a
downloadVideoLib boolean An option to enable loading of 3rd party video libraries. Needs to be set to true in order to show videos inside an offer.

Note: this option is only available in the static config, passing this along with the open parameter will not work.

false n/a true/false
styles object An object containing a custom CSS declarations. The JSON definition placed here overrides the CSS of elements visible inside the offers container. n/a n/a n/a
Comments or questions about this documentation? Contact us for support!