Merge pull request #37 from techthoughts2/Enhancements

Enhancements

Author: techthoughts2

.github/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.12.0]
+
+- Added support for MarkdownV2
+- Changed default Parse Mode for all functions from legacy Markdown to HTML
+- Added support for Polls v2.0 features
+
 ## [1.10.1]
 
 - Fixed bug where DisableNotification had no effect when running Send-TelegramSticker

docs/PoshGram.md

@@ -2,7 +2,7 @@
 Module Name: PoshGram
 Module Guid: 277b92bc-0ea9-4659-8f6c-ed5a1dfdfda2
 Download Help Link: NA
-Help Version: 1.10.1
+Help Version: 1.12.0
 Locale: en-US
 ---
 

docs/Send-TelegramContact.md

@@ -31,7 +31,6 @@ $firstName = 'Jean-Luc'
 Send-TelegramContact -BotToken $botToken -ChatID $chat -PhoneNumber $phone -FirstName $firstName
 ```
 
-
 Sends contact via Telegram API
 
 ### EXAMPLE 2
@@ -41,17 +40,16 @@ $chat = "-nnnnnnnnn"
 $phone = '1-222-222-2222'
 $firstName = 'Jean-Luc'
 $lastName = 'Picard'
-Send-TelegramContact \`
-    -BotToken $botToken \`
-    -ChatID $chat \`
-    -PhoneNumber $phone \`
-    -FirstName $firstName \`
-    -LastName $lastName \`
-    -DisableNotification \`
+Send-TelegramContact `
+    -BotToken $botToken `
+    -ChatID $chat `
+    -PhoneNumber $phone `
+    -FirstName $firstName `
+    -LastName $lastName `
+    -DisableNotification `
     -Verbose
 ```
 
-
 Sends contact via Telegram API
 
 ## PARAMETERS
@@ -173,4 +171,3 @@ Use the BotFather https://t.me/BotFather
 
 [https://core.telegram.org/bots/api#sendcontact](https://core.telegram.org/bots/api#sendcontact)
 
-

docs/Send-TelegramLocalAnimation.md

@@ -32,27 +32,42 @@ $animation = "C:\animation\animation.gif"
 Send-TelegramLocalAnimation -BotToken $botToken -ChatID $chat -AnimationPath $animation
 ```
 
-
 Sends AnimationPath message via Telegram API
 
 ### EXAMPLE 2
 ```
 $botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
 $chat = "-nnnnnnnnn"
 $animation = "C:\animation\animation.gif"
-Send-TelegramLocalAnimation \`
-    -BotToken $botToken \`
-    -ChatID $chat \`
-    -AnimationPath $animation \`
-    -Caption "Check out this animation" \`
-    -ParseMode Markdown \`
-    -DisableNotification \`
+Send-TelegramLocalAnimation `
+    -BotToken $botToken `
+    -ChatID $chat `
+    -AnimationPath $animation `
+    -Caption "Check out this animation" `
+    -ParseMode MarkdownV2 `
+    -DisableNotification `
     -Verbose
 ```
 
-
 Sends animation message via Telegram API
 
+### EXAMPLE 3
+```
+$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
+$chat = "-nnnnnnnnn"
+$animation = "C:\animation\animation.gif"
+$sendTelegramLocalAnimationSplat = @{
+    BotToken      = $botToken
+    ChatID        = $chat
+    AnimationPath = $animation
+    Caption       = "Check out this __awesome__ animation\."
+    ParseMode     = 'MarkdownV2'
+}
+Send-TelegramLocalAnimation @sendTelegramLocalAnimationSplat
+```
+
+Sends animation message via Telegram API with properly formatted underlined word and escaped special character.
+
 ## PARAMETERS
 
 ### -BotToken
@@ -117,7 +132,7 @@ Accept wildcard characters: False
 
 ### -ParseMode
 Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
-Default is Markdown.
+Default is HTML.
 
 ```yaml
 Type: String
@@ -126,7 +141,7 @@ Aliases:
 
 Required: False
 Position: 5
-Default value: Markdown
+Default value: HTML
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
@@ -178,4 +193,9 @@ Get creative by sending Gifs with your bot!
 
 [https://core.telegram.org/bots/api#sendanimation](https://core.telegram.org/bots/api#sendanimation)
 
+[https://core.telegram.org/bots/api#html-style](https://core.telegram.org/bots/api#html-style)
+
+[https://core.telegram.org/bots/api#markdownv2-style](https://core.telegram.org/bots/api#markdownv2-style)
+
+[https://core.telegram.org/bots/api#markdown-style](https://core.telegram.org/bots/api#markdown-style)
 

docs/Send-TelegramLocalAudio.md

@@ -34,30 +34,47 @@ $audio = "C:\audio\halo_on_fire.mp3"
 Send-TelegramLocalAudio -BotToken $botToken -ChatID $chat -Audio $audio
 ```
 
-
 Sends audio message via Telegram API
 
 ### EXAMPLE 2
 ```
 $botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
 $chat = "-nnnnnnnnn"
 $audio = "C:\audio\halo_on_fire.mp3"
-Send-TelegramLocalAudio \`
-    -BotToken $botToken \`
-    -ChatID $chat \`
-    -Audio $audio \`
-    -Caption "Check out this audio track" \`
-    -ParseMode Markdown \`
-    -Duration 495 \`
-    -Performer "Metallica" \`
-    -Title "Halo On Fire" \`
-    -DisableNotification \`
+Send-TelegramLocalAudio `
+    -BotToken $botToken `
+    -ChatID $chat `
+    -Audio $audio `
+    -Caption "Check out this audio track" `
+    -ParseMode MarkdownV2 `
+    -Duration 495 `
+    -Performer "Metallica" `
+    -Title "Halo On Fire" `
+    -DisableNotification `
     -Verbose
 ```
 
-
 Sends audio message via Telegram API
 
+### EXAMPLE 3
+```
+$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
+$chat = "-nnnnnnnnn"
+$audio = "C:\audio\halo_on_fire.mp3"
+$sendTelegramLocalAudioSplat = @{
+    BotToken  = $botToken
+    ChatID    = $chat
+    Audio     = $audio
+    Title     = "Halo On Fire"
+    Performer = "Metallica"
+    Caption   = "Check out this __awesome__ audio track\."
+    ParseMode = 'MarkdownV2'
+}
+Send-TelegramLocalAudio @sendTelegramLocalAudioSplat
+```
+
+Sends audio message via Telegram API with properly formatted underlined word and escaped special character.
+
 ## PARAMETERS
 
 ### -BotToken
@@ -122,7 +139,7 @@ Accept wildcard characters: False
 
 ### -ParseMode
 Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
-Default is Markdown.
+Default is HTML.
 
 ```yaml
 Type: String
@@ -131,7 +148,7 @@ Aliases:
 
 Required: False
 Position: 5
-Default value: Markdown
+Default value: HTML
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
@@ -226,4 +243,9 @@ Use the BotFather https://t.me/BotFather
 
 [https://core.telegram.org/bots/api#sendaudio](https://core.telegram.org/bots/api#sendaudio)
 
+[https://core.telegram.org/bots/api#html-style](https://core.telegram.org/bots/api#html-style)
+
+[https://core.telegram.org/bots/api#markdownv2-style](https://core.telegram.org/bots/api#markdownv2-style)
+
+[https://core.telegram.org/bots/api#markdown-style](https://core.telegram.org/bots/api#markdown-style)
 

docs/Send-TelegramLocalDocument.md

@@ -32,27 +32,42 @@ $file = "C:\Logs\Log1.txt"
 Send-TelegramLocalDocument -BotToken $botToken -ChatID $chat -File $file
 ```
 
-
 Sends document message via Telegram API
 
 ### EXAMPLE 2
 ```
 $botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
 $chat = "-nnnnnnnnn"
 $file = "C:\Logs\Log1.txt"
-Send-TelegramLocalDocument \`
-    -BotToken $botToken \`
-    -ChatID $chat \`
-    -File $file \`
-    -Caption "Check out this file" \`
-    -ParseMode Markdown \`
-    -DisableNotification \`
+Send-TelegramLocalDocument `
+    -BotToken $botToken `
+    -ChatID $chat `
+    -File $file `
+    -Caption "Check out this file" `
+    -ParseMode MarkdownV2 `
+    -DisableNotification `
     -Verbose
 ```
 
-
 Sends document message via Telegram API
 
+### EXAMPLE 3
+```
+$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
+$chat = "-nnnnnnnnn"
+$file = "C:\Logs\Log1.txt"
+$sendTelegramLocalDocumentSplat = @{
+    BotToken  = $botToken
+    ChatID    = $chat
+    File      = $file
+    Caption   = "Check out this __important__ file\."
+    ParseMode = 'MarkdownV2'
+}
+Send-TelegramLocalDocument @sendTelegramLocalDocumentSplat
+```
+
+Sends document message via Telegram API with properly formatted underlined word and escaped special character.
+
 ## PARAMETERS
 
 ### -BotToken
@@ -117,7 +132,7 @@ Accept wildcard characters: False
 
 ### -ParseMode
 Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
-Default is Markdown.
+Default is HTML.
 
 ```yaml
 Type: String
@@ -126,7 +141,7 @@ Aliases:
 
 Required: False
 Position: 5
-Default value: Markdown
+Default value: HTML
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
@@ -175,4 +190,9 @@ Use the BotFather https://t.me/BotFather
 
 [https://core.telegram.org/bots/api#senddocument](https://core.telegram.org/bots/api#senddocument)
 
+[https://core.telegram.org/bots/api#html-style](https://core.telegram.org/bots/api#html-style)
+
+[https://core.telegram.org/bots/api#markdownv2-style](https://core.telegram.org/bots/api#markdownv2-style)
+
+[https://core.telegram.org/bots/api#markdown-style](https://core.telegram.org/bots/api#markdown-style)
 

docs/Send-TelegramLocalPhoto.md

@@ -32,27 +32,42 @@ $photo = "C:\photos\aphoto.jpg"
 Send-TelegramLocalPhoto -BotToken $botToken -ChatID $chat -PhotoPath $photo
 ```
 
-
 Sends photo message via Telegram API
 
 ### EXAMPLE 2
 ```
 $botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
 $chat = "-nnnnnnnnn"
 $photo = "C:\photos\aphoto.jpg"
-Send-TelegramLocalPhoto \`
-    -BotToken $botToken \`
-    -ChatID $chat \`
-    -PhotoPath $photo \`
-    -Caption "Check out this photo" \`
-    -ParseMode Markdown \`
-    -DisableNotification \`
+Send-TelegramLocalPhoto `
+    -BotToken $botToken `
+    -ChatID $chat `
+    -PhotoPath $photo `
+    -Caption "Check out this photo" `
+    -ParseMode MarkdownV2 `
+    -DisableNotification `
     -Verbose
 ```
 
-
 Sends photo message via Telegram API
 
+### EXAMPLE 3
+```
+$botToken = "nnnnnnnnn:xxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxx"
+$chat = "-nnnnnnnnn"
+$photo = "C:\photos\aphoto.jpg"
+$sendTelegramLocalPhotoSplat = @{
+    BotToken  = $botToken
+    ChatID    = $chat
+    PhotoPath = $photo
+    Caption   = "Check out this __awesome__ photo\."
+    ParseMode = 'MarkdownV2'
+}
+Send-TelegramLocalPhoto @sendTelegramLocalPhotoSplat
+```
+
+Sends photo message via Telegram API with properly formatted underlined word and escaped special character.
+
 ## PARAMETERS
 
 ### -BotToken
@@ -117,7 +132,7 @@ Accept wildcard characters: False
 
 ### -ParseMode
 Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in your bot's message.
-Default is Markdown.
+Default is HTML.
 
 ```yaml
 Type: String
@@ -126,7 +141,7 @@ Aliases:
 
 Required: False
 Position: 5
-Default value: Markdown
+Default value: HTML
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
@@ -176,4 +191,9 @@ Use the BotFather https://t.me/BotFather
 
 [https://core.telegram.org/bots/api#sendphoto](https://core.telegram.org/bots/api#sendphoto)
 
+[https://core.telegram.org/bots/api#html-style](https://core.telegram.org/bots/api#html-style)
+
+[https://core.telegram.org/bots/api#markdownv2-style](https://core.telegram.org/bots/api#markdownv2-style)
+
+[https://core.telegram.org/bots/api#markdown-style](https://core.telegram.org/bots/api#markdown-style)