[TASK] Update Install Tool text 25/56825/5
authorTom Warwick <tom.warwick@typo3.org>
Sun, 29 Apr 2018 13:52:06 +0000 (14:52 +0100)
committerAndreas Fernandez <a.fernandez@scripting-base.de>
Fri, 1 Jun 2018 13:03:05 +0000 (15:03 +0200)
This commit is intented to improve the language
used in the Install Tool and each of its modules.

[+] Review title,subtitle and description for
each action available and update/amend where required.

Resolves: #84891
Releases: master
Change-Id: I7f71f85ae86c37786870b2c30511673fe28da7c2
Reviewed-on: https://review.typo3.org/56825
Reviewed-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Tested-by: Anja Leichsenring <aleichsenring@ab-softlab.de>
Reviewed-by: Mona Muzaffar <mona.muzaffar@gmx.de>
Tested-by: Mona Muzaffar <mona.muzaffar@gmx.de>
Tested-by: TYPO3com <no-reply@typo3.com>
Reviewed-by: Andreas Fernandez <a.fernandez@scripting-base.de>
Tested-by: Jan Helke <typo3@helke.de>
Reviewed-by: Jan Helke <typo3@helke.de>
Reviewed-by: Joerg Boesche <typo3@joergboesche.de>
Tested-by: Joerg Boesche <typo3@joergboesche.de>
Tested-by: Andreas Fernandez <a.fernandez@scripting-base.de>
typo3/sysext/install/Resources/Private/Templates/Environment/Cards.html
typo3/sysext/install/Resources/Private/Templates/Maintenance/Cards.html
typo3/sysext/install/Resources/Private/Templates/Maintenance/LanguagePacks.html
typo3/sysext/install/Resources/Private/Templates/Settings/Cards.html
typo3/sysext/install/Resources/Private/Templates/Settings/ChangeInstallToolPassword.html
typo3/sysext/install/Resources/Private/Templates/Settings/LocalConfigurationGetContent.html
typo3/sysext/install/Resources/Private/Templates/Settings/PresetsGetContent.html
typo3/sysext/install/Resources/Private/Templates/Settings/SystemMaintainer.html
typo3/sysext/install/Resources/Private/Templates/Upgrade/Cards.html

index 763d07a..9675292 100644 (file)
@@ -4,11 +4,11 @@
 <div class="card-container">
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Main System Information</h1>
+                       <h1 class="card-title">Environment Overview</h1>
                        <span class="card-subtitle">Environment</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Gives a short overview of your system environment, webserver, PHP and database information.</p>
+                       <p class="card-text">Gives an overview of your host environment including its web server, PHP version and selected database.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/SystemInformation">Show System Information</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Check Environment</h1>
+                       <h1 class="card-title">Environment Status</h1>
                        <span class="card-subtitle">PHP</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Performs various checks if there are problems within the server to have TYPO3 running properly.</p>
+                       <p class="card-text">Analyzes your host environment, identifying any issues that may prevent TYPO3 from running correctly.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/EnvironmentCheck">Check Environment</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Check Folder Structure</h1>
+                       <h1 class="card-title">Directory Status</h1>
                        <span class="card-subtitle">Permissions</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Analyzes your folder structure by checking the permissions and whether files or folders are missing.</p>
+                       <p class="card-text">Analyzes your folder structure, checking files and directories for correct permissions and identifying any files or directories that may be missing from your installation.</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/FolderStructure">Check Folder Structure</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/FolderStructure">Check Directory Status</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
                        <span class="card-subtitle">PHP</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Outputs a large amount of information about the current state of PHP.</p>
+                       <p class="card-text">Outputs detailed information about your installation of PHP. Including version details and enabled PHP extensions.</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/PhpInfo">Show PHP Info</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/PhpInfo">View PHP Info</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
@@ -56,7 +56,7 @@
                        <span class="card-subtitle">Mail</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Checks if TYPO3 can send out emails properly by sending a test email.</p>
+                       <p class="card-text">Test your mail configuration by sending out a dummy email via TYPO3.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/MailTest">Test Mail Setup</a>
@@ -68,7 +68,7 @@
                        <span class="card-subtitle">Image Processing</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Creates test images and compares with a reference to ensure that Image Processing works correctly in the current environment.</p>
+                       <p class="card-text">Creates test images and compares them against a set of reference images to help ensure that image processing is working correctly within your environment.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ImageProcessing">Test Images</a>
index 3583d63..6c6f90e 100644 (file)
@@ -5,14 +5,17 @@
 <div class="card-container">
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Flush TYPO3 and PHP Caches</h1>
+                       <h1 class="card-title">Flush TYPO3 and PHP Cache</h1>
                        <span class="card-subtitle">Caching</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Clears all TYPO3 Caches including PHP Op-Caches, similiar to the <i>Clear Cache</i> Button in the TYPO3 Backend.</p>
+                       <p class="card-text">This action directly clears all registered caches including opcode cache.
+                               This utility is also present in TYPO3’s backend: Top Bar > Clear Cache > Flush all caches.
+                               A fatal error will be thrown if a broken extension is detected. If this occurs, use the extension tester utility (Upgrade > Check For Broken Extensions).
+                       </p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-primary " data-inline="1"  data-require="TYPO3/CMS/Install/Cache">Clear all cache</a>
+                       <a href="#" class="btn btn-primary " data-inline="1"  data-require="TYPO3/CMS/Install/Cache">Flush cache</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
@@ -21,7 +24,7 @@
                        <span class="card-subtitle">Database</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Compare and update the database table and field definitions of the current database with specifications from extensions.</p>
+                       <p class="card-text">Compare and update the database table and field definitions of your installation against the specification defined for every activated extension.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/DatabaseAnalyzer">Analyse database</a>
@@ -33,7 +36,7 @@
                        <span class="card-subtitle">Caching</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Clears temporary files in typo3temp/assets/ folder, including concatenated JS/CSS files, and processed images.</p>
+                       <p class="card-text">Clears temporary files including concatenated JS/CSS files and processed images.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ClearTypo3tempFiles">Scan temporary files</a>
@@ -45,7 +48,7 @@
                        <span class="card-subtitle">Caching</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">This (re-)dumps autoload information for all active third party extensions.</p>
+                       <p class="card-text">Resets autoload information for all active third party extensions.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-primary " data-inline="1"  data-require="TYPO3/CMS/Install/DumpAutoload">Dump autoload</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Clear Semi-Temporary Database Tables</h1>
+                       <h1 class="card-title">Clear persistent database tables</h1>
                        <span class="card-subtitle">Database</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Truncates semi-temporary database tables, which are not related to caches, but can also be re-populated by TYPO3.</p>
+                       <p class="card-text">Truncates persistent database tables, which are not related to caching.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ClearTables">Scan tables</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Add Administrator User</h1>
+                       <h1 class="card-title">Create administrative user</h1>
                        <span class="card-subtitle">Backend Users</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Use this function if there are no admin users in the database, for instance if this is a blank installation.</p>
+                       <p class="card-text">Create new administrative users and grant them system maintainer privileges (optional).</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/CreateAdmin">Add Administrator</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/CreateAdmin">Create Administrator</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Reset All Backend User Preferences</h1>
+                       <h1 class="card-title">Reset backend user preferences</h1>
                        <span class="card-subtitle">Backend Users</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Clears user preferences of all backend users from be_users table. The field <code>uc</code> will be set to an empty string.</p>
+                       <p class="card-text">Clears preferences and settings for all backend users. The <code>uc</code> field is then set to an empty string.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-primary " data-inline="1"  data-require="TYPO3/CMS/Install/ResetBackendUserUc">Reset backend user preferences</a>
@@ -93,7 +96,7 @@
                        <span class="card-subtitle">Language</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Download and update language packs of extensions.</p>
+                       <p class="card-text">Download and update language packs for installed extensions.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/LanguagePacks">Manage languages</a>
index 6e6cefc..2e55ee0 100644 (file)
@@ -9,9 +9,8 @@
     <div id="t3js-languagePacks-extensionPack-misses-icon"><core:icon identifier="actions-add" /></div>
 </div>
 <p>
-    This module gives an overview of available languages other than the default "English" language. It allows
-    to activate and deactivate additional localizations and to update language packs from the official
-    translation server.
+    Gives an overview of available languages excluding the default (English) language.
+    It allows you to activate and deactivate additional localizations and to update language packs from the official TYPO3 translation server.
 </p>
 <div class="t3js-languagePacks-notifications"></div>
 <div class="t3js-languagePacks-output"></div>
index f5bf37d..7f6ae1b 100644 (file)
@@ -8,7 +8,7 @@
                        <span class="card-subtitle">Access</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Set a new password for accessing the Install Tool in Standalone Mode.</p>
+                       <p class="card-text">Set a new password for the Install Tool when accessed in Standalone mode.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ChangeInstallToolPassword">Change Install Tool Password</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Configure System Maintainers</h1>
+                       <h1 class="card-title">Manage System Maintainers</h1>
                        <span class="card-subtitle">Access</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Add or remove backend administrators which should have access to the Install Tool.</p>
+                       <p class="card-text">Specify which backend administrators have access to the Admin Tools module and Install Tool when accessed in Standalone Mode.</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/SystemMaintainer">Manage System Maintainer</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/SystemMaintainer">Manage System Maintainers</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Choose Configuration Presets</h1>
+                       <h1 class="card-title">Configuration Presets</h1>
                        <span class="card-subtitle">Global Configuration</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Detect and select settings for Image Processing, Debug/Live mode and Mail settings.</p>
+                       <p class="card-text">Configure image processing, debug/live mode and mail settings.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/Presets">Choose Preset</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Configure installation-wide options</h1>
+                       <h1 class="card-title">Configure Installation-Wide Options</h1>
                        <span class="card-subtitle">Global Configuration</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Modify settings to be written into TYPO3\'s LocalConfiguration.php.</p>
+                       <p class="card-text">Modify settings written to LocalConfiguration.php.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/LocalConfiguration">Configure options</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Extension configuration</h1>
+                       <h1 class="card-title">Extension Configuration</h1>
                        <span class="card-subtitle">Global Configuration</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Configure settings for extensions.</p>
+                       <p class="card-text">Configure settings for all enabled extensions.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ExtensionConfiguration">Configure extensions</a>
index 21a779d..224a34b 100644 (file)
@@ -1,6 +1,5 @@
 <p>
-       Allows you to set a new install tool password.
-       The hash of this password will be written into LocalConfiguration.php and overwrite the old password.
+       Allows you to set a new Install Tool password. The hash for this password will be written to LocalConfiguration.php and will overwrite the previously specified password.
 </p>
 
 <div style="display:none;">
index eac35a5..9399bc1 100644 (file)
@@ -1,7 +1,5 @@
 <p>
-       Changed values are written to LocalConfiguration.php. The optional file AdditionalConfiguration.php
-       is not controlled by the TYPO3 CMS core and may override single settings again. Administrators
-       must maintain AdditionalConfiguration.php on their own and should use it with care.
+       Modified values are written to LocalConfiguration.php. The optional file AdditionalConfiguration.php is not controlled by the TYPO3’s core and may override certain settings. Administrators must maintain AdditionalConfiguration.php manually and should be used with caution.
 </p>
 
 <div style="display:none;">
index 3ef48ce..c1340f0 100644 (file)
@@ -1,19 +1,11 @@
 <p>
-       The configuration module suggests best matching configuration settings
-       based on your system setup.
+       The Configuration Module recommends configuration settings based on information found in your environments setup.
 </p>
 <p>
-       Alternatively TYPO3 can be run in a specific <a
-       href="https://docs.typo3.org/typo3cms/CoreApiReference/ApiOverview/Bootstrapping/Index.html#bootstrapping-context"
-       target="_blank">application context</a>,
-       by setting an environment variable in the web server configuration.
-       The application context can then be accessed e.g. in the AdditionalConfiguration.php file or
-       TypoScript configuration to customize settings accordingly.
+       TYPO3 can also be run in a specific application context, by setting an environment variable in the web server configuration. The application context can then be accessed e.g. in the AdditionalConfiguration.php file or TypoScript configuration to customize settings accordingly.
 </p>
 <p>
-       Changed values are written to LocalConfiguration.php. The optional file AdditionalConfiguration.php
-       is not controlled by the TYPO3 CMS core and may override single settings again. Administrators
-       must maintain AdditionalConfiguration.php on their own and should use it with care.
+       Changed values are written to LocalConfiguration.php. The optional file AdditionalConfiguration.php is not controlled by the TYPO3’s core and may override certain settings. Administrators must maintain AdditionalConfiguration.php manually and should be used with caution.
 </p>
 
 <div style="display:none;">
index 4384385..b4cef91 100644 (file)
@@ -1,9 +1,5 @@
 <p>
-       Backend admin users listed here will see the system maintenance related main
-       module entries "Maintenance", "Settings", "Upgrade" and "Environment" in the
-       backend and are allowed to use them without further log in.
-       Note that all backend admin users see these menu entries if the system is in
-       development (not production) context.
+       Administrative users listed here will have full access to the Admin Tools module located in the backend. Note that all backend administrative users have access to this module when the system is running in development mode.
 </p>
 
 <f:if condition="{systemMaintainerIsDevelopmentContext}">
index e715581..4f571c9 100644 (file)
@@ -8,7 +8,7 @@
                        <span class="card-subtitle">Core Upgrade</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Update your TYPO3 installation with one click, if your instance is set up correctly.</p>
+                       <p class="card-text">Update your TYPO3 installation (support for symbolic links required).</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/CoreUpdate">Update Core</a>
        </div>
        <div class="card card-size-fixed-small">
                <div class="card-header">
-                       <h1 class="card-title">Execute Upgrade Wizards</h1>
+                       <h1 class="card-title">Upgrade Wizard</h1>
                        <span class="card-subtitle">Core Upgrade</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">If you upgrade your TYPO3 installation from e.g. v8 to v9, then Upgrade Wizards guide you through the necessary steps.</p>
+                       <p class="card-text">Finalises the upgrade process when moving to a major release.</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/UpgradeWizards">Execute Upgrade Wizards</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/UpgradeWizards">Run Upgrade Wizard</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
@@ -32,7 +32,7 @@
                        <span class="card-subtitle">Core Upgrade</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Show and search documentation files describing important changes between TYPO3 versions.</p>
+                       <p class="card-text">View and search for important changes that have been made for every major and minor release of TYPO3.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/UpgradeDocs">View Upgrade Documentation</a>
@@ -44,7 +44,8 @@
                        <span class="card-subtitle">TCA</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Test if extensions still change TCA in ext_tables.php files, resulting in performance drawbacks.</p>
+                       <p class="card-text">Identify any extensions that are modifying the Table Control Array (TCA) in ext_tables.php. Changes made to the TCA can result in performance drawbacks.
+                       </p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/TcaExtTablesCheck">Check TCA</a>
                        <span class="card-subtitle">Extensions</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Check if all base configuration files of currently loaded extensions have errors with the current TYPO3 version.</p>
+                       <p class="card-text">Checks the compatibility of all active extensions against the current (installed) version of TYPO3.</p>
                </div>
                <div class="card-footer">
-                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ExtensionCompatTester">Check Extensions</a>
+                       <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/ExtensionCompatTester">Check Extension Compatibility</a>
                </div>
        </div>
        <div class="card card-size-fixed-small">
@@ -68,7 +69,7 @@
                        <span class="card-subtitle">TCA</span>
                </div>
                <div class="card-content">
-                       <p class="card-text">Check if third-party extensions have outdated TCA configuration which should be adapted for the current TYPO3 version.</p>
+                       <p class="card-text">Identifies any third-party extensions that contain an outdated TCA configuration which should be adapted for the current (installed) version of TYPO3.</p>
                </div>
                <div class="card-footer">
                        <a href="#" class="btn btn-default t3js-install-open-modal t3js-require" data-require="TYPO3/CMS/Install/TcaMigrationsCheck">Check TCA Migrations</a>