Social Logins > Github App Setup

This document provides instructions on properly setting up a GitHub application so users can log in/register via Github on your site.

Please note that the Github social login feature requires the WP ULike Pro version.

Step 1: Create a GitHub OAuth Application

1. Go to the GitHub Developer Settings page: https://github.com/settings/developers.
2. Click on the "New OAuth App" button.
3. Fill in the necessary information:
   • Application Name: This can be anything you want, e.g., "WP ULike Social Login."
   • Homepage URL: The URL of your WordPress site.
   • Authorization callback URL: Enter the callback URL provided by WP ULike: (You can find this URL in "Step 2" settings)
     https://yourdomain.com/?ulp-api=auth&provider=GitHub
4. Click "Register Application" to create your GitHub OAuth application.
5. After registering, you'll see the "Client ID" and "Client Secret." Keep these handy, as you'll need them later. If no Client Secret is shown, you need to click the Generate a new client secret button. 

Step 2: Configure WP ULike Social Login

1. In your WordPress admin dashboard, navigate to "ULike ᴾᴿᴼ" > "Configuration" > "Social Logins"
2. Enable the "Social Logins" option.
3. Add a new social network and choose "Github" for network option.
4. Enter the "Client ID" and "Client Secret" from the GitHub OAuth application you created earlier.
5. Choose your styling configurations and set an option for "Auto Display".
6. You can also make a new profile tab and add [wp_ulike_pro_social_login] shortcode to make old users connect their social app.
7. Save your settings.

step 3: Test the GitHub Social Login

1. On your WordPress site, go to your login page. (or profile if you set shortcode in there)
2. Click on the "GitHub" login option.
3. You'll be redirected to GitHub's login page. Log in with your GitHub credentials.
4. After successful authentication, you'll be redirected back to your profile with a sucessful.

Step 4: Verify Functionality

1. After logging in with GitHub, make sure your user profile is updated with the appropriate GitHub information.
2. Test the social login multiple times to ensure consistent functionality.

Congratulations! You've successfully set up GitHub social login for the WP ULike pro plugin.