https://github.com/s0d3s/tg-long-req
Simple PHP class for navigate user in telegram bot(by design)
https://github.com/s0d3s/tg-long-req
php telegram telegram-bot telegram-bots telegram-long-request telegram-menu telegram-user-interface teleram-bot-menu
Last synced: 9 months ago
JSON representation
Simple PHP class for navigate user in telegram bot(by design)
- Host: GitHub
- URL: https://github.com/s0d3s/tg-long-req
- Owner: s0d3s
- License: mit
- Created: 2019-04-18T20:43:29.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-01-03T18:35:50.000Z (over 6 years ago)
- Last Synced: 2025-10-09T23:45:27.981Z (9 months ago)
- Topics: php, telegram, telegram-bot, telegram-bots, telegram-long-request, telegram-menu, telegram-user-interface, teleram-bot-menu
- Language: PHP
- Size: 89.8 KB
- Stars: 2
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TG LONG REQUEST
## What is this?
This is a small help-oriented class for creating tg bots. It helps with the creation and navigation in the menu telegram bot
---
Это небольшой класс для телеграм ботов. Он помогает в создании меню и дальнейшей навигации в нём.
## Abstract exemple

## INSTALL
**via composer**
(add this to section "require" in your composer.json)
{
"require" : {
"s0d3s/tg-long-req": ">=1"
}
}
and
include_once('path/to/autoload.php');
use s0d3s\TgLongReq;
**manual**
Copy the "TgLongReq.php" to the project dir and:
include_once('TgLongReq.php');
use s0d3s\TgLongReq;
## Simple use
1. **Create a TgLongReq obj**
>$tg_req = TgLongReq
>(
> 'user_id',
> 'req_func list'
> */*optinal*/* ,
> 'user_request_dir',
> tg_api_key,
> tg_api_result
> );
>
|Var|Type|Caption|
|--|--|--|
|$user_id| STRING | Telegram user id |
|$req_func| ARRAY | Requests and functions association table |
|$usr_req_dir|STR| Path to general request dir **|
|$tg_api_key| SOMETH/* | irazasyed/telegram-bot-sdk Api() object* |
|$tg_api_result| SOMETH/* |Api()->getWebhookUpdates() |
*It could be something else, or be null.
**Temporary requests from users will be stored in this folder.
---
2. **Create request**
> $tg_req->reqCreate('req_name'); *
*This parameter depends only on you (this name should be in the association table)
---
3. **Save and restore temprorary data**
- **saving**
For store (temporary) data, you can use "saveToTemp", the function accepts any data types and saves it as json string
> $tg_req->saveToTemp(\$some_data);
- **restore**
.
>$some_array = array();
>$some_array = \$tg_req->getFromTemp(\$hold_it==false);*
\* If needed, you can leave a temporary file until the next used, for this pass to function "true"(bool)
---
4. **Check the existence of the request**
> $tg_req->reqCheck();
> //return true if exists, else false
---
5. **Delete user request**
> $tg_req->reqDel();
---
6. **Handling request**
> $tg_req->reqHand();
> //This method will call the corresponding function from the association table.
---
7. **NOTES**
- Association table is array('req_name'=>'func_name')
- Functions specified in the table may not process passed parameters
> Some examples you can find at ./exmp