---
title: "Feature: The partner map is configurable per site"
manual: "Academic Partners"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-partners:feature-1790618147@main"
source: "Changelog/3.0/Feature-ConfigurablePartnerMap.rst"
rendered: "2026-10-26T19:20:19+00:00"
---

# Feature: The partner map is configurable per site {#feature-1790618147}

## Description {#description}

Everything about the map of the **Partner Map** content element was
fixed in its JavaScript: the centre over Germany, the zoom, how far it zooms in,
the padding around the partners, the tile server and the attribution. A map
with a single partner zoomed in to street level, and a site outside Germany or
with a tile server of its own had to copy and rebuild the script.

-   Seven site settings of the set `fgtclb/academic-partners-map`, and
    constants of the same names for the static template:
    `plugin.tx_academicpartners.map.centerLatitude`,
    `centerLongitude`, `zoom`, `maxZoom`,
    `padding`, `tileUrl` and `attribution`.
    Their defaults are the values the map used so far.
-   A tab **Layout** on the content element with the field
    **Map width**. **Full width** adds the class
    `layout-fullWidth` to the element, for the theme to style.
    The extension ships no style for it.
-   The map moved from the plugin template into the partial
    `Partner/Map.html`, which takes a list of partners or a single
    partner, and the map settings. The data processor `partner-data` of the
    partner page adds the map settings as `{mapSettings}`, so a page
    template can show the location of the partner of the page:

    ```html
    <f:render partial="Partner/Map" arguments="{partner: partner, map: mapSettings, assets: mapAssets}" />
    ```

    The shipped page template does not render a map. `{mapAssets}` is the
    switch of the map script, see [Feature: The script of the partner map can be switched off](https://docs.typo3.org/permalink/fgtclb/academic-partners:feature-1791566502@main).

See [The partner map](https://docs.typo3.org/permalink/fgtclb/academic-partners:configuration-map@main).

## Impact {#impact}

-   A site that configures nothing sees the map it saw before.
-   The settings reach the map as `data-academic-partners-*` attributes of the
    element `<div id="map">`, listed in [The partner map](https://docs.typo3.org/permalink/fgtclb/academic-partners:configuration-map@main). A
    project that overrides `Templates/Partner/Map.html` renders that
    element without them, so its map keeps the values it had until the project
    renders the partial or adds the attributes. A project that ships its own
    `Partner/Map.html` partial overrides the shipped one, and it is
    rendered with the arguments `partners` and `map`.
-   The FlexForm of the map, `Configuration/FlexForms/MapSettings.xml`,
    has two sheets now. The fields of the first one kept their sheet `sDEF` and
    their names, so stored values and page TSconfig that addresses them keep
    working.
-   A project that copied the map JavaScript only to change the centre, or added
    a field of its own for a full width map, can drop it with this update.