Merge pull request #21 from mrbot-ai/feature/expose-functions

Feature/expose functions

Author: Nathan Zylbersztejn

CHANGELOG.md

@@ -16,3 +16,7 @@ ratio while filling the element’s entire content box. If the
 object's aspect ratio does not match the aspect ratio of its box
 then the object will be clipped to fit. The clipping will be taken
 from the center.
+- `WebChat.toggle()`, `WebChat.open()`, and `WebChat.close` can be used to change the state of the chat box to open or closed.
+- `WebChat.show()` and `WebChat.hide()` can be used to show or hide the entire chat widget.
+- `WebChat.isOpen()` and `WebChat.isVisible()` can be used to get the open state of the chat box and the visibility state of the entire widget.
+

README.md

@@ -46,6 +46,12 @@ About images: `width` and `height` define the size in pixels that images in mess
 It is recommended to use a particular version (i.e. "webchat-<version>.js") however the file "webchat-latest.js"
 is also available and is updated continuously with the latest version.
 
+`WebChat.toggle()`, `WebChat.open()`, and `WebChat.close` can be used to change the state of the chat box to open or closed.
+
+`WebChat.show()` and `WebChat.hide()` can be used to show or hide the entire chat widget.
+
+`WebChat.isOpen()` and `WebChat.isVisible()` can be used to get the open state of the chat box and the visibility state of the entire widget.
+
 #### As a React component
 
 Install the package from GitHub by running:
@@ -64,7 +70,7 @@ function CustomWidget = () => {
       interval={2000}
       initPayload={"/get_started"}
       socketUrl={"http://localhost:5500"}
-       socketPath={"/socket.io/"}
+      socketPath={"/socket.io/"}
       title={"Title"}
       embedded={true}
       params={

dev/src/index.html

@@ -24,7 +24,6 @@
     }
   })
 </script>
-
 </body>
 
 </html>

index.js

@@ -1,9 +1,10 @@
 import React from 'react';
 import ReactDOM from 'react-dom';
-import { Widget } from './index_for_react_app';
+import { Widget, toggleWidget, openWidget, closeWidget, showWidget, hideWidget, isOpen, isVisible } from './index_for_react_app';
 
 const plugin = {
   init: (args) => {
+
     ReactDOM.render(
       <Widget
         socketUrl={args.socketUrl}
@@ -20,13 +21,19 @@ const plugin = {
         badge={args.badge}
         params={args.params}
       />, document.querySelector(args.selector)
-
     );
   }
 };
 
 export {
   plugin as default,
-  Widget
+  Widget,
+  toggleWidget as toggle,
+  openWidget as open,
+  closeWidget as close,
+  showWidget as show,
+  hideWidget as hide,
+  isOpen, 
+  isVisible
 };
 

index_for_react_app.js

@@ -7,7 +7,13 @@ import {
   addImageSnippet,
   addQuickReply,
   renderCustomComponent,
+  isOpen,
+  isVisible,
+  showWidget,
+  hideWidget,
   toggleWidget,
+  openWidget,
+  closeWidget,
   toggleInputDisabled,
   dropMessages
 } from './src/store/actions/dispatcher';
@@ -21,7 +27,13 @@ export {
   addImageSnippet,
   addQuickReply,
   renderCustomComponent,
+  isOpen,
+  isVisible,
+  showWidget,
+  hideWidget,
   toggleWidget,
+  openWidget,
+  closeWidget,
   toggleInputDisabled,
   dropMessages
 };

src/components/Widget/index.js

@@ -103,6 +103,7 @@ class Widget extends Component {
         profileAvatar={this.props.profileAvatar}
         showCloseButton={this.props.showCloseButton}
         fullScreenMode={this.props.fullScreenMode}
+        showWidget={this.props.showWidget}
         showChat={this.props.showChat}
         badge={this.props.badge}
         embedded={this.props.embedded}
@@ -126,6 +127,7 @@ Widget.propTypes = {
   profileAvatar: PropTypes.string,
   showCloseButton: PropTypes.bool,
   fullScreenMode: PropTypes.bool,
+  showWidget: PropTypes.bool,
   showChat: PropTypes.bool,
   badge: PropTypes.number,
   socket: PropTypes.shape({}),

src/components/Widget/layout.js

@@ -16,6 +16,7 @@ const WidgetLayout = (props) => {
   );
 
   return (
+    props.showWidget ? 
     <div className={classes.join(' ')}>
       {
         (props.fullScreenMode || props.showChat || props.embedded) &&
@@ -39,6 +40,7 @@ const WidgetLayout = (props) => {
         />
       }
     </div>
+    : null
   );
 };
 
@@ -58,6 +60,7 @@ WidgetLayout.propTypes = {
 };
 
 export default connect(store => ({
+  showWidget: store.behavior.get('showWidget'),
   showChat: store.behavior.get('showChat'),
   disabledInput: store.behavior.get('disabledInput')
 }))(WidgetLayout);

src/store/actions/actionTypes.js

@@ -1,5 +1,11 @@
 export const INITIALIZE = 'INITIALIZE';
+export const GET_OPEN_STATE = 'GET_OPEN_STATE';
+export const GET_VISIBLE_STATE = 'GET_VISIBLE_STATE';
+export const SHOW_WIDGET = 'SHOW_WIDGET';
+export const HIDE_WIDGET = 'HIDE_WIDGET';
 export const TOGGLE_CHAT = 'TOGGLE_CHAT';
+export const OPEN_CHAT = 'OPEN_CHAT';
+export const CLOSE_CHAT = 'CLOSE_CHAT';
 export const TOGGLE_INPUT_DISABLED = 'TOGGLE_INPUT_DISABLED';
 export const CHANGE_INPUT_FIELD_HINT = 'CHANGE_INOUT_FIELD_HINT';
 export const ADD_NEW_USER_MESSAGE = 'ADD_NEW_USER_MESSAGE';

src/store/actions/dispatcher.js

@@ -1,6 +1,14 @@
 import { store } from '../store';
 import * as actions from './index';
 
+export function isOpen() {
+  return store.dispatch(actions.getOpenState());
+  }
+
+export function isVisible() {
+  return store.dispatch(actions.getVisibleState());
+}
+
 export function initialize() {
   store.dispatch(actions.initialize());
 }
@@ -45,10 +53,26 @@ export function renderCustomComponent(component, props, showAvatar = false) {
   store.dispatch(actions.renderCustomComponent(component, props, showAvatar));
 }
 
+export function showWidget() {
+  store.dispatch(actions.showWidget());
+}
+
+export function hideWidget() {
+  store.dispatch(actions.hideWidget());
+}
+
 export function toggleWidget() {
   store.dispatch(actions.toggleChat());
 }
 
+export function openWidget() {
+  store.dispatch(actions.openChat());
+}
+
+export function closeWidget() {
+  store.dispatch(actions.closeChat());
+}
+
 export function toggleInputDisabled() {
   store.dispatch(actions.toggleInputDisabled());
 }

src/store/actions/index.js

@@ -6,12 +6,48 @@ export function initialize() {
   };
 }
 
+export function getOpenState() {
+  return {
+    type: actions.GET_OPEN_STATE
+  };
+}
+
+export function getVisibleState() {
+  return {
+    type: actions.GET_VISIBLE_STATE
+  };
+}
+
+export function showWidget() {
+  return {
+    type: actions.SHOW_WIDGET
+  };
+}
+
+export function hideWidget() {
+  return {
+    type: actions.HIDE_WIDGET
+  };
+}
+
 export function toggleChat() {
   return {
     type: actions.TOGGLE_CHAT
   };
 }
 
+export function openChat() {
+  return {
+    type: actions.OPEN_CHAT
+  };
+}
+
+export function closeChat() {
+  return {
+    type: actions.CLOSE_CHAT
+  };
+}
+
 export function toggleInputDisabled() {
   return {
     type: actions.TOGGLE_INPUT_DISABLED