From de624dc8ce63ec819c61216d9d44f828841c293e Mon Sep 17 00:00:00 2001
From: Alexis Degrugillier <aledeg@users.noreply.github.com>
Date: Fri, 5 Sep 2025 16:57:34 -0400
Subject: Add new file in i18n (#7917)

When manipulating I18N files, it is now possible to add a new file to all
languages. This action is available both in the manipulation script and
the makefile.
---
 cli/i18n/I18nData.php          | 27 ++++++++++++++++++++++++++-
 cli/manipulate.translation.php |  4 ++++
 2 files changed, 30 insertions(+), 1 deletion(-)

(limited to 'cli')

diff --git a/cli/i18n/I18nData.php b/cli/i18n/I18nData.php
index 7170765b7..981c19e62 100644
--- a/cli/i18n/I18nData.php
+++ b/cli/i18n/I18nData.php
@@ -110,10 +110,17 @@ class I18nData {
 	 * Check if the key is known.
 	 */
 	public function isKnown(string $key): bool {
-		return array_key_exists($this->getFilenamePrefix($key), $this->data[static::REFERENCE_LANGUAGE]) &&
+		return $this->exists($key) &&
 			array_key_exists($key, $this->data[static::REFERENCE_LANGUAGE][$this->getFilenamePrefix($key)]);
 	}
 
+	/**
+	 * Check if the file exists
+	 */
+	public function exists(string $file): bool {
+		return array_key_exists($this->getFilenamePrefix($file), $this->data[static::REFERENCE_LANGUAGE]);
+	}
+
 	/**
 	 * Return the parent key for a specified key.
 	 * To get the parent key, you need to remove the last section of the key. Each
@@ -186,6 +193,24 @@ class I18nData {
 		return count($children) !== 0;
 	}
 
+	/**
+	 * Add a new translation file to all languages
+	 * @throws Exception
+	 */
+	public function addFile(string $file): void {
+		$file = strtolower($file);
+		if (!str_ends_with($file, '.php')) {
+			throw new Exception('The selected file name is not supported.');
+		}
+		if ($this->exists($file)) {
+			throw new Exception('The selected file exists already.');
+		}
+
+		foreach ($this->getAvailableLanguages() as $language) {
+			$this->data[$language][$this->getFilenamePrefix($file)] = [];
+		}
+	}
+
 	/**
 	 * Add a new key to all languages.
 	 * @throws Exception
diff --git a/cli/manipulate.translation.php b/cli/manipulate.translation.php
index db6243cc0..1c4a30ca6 100755
--- a/cli/manipulate.translation.php
+++ b/cli/manipulate.translation.php
@@ -43,6 +43,8 @@ switch ($cliOptions->action) {
 			$i18nData->addValue($cliOptions->key, $cliOptions->value, $cliOptions->language);
 		} elseif (isset($cliOptions->key) && isset($cliOptions->value)) {
 			$i18nData->addKey($cliOptions->key, $cliOptions->value);
+		} elseif (isset($cliOptions->key)) {
+			$i18nData->addFile($cliOptions->key);
 		} elseif (isset($cliOptions->language)) {
 			$reference = null;
 			if (isset($cliOptions->originLanguage)) {
@@ -172,6 +174,8 @@ Example 9:	revert ignore on all unmodified keys. Removes IGNORE comments from al
 Example 10:	check if a key exist.
 	php $file -a exist -k my_key
 
+Example 11:	add a new file to all languages
+	php $file -a add -k my_file.php
 HELP;
 	exit();
 }
-- 
cgit v1.2.3