Merge branch '2026.1' into 2026.x

Author: Corepex

assets/js/src/core/app/i18n/index.ts

@@ -8,13 +8,13 @@
  *  @license    Pimcore Open Core License (POCL)
  */
 
+import trackError, { GeneralError } from '@Pimcore/modules/app/error-handler'
+import { isNonEmptyString } from '@sdk/utils'
 import i18n from 'i18next'
 import { initReactI18next } from 'react-i18next'
-import trackError, { GeneralError } from '@Pimcore/modules/app/error-handler'
-import { addMissingTranslation } from './store/missingTranslations.slice'
 import { store } from '../store'
-import { returnKeyIfEmptyProcessor } from './utils/post-processors'
-import { isNonEmptyString } from '@sdk/utils'
+import { addMissingTranslation } from './store/missingTranslations.slice'
+import { createDebugTranslationsProcessor, returnKeyIfEmptyProcessor } from './utils/post-processors'
 
 export const FALLBACK_LANGUAGE = 'en'
 
@@ -27,7 +27,7 @@ i18n
     resources: {},
     keySeparator: false,
     saveMissing: true,
-    postProcess: ['returnKeyIfEmpty']
+    postProcess: ['returnKeyIfEmpty', 'debugTranslations']
   })
 
   .catch(() => {
@@ -36,6 +36,11 @@ i18n
 
 i18n.use(returnKeyIfEmptyProcessor)
 
+const debugTranslationsProcessor = createDebugTranslationsProcessor(
+  () => (store.getState()).settings?.settings?.debug_admin_translations === true
+)
+i18n.use(debugTranslationsProcessor)
+
 i18n.on('missingKey', (lngs, namespace, key, res) => {
   if (isNonEmptyString(key)) {
     store.dispatch(addMissingTranslation(key))

assets/js/src/core/app/i18n/utils/post-processors.ts

@@ -12,6 +12,25 @@
  * i18next post-processor that returns the key if the translation value is empty
  * Used consistently across main app and iframe i18n setup
  */
+export const createDebugTranslationsProcessor = (getDebugMode: () => boolean): {
+  type: 'postProcessor'
+  name: string
+  process: (value: string, key: string | string[]) => string
+} => ({
+  type: 'postProcessor' as const,
+  name: 'debugTranslations',
+  process (value: string, key: string | string[]): string {
+    if (!getDebugMode()) {
+      return value
+    }
+
+    const keyString = Array.isArray(key) ? key[0] : key
+    const isMissingTranslation = value === keyString
+
+    return isMissingTranslation ? `+ ${value} +` : value
+  }
+})
+
 export const returnKeyIfEmptyProcessor = {
   type: 'postProcessor' as const,
   name: 'returnKeyIfEmpty',