TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:39 +02:00
commit e54ab24745
68 changed files with 3683 additions and 0 deletions
@@ -0,0 +1,51 @@
+.. include:: /Includes.rst.txt
+
+
+.. _configuration:
+
+=============
+Configuration
+=============
+
+Target group: **Developers, Integrators**
+
+..  seealso::
+    General SEO recommendations for TypoScript and Site Configuration can be
+    found in `TYPO3 explained, Suggested configuration options for improved
+    SEO in TYPO3 <https://docs.typo3.org/permalink/t3coreapi:seo-configuration>`_.
+
+..  toctree::
+    :caption: Subpages
+    :glob:
+
+    *
+
+.. _configuration-site-sets:
+
+Site sets
+=========
+
+..  versionadded::13.3
+    EXT:seo now offers a site set "SEO Sitemap"  to include the TypoScript to
+    output the XML sitemap.
+
+Include the site set "SEO Sitemap", `typo3/seo-sitemap` via the :ref:`site set in the site
+configuration <t3coreapi:site-sets>` or the custom
+:ref:`site package's site set <t3sitepackage:site_set>`.
+
+Settings for the included set can be adjusted in the :ref:`settings-editor`.
+
+..  figure:: /Images/SiteSet.png
+
+    Add the site set "SEO Sitemap"
+
+This will change your site configuration file as follows:
+
+..  literalinclude:: _site_config.diff
+    :caption: config/sites/my-site/config.yaml (diff)
+
+If your site has a custom :ref:`site package <t3sitepackage:start>`, you
+can also add the "SEO Sitemap" set as dependency in your site's configuration:
+
+..  literalinclude:: _site_package_set.diff
+    :caption: EXT:my_site_package/Configuration/Sets/MySite/config.yaml (diff)
@@ -0,0 +1,28 @@
+:navigation-title: Settings
+
+.. include:: /Includes.rst.txt
+
+.. _configuration-site-set-settings:
+
+=============================
+Site sets settings of EXT:seo
+=============================
+
+The following settings are available via the
+:ref:`site set settings <configuration-site-sets>` and can be adjusted in
+the :ref:`settings-editor`.
+
+..  versionchanged:: 14.0
+    The names of the GET parameters used in the sitemap generated by EXT:seo have
+    been changed from `page` and  `sitemap` to `tx_seo[page]` and `tx_seo[sitemap]`
+    respectively. If you are overriding the templates for the sitemap, provide
+    separate sets for TYPO3 13.4 and 14.x support.
+
+..  versionchanged:: 14.1
+    The site set `typo3/seo-sitemap` now ships a sitemap route enhancer. See
+    also `Automatic routing for the XML sitemap <https://docs.typo3.org/permalink/typo3/cms-seo:xmlsitemap-routing>`_.
+
+..  typo3:site-set-settings:: PROJECT:/Configuration/Sets/Sitemap/settings.definitions.yaml
+    :name: seo-settings
+    :type:
+    :Label: Settings of the site set of EXT:seo
@@ -0,0 +1,23 @@
+..  include:: /Includes.rst.txt
+
+..  _settings-editor:
+
+===============
+Settings editor
+===============
+
+When the :ref:`site set for the SEO sitemap <configuration-site-sets>` is included,
+the settings for sitemaps become available in the editor:
+
+You can find the available site settings in module
+:guilabel:`Sites > Setup > Settings`
+
+You can change individual settings here. If the site settings are writable
+you can hit the :guilabel:`Save` button and the settings will be written
+directly to the site settings.
+
+If the settings are not writable you can click the :guilabel:`YAML export`
+button to export the settings. These can then be added by a developer with
+sufficient rights.
+
+The available settings are also described in detail in :ref:`site-sets`.
@@ -0,0 +1,5 @@
+  base: 'https://example.com/'
+  rootPageId: 1
+  dependencies:
+    - typo3/fluid-styled-content-css
+   - typo3/seo-sitemap
@@ -0,0 +1,9 @@
+name: my-vendor/my-site-package
+ label: My Site Package Set
+ settings:
+   website:
+     background:
+       color: '#386492'
+ dependencies:
+   - typo3/fluid-styled-content-css
+  - typo3/seo-sitemap