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

.. include:: ../Includes.txt


What does it do?
================

This extension ensures, that in specific folders for each file access it is checked first if a user is allowed to view a file before displaying the file/sending the file to the user's browser. Each file in these secure folders will be inaccessible at first (the folder is indeed secured) and permissions have to be granted to each file via ``File`` -> ``File List`` in your ``typo3`` backend, in order for users to be able to access the files. This applies to all files in the secured folder as well as all processed files (e.g. smaller previews), which originate from files in the secured folder (the access permissions of the processed file's will always be the same as the original file's).

The functionality is included via a ``.htacces`` file using the (apache's) rewrite module, guaranteeing that no internal file can be accessed without the proper permissions and that the file's URL stays nice and human readable. 

The extension uses the typo3 FAL database fields for the feuser permissions, which can be activated by installing the sysext ``filemetadata``. So the extension relies solely on ``typo3 6.2 LTS`` and you do not have to install any 3rd party extension.

There is a hook integrated within the extension, enabling the usage in combination with RealURL (In the ``.htacces`` file a specific parameter is set therefore).