onmotion / yii2-telegram
Support chat for site based on Telegram bot
Installs: 5 603
Dependents: 0
Suggesters: 0
Security: 0
Stars: 51
Watchers: 11
Forks: 23
Open Issues: 1
Type:yii2-extension
Requires
- php: >=5.5.0
- longman/telegram-bot: ^0.35.0
- yiisoft/yii2: >=2.0.1
README
Support chat for site based on Telegram bot
The Bot logic based on akalongman/php-telegram-bot, so you can read Instructions by longman how to register Telegram Bot and etc.
Now only telegram webhook api support. You need SSL cert! Doesn't work on http!
Installation
The preferred way to install this extension is through composer.
Run
composer require onmotion/yii2-telegram
add to your web config:
'modules' => [
//...
'telegram' => [
'class' => 'onmotion\telegram\Module',
'API_KEY' => 'forexample241875489:AdfgdfFuVJdsKa1cycuxra36g4dfgt66',
'BOT_NAME' => 'YourBotName_bot',
'hook_url' => 'https://yourhost.com/telegram/default/hook', // must be https! (if not prettyUrl https://yourhost.com/index.php?r=telegram/default/hook)
'PASSPHRASE' => 'passphrase for login',
// 'db' => 'db2', //db file name from config dir
// 'userCommandsPath' => '@app/modules/telegram/UserCommands',
// 'timeBeforeResetChatHandler' => 60
]
//more...
]
and to console config:
'bootstrap' => [
//other bootstrap components...
'telegram'],
'modules' => [
//...
'telegram' => [
'class' => 'onmotion\telegram\Module',
'API_KEY' => 'forexample241875489:AdfgdfFuVJdsKa1cycuxra36g4dfgt66',
'BOT_NAME' => 'YourBotName_bot',
'hook_url' => 'https://yourhost.com/telegram/default/hook', // must be https! (if not prettyUrl https://yourhost.com/index.php?r=telegram/default/hook)
'PASSPHRASE' => 'passphrase for login',
]
],
run migrations:
php yii migrate --migrationPath=@vendor/onmotion/yii2-telegram/migrations #that add 4 tables in your DB
or add to your config file
'controllerMap' => [
...
'migrate' => [
'class' => 'yii\console\controllers\MigrateController',
'migrationNamespaces' => [
'onmotion\telegram\migrations',
],
],
...
],
and run
php yii migrate/up
go to https://yourhost.com/telegram/default/set-webhook (if not prettyUrl https://yourhost.com/index.php?r=telegram/default/set-webhook)
Now you can place where you want
echo \onmotion\telegram\Telegram::widget(); //that add chat button in the page
in bottom right corner you can see:
if you click it:
and server side:
If you want to limit the storage period of messages history, add to you crontab:
#leave 5 days (if empty - default = 7)
php yii telegram/messages/clean 5
Also you can use custom commands. To do this, you can copy UserCommands dir from /vendor/onmotion/yii2-telegram/Commands and add path to this in config, for example:
'userCommandsPath' => '@app/modules/telegram/UserCommands'
timeBeforeResetChatHandler - the number of minutes before chat handler will be killed (if he forgot do /leavedialog). Never kill if 0 or not setted.