TeploBot - Telegram Bot for WP

Описание на русском языке - ниже.

TeploBot - Telegram Bot for WP is the plugin for WordPress that provides basic Telegram chatbot functionality for your site. The bot sends search results from your site as reply to chat users. For developers: the behavior of the bot could be customized.

Plugin features:

• webhook support to receive automatic updates from Telegram
• support for global Telegram commands
• send list of serach results into group and privte chats as a response to search requst
• support up to 5 custom commands with lists or recent posts or custom post types
• in private chats: messages without command processed as search requests
• log of messages and responses
• for developers: commands with custom logic could be defined

Limitation. In mean time the plugin doesn't support inline mode. Follow the development progress or send as pull-requests for improvements.

The plugin developed and supported by Teplitsa. Technologies for Social Good.

###How to install###

Plugins requires PHP 5.3+ and WordPress 4.5+.

1. Upload the plugin folder into wp-content/plugins using WordPress Dashboard (Plugins -- Add new) or by cloning GitHub-repo.

2. Activate the plugin through the Plugins menu in WordPress.

3. Configure the plugin by going to the page TeploBot -> Settings that appears in your admin menu.

To set the plugin into work you need to create a Telegram bot in the dialogue with BotFather user. Start chat with it and follow a few simple steps. Once you've created a bot you will received your authorization token, that should be saved in plugin settings.

Default commands

• /start Greeting on the dialogue start
• /help Provide the help text for user
• /s Provide search results as list of posts' link

Admins could add up to 5 custom commands that send list or posts or CPTs to chats. Developers could alter the commands logic through gwptb_supported_commnds_list filter (details published at GitHub wiki).

Commands should be defined in chat with @BotFather to be accepted by plugin: use /setcommands command and follow the instructions.

Screenshots

Plugin Settings

Connection setup for the bot

Log screen

Search results in chat

###Help the project###

We will be very grateful if you help us to make TeploBot better.

• Submit a bug report or feature request at GitHub.
• Send us pull-request to share a code improvement.
• Translate the plugin into your language

##Описание на русском языке##

TeploBot - Telegram Bot for WP - плагин для WordPress, реализующий простого чатбота для Телеграм. Бот может автоматически отправлять результаты поиска по сайту в ответ на запрос пользователей и позволяет их просматривать. Для разработчиков: состав действий бота может быть расширен.

Основные функции

• получение и обработка автоматический уведомлений от Телеграм о сообщениях боту
• поддержка стандартных команд Телеграм - /start и /help
• отправка результатов поиска по сайту в ответ на поисковый запрос (команду)
• поддержка до 5 собственный команд, отправляющих список последних записей или пользовательских типов записей
• в индивидуальных чатах сообщения, не содержащие команд, трактуются как поисковый запрос
• лог сообщений
• для разработчиков - возможность добавлять собственные команды или менять логику существующих

Ограничение. В настоящее время инлайновый режим не поддерживается плагином. Следите за обновлениями и присылайте пулл-реквесты.

Плагин разработан и поддерживается Теплицей социальных технологий.

Установка и использование

Для корректной работы необходим PHP версии 5.3 и выше и WordPress версии 4.5 и выше.

1. Загрузите папку плагина в директорию wp-content/plugins, используя административный интерфейс добавления плагинов (Плагины -- Добавить новый) или клонировав GitHub-репозиторий.

2. Активируйте плагин в списке плагинов (Меню - Плагины).

3. Настройки плагина доступны в меню TeploBot -> Настройки.

Для начала работы необходимо создать нового бота в чате Телеграм с пользователем @BotFather. Отправьте команду /newbot и следуйте инструкциям.

В случае успешного создания бота вы получите ключ (токен) авторизации. Скопируйте и сохраните его в настройках плагина, после чего установите соединение с Телеграм. В этом режиме бот будет отвечать на запросы пользователей в чате, отправляя результаты поиска по сайту и позволяя их пролистывать.

Стандартные команды

• /start Начало диалога
• /help Подсказка и описание команд
• /s Результаты поиска

Администраторы сайта могут добавить до 5 собственных команд, отправляющих список последних публикаций в чат. Разработчики могут определять собственные команды или менять логику существующих, используя фильтр gwptb_supported_commnds_list (подробнее в wiki на GitHub).

Чтобы бот распознавал команды, они должны быть установлены в диалоге с @BotFather: отправьте ему команду /setcommands и следуйте инструкциям.

Помощь проекту

Мы очень ждем вашей помощи проекту. Вы можете помочь следующими способами:

• Добавить сообщение об ошибке или предложение по улучшению на GitHub
• Поделиться улучшениями кода, прислав нам Pull Request
• Сделать перевод плагина или оптимизировать его для вашей страны.