Skip to content

Commit

Permalink
[FEATURE] Mention the site settings editor (#414)
Browse files Browse the repository at this point in the history
* [FEATURE] Mention the site settings editor

References: TYPO3-Documentation/Changelog-To-Doc#1026
Releases: main

* Update Documentation/Setup/Settings.rst

Co-authored-by: Chris Müller <2566282+brotkrueml@users.noreply.github.com>

* Update Documentation/Setup/Settings.rst

Co-authored-by: Chris Müller <2566282+brotkrueml@users.noreply.github.com>

* Update Documentation/Setup/Settings.rst

---------

Co-authored-by: Chris Müller <2566282+brotkrueml@users.noreply.github.com>
  • Loading branch information
linawolf and brotkrueml authored Sep 25, 2024
1 parent fe12866 commit 4cc49f8
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 8 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 42 additions & 8 deletions Documentation/Setup/Settings.rst
Original file line number Diff line number Diff line change
Expand Up @@ -78,14 +78,48 @@ Find detailed information in :ref:`TYPO3 Explained, Site handling <t3coreapi:sit
Site settings
-------------

.. versionadded:: 12.0
Starting with TYPO3 v12 site settings can be saved in a file called
:file:`config/sites/my-site/settings.yaml`.

Settings that only affect one site can be made in file
:file:`config/sites/my-site/settings.yaml`. If that is necessary we will refer
to this file in the documentation and authors of third party extensions might
also refer you to it. Find detailed information in
.. versionadded:: 13.3
Starting with TYPO3 v13.3 site settings can also be edited in the site
settings editor.

You can edit site settings in the module :guilabel:`Site Management > Settings`.
Changes are written to file :file:`config/sites/my-site/settings.yaml`. If you
keep this file under version control you must commit and push the changes made
to this file.

.. figure:: /Images/ManualScreenshots/SiteManagement/SiteSettingsOverview.png
:alt: Screenshot of the Site Settings Overview

You can find all sites in the settings module. If editable settings are available there is a button "Edit Settings"

You can find more information about this editor in
:ref:`TYPO3 Explained, Site settings editor <t3coreapi:site-settings-editor>`.

If site settings are available refer to the documentation of the extension
offering them.

The following optional Core extensions offer site settings:

* :composer:`typo3/cms-fluid-styled-content`:
:ref:`Site set "Fluid Styled Content" <typo3/cms-fluid-styled-content:site-set-fluid-styled-content>`.
Commonly used in projects that do not depend on :composer:`bk2k/bootstrap-package`.
* :composer:`typo3/cms-felogin`:
:ref:`Settings for the "Frontend Login" site set <typo3/cms-felogin:configuration-site-set-settings>`.
Used to offer a login for frontend users.
* :composer:`typo3/cms-indexed-search`:
:ref:`Settings of the site set "Indexed Search" <typo3/cms-indexed-search:site-set-settings>`.
Used to display a search box and offer basic indexing of a page without need
for a Solr core as would be required by :composer:`apache-solr-for-typo3/solr`.
* :composer:`typo3/cms-seo`:
:ref:`Site sets settings of EXT:seo <typo3/cms-seo:configuration-site-set-settings>`.
Used to improve meta tags, page titles and a provides a XML sitemap.

You can define custom site settings in your site package:
:ref:`TYPO3 Sitepackage Tutorial <t3sitepackage:start>`.

.. todo: link to the site settings page in the sitepackage tutorial once it is written.
Find detailed information on the topic also in
:ref:`TYPO3 Explained, Site settings <t3coreapi:sitehandling-settings>`.

.. _settings_typoscript:
Expand Down

0 comments on commit 4cc49f8

Please sign in to comment.