octoleo
/
telegram-bot-bash
mirror of https://github.com/octoleo/telegram-bot-bash.git
1
1
Fork 0
Code Issues Projects Releases Wiki Activity

doc: advise use of new _button_row helper function

This commit is contained in:
Kay Marquardt (Gnadelwartz) 2021-01-20 16:21:46 +01:00
parent f95b6c2e7d
commit f6e319c6eb
2 changed files with 40 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
bin/send_buttons.sh
View File

@ -9,19 +9,22 @@ USAGE='send_message.sh [-h|--help] "CHAT[ID]" "message" "text|url" ...'
# #
# OPTIONS: CHAT[ID] - ID number of CHAT or BOTADMIN to send to yourself # OPTIONS: CHAT[ID] - ID number of CHAT or BOTADMIN to send to yourself
# message - message to send # message - message to send
# text|url - buttons to send in a row, each as "button text|url" # text|url - buttons to send, each button as "text|url" pair or
# e.g. "Amazon|https://www.amzon.com" "Mydealz|https://mydealz.de" ... # "url" only to show url as text also, "" starts new row
# #
# -h - display short help # -h - display short help
# --help - this help # --help - this help
# #
# EXAMPLE: 2 buttons on 2 rows, first shows Amazon, second the url as text
# send_buttons.sh "Amazon|https://www.amazon.com" "" "https://mydealz.de" ...
#
# Set BASHBOT_HOME to your installation directory # Set BASHBOT_HOME to your installation directory
# #
# LICENSE: WTFPLv2 http://www.wtfpl.net/txt/copying/ # LICENSE: WTFPLv2 http://www.wtfpl.net/txt/copying/
# AUTHOR: KayM (gnadelwartz), kay@rrr.de # AUTHOR: KayM (gnadelwartz), kay@rrr.de
# CREATED: 18.01.2021 11:34 # CREATED: 18.01.2021 11:34
# #
#### $$VERSION$$ v1.31-dev-9-g6c91a32 #### $$VERSION$$ v1.31-dev-10-gf95b6c2
#=============================================================================== #===============================================================================
#### ####

47
doc/6_reference.md
View File

@ -220,36 +220,57 @@ _keyboard_numpad
##### send_button ##### send_button
`send_button` sends a text message followed by a single button.
*usage:* send_button "$CHAT[ID]" "message" "text" "URL" *usage:* send_button "$CHAT[ID]" "message" "text" "URL"
*alias:* _button "text" "URL" *alias:* _button "text" "URL"
*example:* *example:*
```bash ```bash
send_button "${CHAT[ID]}" "MAKE MONEY FAST!!!" "Visit my Shop" "https://dealz.rrr.de" send_button "${CHAT[ID]}" "Awesome Deals!" "Visit my Shop" "https://dealz.rrr.de"
``` ```
##### send_inline_keyboard ##### _button_row
`send_inline_keyboard` send an array of buttons. `_button_row` is a helper function to create a JSON button array for use with `send_inline_keyboard`.
*usage:* send_inline_keyboard "CHAT[ID]" "message" "[ {"text":"text", "url":"url"} ...]" *usage:* _button_row "text|url" "text|url" "" "url" "" "text|url" ...
*alias:* _inline_keyboard "[{"text":"text", "url":"url"} ...]" Each button is specified as a `"tex|url"` pair separated by `|`, text is shown on the button and url is opened on button click.
By default all buttons are displayed on one row, an empty string `""` starts a new button row.
The buttons array must be specified as a JSON string in the following format per button row, multiple rowsare concateneated with ',' If `"url"` without text is given, the url is shown on the button and opened on button click.
`[ {"text":"text1", "url":"url1"}, ... {"text":"textN", "url":"urlN"} ]`
*example:* *example:*
```bash ```bash
# one button, same as send_button # one button, same as send_button
send_inline_keyboard "${CHAT[ID]}" "MAKE MONEY FAST!!!" '[{"text":"Visit my Shop", "url":"https://dealz.rrr.de"}]' send_inline_keyboard "${CHAT[ID]}" "Best Dealz!" "$(_button_row "Visit my Shop|https://dealz.rrr.de")"
# one button row # one button row
send_inline_keyboard "${CHAT[ID]}" "" '[{"text":"button 1", url"":"http://rrr.de"}, {"text":"button 2", "url":"http://rrr.de"} ]' send_inline_keyboard "${CHAT[ID]}" "message" "$(_button_row "button 1|"http://rrr.de" "button 2|http://rrr.de")"
# multiple button rows # multiple button rows
send_inline_keyboard "${CHAT[ID]}" "" '[{"text":"b1", "url":"http://rrr.de"}, {"text":"b2", "url":"http://rrr.de"}], [{"text":"b4", "url":"http://rrr.de"}, "text":"b5", "url":"http://rrr.de"}]' send_inline_keyboard "${CHAT[ID]}" "message" "$(_button_row "b1|http://rrr.de" "b2|http://rrr.de" "" "b3|http://rrr.de" "b4|http://rrr.de")"
```
##### send_inline_keyboard
`send_inline_keyboard` send buttons given as an array of buttons in JSON format.
*usage:* send_inline_keyboard "CHAT[ID]" "message" "[JSON button array]"
A JSON button array has the following format, but I suggest to use `_button_row` to create them:
`[ {"text":"text1", "url":"url1"}, ... {"text":"textN", "url":"urlN"} ],[...]`
*example:*
```bash
# one button, same as send_button
send_inline_keyboard "${CHAT[ID]}" "Best Dealz!" '[{"text":"Visit my Shop", "url":"https://dealz.rrr.de"}]'
# one button row
send_inline_keyboard "${CHAT[ID]}" "message" '[{"text":"button 1", url"":"http://rrr.de"}, {"text":"button 2", "url":"http://rrr.de"} ]'
# multiple button rows
send_inline_keyboard "${CHAT[ID]}" "message" '[{"text":"b1", "url":"http://rrr.de"}, {"text":"b2", "url":"http://rrr.de"}], [{"text":"b3", "url":"http://rrr.de"}, "text":"b4", "url":"http://rrr.de"}]'
``` ```
*See also [Inline keyboard markup](https://core.telegram.org/bots/api/#inlinekeyboardmarkup)* *See also [Inline keyboard markup](https://core.telegram.org/bots/api/#inlinekeyboardmarkup)*
@ -1270,5 +1291,5 @@ The name of your bot is available as bash variable "$ME", there is no need to ca
#### [Prev Best Practice](5_practice.md) #### [Prev Best Practice](5_practice.md)
#### [Next Notes for Developers](7_develop.md) #### [Next Notes for Developers](7_develop.md)
#### $$VERSION$$ v1.31-dev-3-gb0f653b #### $$VERSION$$ v1.31-dev-10-gf95b6c2