VP Social Login - Troubleshooting & FAQ

Most problems come down to one of three things: a plugin that isn't enabled, a redirect URI that doesn't match, or a Telegram domain set the wrong way. Here's how to spot and fix each, plus answers to common questions.

The buttons don't appear

• Make sure the System - VP Social Login plugin is enabled (Installation & setup).
• The provider must be switched Enabled on its tab, with a Client ID and secret filled in (Telegram needs a bot username and token).
• Clear the Joomla cache after changing settings.

"redirect_uri_mismatch" or "Invalid redirect"

The provider rejects the sign-in because the redirect URI registered in its console doesn't exactly match the one VP Social Login sends.

• Copy the redirect URI from the provider's tab in the plugin and paste it into the provider console — don't type it by hand.
• It must match character for character: https:// (not http://), the correct domain, no extra spaces or trailing slash.
• If your site is reachable on both www. and the bare domain, register the one your site actually uses.

Telegram doesn't come back / nothing happens

• In @BotFather, run /setdomain and set the bare domain only — your-site.com, not https://your-site.com and not a path.
• Check the Bot username (without @) and Bot token on the Telegram tab.
• The domain in BotFather must be the same domain visitors use to reach the site.

Linking and account errors

"This account is already connected to a different user." That social identity is linked to another Joomla account. Sign in to that account and disconnect it first, or link a different social account.

"An account with this email already exists." A user with that e-mail already exists. Sign in with your username and password, then connect the provider from your profile (Connected accounts).

You can't remove the last provider. If your account was created through social login and has no password, you can't disconnect your only sign-in method. Connect another provider, or set a password first.

The Connected accounts panel is missing

Enable the User - VP Social Login (Connected accounts) plugin. It can't work unless the System plugin is enabled too.

Turn on debug mode

If a sign-in fails without a clear reason, open the plugin's Plugin tab and set Debug mode to Yes. The technical reason is then shown on screen. Switch it back off once you've found the cause.

FAQ

Is it really free? Yes — GNU GPL v2, all four providers included, no paid tier or license key.

Do users need an e-mail for Telegram? No. Telegram doesn't share one, so VP Social Login assigns a stable internal address automatically.

Can existing members link a social account? Yes, from the Connected accounts panel in their profile.

Does it replace password login? No — it adds to the native Joomla login. Password sign-in keeps working.

Can I show only some providers? Enable only the ones you want on their tabs; the login form and module show just those.

What data is stored? Only what's needed to link the account — the provider name and your ID with that provider. No passwords.