Skip to content

Commit 9524ed3

Browse files
[TASK] List modules in Configuration chapter (#5775)
* [TASK] List modules in Configuration chapter Extending the Configuration module has been moved to EXT:lowlevel docs with https://review.typo3.org/c/Packages/TYPO3.CMS/+/89782 Releases: main, 13.4 * [TASK] Language checks --------- Co-authored-by: Sarah McCarthy <sarahmccarthy123@yahoo.com>
1 parent ac46252 commit 9524ed3

File tree

18 files changed

+228
-216
lines changed

18 files changed

+228
-216
lines changed

Documentation/Configuration/ConfigurationModule/Index.rst

Lines changed: 0 additions & 152 deletions
This file was deleted.

Documentation/Configuration/ConfigurationModule/_MyProvider.php

Lines changed: 0 additions & 37 deletions
This file was deleted.

Documentation/Configuration/ConfigurationOverview.rst

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,9 @@ information, refer to the relevant chapters or references.
1414
TYPO3 is highly configurable—settings can be adjusted through the backend,
1515
extensions, or configuration files, and extended as needed.
1616

17+
.. contents:: Table of contents
18+
:depth: 2
19+
1720
.. _config-overview-files:
1821

1922
Configuration overview: files
@@ -166,8 +169,6 @@ integrators.
166169

167170
Global configuration arrays in PHP
168171
----------------------------------
169-
Global Configuration Arrays in PHP
170-
----------------------------------
171172

172173
TYPO3 stores global configuration in the :php:`$GLOBALS` PHP array. Key entries:
173174

Documentation/Configuration/GlobalVariables.rst

Lines changed: 4 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@
99
$GLOBALS
1010
========
1111

12+
.. seealso::
13+
Most global variables described here can be viewed in module
14+
:guilabel:`System > Configuration`: :ref:`globals-exploring`
15+
1216
.. confval:: TYPO3_CONF_VARS
1317
:name: globals-typo3-conf-vars
1418
:Path: $GLOBALS
@@ -152,27 +156,3 @@ $GLOBALS
152156
More information about retrieving the
153157
:php:`LanguageService` is available in
154158
:ref:`extension-localization-php`.
155-
156-
157-
.. index:: $GLOBALS; Admin Tools
158-
.. _globals-exploring:
159-
160-
Exploring global variables
161-
==========================
162-
163-
Many of the global variables described above can be inspected using the module
164-
:guilabel:`System > Configuration`.
165-
166-
.. warning::
167-
This module is always viewed in the BE context. Variables defined
168-
only in the FE context will not be visible there.
169-
170-
.. note::
171-
172-
This module is purely a browser. It does not let you change
173-
values.
174-
175-
It also lets you browse a number of other global arrays as well as values
176-
defined in other syntaxes including YAML.
177-
178-
.. include:: /Images/AutomaticScreenshots/BackendModules/GlobalValuesConfiguration.rst.txt

Documentation/Configuration/Index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ changed by developers and integrators.
3535
:maxdepth: 1
3636

3737
ConfigurationOverview
38-
ConfigurationModule/Index
38+
Modules/Index
3939
GlobalVariables
4040
Typo3ConfVars/Index
4141
TypoScript/Index
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
:navigation-title: System Settings
2+
3+
.. include:: /Includes.rst.txt
4+
.. _system-settings-module:
5+
6+
==============================================
7+
System settings: Module Admin Tools > Settings
8+
==============================================
9+
10+
Global configuration can only be changed by backend users with
11+
`System Maintainer privileges <https://docs.typo3.org/permalink/t3coreapi:system-maintainer>`_.
12+
13+
Use the backend module :guilabel:`Admin Tools > Settings` to access the
14+
different configuration options:
15+
16+
.. figure:: /Images/ManualScreenshots/AdminTools/AdminToolsSettings.png
17+
:alt: Backend module "Admin Tools > Settings" as seen by a system maintainer
18+
19+
Changes made in this module are written to file :file:`config/system/settings.php`.
20+
They can be overridden by configuration in file :file:`config/system/additional.php`
21+
in which case they cannot be changed from the TYPO3 Backend.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
:navigation-title: From the Backend
2+
3+
.. include:: /Includes.rst.txt
4+
.. _config-overview-backend:
5+
6+
=================================================
7+
View and edit settings from the backend: Overview
8+
=================================================
9+
10+
.. toctree::
11+
:caption: Subpages
12+
13+
SystemConfiguration/Index
14+
AdminToolsSettings/Index
15+
SiteConfiguration/Index
16+
SiteSettings/Index
17+
PageProperties/Index
18+
PluginSettings/Index
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
:navigation-title: Page properties
2+
3+
.. include:: /Includes.rst.txt
4+
.. _config-page-properties:
5+
6+
=======================================
7+
Page properties: Settings at page level
8+
=======================================
9+
10+
If the user has the correct permissions, settings for a page (and in some
11+
cases all subpages) can be made in the page properties:
12+
13+
.. figure:: /Images/ManualScreenshots/Backend/PageProperties.png
14+
:alt: Screenshot demonstrating the location of the "Edit page properties" button in the header of the "Web > Page" module
15+
16+
In the "Page" or "List" module click on "Edit page properties"
17+
18+
Some plugins also come with settings, refer to the manual of the extension
19+
providing the plugin.
20+
21+
.. seealso::
22+
23+
* `Tutorial for editors: Page properties <https://docs.typo3.org/permalink/t3editors:pages-properties>`_
24+
* `Site package Tutorial: Choose the page layout in the page properties <https://docs.typo3.org/permalink/t3sitepackage:choose-page-layout>`_
25+
26+
Technically the page properties are the same as the form displaying the page
27+
record from table :sql:`pages`. They can therefore be configured by developers
28+
via `TCA <https://docs.typo3.org/permalink/t3tca:start>`_.
29+
30+
The concrete settings available in the page properties depend on the chosen
31+
`Page types <https://docs.typo3.org/permalink/t3coreapi:page-types-intro>`_,
32+
represented by database field :sql:`doktype`.
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
:navigation-title: Plugin Settingss
2+
3+
.. include:: /Includes.rst.txt
4+
.. _plugin-settings:
5+
6+
========================================
7+
Plugin options: Settings at plugin level
8+
========================================
9+
10+
The plugins of many extensions come with settings inside the content
11+
element representing the plugin. These are commonly labeled "Plugin options"
12+
13+
Depending on their permissions, editors may be able to edit the settings of
14+
a plugin.
15+
16+
In general, plugin-specific settings are evaluated in the following order:
17+
18+
#. `Site settings <https://docs.typo3.org/permalink/t3coreapi:config-overview-backend-site>`_
19+
#. `TypoScript <https://docs.typo3.org/permalink/t3coreapi:extbase-typoscript-configuration-plugin>`_
20+
#. Settings made inside the plugin's content element
21+
22+
The settings of a plugin are commonly found in a tab called "Plugin" and
23+
a section called "Plugin Options". Extension authors are, however, free to
24+
chose different labels.
25+
26+
.. figure:: /Images/ManualScreenshots/Backend/PluginOptions.png
27+
:alt: Plugin Options of the Frontend login plugin
28+
29+
Example: Plugin options of the Frontend login plugin
30+
31+
Extension authors can use `FlexForms <https://docs.typo3.org/permalink/t3coreapi:flexforms>`_
32+
or `TCA <https://docs.typo3.org/permalink/t3tca:start>`_ to configure
33+
plugin options that can be set in the content element of the plugin.
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
:navigation-title: Site Configuration
2+
3+
.. include:: /Includes.rst.txt
4+
.. _site-configuration:
5+
6+
=========================================================
7+
Site configuration: Basic settings for the whole web site
8+
=========================================================
9+
10+
.. figure:: /Images/ManualScreenshots/SiteHandling/SiteConfigurationOverview.png
11+
:alt: Backend module Site Configuration in overview, found at Site Management > Sites
12+
13+
The site configuration gives you an overview of all configured sites
14+
15+
TYPO3 can handle multiple sites within one installation. For example, one
16+
TYPO3 installation might contain a company's web site and a few landing pages
17+
for special products and events.
18+
19+
Even if your TYPO3 installation only contains one site, this site needs to
20+
be configured. This includes the domain used to reach the site,
21+
language related configuration, error handling (for example a custom 404 page)
22+
and the inclusion of "Sets" of settings.
23+
24+
Settings provided by the included sets can be made in
25+
`Site Settings <https://docs.typo3.org/permalink/t3coreapi:config-overview-backend-site>`_.
26+
27+
.. seealso::
28+
29+
* `Site handling basics <https://docs.typo3.org/permalink/t3coreapi:sitehandling-basics>`_
30+
* `Creating a new site configuration <https://docs.typo3.org/permalink/t3coreapi:sitehandling-create-new>`_
31+
* `Getting Started Tutorial - Site Management <https://docs.typo3.org/permalink/t3start:site-management>`_

0 commit comments

Comments
 (0)