From 0fe5f5735aa59627f848f321bd13c6579e2d8ed4 Mon Sep 17 00:00:00 2001 From: Netkas Date: Wed, 15 Feb 2023 15:35:50 -0500 Subject: [PATCH] Updated README.md --- .idea/webResources.xml | 14 ++++++++ README.md | 71 ++++++++++++++++++++++++++++++++++++++- assets/documentation.png | Bin 0 -> 51689 bytes 3 files changed, 84 insertions(+), 1 deletion(-) create mode 100644 .idea/webResources.xml create mode 100644 assets/documentation.png diff --git a/.idea/webResources.xml b/.idea/webResources.xml new file mode 100644 index 0000000..7356908 --- /dev/null +++ b/.idea/webResources.xml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/README.md b/README.md index 361cc8a..4e2d080 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,75 @@ # TgBotLib -Coming soon... +TgBotLib is a library for creating Telegram Bots in PHP, based on the [Telegram Bot API](https://core.telegram.org/bots/api). + +The approach taken by this library is to be as close as possible to the Telegram Bot API, while providing a simple and +easy to use interface that is easy to understand and out of your way, allowing you to use the library as a simple +wrapper around the API. + +## Installation + +The library can be installed using ncc: + +```bash +ncc install -p "nosial/libs.tgbot=latest@n64" +``` + +or by adding the following to your project.json file under the `build.dependencies` section: +```json +{ + "name": "net.nosial.tgbotlib", + "version": "latest", + "source_type": "remote", + "source": "nosial/libs.tgbot=latest@n64" +} +``` + +If you don't have the n64 source configured, you can add it by running the following command: +```bash +ncc source add --name n64 --type gitlab --host git.n64.cc +``` + + +## Usage + + 1. Import the library using `import('net.nosial.tgbotlib');` + 2. Create a new instance of the `TgBotLib\Bot` class, passing the bot token as the first argument + 3. Profit + +```php + +require 'ncc'; +import('net.nosial.tgbotlib'); + +$bot = new TgBotLib\Bot(''); + +/** @var \TgBotLib\Objects\Telegram\Update $update */ +foreach ($bot->getUpdates() as $update) +{ + $bot->sendMessage($update->getMessage()->getChat()->getId(), 'Hello World!'); +} +``` + +Each method of the `TgBotLib\Bot` class is named after the corresponding method of the Telegram Bot API, all methods +contains an optional `$parameters` argument that can be used to pass additional parameters to the API method. + +But for methods that has required parameters, the library provides a more convenient way to pass them, by using +named parameters. For example, the `sendMessage` method requires the `chat_id` and `text` parameters, but instead +of passing them as an array, you can pass them as named parameters: + +```php +$bot->sendMessage('', 'Hello World!', [ + 'parse_mode' => 'Markdown', + 'disable_web_page_preview' => true, +]); +``` + +## Documentation + +Almost everything in the library has PhpDoc documentation, so you can use your IDE to get documentation for the +library. For example, in PhpStorm, you can press `Ctrl+Q` on a method to get the documentation for it: + +![PhpStorm Documentation](assets/documentation.png) # License diff --git a/assets/documentation.png b/assets/documentation.png new file mode 100644 index 0000000000000000000000000000000000000000..e553c5dc2319524499f27bf0c777fe9fc4753c23 GIT binary patch literal 51689 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