Skip to content
/ widgets Public

Embed the power of Webex in your web applications ✨

License

Notifications You must be signed in to change notification settings

webex/widgets

Repository files navigation

Webex Widgets

Embed the power of Webex in your web applications ✨

CircleCI npm latest version semantic-release license

Webex Widgets are a set of self-contained React components that follow the Webex products experience, aimed at developers that want to embed Webex into their applications.

Table of Contents

Install

npx install-peerdeps @webex/widgets

This will install the Widgets package, peer dependencies and dependencies.

Usage

Styles

In order to properly style Webex Widgets, you will need to import our CSS separately. Import @webex/widgets/dist/css/webex-widgets.css into your main entry file.

There are two ways to do this:

JavaScript

In your App.js[x], add the following import:

import '@webex/widgets/dist/css/webex-widgets.css';

...

HTML

In the <head> tag of your index.html, add the following tag:

<head>
  ...

  <link rel="stylesheet" type="text/css" href="node_modules/@webex/widgets/dist/css/webex-widgets.css" />
</head>

For this to work, make sure that your node_modules folder is served. Alternately, you may copy the CSS file to your public folder and update the link reference accordingly.

Widgets

Please make sure to install the Webex Widget package and related dependencies.

npx install-peerdeps @webex/widgets

To use a Webex Widget, simply import the desired widget and render it into your React application.

import {WebexMeetingsWidget} from '@webex/widgets';

import '@webex/widgets/dist/css/webex-widgets.css';

export default function App() {
  return (
    <WebexMeetingsWidget
      style={{width: "1000px", height: "500px"}} // Substitute with any arbitrary size or use `className`
      accessToken="<ACCESS_TOKEN>"
      meetingDestination="<MEETING_DESTINATION>"
    />
  );
}

Available widgets from this package are:

FedRAMP Environment

To enable usage simply use the fedramp prop when adding the widget to your React appplication.

import {WebexMeetingsWidget} from '@webex/widgets';

import '@webex/widgets/dist/css/webex-widgets.css';

export default function App() {
  return (
    <WebexMeetingsWidget
      accessToken="<ACCESS_TOKEN>"
      meetingDestination="<MEETING_DESTINATION>"
      fedramp={true}
    />
  );

For more information on FedRAMP visit https://developer.webex.com/docs/fedramp-overview

Features that do not work in FedRAMP

  • Creating Guest tokens aka JWT tokens (not a widget limitation but environment limitation)

Contributing

We'd love for you to contribute to our source code and to make the Webex Widgets even better than they are today! Here are some guidelines that we'd like you to follow.

Issues

Please open an issue and we will get to it in an orderly manner. Please leave as much as information as possible for a better understanding.

Contributing Code

We are using Airbnb-style lint rules and prettier to lint the code. Make sure your code your code follows our lint rules before submitting!

For more information on contributions, please visit our contributing guide.

Commit linter

We are using commitlint to lint the commit messages. Please make sure to choose the appropriate commit type, scope and subject.

License

MIT License

Support

For more developer resources, tutorials and support, visit the Webex developer portal, https://developer.webex.com.