Skip to main content

First Configuration

After installing the plugin and creating your Google Cloud credentials, it's time to configure the plugin. This guide walks you through entering your credentials and making your first test.

Step 1: Access Plugin Settings​

  1. In your WordPress admin, go to Settings > OneTap Login
  2. You'll see the plugin settings page with multiple tabs

Plugin Settings API Fields

Step 2: Enter Google Credentials​

2.1: Locate the API Section​

In the General tab, find the API Credentials section at the top.

2.2: Enter Client ID​

  1. Paste your Google Client ID in the Client ID field
  2. The Client ID looks like: 
    123456789012-abcdefghijklmnopqrstuvwxyz123456.apps.googleusercontent.com

2.3: Enter Client Secret (Optional)​

  1. Paste your Client Secret in the Client Secret field
  2. The Client Secret looks like: 
    GOCSPX-abcdefghijklmnopqrstuvwxyz12
Client Secret is Optional

The Client Secret is only required for certain advanced features. Google One Tap works with just the Client ID. However, we recommend entering both for full functionality.

2.4: Save Settings​

Click Save Changes at the bottom of the page.

Step 3: Configure Basic Options​

Before testing, review these essential settings:

Enable One Tap​

In the One Tap Configuration section:

  1. Ensure Enable One Tap is checked
  2. This activates the popup that appears automatically for logged-in Google users

Enable Sign-In Button​

In the Button Configuration section:

  1. Check Enable on My Account page
  2. This displays the "Sign in with Google" button on WooCommerce login forms
Start Simple

For your first test, enable both One Tap and the button. You can fine-tune later.

Step 4: Test Connection​

The plugin includes a built-in diagnostic tool to verify your configuration.

4.1: Locate Test Button​

In the API Credentials section, find the Test Connection button.

4.2: Run the Test​

  1. Click Test Connection
  2. Wait a few seconds for the results
  3. A panel will expand showing 5 diagnostic checks

Connection Test Success

4.3: Understand the Results​

CheckWhat It TestsExpected Result
Client ID FormatID matches Google format✅ Valid
Client Secret FormatSecret matches Google format✅ Valid (or skipped)
HTTPSSite uses SSL certificate✅ Enabled
REST APIWordPress REST API accessible✅ Available
Google ConnectionCan reach Google servers✅ Connected

4.4: All Green?​

If all 5 checks show green checkmarks, your configuration is correct. Proceed to Verification for live testing.

4.5: Red or Yellow Results?​

See the Troubleshooting section below.

Step 5: Review Default Settings​

These settings are pre-configured with sensible defaults, but review them:

User Registration​

SettingDefaultDescription
Auto-register usersEnabledCreates new accounts for first-time Google users
Default roleCustomerRole assigned to new Google users (Subscriber if no WooCommerce)

Button Appearance​

SettingDefaultDescription
Button text"Continue with Google"Text displayed on the button
ThemeFilled BlueButton color scheme
ShapePillRounded or rectangular
SettingDefaultDescription
Respect cookie consentAuto-detectWaits for user consent if a consent plugin is detected

Step 6: Save and Prepare to Test​

  1. Review all settings
  2. Click Save Changes
  3. Proceed to Verification for live testing

Troubleshooting Connection Issues​

Client ID Format Invalid​

Symptoms: Red X on Client ID check

Solutions:

  1. Verify you copied the entire Client ID
  2. Check for extra spaces before or after
  3. Ensure it ends with .apps.googleusercontent.com
  4. Go back to Google Cloud Console and copy again

Client Secret Format Invalid​

Symptoms: Red X on Client Secret check

Solutions:

  1. Client Secret starts with GOCSPX-
  2. Verify complete copy (no truncation)
  3. Leave blank if not using features requiring it

HTTPS Not Enabled​

Symptoms: Red X on HTTPS check

Solutions:

  1. Install an SSL certificate (required by Google)
  2. Contact your hosting provider for SSL setup
  3. Use a service like Cloudflare for free SSL
  4. Update WordPress URLs to use https://
No Workaround

Google requires HTTPS for all OAuth implementations. There is no way to use this plugin without SSL.

REST API Unavailable​

Symptoms: Red X on REST API check

Solutions:

  1. Check if a security plugin blocks REST API
  2. Add exception for /wp-json/onetap/ endpoint
  3. Verify permalink settings (Settings > Permalinks)
  4. Try resaving permalinks

Google Connection Failed​

Symptoms: Red X on Google Connection check

Solutions:

  1. Check your server's internet connection
  2. Verify firewall allows outbound HTTPS (port 443)
  3. Check if accounts.google.com is accessible
  4. Contact hosting provider about external API access

Settings Reference​

Here's a complete reference of settings available in the General tab:

API Credentials Section​

FieldRequiredDescription
Client IDYesYour Google OAuth Client ID
Client SecretNoYour Google OAuth Client Secret
Test Connection-Button to run diagnostics

One Tap Configuration​

FieldDefaultDescription
Enable One TapYesShow automatic popup
Auto-selectNoAuto-select account if only one
Cancel on tap outsideYesClose popup when clicking elsewhere

Button Configuration​

FieldDefaultDescription
Enable on My AccountYesShow button on WooCommerce login
Enable on wp-login.phpNoShow button on WordPress login
Button textcontinue_with"Continue with Google" text
Themefilled_blueoutline, filled_blue, filled_black
Shapepillpill or rectangular
FieldDefaultOptions
Respect cookie consentauto_detectdisabled, auto_detect, always_require

Next Steps​

Once your connection test passes:

  1. Verify the installation - Test with a real Google account
  2. Customize button appearance - Match your site design
  3. Configure user settings - Set roles and registration options

Quick Checklist​

Before moving on, verify:

  • Client ID entered correctly
  • Client Secret entered (optional but recommended)
  • Settings saved
  • Test Connection shows all green
  • One Tap enabled
  • Sign-In Button enabled on desired pages