This guide helps you get VentraConnect working fast on WordPress. VentraConnect gives you three ways to let users sign in: Social Login with providers like Google, Facebook, and GitHub; Magic Link login through a secure email link; and Email OTP login using a short one-time code. For basic WordPress usage, all three methods are available in the free plugin. Pro extends that foundation with WooCommerce, memberships, LMS, comments, analytics, advanced notifications, and Passwordless Mode controls.
Before you start
- VentraConnect is installed and activated
- You can access the plugin settings in WordPress admin
- You know which method you want to set up first
- If using Social Login: you have access to the provider’s developer or app console
- If using Magic Link or Email OTP: your WordPress site can send emails reliably
For most sites, the safest approach is to enable one method, test it in a private or incognito window, and only then add more options.
Choose Your Quick Start Path
Pick the login method you want to get working first. Start with one, test it properly, then come back for the others.
Option 1 — Social Login
Fastest way to reduce friction. Users sign in with an existing account from Google, Facebook, GitHub, Microsoft, and more.
Option 2 — Magic Link
One-click passwordless login via a secure email link. No password or manual code entry required.
Option 3 — Email OTP
Short one-time code sent by email. Familiar verification flow for users comfortable entering a brief code.
Option 1: Social Login
Social Login lets users sign in with accounts they already have. Start with one provider, confirm it works, then add more.
- Open Login Methods. In WordPress admin, go to the VentraConnect settings and open Login Methods.
- Enable one provider. Choose one provider to start with, such as Google, Facebook, GitHub, or Microsoft. Do not enable multiple providers until you have verified one is working.
- Add provider credentials. Open that provider’s settings panel and enter the required credentials, such as Client ID and Client Secret. VentraConnect will display the callback or redirect URI that must be registered in the provider’s app console.
- Verify the provider settings. Use the built-in verification or diagnostics tools to confirm the provider is configured correctly. Fix any errors before moving on.
- Choose where buttons appear. Go to Settings and enable Social Login on the WordPress login form, registration form, or a shortcode-based custom page.
- Test the full login flow. Open a private or incognito browser window and test with a real account for that provider. Confirm the button appears where expected, login completes without errors, and the redirect lands on the correct page.
Adding more providers: Once one provider is working, add others using the same credential and verification steps. Each additional provider is independent.
Option 2: Magic Link
Magic Link lets users sign in by entering their email address and clicking a secure link sent to their inbox. No password or code entry required.
Email delivery must work first. Before setting up Magic Link, confirm your WordPress site sends transactional emails reliably. Use the test email feature in Step 6 to verify delivery before expecting real users to receive Magic Links.
- Open Login Methods. Go to the VentraConnect settings and open Login Methods.
- Enable Magic Link. Turn on Magic Link.
- Configure the basic settings. Review and set key options:
- Link expiry time
- Single-use link behavior
- Same-IP restriction (optional, for added protection)
- Resend throttle
- Registration mode — Login & Register or Login Only. Choose Login Only if you do not want new accounts created through this method.
- Configure redirect behavior. Choose what happens after a successful login: same page, referrer, homepage, or a custom URL. Keep it simple at first.
- Configure the email content. Set the sender name, subject line, and body text. Start with the defaults and refine later.
- Send a test email. Use the built-in test email feature to confirm Magic Link emails are sent and received. If the test email does not arrive, fix email delivery before launching.
- Choose where Magic Link appears. Enable it on the WordPress login form, registration form, or a shortcode-based custom page.
- Test the full flow. Open a private or incognito window. Request a Magic Link with a real email address, receive the email, click the link, and confirm login completes correctly. Verify the email arrives quickly, the link works, and the redirect is correct.
Option 3: Email OTP
Email OTP lets users sign in with a short one-time code sent to their inbox instead of a password.
Email delivery must work first. Confirm your WordPress site sends transactional emails reliably before launching Email OTP. Use the test email feature in Step 6 to verify delivery.
- Open Login Methods. Go to the VentraConnect settings and open Login Methods.
- Enable Email OTP. Turn on Email OTP.
- Configure the basic settings. Review and set key options:
- Code length
- Code expiry time
- Resend throttle
- Maximum attempts
- Registration mode — Login & Register or Login Only. For most sites, shorter expiry and sensible attempt limits are a good starting point.
- Configure redirect behavior. Choose what happens after a successful OTP login: same page, referrer, homepage, or a custom URL.
- Configure the email content. Set the sender name, subject line, and body text. Start with the defaults and improve later.
- Send a test email. Use the built-in test email option to confirm OTP emails are delivered. Do not launch Email OTP if email delivery is unreliable.
- Choose where Email OTP appears. Enable it on the WordPress login form, registration form, or a shortcode-based custom page.
- Test the full flow. Open a private or incognito window and run through the complete process. Confirm the email arrives, the code is accepted, expiry works correctly, failed attempts are handled properly, and login redirects correctly after success.
Where You Can Use These Login Methods
All three methods work on standard WordPress pages with the free plugin. Pro extends placement into more advanced contexts.
Free plugin: WordPress login form · WordPress registration form · shortcode-based custom pages
Pro adds: WooCommerce login, registration, checkout, and My Account · membership and community plugins · LMS and course platforms · comments login · advanced notifications and missing-email handling · analytics and debug visibility · Passwordless Mode rollout controls
First Test Checklist
Before calling your setup done, confirm each of these basics in a private or incognito browser window:
Before you launch
- The login method is enabled in settings
- It is visible where you expect it to be
- Provider credentials are valid (Social Login)
- Emails are being delivered reliably (Magic Link or Email OTP)
- The method works in a private or incognito browser window
- Login succeeds without errors
- Redirect behavior after login is correct
- Account creation behavior matches your site’s needs
Do not skip real testing. A method that looks enabled in admin but fails in a real browser is not set up. Always test while logged out, in a private or incognito window.
Recommended First Setup Strategy
If you are not sure where to begin, use one of these starting points.
Easiest first win
Start with one Social Login provider. Fastest to test, quickest visible result, and easiest for users to understand.
Passwordless first
Start with Magic Link. Simple for users, feels modern, and requires no manual code entry.
Familiar verification flow
Start with Email OTP. Useful when users are comfortable with short code entry and you want a clear verification step.
Whatever you choose, do not launch all methods at once unless you have tested each one properly.
Common first-time mistakes to avoid
- Enabling too many providers before testing one
- Forgetting to register the callback or redirect URI in the provider’s app console
- Skipping the built-in provider verification step
- Assuming WordPress email delivery is reliable without testing it first
- Enabling Magic Link or OTP before verifying real email delivery
- Testing while already logged in to WordPress
- Not using a private or incognito window when testing
- Not checking redirect behavior after login
- Confusing Passwordless Mode (Pro) with basic Magic Link or Email OTP setup
