[BUGFIX] Name "default language" consistently 02/62602/3
authorBenni Mack <benni@typo3.org>
Thu, 12 Dec 2019 06:33:39 +0000 (07:33 +0100)
committerGeorg Ringer <georg.ringer@gmail.com>
Fri, 13 Dec 2019 18:25:26 +0000 (19:25 +0100)
When working with the "pages.l18n_cfg" bitset flag, there is an
option "default translation", which commonly refers to language
with sys_language_uid=0. In most other cases, also in various
documentation pieces, the naming is "default language" instead
of "default translation" which is more correct in this case.

All places are now properly named "default language"
and no "default translation" is there anymore, making the
functionality more consistent.

Resolves: #89924
Releases: master, 9.5
Change-Id: Ibe9ad9371615119eff7535cb45d0f25b858d04da
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/62602
Tested-by: TYPO3com <noreply@typo3.com>
Tested-by: Alexander Schnitzler <review.typo3.org@alexanderschnitzler.de>
Tested-by: Oliver Bartsch <bo@cedev.de>
Tested-by: Georg Ringer <georg.ringer@gmail.com>
Reviewed-by: Oliver Bartsch <bo@cedev.de>
Reviewed-by: Alexander Schnitzler <review.typo3.org@alexanderschnitzler.de>
Reviewed-by: Georg Ringer <georg.ringer@gmail.com>
typo3/sysext/core/Documentation/Changelog/9.0/Important-82445-MigratePagesLanguageOverlayIntoPages.rst
typo3/sysext/core/Resources/Private/Language/locallang_csh_pages.xlf
typo3/sysext/extbase/Classes/Persistence/Generic/Storage/Typo3DbQueryParser.php
typo3/sysext/frontend/Classes/ContentObject/ContentObjectRenderer.php
typo3/sysext/frontend/Classes/Controller/TypoScriptFrontendController.php
typo3/sysext/frontend/Resources/Private/Language/locallang_tca.xlf
typo3/sysext/info/Resources/Private/Language/locallang_csh_webinfo.xlf

index 20eb592..7db7581 100644 (file)
@@ -40,7 +40,7 @@ Definitions:
 **The following details apply**
 
 - Any TCA-based records (= subpages, content elements) still ALWAYS contain the pid to the *Original Language Page*, a DataHandler restriction ensures this constraint.
-- Backend: All UI elements like Element Browser, Page Browser etc. are restricted to only show the *Default Translation Pages* to be selected (one can not link to a specific Translated Page).
+- Backend: All UI elements like Element Browser, Page Browser etc. are restricted to only show the *Default Language Pages* to be selected (one can not link to a specific Translated Page).
 - Permissions are always fetched from the "Original Language Page"
 - DataHandler: Moving or deleting of a *Default Language Page* always moves/deletes the associated *Translated Page* records as well.
 - DataHandler: "sorting" and "pid" parameters of translations are always kept in sync one-to-one for translated pages. Translated pages cannot be moved themselves.
@@ -48,6 +48,6 @@ Definitions:
 - Permissions: All existing "pages_language_overlay" permissions are merged into "pages" options for all records - when a Backend User/Group is limited to only certain languages (and not the default language) this , the . If a Backend User/Group does have permission on "pages_language_overlay" but not "pages", the Backend User/Group has automatically assigned all translations (sys_language_uid) as language limitations.
 - Frontend: Requesting a page can be done with ?id=originalpage&L=1 or ?id=translatedpage where "?id=translatedpage" internally resolves the "id" parameter to the uid of the Original Language Page and the "L" parameter resolved to the "sys_language_uid" corresponding in the TypoScript options.
 - Frontend: All "pid" checks are always done against the Original Language Page, as all records still sit on that page.
-- Frontend: Generating a link to a *Default Translation Page* with a current Translated Page generated, will exchange the target on link creation to the targeted Translated Page automatically.
+- Frontend: Generating a link to a *Default Language Page* with a current Translated Page generated, will exchange the target on link creation to the targeted Translated Page automatically.
 
 .. index:: Database, PHP-API
index a014f7e..4894680 100644 (file)
@@ -337,7 +337,7 @@ If you enter this string in the 'TSConfig' field, the 'Web&gt;Page' Module will
                                <source>Affect availability of pages in the various languages.</source>
                        </trans-unit>
                        <trans-unit id="l18n_cfg.details" resname="l18n_cfg.details" xml:space="preserve">
-                               <source>&lt;b&gt;Hide default translation of page&lt;/b&gt;
+                               <source>&lt;b&gt;Hide default language of page&lt;/b&gt;
 If set, the page is only available in translated versions and not in the default language. Any attempt to access the page in the default language will result in an error message.
 
 &lt;b&gt;Hide page if no translation for current language exists&lt;/b&gt;
index 52a83d1..d393578 100644 (file)
@@ -832,7 +832,7 @@ class Typo3DbQueryParser
         $andConditions = [];
         // records in language 'all'
         $andConditions[] = $this->queryBuilder->expr()->eq($tableAlias . '.' . $languageField, -1);
-        // translated records where a default translation exists
+        // translated records where a default language exists
         $andConditions[] = $this->queryBuilder->expr()->andX(
             $this->queryBuilder->expr()->eq($tableAlias . '.' . $languageField, (int)$querySettings->getLanguageUid()),
             $this->queryBuilder->expr()->in(
@@ -842,7 +842,7 @@ class Typo3DbQueryParser
         );
         if ($mode !== 'hideNonTranslated') {
             // $mode = TRUE
-            // returns records from current language which have default translation
+            // returns records from current language which have default language
             // together with not translated default language records
             $translatedOnlyTableAlias = $tableAlias . '_to';
             $queryBuilderForSubselect = $this->queryBuilder->getConnection()->createQueryBuilder();
index 8e04e0a..bb94e36 100644 (file)
@@ -6629,7 +6629,7 @@ class ContentObjectRenderer implements LoggerAwareInterface
             // Sys language content is set to zero/-1 - and it is expected that whatever routine processes the output will
             // OVERLAY the records with localized versions!
             $languageQuery = $expressionBuilder->in($languageField, [0, -1]);
-            // Use this option to include records that don't have a default translation ("free mode")
+            // Use this option to include records that don't have a default language counterpart ("free mode")
             // (originalpointerfield is 0 and the language field contains the requested language)
             if (isset($conf['includeRecordsWithoutDefaultTranslation']) || $conf['includeRecordsWithoutDefaultTranslation.']) {
                 $includeRecordsWithoutDefaultTranslation = isset($conf['includeRecordsWithoutDefaultTranslation.']) ?
index 4aa63df..1720d08 100644 (file)
@@ -2252,7 +2252,7 @@ class TypoScriptFrontendController implements LoggerAwareInterface
 
         // Setting sys_language_uid inside sys-page by creating a new page repository
         $this->sys_page = GeneralUtility::makeInstance(PageRepository::class, $this->context);
-        // If default translation is not available:
+        // If default language is not available:
         if ((!$languageAspect->getContentId() || !$languageAspect->getId())
             && GeneralUtility::hideIfDefaultLanguage($this->page['l18n_cfg'] ?? 0)
         ) {
index a059bea..0ee88c4 100644 (file)
                                <source>Localization</source>
                        </trans-unit>
                        <trans-unit id="pages.l18n_cfg.I.1" resname="pages.l18n_cfg.I.1">
-                               <source>Hide default translation of page</source>
+                               <source>Hide default language of page</source>
                        </trans-unit>
                        <trans-unit id="pages.l18n_cfg.I.2" resname="pages.l18n_cfg.I.2">
                                <source>Hide page if no translation for current language exists</source>
index 3af087d..cbdff05 100644 (file)
@@ -85,7 +85,7 @@ Here you see the "TSconfig" column. The overview exposes that these two pages in
 &lt;b&gt;Gray background (not available for default language):&lt;/b&gt; Page will fall back to the specified fallback mode for content. Depends on configuration. (sys_language_mode = content_fallback is recommended for most flexible fallback, sys_language_mode = strict will prevent this and issue an error instead!)
 
 &lt;b&gt;The pages "Localization settings:"&lt;/b&gt;
-It is the "Localization settings" of the page record that determines the modes above. In the column of the default translation each of these settings are represented by a "N" (Hide page if no translation for current language exists) or a "D" (Hide default translation of page).
+It is the "Localization settings" of the page record that determines the modes above. In the column of the default language each of these settings are represented by a "N" (Hide page if no translation for current language exists) or a "D" (Hide default language of page).
 As you can see the page "Startpage" has the N flag set and therefore any access to the german version of that page will be blocked with an error message because there is no translation in german. By default "german access" to a non-translated page will just show the english content.
 There is also a page with the D flag ("[Dummy]"). The D flag means that the page is only available in one of the translations, in this case Danish. So any attempt to access the page in the default language or german will show an error message.