.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../Includes.txt


.. _AccessRestrictedPageErrorHandler:

Access restricted page error
============================


.. only:: html

    The handler for access restricted page errors (403 error) will redirect to the configured login page with the original requested
    url in the return_url parameter. This causes a redirect to this page after successful login. If the requested page is not
    accessible for the logged in user, because e.g. the user group does not match, the user gets the content of a configured
    403 error page.

    Site-Configuration
    ^^^^^^^^^^^^^^^^^^

.. code-block:: yaml

    errorHandling:
      -
        errorCode: 403
        errorHandler: PHP
        errorPhpClassFQCN: T3G\HigherEducationPackage\Handler\Error\AccessRestriction\AccessRestrictedPageErrorHandler
        loginUrl: 't3://page?uid=66'
        fallBackErrorContentSource: 't3://page?uid=135'

**Handler specific configuration values:**

.. confval:: loginUrl

    :type: string

    Contains the link for the page with the login form in typolink format.

.. confval:: fallBackErrorContentSource

    :type: string

    Contains the link for the page with the 403 error page in typolink format.

.. attention::
    Since TYPO3 11.4 you have to enable the core feature flag "subrequestPageErrors" for correct working error handling.
    For more information look at https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/11.4/Feature-94402-GenerateErrorPagesViaTYPO3-internalSubRequest.html

.. important::
    At the moment it is only possible to configure a TYPO3 backend page for the real 403 error page! It is not possible to
    use a Fluid template.