[FEATURE] Introduce Site Sets

As a site set can only be used in TYPO3 v13
we can use the new constant syntax
{$plugin.tx_ttaddress.view.templateRootPath ?? $tt_address.templateRootPath} here.
The TypoScript will not be included by v12 installations.

resolves #570

.editorconfig

@@ -6,7 +6,7 @@ end_of_line = lf
 insert_final_newline = true
 trim_trailing_whitespace = true
 indent_style = space
-indent_size = 3
+indent_size = 4
 max_line_length = 80
 
 # MD-Files

.gitattributes

@@ -9,3 +9,4 @@
 /.styleci.yml export-ignore
 /.travis.yml export-ignore
 /.php_cs export-ignore
+/Makefile export-ignore

Configuration/Sets/Address/config.yaml

@@ -0,0 +1,2 @@
+name: friendsoftypo3/tt-address
+label: Addresses (Extbase/Fluid)

Configuration/Sets/Address/settings.definitions.yaml

@@ -0,0 +1,16 @@
+settings:
+  tt_address.templateRootPath:
+    label: 'Path to template root (FE)'
+    description: ''
+    type: string
+    default: 'EXT:tt_address/Resources/Private/Templates/'
+  tt_address.partialRootPath:
+    label: 'Path to template partials (FE)'
+    description: ''
+    type: string
+    default: 'EXT:tt_address/Resources/Private/Partials/'
+  tt_address.layoutRootPath:
+    label: 'Path to template layouts (FE)'
+    description: ''
+    type: string
+    default: 'EXT:tt_address/Resources/Private/Layouts/'

Configuration/Sets/Address/setup.typoscript

@@ -0,0 +1,14 @@
+@import 'EXT:tt_addressConfiguration/TypoScript/setup.typoscript'
+plugin.tx_ttaddress {
+    view {
+        templateRootPaths {
+            1 = {$plugin.tx_ttaddress.view.templateRootPath ?? $tt_address.templateRootPath}
+        }
+        partialRootPaths {
+            1 = {$plugin.tx_ttaddress.view.partialRootPath ?? $tt_address.partialRootPath}
+        }
+        layoutRootPaths {
+            1 = {$plugin.tx_ttaddress.view.layoutRootPath ?? $tt_address.layoutRootPath}
+        }
+    }
+}

Documentation/Configuration/Index.rst

@@ -11,10 +11,11 @@ where you do all the configuration for this extension. That extension template c
 in the root template. In the extension template add the static TS configuration, otherwise it wont
 work!
 
-.. toctree::
+..  toctree::
     :maxdepth: 2
     :titlesonly:
 
+    Sets/Index
     ExtensionSettings/Index
     TypoScript/Index
     TsConfig/Index

Documentation/Configuration/Sets/Index.rst

@@ -0,0 +1,50 @@
+:navigation-title: Site sets
+..  include:: /Includes.rst.txt
+
+..  _configuration-extension-sets:
+
+====================================
+Site sets provided by EXT:tt_address
+====================================
+
+..  versionchanged:: tt_address 9.1.0 /  TYPO3 v13.3
+    Site sets were added.
+
+The extension :composer:`friendsoftypo3/tt-address` offers a site set
+called "Addresses (Extbase/Fluid)" and has the key `friendsoftypo3/tt-address`.
+
+..  _configuration-extension-sets-usage:
+
+Using the site set "Addresses (Extbase/Fluid)"
+==============================================
+
+You can include this :ref:`Site set <t3coreapi:site-sets>` in your site configuration:
+
+*   Got to :guilabel:`Site Management > Sites`.
+*   Edit your site configuration.
+*   In :guilabel:`General > Sets for this Site` add the site set called
+    "Addresses (Extbase/Fluid)".
+
+This changes the YAML file representing your site configuration as follows:
+
+..  literalinclude:: _siteconfig.diff
+    :caption: config/sites/my_site/config.yaml (diff)
+
+If you are using a :ref:`custom site package extension <t3sitepackage:start>`
+providing a custom Set you can include `friendsoftypo3/tt-address` into your
+site packages set:
+
+..  literalinclude:: _setconfig.yaml
+    :caption: EXT:my_sitepackage/Configuration/Sets/MySitepackage/config.yaml
+
+..  _configuration-extension-sets-settings:
+
+Settings for site set "Addresses (Extbase/Fluid)"
+=================================================
+
+The following settings are available:
+
+..  typo3:site-set-settings:: PROJECT:/Configuration/Sets/Address/settings.definitions.yaml
+    :name: address-settings
+    :type:
+    :Label: Settings of the site set of EXT:tt_address

Documentation/Configuration/Sets/_setconfig.yaml

@@ -0,0 +1,5 @@
+name: myvendor/my-sitepackage
+label: My Sitepackage
+dependencies:
+  - my-vendor/my-other-set
+  - friendsoftypo3/tt-address

Documentation/Configuration/Sets/_siteconfig.diff

@@ -0,0 +1,6 @@
+ base: 'https://example.org/'
+ dependencies:
+   - typo3/fluid-styled-content-css
++  - friendsoftypo3/tt-address
+ languages:
+   -

Documentation/Tutorials/Templates/Index.rst

@@ -5,6 +5,11 @@
 
 Working with the templates
 ==========================
+
+..  versionchanged:: tt_address 9.1.0 /  TYPO3 v13.3
+    You can use the :ref:`site set <configuration-extension-sets>` to configure
+    the template paths.
+
 The following tutorials describe how to work best with the provided templates
 
 Modify the templates

Documentation/guides.xml

@@ -9,7 +9,7 @@
                project-issues="https://github.com/FriendsOfTYPO3/tt_address/issues"
                edit-on-github-branch="master"
                edit-on-github="https://github.com/FriendsOfTYPO3/tt_address"
-               typo3-core-preferred="stable"
+               typo3-core-preferred="main"
                interlink-shortcode="friendsoftypo3/tt-address"
     />
     <project title="Address List"

Makefile

@@ -0,0 +1,10 @@
+.PHONY: help
+help: ## Displays this list of targets with descriptions
+	@echo "The following commands are available:\n"
+	@grep -E '^[a-zA-Z0-9_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[32m%-30s\033[0m %s\n", $$1, $$2}'
+
+.PHONY: docs
+docs: ## Generate projects docs (from "Documentation" directory)
+	mkdir -p Documentation-GENERATED-temp
+
+	docker run --rm --pull always -v "$(shell pwd)":/project -t ghcr.io/typo3-documentation/render-guides:latest --config=Documentation