Installation

You can install the File Canonical extension for TYPO3 CMS with or without Composer. It’s recommended to use composer!

With Composer

Just perform the following command on CLI:

$ composer req t3/file-canonical

When composer is done, you need to enable the extension in the extension manager.

Without Composer

You can also fetch file_canonical from the TER and install it the old-fashioned way.

After installation (!)

The File Canonical extension can only work, when HTTP requests to files are routed through TYPO3. To achieve this you can simply adjust the root .htaccess file, right after the TYPO3_CONTEXT has been set (before other rewrite conditions take effect):

# Rule for EXT:file_canonical
RewriteCond %{REQUEST_URI} ^/fileadmin
RewriteCond %{REQUEST_FILENAME} \.(pdf|docx|xlsx|pptx)$
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]

Now, all requests which point to /fileadmin and request a PDF or common office file will be processed by the FileCanonicalMiddleware provided by this extension.

You can adjust this configuration to your needs.