Integrate Feedback Widget Using React
This react component allows you to easily include Olvy widgets in your React applications. The component takes care of all the necessary set up and configuration, allowing you to simply specify which Olvy widget you want to use and any relevant options.
Project Setup
npm install @olvyhq/widget-react
Getting Started
On Main file
import {OlvyWidget,OlvyUtils} from "@olvyhq/widget-react"
How to use
<OlvyWidget
config={<Configuration> }
targetElement={<div>
<div id="<Target-Element-Id>"></div>
</div>
}
></OlvyWidget>
//Replace <Target-Element-Id> with your target element id and <Configuration> with your configuration
Example:
<OlvyWidget
config={{workspaceAlias: "olvysdktest"}}
targetElement={<div>
<div id="olvy-whats-new">Announcement Widget</div>
</div>
}>
</OlvyWidget>
Customize configuration
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
Methods
To show widget
OlvyUtils.showWidget(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To hide widget
OlvyUtils.hideWidget(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To set user
OlvyUtils.setUser(workspaceAlias, userObject)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
userObject | object | Required. |
To set feedback meta info
OlvyUtils.setFeedbackMetaInfo (workspaceAlias, metaInfo)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
metaInfo | object | Required. |
To refresh unread count
OlvyUtils.refreshUnreadCount(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To show unread releases count
OlvyUtils.getUnreadReleasesCount(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To remove unread indicator element
OlvyUtils.removeUnreadIndicatorElement(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To add unread indicator element
OlvyUtils.addUnreadIndicatorElement(workspaceAlias,widgetAliasOrID, count)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To get last opened timestamp
OlvyUtils.getLastOpenedTimestamp(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To refresh the widget
OlvyUtils.refresh(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To teardown the widget
OlvyUtils.teardown(workspaceAlias,widgetAliasOrID)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
widgetAliasOrID | string | Required. widget Id or alias ( you can find it on widget details page in olvy dashbaord ) |
To create feedback
OlvyUtils.createFeedback(workspaceAlias,params)
Parameter | Type | Description |
---|---|---|
workspaceAlias | string | Required. Your subdomain |
params | object | Required. |
Demo
Here's a link to the codesandbox demo so you can see a quick implementation.
That's it. That's how you can integrate Olvy in your React app. If you face any issues while integrating feel free to reach out to us on support@olvy.co and we will help you integrate Olvy into your application.