2019-10-11 18:09:50 +00:00
|
|
|
// @flow
|
|
|
|
|
|
|
|
import { createToolbarEvent, sendAnalytics } from '../../analytics';
|
2022-09-27 07:10:28 +00:00
|
|
|
import { HELP_BUTTON_ENABLED, getFeatureFlag } from '../../base/flags';
|
2019-10-11 18:09:50 +00:00
|
|
|
import { translate } from '../../base/i18n';
|
|
|
|
import { IconHelp } from '../../base/icons';
|
|
|
|
import { connect } from '../../base/redux';
|
2020-07-24 12:14:33 +00:00
|
|
|
import { AbstractButton, type AbstractButtonProps } from '../../base/toolbox/components';
|
2020-05-20 10:57:03 +00:00
|
|
|
import { openURLInBrowser } from '../../base/util';
|
2019-10-11 18:09:50 +00:00
|
|
|
|
|
|
|
type Props = AbstractButtonProps & {
|
|
|
|
|
|
|
|
/**
|
2021-03-16 15:59:33 +00:00
|
|
|
* The URL to the user documentation.
|
2019-10-11 18:09:50 +00:00
|
|
|
*/
|
|
|
|
_userDocumentationURL: string
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Implements an {@link AbstractButton} to open the user documentation in a new window.
|
|
|
|
*/
|
|
|
|
class HelpButton extends AbstractButton<Props, *> {
|
|
|
|
accessibilityLabel = 'toolbar.accessibilityLabel.help';
|
|
|
|
icon = IconHelp;
|
|
|
|
label = 'toolbar.help';
|
2021-07-08 13:42:07 +00:00
|
|
|
tooltip = 'toolbar.help';
|
2019-10-11 18:09:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Handles clicking / pressing the button, and opens a new window with the user documentation.
|
|
|
|
*
|
|
|
|
* @private
|
|
|
|
* @returns {void}
|
|
|
|
*/
|
|
|
|
_handleClick() {
|
2022-01-04 11:21:00 +00:00
|
|
|
const { _userDocumentationURL } = this.props;
|
2021-09-14 07:07:20 +00:00
|
|
|
|
2019-10-11 18:09:50 +00:00
|
|
|
sendAnalytics(createToolbarEvent('help.pressed'));
|
2021-09-14 07:07:20 +00:00
|
|
|
openURLInBrowser(_userDocumentationURL);
|
2019-10-11 18:09:50 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Maps part of the redux state to the component's props.
|
|
|
|
*
|
|
|
|
* @param {Object} state - The redux store/state.
|
|
|
|
* @returns {Object}
|
|
|
|
*/
|
|
|
|
function _mapStateToProps(state: Object) {
|
2019-10-16 18:36:39 +00:00
|
|
|
const { userDocumentationURL } = state['features/base/config'].deploymentUrls || {};
|
2021-02-10 21:34:13 +00:00
|
|
|
const enabled = getFeatureFlag(state, HELP_BUTTON_ENABLED, true);
|
2022-06-09 13:00:41 +00:00
|
|
|
const visible = typeof userDocumentationURL === 'string' && enabled;
|
2019-10-11 18:09:50 +00:00
|
|
|
|
|
|
|
return {
|
|
|
|
_userDocumentationURL: userDocumentationURL,
|
|
|
|
visible
|
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
export default translate(connect(_mapStateToProps)(HelpButton));
|