..  include:: /Includes.rst.txt


..  _installation:

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

Target group: **Administrators**

..  contents::
    :backlinks: top
    :class: compact-list
    :depth: 1
    :local:

..  _installation_composer:

Composer mode
=============

If your TYPO3 installation uses Composer, install the latest release of this
extension through:

..  code-block:: bash

    composer require jweiland/maps2

If you are not using the latest version, you need to
add a version constraint, for example:

..  code-block:: bash

    composer require jweiland/maps2:"^9.3"

Installing the extension prior to TYPO3 11.4
--------------------------------------------

Before TYPO3 11.4 it was still necessary to manually activate extensions
installed via Composer using the Extension Manager. Activate it as follows:

*   Navigate to :guilabel:`Admin Tools > Extensions > Installed Extensions`
*   Search for `maps2`
*   Activate the extension by clicking on the :guilabel:`Activate` button in the
    :guilabel:`A/D` column


..  _installation_legacy:

Legacy mode
===========

If you are working with a TYPO3 installation that does not use Composer, install
the extension in the Extension Manager:

*   Navigate to :guilabel:`Admin Tools > Extensions > Get Extensions`.
*   Click on :guilabel:`Update now`
*   Search for `maps2`
*   Click :guilabel:`Import and install` on the side of the extension entry

and activate it:

*   Navigate to :guilabel:`Admin Tools > Extensions > Installed Extensions`
*   Search for `maps2`
*   Activate the extension by clicking on the :guilabel:`Activate` button in the
   :guilabel:`A/D` column

..  seealso::

    On pages ":doc:`Managing Extensions <t3start:Extensions/Management>`" and
    ":doc:`Managing Extensions - Legacy Guide <t3start:Extensions/LegacyManagement>`"
    both TYPO3 installation modes are explained in detail.

**Next step**

Please edit ExtensionManager configuration of maps2 to decide, if you will use Google Maps or OpenStreetMap
as your default rendering service: :ref:`Configure extension <extensionManager>`.