.. include:: ../Includes.txt

.. _user_guide:

==========
User Guide
==========

Register with an OAuth2 Provider
================================

.. rst-class:: bignums-xxl

1. Go to :guilabel:`User Settings`

   To register with an OAuth2 provider, go to your user settings and click :guilabel:`Setup OAuth2 Providers`.

   .. figure:: ../Images/userSettings_setup.png
      :class: with-shadow
      :alt: TYPO3 Oauth2 Configured Providers
      :width: 600px

      Setup provider configuration

2. Activate Provider

   On the next page, click on activate for the provider you want to configure.

   .. figure:: ../Images/configuredProviders.png
      :class: with-shadow
      :alt: TYPO3 Oauth2 Configured Providers
      :width: 600px

      Manage provider configuration

3. Login and grant access

   In the popup that opens, enter your provider user credentials and confirm
   that you are granting access to your profile data to TYPO3.

   .. note::

      If the popup does not open, make sure you are not using a popup blocker.

Login with an OAuth2 Provider
=============================

.. rst-class:: bignums-xxl

1. Switch to OAuth2 Provider

   On the TYPO3 Login Screen click the link "OAuth2 Login (Social Login)"

   .. figure:: ../Images/login_step1.png
      :class: with-shadow
      :alt: TYPO3 Login
      :width: 600px

      Choose OAuth2 Login

2. Choose Provider

   Choose the provider you want to use for logging in. Remember: you can only
   use a provider that you registered for your user in the previous step.

   .. figure:: ../Images/loginScreen.png
      :class: with-shadow
      :alt: TYPO3 Login
      :width: 600px

      Choose OAuth2 Provider