MDL-87816: Add hooks before and after langpack update

Author: PM84

public/admin/tool/langimport/classes/controller.php

@@ -214,6 +214,10 @@ public function update_all_installed_languages() {
             }
         }
 
+        // Dispatch hook before updating language packs.
+        $hook = new \tool_langimport\hook\before_langpacks_updated($neededlangs);
+        \core\di::get(\core\hook\manager::class)->dispatch($hook);
+
         try {
             $updated = $this->install_languagepacks($neededlangs, true);
         } catch (\moodle_exception $e) {
@@ -223,6 +227,11 @@ public function update_all_installed_languages() {
 
         if ($updated) {
             $this->info[] = get_string('langupdatecomplete', 'tool_langimport');
+
+            // Dispatch hook before purging the string cache.
+            $hook = new \tool_langimport\hook\after_langpacks_updated($neededlangs);
+            \core\di::get(\core\hook\manager::class)->dispatch($hook);
+
             // The strings have been changed so we need to purge their cache to ensure users see the changes.
             get_string_manager()->reset_caches();
         } else {

public/admin/tool/langimport/classes/hook/after_langpacks_updated.php

@@ -0,0 +1,43 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace tool_langimport\hook;
+
+/**
+ * Hook dispatched after language packs have been updated, before the string cache is purged.
+ *
+ * This hook allows plugins to perform actions after language pack updates
+ * are completed but before the language string cache is reset.
+ *
+ * @package    tool_langimport
+ * @copyright  2026 ISB Bayern
+ * @author     Dr. Peter Mayer
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+#[\core\attribute\label('Allows plugins to perform actions after language packs are updated, before the string cache is purged.')]
+#[\core\attribute\tags('language', 'langimport')]
+class after_langpacks_updated {
+    /**
+     * Constructor for the hook.
+     *
+     * @param array $updatedlangs Array of language codes that were updated.
+     */
+    public function __construct(
+        /** @var array Array of language codes that were updated */
+        public readonly array $updatedlangs,
+    ) {
+    }
+}

public/admin/tool/langimport/classes/hook/before_langpacks_updated.php

@@ -0,0 +1,43 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace tool_langimport\hook;
+
+/**
+ * Hook dispatched before language packs are updated.
+ *
+ * This hook allows plugins to perform actions before language pack updates
+ * are executed, such as backing up current translations or preparing for changes.
+ *
+ * @package    tool_langimport
+ * @copyright  2026 ISB Bayern
+ * @author     Dr. Peter Mayer
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+#[\core\attribute\label('Allows plugins to perform actions before language packs are updated.')]
+#[\core\attribute\tags('language', 'langimport')]
+class before_langpacks_updated {
+    /**
+     * Constructor for the hook.
+     *
+     * @param array $langstobeupated Array of language codes that will be updated.
+     */
+    public function __construct(
+        /** @var array Array of language codes that will be updated */
+        public readonly array $langstobeupdated,
+    ) {
+    }
+}