.. include:: ../Includes.txt


.. _administration:

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


.. _admin_installation:

Installation
============

The distribution can be installed from within the distribution list, by uploading the extension and through composer.
Refer to TYPO3 documentation for further details on handling extensions.

.. note::
   Due to a bug it is recommended to install the extension news prior installing the distribution.

.. note::
   In case the extension tt_address should be used the extension should be installed prior installing the distribution.


.. _admin_update:

Update
======

If a newer version from this distribution is installed its update script should be executed. It can be started through
the update button available in the extension manager.

.. figure:: ../Images/Administration/Update.jpg
   :alt: Distribution update button

   Distribution update button


.. _admin_upgrade:

Upgrade
=======

The following upgrade descriptions are available:

.. toctree::
   :maxdepth: 2

   Upgrade9
   UpgradeBootstrap4


.. _admin_customization:

Customization
=============

The suggested way to customize the distribution for customer projects is to create an extension (e.g. user_customer)
and define the customer theme and functions in it (`see TYPO3 documentation
<https://docs.typo3.org/typo3cms/ExtbaseFluidBook/4-FirstExtension/Index.html>`__).

An example extension for that purpose is delivered and activated with the distribution. You might use it as your
starting point.

.. figure:: ../Images/Administration/Customize.jpg
   :alt: Customize the distribution for customer projects

   Customize the distribution for customer projects

The extension might be deactivated by removing its static template or uninstalling it.

.. note::
   The sample extension "user_customer" is being installed by adding an extension dependency to the ext_emconf.php file.
   By finalizing the installation this dependency is removed (commented) to enable the extension "user_customer" being
   uninstalled with the distribution remaining installed.


.. _admin_extensions:

Extensions
==========

For some extensions additional packages are available:

.. toctree::
   :maxdepth: 1

   Extensions/Form
   Extensions/News
   Extensions/TtAddress


.. _admin_development:

Development
===========

During development or maintenance phase two actions might be of interest:

#. Show under construction page
#. Enable code debugging

To temporarily show an under construction page an url redirection might be created to the page "In Arbeit" and the code
debugging might be enabled by setting the site mode in the "PIZPALUE: AGENCY" category from the constant editor.