.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.
.. include:: ../Includes.txt
.. _admin-manual-install:
Installing the extension
------------------------
There are a few steps necessary to install the Metadata and content analysis
extension. If you have installed other extensions in the past, you will run into
little new here.
As usual, install the extension and load it using the Extension Manager. Then
configure it by either clicking on the gear icon or on the title of this
extension.
.. figure:: ../Images/em.png
:alt: Configuring the extension
Click on the title or on the gear icon to configure the extension.
The tabs (see corresponding figures) let you configure the various settings of
this extension.
.. figure:: ../Images/em-basic.png
:alt: Basic settings
Basic settings to enable or disable the use of external tools or extract
metadata on-the-fly when uploading a file (TYPO3 6.2 only since this is the
case automatically since TYPO3 7).
.. figure:: ../Images/em-apache-tika.png
:alt: Apache Tika
Settings for using Apache Tika (optional).
.. figure:: ../Images/em-external-tools.png
:alt: External tools
Path to various external tools (optional).
.. _admin-manual-install-tika:
Apache Tika
^^^^^^^^^^^
Using Apache Tika is highly recommended for best extraction results. You may use
either the standalone application jar or connect to an Apache Tika server. The
latter should probably be quicker to answer since it runs as a daemon.
Apache Tika may be downloaded from https://tika.apache.org/download.html.
**Connection to an Apache Tika Server**
When connecting to a server and not to the standalone Jar application, handy
animations, in Extension Manager, will let you easily double check that provided
parameters are correct:
.. only:: html or json
Successful connection
.. image:: ../Images/animation-ok.gif
:alt: Successful connection
Broken connection
.. image:: ../Images/animation-ko.gif
:alt: Broken connection
.. only:: latex
Successful connection
.. image:: ../Images/connection-success.png
:alt: Successful connection
Broken connection
.. image:: ../Images/connection-broken.png
:alt: Broken connection
.. hint::
If you are able to run Tika as a server, you will be able to extract metadata
nearly instantaneously, whereas the same with the standalone application jar
will typically result in a delay of a few seconds per file.
.. _admin-manual-install-tools:
External Tools
^^^^^^^^^^^^^^
This extension is capable of using external tools to extract metadata:
- `exiftool `__ for files containing EXIF, IPTC / XMP
metadata;
- `pdfinfo `__ for PDF.