Initial commit - Typo3 11.5.41

typo3conf/ext/tt_address/Documentation/UsersManual/CreatingAPluginContent/Index.rst

@@ -0,0 +1,40 @@
+.. include:: /Includes.rst.txt
+
+
+.. _users-manual-creating-a-plugin-content:
+
+Creating a Plugin Content Element
+---------------------------------
+
+Go to the page view and navigate to the page where you want to insert one or more addresses. Create
+a new content element and in the “new content element wizard” scroll down to the plugins section
+and select "Address Selection"
+
+|image-2|
+
+Now on the first tab [1] you can add address records to the plugin, the second tab [2] is
+for selecting a template for how the address should look like, this needs to be configured by your
+administrator. If there're no templates on the second tab, just save the content element once and
+after saving it they should appear.
+
+.. |image-2| image:: ../../Images/image-2.png
+
+|image-7|
+
+In the Single addresses field [3] you can select addresses by using the known element
+browser. Even if the addresses selected here would be selected via groups, too they do not appear
+twice in the front end.
+
+.. |image-7| image:: ../../Images/image-7.png
+
+In the groups field [4] you can select groups from the tree view. These groups get combined either
+by AND or by OR [5]. That means you can select addresses which are in all of the given groups (AND)
+or they are required to be in at least one of the given groups (OR).
+
+You set the sorting the addresses by selecting the sort order dropdown [7].
+
+The starting point [8] does not necessarily need to be set. The extension can be configured to work with
+a default setting which needs to be adjusted by your administrator. If you set a startingpoint here,
+it will override that default setting that might be set. The recursive field [9] sets how deep in
+the page tree beginning from the startingpoint the system should look for addresses with the given
+groups.

typo3conf/ext/tt_address/Documentation/UsersManual/CreatingRecords/Index.rst

@@ -0,0 +1,18 @@
+.. include:: /Includes.rst.txt
+
+
+.. _users-manual-creating-records:
+
+Creating address records
+------------------------
+
+#. Switch to the list view
+
+   #. Create a new page with type **Sysfolder** or
+
+   #. Select an existing page
+
+#. Click the "+" icon and select *Address*.
+
+#. Fill out all information you need and save.
+

typo3conf/ext/tt_address/Documentation/UsersManual/Index.rst

@@ -0,0 +1,15 @@
+.. include:: /Includes.rst.txt
+
+
+.. _users-manual:
+
+Users manual
+============
+
+.. toctree::
+    :maxdepth: 2
+    :titlesonly:
+
+    CreatingRecords/Index
+    CreatingAPluginContent/Index
+    Maps/Index

typo3conf/ext/tt_address/Documentation/UsersManual/Maps/Index.rst

@@ -0,0 +1,50 @@
+.. include:: /Includes.rst.txt
+
+
+.. _users-manual-maps:
+
+Rendering records with a map
+============================
+
+Since version *4.2.0* the extension is capable of rendering records on a map.
+The following variants are included by default:
+
+- Leaflet
+- Google Maps
+- Static Google Maps
+
+Providing coordinates in records
+--------------------------------
+If a record should be rendered on a map the record must contain coordinates in format of latitude and longitude.
+
+The coordinates can either be provided manually or by using the wizard in the backend.
+
+.. image:: ../../Images/record_coordinate-wizard.png
+
+Mass geocoding
+~~~~~~~~~~~~~~
+By using a provided command it is possible to set coordinates to all records.
+A requirement for this is a **valid Google Maps key**. Read all about it at https://developers.google.com/maps/documentation/geocoding/intro
+
+The command is called by cli with the following line
+
+
+.. code-block:: bash
+
+   ./typo3cms ttaddress:geocode <your google maps key>
+
+Frontend integration
+--------------------
+To output the records, 2 important configurations need to be set in the plugin.
+
+**First**, the setting *Ignore records with no latitude/longitude* must be set.
+Otherwise records with no coordinates would be rendered in the frontend
+
+**Second**, the setting *Select display mode* in the 2nd tab *Display* must be changed to `map`.
+
+Which map type is used is defined with TypoScript: :typoscript:`plugin.tx_ttaddress.settings.map.rendering = googleMaps`.
+Available options are: leaflet (default), googleMaps or staticGoogleMaps.
+
+For each render type, a custom fluid section is available in the partial `Partials/Maps.html`.
+
+