diff options
author | Harrison Healey <harrisonmhealey@gmail.com> | 2016-08-03 00:16:27 -0400 |
---|---|---|
committer | Corey Hulen <corey@hulen.com> | 2016-08-02 20:16:27 -0800 |
commit | ea027c8de44d44b6ac4e66ab802e675d315b0be5 (patch) | |
tree | 52f3eff3d7e5ea0812ecd8173fa438a349fac38c /webapp | |
parent | 1de3bd3b4340cb51b2699a14a92d653db988a988 (diff) | |
download | chat-ea027c8de44d44b6ac4e66ab802e675d315b0be5.tar.gz chat-ea027c8de44d44b6ac4e66ab802e675d315b0be5.tar.bz2 chat-ea027c8de44d44b6ac4e66ab802e675d315b0be5.zip |
PLT-3728 Updated help text on integration pages (#3721)
Diffstat (limited to 'webapp')
4 files changed, 154 insertions, 30 deletions
diff --git a/webapp/components/integrations/components/add_command.jsx b/webapp/components/integrations/components/add_command.jsx index d24acd70d..cf1824145 100644 --- a/webapp/components/integrations/components/add_command.jsx +++ b/webapp/components/integrations/components/add_command.jsx @@ -261,8 +261,8 @@ export default class AddCommand extends React.Component { /> <div className='form__help'> <FormattedMessage - id='add_command.autocompleteDescription.help' - defaultMessage='Optional hint in the autocomplete list about command parameters' + id='add_command.autocompleteHint.help' + defaultMessage='(Optional) Arguments associated with your slash command, displayed as help in the autocomplete list.' /> </div> </div> @@ -295,7 +295,7 @@ export default class AddCommand extends React.Component { <div className='form__help'> <FormattedMessage id='add_command.autocompleteDescription.help' - defaultMessage='Optional short description of slash command for the autocomplete list.' + defaultMessage='(Optional) Short description of slash command for the autocomplete list.' /> </div> </div> @@ -341,6 +341,12 @@ export default class AddCommand extends React.Component { value={this.state.displayName} onChange={this.updateDisplayName} /> + <div className='form__help'> + <FormattedMessage + id='add_command.displayName.help' + defaultMessage='Display name for your slash command made of up to 64 characters.' + /> + </div> </div> </div> <div className='form-group'> @@ -362,6 +368,12 @@ export default class AddCommand extends React.Component { value={this.state.description} onChange={this.updateDescription} /> + <div className='form__help'> + <FormattedMessage + id='add_command.description.help' + defaultMessage='Description for your incoming webhook.' + /> + </div> </div> </div> <div className='form-group'> @@ -386,14 +398,34 @@ export default class AddCommand extends React.Component { /> <div className='form__help'> <FormattedMessage - id='add_command.trigger.help1' - defaultMessage='Examples: /patient, /client /employee' + id='add_command.trigger.help' + defaultMessage='Trigger word must be unique, and cannot begin with a slash or contain any spaces.' /> </div> <div className='form__help'> <FormattedMessage - id='add_command.trigger.help2' - defaultMessage='Reserved: /echo, /join, /logout, /me, /shrug' + id='add_command.trigger.helpExamples' + defaultMessage='Examples: client, employee, patient, weather' + /> + </div> + <div className='form__help'> + <FormattedMessage + id='add_command.trigger.helpReserved' + defaultMessage='Reserved: {link}' + values={{ + link: ( + <a + href='https://docs.mattermost.com/help/messaging/executing-commands.html#built-in-commands' + target='_blank' + rel='noopener noreferrer' + > + <FormattedMessage + id='add_command.trigger.helpReservedLinkText' + defaultMessage='see list of built-in slash commands' + /> + </a> + ) + }} /> </div> </div> @@ -481,7 +513,7 @@ export default class AddCommand extends React.Component { <div className='form__help'> <FormattedMessage id='add_command.username.help' - defaultMessage='Choose a username override for responses for this slash command. Usernames can consist of up to 22 characters consisting of lowercase letters, numbers and the symbols "-", "_", and ".".' + defaultMessage='(Optional) Choose a username override for responses for this slash command. Usernames can consist of up to 22 characters consisting of lowercase letters, numbers and they symbols "-", "_", and "." .' /> </div> </div> @@ -509,28 +541,32 @@ export default class AddCommand extends React.Component { <div className='form__help'> <FormattedMessage id='add_command.iconUrl.help' - defaultMessage='Choose a profile picture override for the post responses to this slash command. Enter the URL of a .png or .jpg file at least 128 pixels by 128 pixels.' + defaultMessage='(Optional) Choose a profile picture override for the post responses to this slash command. Enter the URL of a .png or .jpg file at least 128 pixels by 128 pixels.' /> </div> </div> </div> - <div className='form-group padding-bottom'> - <div className='col-sm-12'> - <div className='checkbox'> - <input - type='checkbox' - checked={this.state.autocomplete} - onChange={this.updateAutocomplete} - /> - <FormattedMessage - id='add_command.autocomplete' - defaultMessage='Autocomplete' - /> - </div> + <div className='form-group'> + <label + className='control-label col-sm-4' + htmlFor='autocomplete' + > + <FormattedMessage + id='add_command.iconUrl' + defaultMessage='Response Icon' + /> + </label> + <div className='col-md-5 col-sm-8 checkbox'> + <input + id='autocomplete' + type='checkbox' + checked={this.state.autocomplete} + onChange={this.updateAutocomplete} + /> <div className='form__help'> <FormattedMessage id='add_command.autocomplete.help' - defaultMessage='Show this command in the autocomplete list' + defaultMessage='(Optional) Show slash command in autocomplete list.' /> </div> </div> diff --git a/webapp/components/integrations/components/add_incoming_webhook.jsx b/webapp/components/integrations/components/add_incoming_webhook.jsx index a213a805f..4a3779aff 100644 --- a/webapp/components/integrations/components/add_incoming_webhook.jsx +++ b/webapp/components/integrations/components/add_incoming_webhook.jsx @@ -142,6 +142,12 @@ export default class AddIncomingWebhook extends React.Component { value={this.state.displayName} onChange={this.updateDisplayName} /> + <div className='form__help'> + <FormattedMessage + id='add_incoming_webhook.displayName.help' + defaultMessage='Display name for your incoming webhook made of up to 64 characters.' + /> + </div> </div> </div> <div className='form-group'> @@ -163,6 +169,12 @@ export default class AddIncomingWebhook extends React.Component { value={this.state.description} onChange={this.updateDescription} /> + <div className='form__help'> + <FormattedMessage + id='add_incoming_webhook.description.help' + defaultMessage='Description for your incoming webhook.' + /> + </div> </div> </div> <div className='form-group'> @@ -183,6 +195,12 @@ export default class AddIncomingWebhook extends React.Component { selectOpen={true} selectPrivate={true} /> + <div className='form__help'> + <FormattedMessage + id='add_incoming_webhook.channel.help' + defaultMessage='Public channel or private group that receives the webhook payloads. You must belong to the private group when setting up the webhook.' + /> + </div> </div> </div> <div className='backstage-form__footer'> diff --git a/webapp/components/integrations/components/add_outgoing_webhook.jsx b/webapp/components/integrations/components/add_outgoing_webhook.jsx index 6f9750a90..540b565cd 100644 --- a/webapp/components/integrations/components/add_outgoing_webhook.jsx +++ b/webapp/components/integrations/components/add_outgoing_webhook.jsx @@ -214,6 +214,12 @@ export default class AddOutgoingWebhook extends React.Component { value={this.state.displayName} onChange={this.updateDisplayName} /> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.displayName.help' + defaultMessage='Display name for your incoming webhook made of up to 64 characters.' + /> + </div> </div> </div> <div className='form-group'> @@ -235,6 +241,12 @@ export default class AddOutgoingWebhook extends React.Component { value={this.state.description} onChange={this.updateDescription} /> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.description.help' + defaultMessage='Description for your incoming webhook.' + /> + </div> </div> </div> <div className='form-group'> @@ -264,6 +276,24 @@ export default class AddOutgoingWebhook extends React.Component { {contentTypeOption2} </option> </select> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.contentType.help1' + defaultMessage='Choose the content type by which the response will be sent.' + /> + </div> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.contentType.help2' + defaultMessage='If application/x-www-form-urlencoded is chosen, the server assumes you will be encoding the parameters in a URL format.' + /> + </div> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.contentType.help3' + defaultMessage='If application/json is chosen, the server assumes you will posting JSON data.' + /> + </div> </div> </div> <div className='form-group'> @@ -283,6 +313,12 @@ export default class AddOutgoingWebhook extends React.Component { onChange={this.updateChannelId} selectOpen={true} /> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.channel.help' + defaultMessage='Public channel to receive webhook payloads. Optional if at least one Trigger Word is specified.' + /> + </div> </div> </div> <div className='form-group'> @@ -304,6 +340,12 @@ export default class AddOutgoingWebhook extends React.Component { value={this.state.triggerWords} onChange={this.updateTriggerWords} /> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.triggerWords.help' + defaultMessage='Messages that start with one of the specified words will trigger the outgoing webhook. Optional if Channel is selected.' + /> + </div> </div> </div> <div className='form-group'> @@ -339,6 +381,12 @@ export default class AddOutgoingWebhook extends React.Component { /> </option> </select> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.triggerWordsTriggerWhen.help' + defaultMessage='Choose when to trigger the outgoing webhook; if the first word of a message matches a Trigger Word exactly, or if it starts with a Trigger Word.' + /> + </div> </div> </div> <div className='form-group'> @@ -360,6 +408,12 @@ export default class AddOutgoingWebhook extends React.Component { value={this.state.callbackUrls} onChange={this.updateCallbackUrls} /> + <div className='form__help'> + <FormattedMessage + id='add_outgoing_webhook.callbackUrls.help' + defaultMessage='The URL that messages will be sent to.' + /> + </div> </div> </div> <div className='backstage-form__footer'> diff --git a/webapp/i18n/en.json b/webapp/i18n/en.json index e2f14fa36..d77c9e2d8 100644 --- a/webapp/i18n/en.json +++ b/webapp/i18n/en.json @@ -30,19 +30,21 @@ "activity_log_modal.androidNativeApp": "Android Native App", "activity_log_modal.iphoneNativeApp": "iPhone Native App", "add_command.autocomplete": "Autocomplete", - "add_command.autocomplete.help": " Show this command in the autocomplete list.", + "add_command.autocomplete.help": "(Optional) Show slash command in autocomplete list.", "add_command.autocompleteDescription": "Autocomplete Description", - "add_command.autocompleteDescription.help": "Optional short description of slash command for the autocomplete list.", + "add_command.autocompleteDescription.help": "(Optional) Short description of slash command for the autocomplete list.", "add_command.autocompleteDescription.placeholder": "Example: \"Returns search results for patient records\"", "add_command.autocompleteHint": "Autocomplete Hint", - "add_command.autocompleteHint.help": "Optional hint in the autocomplete list about parameters needed for command.", + "add_command.autocompleteHint.help": "(Optional) Arguments associated with your slash command, displayed as help in the autocomplete list.", "add_command.autocompleteHint.placeholder": "Example: [Patient Name]", "add_command.cancel": "Cancel", "add_command.description": "Description", + "add_command.description.help": "Description for your incoming webhook.", "add_command.displayName": "Display Name", + "add_command.displayName.help": "Display name for your slash command made of up to 64 characters.", "add_command.header": "Add", "add_command.iconUrl": "Response Icon", - "add_command.iconUrl.help": "Choose a profile picture override for the post responses to this slash command. Enter the URL of a .png or .jpg file at least 128 pixels by 128 pixels.", + "add_command.iconUrl.help": "(Optional) Choose a profile picture override for the post responses to this slash command. Enter the URL of a .png or .jpg file at least 128 pixels by 128 pixels.", "add_command.iconUrl.placeholder": "https://www.example.com/myicon.png", "add_command.method": "Request Method", "add_command.method.get": "GET", @@ -50,8 +52,10 @@ "add_command.method.post": "POST", "add_command.save": "Save", "add_command.trigger": "Command Trigger Word", - "add_command.trigger.help1": "Examples: patient, client, employee", - "add_command.trigger.help2": "Reserved: echo, join, logout, me, shrug", + "add_command.trigger.help": "Trigger word must be unique, and cannot begin with a slash or contain any spaces.", + "add_command.trigger.helpExamples": "Examples: client, employee, patient, weather", + "add_command.trigger.helpReserved": "Reserved: {link}", + "add_command.trigger.helpReservedLinkText": "see list of built-in slash commands", "add_command.trigger.placeholder": "Command trigger e.g. \"hello\"", "add_command.triggerInvalidLength": "A trigger word must contain between {min} and {max} characters", "add_command.triggerInvalidSlash": "A trigger word cannot begin with a /", @@ -62,7 +66,7 @@ "add_command.url.placeholder": "Must start with http:// or https://", "add_command.urlRequired": "A request URL is required", "add_command.username": "Response Username", - "add_command.username.help": "Choose a username override for responses for this slash command. Usernames can consist of up to 22 characters consisting of lowercase letters, numbers and they symbols \"-\", \"_\", and \".\" .", + "add_command.username.help": "(Optional) Choose a username override for responses for this slash command. Usernames can consist of up to 22 characters consisting of lowercase letters, numbers and they symbols \"-\", \"_\", and \".\" .", "add_command.username.placeholder": "Username", "add_emoji.cancel": "Cancel", "add_emoji.header": "Add", @@ -81,26 +85,38 @@ "add_incoming_webhook.cancel": "Cancel", "add_incoming_webhook.channel": "Channel", "add_incoming_webhook.channelRequired": "A valid channel is required", + "add_incoming_webhook.channel.help": "Public channel or private group that receives the webhook payloads. You must belong to the private group when setting up the webhook.", "add_incoming_webhook.description": "Description", + "add_incoming_webhook.description.help": "Description for your incoming webhook.", "add_incoming_webhook.displayName": "Display Name", + "add_incoming_webhook.displayName.help": "Display name for your incoming webhook made of up to 64 characters.", "add_incoming_webhook.header": "Add", "add_incoming_webhook.name": "Name", "add_incoming_webhook.save": "Save", "add_outgoing_webhook.callbackUrls": "Callback URLs (One Per Line)", + "add_outgoing_webhook.callbackUrls.help": "The URL that messages will be sent to.", "add_outgoing_webhook.callbackUrlsRequired": "One or more callback URLs are required", "add_outgoing_webhook.cancel": "Cancel", "add_outgoing_webhook.channel": "Channel", + "add_outgoing_webhook.channel.help": "Public channel to receive webhook payloads. Optional if at least one Trigger Word is specified.", "add_outgoing_webhook.content_Type": "Content Type", + "add_outgoing_webhook.contentType.help1": "Choose the content type by which the response will be sent.", + "add_outgoing_webhook.contentType.help2": "If application/x-www-form-urlencoded is chosen, the server assumes you will be encoding the parameters in a URL format.", + "add_outgoing_webhook.contentType.help3": "If application/json is chosen, the server assumes you will posting JSON data.", "add_outgoing_webhook.description": "Description", + "add_outgoing_webhook.description.help": "Description for your outgoing webhook.", "add_outgoing_webhook.displayName": "Display Name", + "add_outgoing_webhook.displayName.help": "Display name for your outgoing webhook made of up to 64 characters.", "add_outgoing_webhook.header": "Add", "add_outgoing_webhook.name": "Name", "add_outgoing_webhook.save": "Save", "add_outgoing_webhook.triggerWords": "Trigger Words (One Per Line)", + "add_outgoing_webhook.triggerWords.help": "Messages that start with one of the specified words will trigger the outgoing webhook. Optional if Channel is selected.", "add_outgoing_webhook.triggerWordsOrChannelRequired": "A valid channel or a list of trigger words is required", "add_outgoing_webhook.triggerWordsTriggerWhen": "Trigger When", "add_outgoing_webhook.triggerWordsTriggerWhenFullWord": "First word matches a trigger word exactly", "add_outgoing_webhook.triggerWordsTriggerWhenStartsWith": "First word starts with a trigger word", + "add_outgoing_webhook.triggerWordsTriggerWhen.help": "Choose when to trigger the outgoing webhook; if the first word of a message matches a Trigger Word exactly, or if it starts with a Trigger Word.", "admin.audits.reload": "Reload User Activity Logs", "admin.audits.title": "User Activity Logs", "admin.authentication.email": "Email Auth", |