- Compatible With XenForo
-
- 2.1
- Additional Requirements
- The third-party library requires cURL extension installed in PHP
- Visible Branding
- No
The 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 a bot" (for cases when the button doesn't display because user lives in the country with censorship (hello from Russia)).
For using Telegram as an authentication provider, we need to create a bot.
If you enabled webhook and uses Cloudflare or any CDN proxy, don't forget to add Telegram IP ranges in the whitelist. They are presented on the official Telegram site in the documentation.
By default, plugin implements two ways for authenticating: default Telegram OAuth Button and "dialog with a bot" (for cases when the button doesn't display because user lives in the country with censorship (hello from Russia)).
For using Telegram as an authentication provider, we need to create a bot.
- Open the Telegram Client and find @BotFather user.
- Press button "Start" in the window bottom.
- Send the command
/newbot
for starting the process. - Follow the instructions which will come in response to all your actions.
- In reply, after input bot username, you receive your HTTP access token. Do not show it [token] anyone! It is important!
- For opportunity use bot as the authentication provider, we need to say
@BotFather
our domain where our forum is running. For this, you need to use the command/setdomain
.
Domain should be sent without protocol and URI parts! For example, if your forum is hosted inhttps://example.com/forum
, you need to send onlyexample.com
! - If you want, you can change the user avatar (
/setuserpic
) or change user viewable name (/setname
). Note you can't change bot username (starts always with@
and ends on abot
). 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 to add Telegram IP ranges in the whitelist. They are presented on the official Telegram site in the documentation.