====== tgnotify Plugin ======

---- plugin ----
description: A DokuWiki plugin that notifies a Telegram channel of page edits
author     : Ivan Smirnov
email      : ivsmir@gmail.com
type       : action
lastupdate : 2023-12-24
compatible : Hogfather, Igor, Jack Jackrum
depends    : 
conflicts  : 
similar    : 
tags       : notification, telegram, 

downloadurl: https://github.com/IvanVSmirnov/dokuwiki-tgnotify/zipball/master
bugtracker : https://github.com/IvanVSmirnov/dokuwiki-tgnotify/issues
sourcerepo : https://github.com/IvanVSmirnov/dokuwiki-tgnotify/
donationurl: 

screenshot_img : https://raw.githubusercontent.com/IvanVSmirnov/dokuwiki-tgnotify/main/screenshot1.png
----

===== Installation =====

Install the plugin using the [[extension|Extension Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.


===== Configuration and Settings =====

  - First of all we should create new telegram bot, to send messages. [[https://core.telegram.org/bots#3-how-do-i-create-a-bot|How do I create a bot?]]
  - Create a new telegram channel or group. Get an a chat ID for this channel via @getmyid_bot.
  - Add your bot to channel as admin with permission to post messages.
  - Set dokuwiki plugin settings: bot token from step 1 and chat ID from step 2.

Video tutorial (Russian with English subtitles) [[https://youtu.be/8KW71OSYzs8|on YouTube]].


===== Development =====

=== Change Log ===

  * **2023-12-24**
    * Feature: Ukrainian language translation added.
  * **2023-05-17**
    * Feature: Debug mode added.
  * **2023-03-27**
    * Feature: CURL dependency removed to support Dokuwiki Stick version.
  * **2022-03-09**
    * Feature: Silent messages added.
  * **2022-03-08**
    * Initial release.

=== Known Bugs and Issues ===

Don't know, yet.