Google Login Configuration / Google OAuth 2.0 Setup Guide

Google Login Configuration Guide (Vietnamese)

This document provides detailed instructions on how to create and configure a Google OAuth project to support the Google login feature on your website, using the new Google Cloud Console navigation interface.

Step 1: Create a New Project

1. Visit the homepage Google Cloud Console.
2. Click on the project dropdown at the top left corner (next to the Google Cloud logo) and select New Project (New Project).
3. Enter the project name (e.g., ZTruyen Login) and click Create (Create).
4. Wait a few seconds for the project to be created, then select the newly created project from the dropdown menu in the top corner.

Step 2: Configure Branding (OAuth Consent Screen)

Configuration path: Google Cloud Auth Branding

This is where you set up the app information displayed to users when they click login.

1. Access the link above and select your project (if prompted).
2. If the system asks to select User Type, please select External (Other) and click Create.
3. Fill in the required information:
   • App name: Enter a display name (for example: ZTruyen).
   • User support email: Select your administrator email.
   • Developer contact information: Enter your email to receive operational notifications from Google.
4. IMPORTANT NOTE: Strictly DO NOT upload an App logo at this step if you do not want to submit business identity verification documents for Google's approval. Leaving the logo blank will help avoid the “Unverified app” warning screen when users log in.
5. Fill in the information App Domain: Add your website domain name (e.g., https://giaodienwp.net/) to the fields: Application home page, Application privacy policy link, and the section Authorized domains.
6. Click Save and Continue (Save and Continue).
7. In the section Scopes (Scope):
   • Click Add or Remove Scopes.
   • Select basic (non-sensitive) permissions including: .../auth/userinfo.email, .../auth/userinfo.profile, and openid.
   • Click Update -> select Save and Continue.

Step 3: Configure Audience and Activate Production

Configuration path: Google Cloud Auth Audience

By default, the application will be in Testing mode with restricted logins. You need to promote it to In Production.

1. Access the link above.
2. Under Publishing status, click the button PUBLISH APP (Publish App).
3. Click Confirm (Confirm).
4. The project status will change to In Production (In Production). Now, any Gmail account can log in without the 100-user limit.

Step 4: Create Credentials (Client Authentication Info)

Configuration path: Google Cloud Auth Clients

This is the step to create the Client ID and Client Secret to enter into your WordPress plugin.

1. Access the link above.
2. Click the button Create Client (Create credentials) -> select OAuth client ID.
3. Under Application type (Application type), select Web application (Web application).
4. Enter an identifying name (for example: ZTruyen Web Client).
5. Authorized JavaScript origins: Enter your website home page URL (for example: https://quangtuyen.vn).
6. Authorized redirect URIs (Very important): Enter the Callback URL to receive login data provided by the WordPress Plugin. For example: https://quangtuyen.vn/wp-login.php?loginSocial=google
7. Click Create (Create).
8. Copy Client ID and Client Secret just created to configure the Plugin on your website.

Google OAuth 2.0 Setup Guide (English)

This document provides step-by-step instructions to create and configure a Google OAuth project for Google Login on your website, using the new Google Cloud Console layout.

Step 1: Create a New Project

1. Go to the Google Cloud Console.
2. Click on the project dropdown at the top-left (next to the Google Cloud logo) and select New Project.
3. Enter your project name (e.g., ZTruyen Login) and click Create.
4. Wait a few seconds for creation, then select the new project from the top dropdown menu.

Step 2: Configure Branding (OAuth Consent Screen)

Configuration URL: Google Cloud Auth Branding

This configures what users see when they click the “Log in with Google” button on your site.

1. Go to the URL above and select your project if prompted.
2. If prompted for User Type, select External and click Create.
3. Fill in the required fields:
   • App name: Enter the display name (e.g., ZTruyen).
   • User support email: Select your Gmail/Workspace email.
   • Developer contact information: Enter your email address to receive Google updates.
4. IMPORTANT NOTE: Do NOT upload an App logo at this stage unless you are prepared to submit company registration documents to Google. Leaving the logo empty helps bypass the “Unverified App” warning screen during user logins.
5. Fill in the App Domain details: Enter your website URL (e.g., https://giaodienwp.net/) in the Application home page, Application privacy policy link, and the Authorized domains list.
6. Click Save and Continue.
7. In the Scopes section:
   • Click Add or Remove Scopes.
   • Check basic non-sensitive scopes: .../auth/userinfo.email, .../auth/userinfo.profile, and openid.
   • Click Update, then Save and Continue.

Step 3: Configure Audience & Publish to Production

Configuration URL: Google Cloud Auth Audience

By default, your app is in Testing status. You must publish it to allow public logins.

1. Go to the URL above.
2. In the Publishing status section, click PUBLISH APP.
3. Click Confirm.
4. The status will update to In Production. Now, any Gmail user can sign in without the 100-user limit restriction.

Step 4: Create Client Credentials (Client IDs)

Configuration URL: Google Cloud Auth Clients

This generates the Client ID and Client Secret needed for your WordPress Google Login plugin.

1. Go to the URL above.
2. Click Create Client -> select OAuth client ID.
3. Under Application type, select Web application.
4. Enter a name for identification (e.g., ZTruyen Web Client).
5. Authorized JavaScript origins: Enter your website homepage URL (e.g., https://giaodienwp.net/).
6. Authorized redirect URIs: Enter the callback URI provided by your WordPress Google Login plugin (e.g., https://giaodienwp.net/wp-login.php?loginSocial=google).
7. Click Create.
8. Copy the generated Client ID and Client Secret and paste them into your WordPress website plugin settings.