![[Telegram] Core](/community/data/resource_icons/7/7579.jpg?1580582329){kind=icon}
- Compatible XF 2.x versions
- 2.1
- 2.2
- Additional requirements
- The third-party library requires cURL extension installed in PHP
- Visible branding
- No
Plugin provides the ability to log in via Telegram and basic code events for implementing bots with XF.
By default, plugin implements two ways for authenticating: default Telegram OAuth Button and "dialog with bot" (for cases when button doesn't displayed because user lives in country with censorship (hello from Russia)).
The project source code is hosted on GitHub. I am happy accept your PR or review issues.
I spent my free time developing this addon, and will be happy, if you donate me some money on coffee.
By default, plugin implements two ways for authenticating: default Telegram OAuth Button and "dialog with bot" (for cases when button doesn't displayed because user lives in country with censorship (hello from Russia)).
For using Telegram as authentication provider, we need create bot.
If you enabled webhook and uses CloudFlare or any CDN proxy, don't forget add Telegram IP ranges in whitelist. They are presented on the official Telegram site in documentation.
- Open the Telegram Client and find @BotFather user.
- Press button "Start" in window bottom.
- Send the command
/newbotfor starting the process. - Follow the instructions which will come in response in all your actions.
- In reply, after input bot username, you receive your HTTP access token. Do not show it [token] anyone! It important!
- For opportunity use bot as authentication provider, we need say
@BotFatherour domain where our forum is running. For this, you need use command/setdomain.
Domain should be sended without protocol and URI parts! For example, if your forum is hosted inhttps://example.com/forum, you need send onlyexample.com! - If you want, you can change user avatar (
/setuserpic) or change user viewable name (/setname). Note you can't change bot username (starts always with@and ends onbot). If you realized the selected username you don't like, it's time recreate bot! - Open the ACP, in Connected accounts find Telegram item and open settings. Copy HTTP access token from BotFather and Save.
- (optional) In Telegram options (
Setup→Options→Telegram) enable the webhook update method for receiving all updates from Telegram.
If you enabled webhook and uses CloudFlare or any CDN proxy, don't forget add Telegram IP ranges in whitelist. They are presented on the official Telegram site in documentation.
The project source code is hosted on GitHub. I am happy accept your PR or review issues.
I spent my free time developing this addon, and will be happy, if you donate me some money on coffee.
- Related resources
- [Telegram] Notifications, if you interested in receiving alerts in Telegram.
[Telegram] Two Factor, if you interested in using Telegram as Two Factor provider.
