Documentation

Social Login Addon - Workreap Freelance Marketplace

Thank you so much for purchasing our item from Codecanyon.

If you have any questions that are beyond the scope of this help file, please feel free to contact us at Item Support Page.

What is Workreap Social Login Plugin

The WordPress Social Login Addon enables seamless user authentication through Facebook and LinkedIn for Workreap Theme. Enhance your website's user experience by allowing visitors to log in with their existing social media accounts. This plugin simplifies the registration process, boosts engagement, and provides a secure way to manage user access. Ideal for websites aiming to increase user interaction and reduce barriers to entry.

Recommended PHP Server Settings

We recommend below PHP configurations to avoid errors like blank screen, demo content import fails or theme installation error. You can do below configuration changes yourself or contact your hosting provider and ask them to set below configurations.

• PHP Version Should be > 7.4
• PHP Zip Extension Installed
• upload_max_filesize 50M
• post_max_size 128M
• max_execution_time 500
• memory_limit 512M
• max_input_vars 3000

Tip: You can check PHP configuration settings by installing WordPress phpinfo() extension in WordPress. You can also contact your hosting provider if you don’t know much more about it.

How to Install Workreap Social Login

When downloading the zip package file from codecanyon, you'll have all files you need inside. Zip package contains the following files

• workreap-social-login.zip - Contain the plugin
• documentation - It contains documentation for the plugin

To install this plugin you must have a working version of WordPress already installed. For more information regarding installing WordPress, please visit the below-mentioned URL

When you are ready to install a plugin, you must first upload the plugin files and then activate the plugin. For this purpose, unzip the file that you have downloaded from codecanyon and there you will see the (chaton.zip) file then upload it via WordPress installer. The plugin files can be uploaded in two ways

WordPress Upload

• Go to Appearance > Plugins
• Click Add New button and then hit the Upload plugin
• Click on Choose File and find the "workreap-badges.zip" file on your computer and click Install Now button
• The plugin will be uploaded and installed.
• For activating the plugin, Go to Appearance > Plugins and activate the installed plugin

Steps to Enable Social Login

• Go to Social Login Settings menu in the WR Settings.

• Enable the settings that you want to use Facebook/LinkedIn or both.

• Create a social app for the required social platform and update the keys according to the fields.

LinkedIn App

• You can create a LinkedIn App by the following steps.
• Go to LinkedIn Developer Account
• Create a new App

• Fill the form fields

• Please must allow these access

• Copy the LinkedIn redirect Url from the WR Settings->Social Login Settings and paste in the mentioned field.

• Now use these Client ID and Client Secret in the Social Login Settings

• Please complete any additional verification steps for the app if necessary.

Facebook App

• You can create a LinkedIn app by following these steps.
• Visit the Facebook app setup URL at https://developers.facebook.com/apps.
• From My Apps, select Add a New App/Ceate App .
• Enter the app name and your email address in the Display Name and Contact Email text boxes, respectively.
• Click Create App ID.
• On this page, in the Add use case tab, select Authenticate and request data from users with Facebook Login from the use case , and then click the Next button.

• Fill out the App Name and App Contact Email. Then click the Next button.
  • Note: After clicking the Next button, you may be presented with a security check.

• The review screen appears here. You can read the articles for help. Now, click on Create App.


• App customization and requirements

  In the dashboard, click on the Customize adding a Facebook Login button to set up your product.
  • Scroll down to the Permissions section and add public_profile and email permissions by clicking on the Add button.
  
  • After you have added the permissions, go to settings by clicking on the settings button.
  
  • Click the Client OAuth Login toggle switch to turn it to Yes.
  • Click the Web OAuth login toggle switch to turn it to Yes.
  • Click the Login with the JavaScript SDK toggle switch to turn it to Yes.
  • Enter the OAuth URI in the Valid OAuth redirect URIs box.
    • Please copy & paste this valid OAuth redirect URIs from the Theme Social Login Settings options.
  • Enter the Allowed Domains URI in the Allowed Domains for the JavaScript SDK box.
  
  • After you have saved the changes, go to Quickstart and select the Webplatform
  
  • After selecting the Web Platform add your Site URL, then click the Save button.
  
  • Go back to your App's Dashboard

• Prepare and submit for App Review

• Note: Additional steps may be necessary. Ensure that all required verifications and data handling questions, if applicable, are completed before submitting this application to App Review. If you do not have a Facebook business account, please follow the instructions provided here on how to create one: www.facebook.com/business/help/1710077379203657.
• Go back to your App's Dashboard and click on Review and complete testing requirements

• In the Prepare and submit for App Review, click on Review and complete testing requirements, it will redirect you to nex page. Click on Open Graph API Explorer.

• On the right section of the Graph API explorer add the public_profile and email. To add a permission go to permission > User data permissions> email.
• Once added, click on Generate Access Token and Submit button

• Go back to your App's Dashboard

• Business Verification

  • Click on Business Verification, it will redirect you to the verification page. This is where you can add your business account.
  
  • This step is necessary to obtain access to user data, commonly referred to as advanced access in certain applications. Completion of this process is restricted to individuals with full control of a Business Account. For further information on business verification, please refer to this article: https://www.facebook.com/business/help/2058515294227817?id=180505742745347
  
  • Once, you have successfully added a verified business account. Return to the App Dashboard or from the side menu, click on App Review>Data handling questions. It will redirect you to data handling questions where you need to answer questions about data handling.
  • To begin, select Answer questions about data handling, and a window will promptly appear. Within the Usage Check tab, carefully review and confirm the data usage permissions and features you have added. Utilize the checkboxes to express your confirmation and agreement, and subsequently, click on the confirm button to proceed.
  • Now in the Data Handling tab, In order to obtain access to permissions, kindly provide information regarding your data handling practices. This is a mandatory step for App Review and the subsequent launch of your app. Answer the questions and click Submit button.
  

• Publish

  • Go to the Publish tab from the side navigation menu. Then click on the Go to app settings.
  • You must fill in the following information: Privacy Policy URL, Terms of Service URL & User data deletion and you can also include an app icon to make the app appear more professional. Then click the Save changes button.
  • Ensure all required settings are completed and use cases are reviewed before you click on the Publish button, the app can’t be published if the requirements are incomplete.
    • Note: After clicking the 'Publish' button, you may be presented with a security check.
  • After successfully publishing your app, a confirmation message will be displayed indicating that it is now available for the public to use. To proceed to the next step, simply click the Done button.

• App ID & App secret

  • In the side navigation menu, navigate to App Settings> Basic. Here, you'll find both the App ID and App Secret.
  
  • Copy the App ID and App Secret and use in Social Login Settings

Support

If you have any questions that are beyond the scope of this help file, Please feel free contact us at Item Support Page.

We answer all questions within 12-24 hours in weekdays. In some rare cases the waiting time can be to 48 hours. (except holiday seasons which might take longer).

Don’t forget to Rate us

Change Logs

Explore the latest updates, new features, fixes, and enhancements. For a detailed overview, visit the changelog by clicking here.