..  include:: /Includes.rst.txt
..  _extensionSettings:

==================
Extension settings
==================

Some general settings for `clubdirectory` can be configured
in :guilabel:`Admin Tools > Settings > Extension Configuration`.

..  _extensionSettings-tab-basic:

Tab: Basic
==========

..  confval:: poiCollectionPid
    :name: ext-conf-poicollectionpid
    :type: int
    :default: 0

    While saving a club in frontend we geocode its addresses and create a
    maps2 POI record for each address automatically. Define the UID of a
    storage folder where these records should be stored.

    All addresses of a club are geocoded first. The POI records are created
    only, if all addresses were found. Otherwise, the user is asked to
    check the address and no POI record is created.

    Add this storage folder to the storage folders of the maps2 plugin on
    the page configured in the site setting
    :confval:`clubdirectory.pidOfMaps2Plugin
    <site-setting-pidofmaps2plugin>`. Otherwise the map of this plugin
    shows no marker.

    How addresses are geocoded and which API keys are required is
    described in the documentation of
    :ref:`maps2 <maps2:extensionsettings>`.

..  confval:: rootCategory
    :name: ext-conf-rootcategory
    :type: int
    :default: 0

    UID of the parent category of the club categories. The frontend shows
    the direct child categories of this category only: in the category
    selection of the club form of the Management plugin and in the category
    filter of the list and search forms.

    ..  versionchanged:: 9.0.0
        This setting does not restrict the categories in the backend
        anymore. Restrict the category tree of the plugin and of the club
        records with page TSconfig, see :ref:`page-tsconfig`.

..  confval:: emailFromAddress
    :name: ext-conf-emailfromaddress
    :type: string
    :default: empty (use `defaultMailFromAddress` of the TYPO3 mail settings)

    Clubs created or changed in frontend are hidden until the administrator
    activates them. The administrator is informed by mail. Add the email
    address of the sender of this mail.

    If this value and `$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress']`
    are empty, saving a club in frontend ends with an exception.

..  confval:: emailFromName
    :name: ext-conf-emailfromname
    :type: string
    :default: empty (use `defaultMailFromName` of the TYPO3 mail settings)

    Name of the sender of the mail to the administrator.

    If this value and `$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromName']`
    are empty, saving a club in frontend ends with an exception.

..  confval:: emailToAddress
    :name: ext-conf-emailtoaddress
    :type: string
    :default: empty
    :required: true

    Email address of the administrator, who receives the mails about
    created and changed clubs. These mails contain the links to check and
    activate the club, see :ref:`moderation`.

    There is no fallback for this value. If it is empty, saving a club in
    frontend ends with an exception.

..  confval:: emailToName
    :name: ext-conf-emailtoname
    :type: string
    :default: empty

    Name of the administrator, who receives the mails about created and
    changed clubs.