Common

Common is a utility object available for import into Plugins/Widgets and Extensions. It provides common utility functions and dynamic generates common HTML Containers used throughout Genesys Widgets.

Methods

Common.generate.container({options})

Dynamically generates a new HTML Container in matching the style of Genesys Widgets with the selected components you request in your options object. Returns the generated container HTML as a jQuery wrapped set.

Argument	Type	Description
options	object	An object containing options to apply to the generated container.
options.type	string	"generic" or "overlay". Overlay containers have special CSS properties for appearing inside the Overlay widget. Default is "generic".
options.title	string	Title to apply to the container's titlebar area.
options.body	string or jQuery wrapped set	The HTML body you want the container to wrap.
options.icon	string	CSS Classname of icon to use
options.controls	string	Select from a set of window control buttons to show at the top right. "close" = Show only the close button. "minimize" = Show only the minimize button. "all" = Show both close and minimize buttons.
options.buttons	object	Options for displaying action buttons at the bottom of the container, such as OK and Cancel buttons.
options.buttons.type	string	Currently "binary" is the only supported button set at this time. Additional sets and arrangements will be available in a later release. Please pass "binary" as the type here if you wish to show typical "accept" and "dismiss" buttons.
options.buttons.primary	string	Display name on the primary button. (e.g. 'OK', 'Yes', 'Accept', 'Continue', etc)
options.buttons.secondary	string	Display name on the secondary button. (e.g. 'Cancel', 'No', 'Dismiss', 'Reject', etc)

Example

"Generate an Overlay Container"

var ndContainer = Common.Generate.Container({
    
    type: "overlay",
    title: "My Overlay",
    body: "Some HTML here as a string or jQuery wrapped set",
    icon: "cx-img-map preset-blue px48 call-outgoing",
    controls: "close",
    buttons: false
}),

"Generate a Toast Container"

var ndContainer = Common.Generate.Container({

    type: "generic",
    title: "My Toast",
    body: "Some HTML here as a string or jQuery wrapped set",
    icon: "cx-img-map preset-blue px48 chat",
    controls: "",
    buttons: {

        type: "binary",
        primary: "OK",
        secondary: "Cancel"
    }
}),

Common.generate.buttons({options})

Dynamically generates a new HTML Container in matching the style of Genesys Widgets with the selected components you request in your options object.

Argument	Type	Description
theme	string	Name of the theme you want to use. This name is specified in window._genesys.main.themes. Default themes are 'light' and 'dark'.

Example

"Check for window._genesys.main"

Common.checkPath(object, path)

Check for the existence of a sub-property of an object at any depth. Returns the value of that property if found otherwise it returns false. Useful for checking configuration object paths without having to check each sub-property level individually.

Argument	Type	Description
object	object	An Object you want checked for a particular sub property at any depth
path	string	The object path in dot notation you wish to search for.

Example

"Check for window._genesys.main"

 
    var oMainConfig = false;

    if(oMainConfig = Common.checkPath(window, "_genesys.main")){
        
        //... Utilize oMainConfig
    }

Common.linkify(string, options)

Search for and convert URLs within a string into HTML links. Returns transformed string.

Argument	Type	Description
string	string	An Object you want checked for a particular sub property at any depth
options	object	A list of options to apply to the linkify operation.
options.target	string	Choose the HTML TARGET attribute to apply to the generated links. Default is "_blank". Set this option to "self" to apply the target "_self" to the generated links.

Example

"Check for window._genesys.main"

 
    var sString = "Please visit www.genesys.com";

    sString = Common.linkify(sString, {target: 'self'});

    // sString == "Please visit <a href='www.genesys.com' target='_self'>www.genesys.com</a>'"