---
title: "Tutorial"
version: "4.3"
source: "Tutorial/Index.rst"
rendered: "2026-10-01T21:53:50+00:00"
---

# Tutorial {#tutorial}

## Install Extensions via Composer {#install-extensions-via-composer}

The following steps are tested with TYPO3 11.5 LTS.

1.  Install ods_osm

    `composer require bobosch/ods-osm:^4.2`
1.  Install tt_address (optional)

    `composer req friendsoftypo3/tt-address`

## Configure Extensions {#configure-extensions}

1.  Include static template "OpenStreetMap" into your root-template
1.  (optional) Check settings with the TypoScript constant editor. See [TypoScript Configuration](../Administrators/Index.html#typoscript-configuration).
1.  (optional) Check the extension configuration. See [Extension Configuration](../Administrators/Index.html#extension-configuration).

## Create Record {#create-record}

1.  Open or create an `fe_users` or `tt_address` record.
1.  Enter zipcode or city and save the record (without closing it).

![Screenshot of form to create new address record with input fields for city, postalcode, longitute and latitude](../Images/CreateNewAddressRecord.png)

1.  Scroll to the “Longitude” section and use the marker icon to open the map wizard.

![Screenshot of same tt_address form with coordinate wizard (map view) as modal overlay](../Images/EditAddressCoordinateWizard.png)

1.  Click on the correct position or move the marker and select "Import marker-coordinates".
1.  Save the record again.

## Place OSM Plugin {#place-osm-plugin}

1.  Insert a content element plugin "OpenStreetMap" on your page.
1.  Add your address record in "Records to show”.

![Screenshot of the OSM plugin settings with selected tt_address record.](../Images/RecordsToShow.png)