.. include :: substitutions.txt

.. _installation:

Installation procedure
======================

|GC| distribution package is a multi-extension package: it contains the main component (file name starts with **com_geocontent**), two optional but recommenden plugins (**plg_geocontent_editors-xtd** and **plg_geocontent_content**) and a geocoding (address to latitude/longitude) module: **mod_geocontent_geocoding**.


The package must be installed directly from the |J| control panel.


.. seealso::

    :ref:`requirements`

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

All operations described in this section must be performed through |J| control panel, logged in with `administration` privileges.

.. note::

    xxx in the list below represents the version number.

#. install the component (**com_geocontent_xxx.zip**) using the standard |J| installation system: :menuselection:`Extensions-->Install/Uninstall-->Upload Package File-->Upload File & Install`
#. open :menuselection:`Components-->GeoContent`, click on ''Parameters'' and fill in at least
    * Map lat center: latitude of the map center, the values are in DD units (decimal degreees)
    * Map lon center: longitude of the map center, the values are in DD units (decimal degreees)
#. create and configure at least one |GCL| (see: :ref:`gcl_admin`)
#. add at least one |GCI| to the layer (see: :ref:`gci_admin`)
#. add a |J| menu item of type |GC| as described in :ref:`overview_maps`

.. tip::

    You can easily obtain the latitude and longitude, using Google Maps Labs utilities, there are at least two of those that show lat/lon coordinates at the mouse position.
    You can also use the |GCI| edit form, the map will show latitude and longitude of the mouse position.

    Another possibility is to use the |GCI| editing window to determine latitude and longitude: after having added at least one |GCL|, you can open the |GCI| editing form an move the mouse on the small map, you will see latitude and longitude coordinates printed on the map top right corner.

.. warning:

    |GC| must be installed on a server which is reachable from the internet otherwise |GM| will not work. In other words, installing on *localhost* will **not** work for |GM|.|OLM| and |OLWM| will also work on localhost.