.. include :: substitutions.txt


.. _plugins:

Plugins
==================

|GC| is distributed with two plugins:

#. **geocontent_content** plugin
#. **geocontent_editors-xtd** plugin

both plugins are not strictly necessary for the basic |GC| functionalities (:ref:`overview_maps`), but they offer additional features like:

* :ref:`automatic_maps` (**geocontent_content**)
* :ref:`tag_maps` (**geocontent_content**)
* :ref:`front_end` editor button (**geocontent_editors-xtd**)


.. _gc_plugin_manager:

.. figure:: images/gc_plugin_manager.*

    The |J| plugin manager view with a filter activated on |GC| plugins.


.. _content_plugin:

Content plugin
--------------

This plugin is dedicated to :ref:`automatic_maps` and :ref:`tag_maps` generarion.

Automatic maps can be selectively enabled through a plugin configuration parameter.

.. figure:: images/gc_plugin_content.*

    The configuration parameters of the content plugin.

Content plugin configuration
............................

Content plugin can be configured with the following options:

.. tabularcolumns:: |p{3cm}|l|p{8cm}|

=================================== ==================== ==================================================
Label                               Name                 Notes
=================================== ==================== ==================================================
Automatic map                       automatic_map        Define if the plugin will automatically add a map in all articles pages when the article has been georeferenced. If you choose no, the map will be added only when a page contains `{geocontent}` text.
Automatic zoom                      automatic_zoom       Define if the plugin will automatically zoom the map to include the article's items
Automatic center                    automatic_center     Define if the plugin will automatically center the map to the article's items
Enable in the front-page            frontpage_enabled    Define if the plugin will show maps in the front-page too
Zoom level for single points        gmap_minzoom         If automatic_zoom is on and the map contains a single point, this zoom level will be used
Map position for automatic maps     display_position     Position of the map in the article page in case Automatic map is Yes
=================================== ==================== ==================================================


.. _editor_plugin:

Editor plugin
--------------

This plugin adds a |GC| button to the standard |J| article editor window.


.. figure:: images/gc_plugin_editor.*

    The |GC| button at the bottom of the editor window.