0.0.5 • Published 1 year ago

@olvyhq/widget-angular v0.0.5

Weekly downloads
-
License
-
Repository
-
Last release
1 year ago

@olvyhq/widget-angular

This angular component allows you to easily include Olvy widgets in your Angular 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.

Logo

Demo

https://codesandbox.io/s/olvy-widget-angular-qf2fvd

Installation

Install @olvyhq/widget-angular with npm

  npm install @olvyhq/widget-angular

Usage/Examples

import { WidgetAngularComponent } from '@olvyhq/widget-angular';
@NgModule({
  ....

  imports: [
    WidgetAngularComponent
  ],

  ....
 
})

How to use

  <olvy-widget [config]="<Configuration>">
    <div "<css-selector>" ></div>
  </olvy-widget>

//Replace "<css-selector>" with the selector you configured on Olvy for target element and <Configuration> with your configuration

Example

<olvy-widget [config]="appConfig">
    <div id="olvy-whats-new">Announcement Widget</div>
  </olvy-widget>
  //here appConfig has the configuration and #olvy-whats-new is the target element

Configuration

appConfig={
    workspaceAlias: "olvysdktest"
  }
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringOptional. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

Methods

Fetch olvy Utils

let OlvyUtils = await OlvyWidgetComponent.getOlvyUtils()

To show widget

OlvyUtils.showWidget(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To hide widget

OlvyUtils.hideWidget(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To set user

OlvyUtils.setUser(workspaceAlias, userObject) 
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
userObjectobjectRequired.

To set feedback meta info

OlvyUtils.setFeedbackMetaInfo (workspaceAlias, metaInfo)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
metaInfoobjectRequired.

To refresh unread count

OlvyUtils.refreshUnreadCount(workspaceAlias,widgetAliasOrID) 
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To show unread releases count

OlvyUtils.getUnreadReleasesCount(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To remove unread indicator element

OlvyUtils.removeUnreadIndicatorElement(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. 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) 
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To get last opened timestamp

OlvyUtils.getLastOpenedTimestamp(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To refresh the widget

OlvyUtils.refresh(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To teardown the widget

OlvyUtils.teardown(workspaceAlias,widgetAliasOrID)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
widgetAliasOrIDstringRequired. widget Id or alias ( you can find it on widget details page in olvy dashbaord )

To create feedback

OlvyUtils.createFeedback(workspaceAlias,params)
ParameterTypeDescription
workspaceAliasstringRequired. Your subdomain
paramsobjectRequired.

Tests

 npx jest
0.0.1

1 year ago

0.0.3

1 year ago

0.0.5

1 year ago

0.0.4

1 year ago

0.0.2

1 year ago