.. include:: ../Includes.txt


.. _administrator:

Administration
==============

.. _installation:

Installation
------------

Basic Setup
~~~~~~~~~~~

#.  Install media2click via the extension manager.
#.  Include the extension's static template into your TS template.
#.  If your main PAGE object is not named 'page', adapt the TypoScript Setup accordingly.
#.  Activate the extension's functionality via the Constant Editor: :ref:`constants-enable`

If individual placeholder content or permanent activation is required:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

5.  Set up a page of type sysfolder to hold the host data.
#.  Set storagePid to this sysfolder's uid via the Constant Edtior: :ref:`constants-storagepid`
#.  Insert a content element of type "Insert Plugin" -> "Toggle permanent activation of external content" on your privacy
    statement page.
#.  Set privacyPid to the uid of your privacy statement page via the Constant Edtior: :ref:`constants-privacypid`
#.  Globally allow permanent activation via the Constant Editor: :ref:`constants-enablepermanently`
#.  Using the list module, add a host configuration to your storage page for every target host that needs individual
    placeholder content or permanent activation: :ref:`hostconfiguration`

.. _hostconfiguration:

Individual Host Configuration
-----------------------------

.. figure:: ../Images/HostConfiguration.png
   :alt: Host Configuration Form
   :class: with-shadow

   Example host configuration for YouTube videos

For videos, you have to use "YouTube" and "Vimeo" as the hostname.

.. _hosttemplate:

Individual Host Templates
-------------------------

If individual text and logo is not enough, you can configure individual fluid templates for your hosts' placeholders:
Just add a file named after the host in Fluid Styled Contents' partial root paths. For example for the host www.example.com
this file would be named (...)/Partials/Media2click/Placeholder/www.example.com.html

There is an example template for www.example.com included in this extension.