From ac87cbff814ee763d9fbcdda039257f769216743 Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Fri, 21 Nov 2025 21:56:45 +0200
Subject: [PATCH 01/10] feat(frontend/backend): alert end users when are
 potential upgrades available

---
 lib/framework.php                    |  1 +
 lib/version.php                      | 28 ++++++++++++++++++++++++++++
 modules/account/setup.php            |  4 ++--
 modules/calendar/setup.php           |  4 ++--
 modules/core/functions.php           |  1 +
 modules/core/output_modules.php      | 15 +++++++++++++++
 modules/core/setup.php               |  6 +++---
 modules/highlights/setup.php         |  4 ++--
 modules/history/setup.php            |  2 +-
 modules/imap_folders/setup.php       |  4 ++--
 modules/keyboard_shortcuts/setup.php |  2 +-
 modules/nasa/setup.php               |  2 +-
 modules/pgp/setup.php                |  2 +-
 modules/profiles/setup.php           |  2 +-
 modules/recover_settings/setup.php   |  2 +-
 modules/sievefilters/setup.php       |  4 ++--
 modules/smtp/setup.php               |  2 +-
 modules/tags/setup.php               |  2 +-
 18 files changed, 66 insertions(+), 21 deletions(-)
 create mode 100644 lib/version.php

diff --git a/lib/framework.php b/lib/framework.php
index d4a860016a..6c62b151b0 100644
--- a/lib/framework.php
+++ b/lib/framework.php
@@ -37,6 +37,7 @@
 require APP_PATH.'lib/api.php';
 require APP_PATH.'lib/webdav_formats.php';
 require APP_PATH.'lib/js_libs.php';
+require APP_PATH.'lib/version.php';
 
 require_once APP_PATH.'modules/core/functions.php';
 
diff --git a/lib/version.php b/lib/version.php
new file mode 100644
index 0000000000..a905194428
--- /dev/null
+++ b/lib/version.php
@@ -0,0 +1,28 @@
+<?php
+
+define('CYPHT_VERSION', '3.0');
+define('CYPHT_BRANCH', 'dev'); // stable, beta, dev
+
+$installedVersion = env('CYPHT_INSTALLED_VERSION');
+
+$needUpgrade = false;
+
+if (! $installedVersion && CYPHT_BRANCH !== 'dev') {
+    $needUpgrade = true;
+}
+
+if ($installedVersion && version_compare($installedVersion, CYPHT_VERSION, '<')) {
+    $needUpgrade = true;
+}
+
+$fileContent = file_get_contents(APP_PATH . '.env');
+if ($fileContent) {
+    if (strpos($fileContent, 'CYPHT_INSTALLED_VERSION=') === false) {
+        $fileContent .= "\nCYPHT_INSTALLED_VERSION=" . CYPHT_VERSION . "\n";
+    } else {
+        $fileContent = preg_replace('/CYPHT_INSTALLED_VERSION=.*/', 'CYPHT_INSTALLED_VERSION=' . CYPHT_VERSION, $fileContent);
+    }
+    file_put_contents(APP_PATH . '.env', $fileContent);
+}
+
+define('CYPHT_NEED_UPGRADE', $needUpgrade);
diff --git a/modules/account/setup.php b/modules/account/setup.php
index b965ec3c21..2ad86d5141 100644
--- a/modules/account/setup.php
+++ b/modules/account/setup.php
@@ -11,13 +11,13 @@
 add_handler('accounts', 'process_delete_account', true, 'account', 'process_create_account', 'after');
 add_handler('accounts', 'check_internal_users', true, 'account', 'login', 'after');
 add_handler('accounts', 'account_list', true, 'account', 'check_internal_users', 'after');
-add_output('accounts', 'create_form', true, 'account', 'content_section_start', 'after');
+add_output('accounts', 'create_form', true, 'account', 'version_upgrade_checker', 'after');
 add_output('accounts', 'user_list', true, 'account', 'create_form', 'after');
 
 setup_base_page('change_password', 'core');
 add_handler('change_password', 'process_change_password', true, 'account', 'load_user_data', 'after');
 add_handler('change_password', 'check_internal_users', true, 'account', 'login', 'after');
-add_output('change_password', 'change_password', true, 'account', 'content_section_start', 'after');
+add_output('change_password', 'change_password', true, 'account', 'version_upgrade_checker', 'after');
 
 /* folder list link */
 add_handler('ajax_hm_folders', 'check_internal_users', true, 'account', 'login', 'after');
diff --git a/modules/calendar/setup.php b/modules/calendar/setup.php
index fe0b72180b..9366cca225 100644
--- a/modules/calendar/setup.php
+++ b/modules/calendar/setup.php
@@ -13,8 +13,8 @@
 add_handler('calendar', 'process_delete_event', true, 'calendar', 'get_calendar_date', 'after');
 add_handler('ajax_imap_message_content', 'vcalendar_check',  true, 'calendar', 'imap_message_content', 'after');
 /*add_output('ajax_imap_message_content', 'vcalendar_add_output', true, 'calendar', 'filter_message_headers', 'after');*/
-add_output('calendar', 'calendar_content', true, 'calendar', 'content_section_start', 'after');
-add_output('calendar', 'add_cal_event_form', true, 'calendar', 'content_section_start', 'after');
+add_output('calendar', 'calendar_content', true, 'calendar', 'version_upgrade_checker', 'after');
+add_output('calendar', 'add_cal_event_form', true, 'calendar', 'version_upgrade_checker', 'after');
 add_output('ajax_hm_folders', 'calendar_page_link', true, 'calendar', 'main_menu_content', 'before');
 
 return array(
diff --git a/modules/core/functions.php b/modules/core/functions.php
index bec37da69a..7d103186d7 100644
--- a/modules/core/functions.php
+++ b/modules/core/functions.php
@@ -442,6 +442,7 @@ function setup_base_page($name, $source=false, $use_layout=true) {
         add_output($name, 'folder_list_start', true, $source);
         add_output($name, 'folder_list_end', true, $source);
         add_output($name, 'content_section_start', true, $source);
+        add_output($name, 'version_upgrade_checker', true, $source, 'content_section_start', 'after');
         add_output($name, 'content_section_end', true, $source);
         add_output($name, 'modals', true, $source);
         add_output($name, 'save_reminder', true, $source);
diff --git a/modules/core/output_modules.php b/modules/core/output_modules.php
index 5885cf924f..e8dbe4991f 100644
--- a/modules/core/output_modules.php
+++ b/modules/core/output_modules.php
@@ -2505,3 +2505,18 @@ protected function output() {
         $this->out('formatted_message_list', $messageList);
     }
 }
+
+class Hm_Output_version_upgrade_checker extends Hm_Output_Module {
+    protected function output()
+    {
+        // if (! CYPHT_NEED_UPGRADE) return '';
+
+        return '
+        <div class="alert alert-info alert-dismissible fade show d-flex align-items-center" role="alert">
+            <i class="bi bi-info-circle-fill me-2"></i>
+            You are currently running Cypht version '.CYPHT_VERSION.'. A higher version is available. Please visit <a href="https://github.com/cypht-org/cypht/releases" target="_blank" class="ms-1 me-1">GitHub Releases</a> for the full list of available versions.
+            <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
+        </div>
+        ';
+    }
+}
diff --git a/modules/core/setup.php b/modules/core/setup.php
index 9a43f790db..5c9844ed24 100644
--- a/modules/core/setup.php
+++ b/modules/core/setup.php
@@ -14,13 +14,13 @@
 /* homepage */
 setup_base_page('home');
 add_handler('home', 'check_missing_passwords', true, 'core', 'load_user_data', 'after');
-add_output('home', 'home_heading', true, 'core', 'content_section_start', 'after');
+add_output('home', 'home_heading', true, 'core', 'version_upgrade_checker', 'after');
 add_output('home', 'home_password_dialogs', true, 'core', 'home_heading', 'after');
 
 /* servers page */
 setup_base_page('servers');
 add_handler('servers', 'reload_folder_cookie', true, 'core', 'save_user_data', 'after');
-add_output('servers', 'server_content_start', true, 'core', 'content_section_start', 'after');
+add_output('servers', 'server_content_start', true, 'core', 'version_upgrade_checker', 'after');
 add_output('servers', 'server_config_stepper', true, 'core', 'server_content_start', 'after');
 add_output('servers', 'server_config_stepper_end_part', true, 'core', 'server_config_stepper', 'after');
 add_output('servers', 'server_config_stepper_accordion_end_part', true, 'core', 'server_config_stepper_end_part', 'after');
@@ -32,7 +32,7 @@
 /* save settings */
 setup_base_page('save');
 add_handler('save', 'process_save_form', true, 'core', 'load_user_data', 'after');
-add_output('save', 'save_form', true, 'core', 'content_section_start', 'after');
+add_output('save', 'save_form', true, 'core', 'version_upgrade_checker', 'after');
 
 /* settings */
 setup_base_page('settings');
diff --git a/modules/highlights/setup.php b/modules/highlights/setup.php
index fa341e5916..1db3e8775a 100644
--- a/modules/highlights/setup.php
+++ b/modules/highlights/setup.php
@@ -9,10 +9,10 @@
 add_handler('highlights', 'load_feeds_from_config', true, 'feeds', 'load_user_data', 'after');
 add_handler('highlights', 'highlight_process_form', true, 'highlights', 'language', 'after');
 add_handler('highlights', 'highlight_page_data', true, 'highlights', 'highlight_process_form', 'after');
-add_output('highlights', 'highlight_config_page', true, 'highlights', 'content_section_start', 'after');
+add_output('highlights', 'highlight_config_page', true, 'highlights', 'version_upgrade_checker', 'after');
 
 add_handler('message_list', 'highlight_list_data', true, 'highlights', 'load_user_data', 'after');
-add_output('message_list', 'highlight_css', true, 'highlights', 'content_section_start', 'before');
+add_output('message_list', 'highlight_css', true, 'highlights', 'version_upgrade_checker', 'before');
 
 add_output('ajax_hm_folders', 'highlight_link', true, 'highlights', 'settings_save_link', 'after');
 
diff --git a/modules/history/setup.php b/modules/history/setup.php
index 7423b65876..6aeb53efe9 100644
--- a/modules/history/setup.php
+++ b/modules/history/setup.php
@@ -5,7 +5,7 @@
 
 setup_base_page('history', 'core');
 add_handler('history', 'load_message_history', true, 'history', 'save_user_data', 'before');
-add_output('history', 'history_heading', true, 'history', 'content_section_start', 'after');
+add_output('history', 'history_heading', true, 'history', 'version_upgrade_checker', 'after');
 add_output('history', 'history_content', true, 'history', 'history_heading', 'after');
 add_output('history', 'history_footer', true, 'history', 'history_content', 'after');
 
diff --git a/modules/imap_folders/setup.php b/modules/imap_folders/setup.php
index e803c2001f..16911a3721 100644
--- a/modules/imap_folders/setup.php
+++ b/modules/imap_folders/setup.php
@@ -16,7 +16,7 @@
 setup_base_page('folders', 'core');
 add_handler('folders', 'folders_server_id', true, 'imap_folders', 'load_user_data', 'after');
 add_handler('folders', 'special_folders', true, 'imap_folders', 'folders_server_id', 'after');
-add_output('folders', 'folders_content_start', true, 'imap_folders', 'content_section_start', 'after');
+add_output('folders', 'folders_content_start', true, 'imap_folders', 'version_upgrade_checker', 'after');
 add_output('folders', 'folders_server_select', true, 'imap_folders', 'folders_folder_subscription_button', 'after');
 add_output('folders', 'folders_create_dialog', true, 'imap_folders', 'folders_server_select', 'after');
 add_output('folders', 'folders_rename_dialog', true, 'imap_folders', 'folders_create_dialog', 'after');
@@ -79,7 +79,7 @@
 add_handler('folders_subscription', 'folders_server_id', true, 'imap_folders', 'load_user_data', 'after');
 add_handler('folders_subscription', 'special_folders', true, 'imap_folders', 'folders_server_id', 'after');
 add_handler('folders_subscription', 'get_only_subscribed_folders_setting', true, 'imap_folders');
-add_output('folders_subscription', 'folders_subscription_content_start', true, 'imap_folders', 'content_section_start', 'after');
+add_output('folders_subscription', 'folders_subscription_content_start', true, 'imap_folders', 'version_upgrade_checker', 'after');
 add_output('folders_subscription', 'folders_server_select', true, 'imap_folders', 'folders_subscription_content_start', 'after');
 add_output('folders_subscription', 'folders_folder_subscription', true, 'imap_folders', 'folders_server_select', 'after');
 
diff --git a/modules/keyboard_shortcuts/setup.php b/modules/keyboard_shortcuts/setup.php
index b690dafe90..62edb6510a 100644
--- a/modules/keyboard_shortcuts/setup.php
+++ b/modules/keyboard_shortcuts/setup.php
@@ -8,7 +8,7 @@
 setup_base_page('shortcuts', 'core');
 add_handler('shortcuts', 'load_edit_id', true, 'keyboard_shortcuts', 'load_keyboard_shortcuts', 'after');
 add_handler('shortcuts', 'process_edit_shortcut', true, 'keyboard_shortcuts', 'load_edit_id', 'after');
-add_output('shortcuts', 'start_shortcuts_page', true, 'keyboard_shortcuts', 'content_section_start', 'after');
+add_output('shortcuts', 'start_shortcuts_page', true, 'keyboard_shortcuts', 'version_upgrade_checker', 'after');
 add_output('shortcuts', 'shortcut_edit_form', true, 'keyboard_shortcuts', 'start_shortcuts_page', 'after');
 add_output('shortcuts', 'shortcuts_content', true, 'keyboard_shortcuts', 'shortcut_edit_form', 'after');
 
diff --git a/modules/nasa/setup.php b/modules/nasa/setup.php
index 36b76db271..5c8a7d8a51 100644
--- a/modules/nasa/setup.php
+++ b/modules/nasa/setup.php
@@ -8,7 +8,7 @@
 /* APOD display */
 setup_base_page('nasa_apod', 'core');
 add_handler('nasa_apod', 'fetch_apod_content', true, 'nasa', 'http_headers', 'after');
-add_output('nasa_apod', 'apod_content', true, 'nasa', 'content_section_start', 'after');
+add_output('nasa_apod', 'apod_content', true, 'nasa', 'version_upgrade_checker', 'after');
 
 /* folder list entry */
 add_handler('ajax_hm_folders', 'nasa_folder_data',  true, 'nasa', 'load_user_data', 'after');
diff --git a/modules/pgp/setup.php b/modules/pgp/setup.php
index 1658f26a5c..510ea3c0f1 100644
--- a/modules/pgp/setup.php
+++ b/modules/pgp/setup.php
@@ -9,7 +9,7 @@
 add_handler('pgp', 'pgp_delete_public_key', true, 'pgp', 'http_headers', 'after');
 add_handler('pgp', 'pgp_import_public_key', true, 'pgp', 'pgp_delete_public_key', 'after');
 add_handler('pgp', 'load_pgp_data', true, 'pgp', 'pgp_import_public_key', 'after');
-add_output('pgp', 'pgp_settings_start', true, 'pgp', 'content_section_start', 'after');
+add_output('pgp', 'pgp_settings_start', true, 'pgp', 'version_upgrade_checker', 'after');
 add_output('pgp', 'pgp_settings_public_keys', true, 'pgp', 'pgp_settings_start', 'after');
 add_output('pgp', 'pgp_settings_private_key', true, 'pgp', 'pgp_settings_public_keys', 'after');
 add_output('pgp', 'pgp_settings_end', true, 'pgp', 'pgp_settings_private_key', 'after');
diff --git a/modules/profiles/setup.php b/modules/profiles/setup.php
index ea8c0da243..9026f2418c 100644
--- a/modules/profiles/setup.php
+++ b/modules/profiles/setup.php
@@ -11,7 +11,7 @@
 add_handler('profiles', 'profile_edit_data', true, 'profiles', 'profile_data', 'after');
 add_handler('profiles', 'process_profile_delete', true, 'profiles', 'profile_data', 'after');
 add_handler('profiles', 'process_profile_update', true, 'profiles', 'process_profile_delete', 'after');
-add_output('profiles', 'profile_edit_form', true, 'profiles', 'content_section_start', 'after');
+add_output('profiles', 'profile_edit_form', true, 'profiles', 'version_upgrade_checker', 'after');
 add_output('profiles', 'profile_content', true, 'profiles', 'profile_edit_form', 'after');
 
 add_handler('folders', 'load_default_server_from_profiles', true, 'profiles', 'folders_server_id', 'before');
diff --git a/modules/recover_settings/setup.php b/modules/recover_settings/setup.php
index 752e46572d..22ad1b50a1 100644
--- a/modules/recover_settings/setup.php
+++ b/modules/recover_settings/setup.php
@@ -8,7 +8,7 @@
 setup_base_page('recover_settings', 'core');
 add_handler('recover_settings', 'reload_folder_cookie', true, 'core', 'save_user_data', 'after');
 add_handler('recover_settings', 'process_recover_settings_form', true, 'recover_settings', 'load_user_data', 'after');
-add_output('recover_settings', 'recover_settings_page', true, 'recover_settings', 'content_section_start', 'after');
+add_output('recover_settings', 'recover_settings_page', true, 'recover_settings', 'version_upgrade_checker', 'after');
 
 add_module_to_all_pages('handler', 'check_for_lost_settings', true, 'recover_settings', 'load_user_data', 'after');
 add_handler('ajax_hm_folders', 'check_for_lost_settings', true, 'recover_settings', 'load_user_data', 'after');
diff --git a/modules/sievefilters/setup.php b/modules/sievefilters/setup.php
index 7f22bdc6be..7b23ed81ef 100644
--- a/modules/sievefilters/setup.php
+++ b/modules/sievefilters/setup.php
@@ -18,7 +18,7 @@
 add_handler('ajax_imap_debug', 'sieve_connect', true, 'imap', 'imap_connect', 'after');
 
 // sieve filter
-add_output('sieve_filters', 'sievefilters_settings_start', true, 'sievefilters', 'content_section_start', 'after');
+add_output('sieve_filters', 'sievefilters_settings_start', true, 'sievefilters', 'version_upgrade_checker', 'after');
 add_output('ajax_hm_folders', 'sievefilters_settings_link', true, 'sievefilters', 'settings_menu_end', 'before');
 setup_base_ajax_page('ajax_account_sieve_filters', 'core');
 add_handler('ajax_account_sieve_filters', 'settings_load_imap', true, 'sievefilters', 'load_user_data', 'after');
@@ -28,7 +28,7 @@
 add_output('ajax_account_sieve_filters', 'check_filter_status', true, 'sievefilters');
 
 // block list
-add_output('block_list', 'blocklist_settings_start', true, 'sievefilters', 'content_section_start', 'after');
+add_output('block_list', 'blocklist_settings_start', true, 'sievefilters', 'version_upgrade_checker', 'after');
 setup_base_ajax_page('ajax_block_account_sieve_filters', 'core');
 add_handler('ajax_block_account_sieve_filters', 'settings_load_imap', true, 'sievefilters', 'load_user_data', 'after');
 add_handler('ajax_block_account_sieve_filters', 'load_behaviour', true, 'sievefilters', 'settings_load_imap', 'after');
diff --git a/modules/smtp/setup.php b/modules/smtp/setup.php
index c7659a4c8a..60cd8f4c08 100644
--- a/modules/smtp/setup.php
+++ b/modules/smtp/setup.php
@@ -13,7 +13,7 @@
 add_handler('compose', 'load_smtp_servers_from_config', true, 'smtp', 'load_smtp_reply_to_details', 'after');
 add_handler('compose', 'add_smtp_servers_to_page_data', true, 'smtp', 'load_smtp_servers_from_config', 'after');
 add_handler('compose', 'process_compose_form_submit', true, 'smtp', 'load_smtp_servers_from_config', 'after');
-add_output('compose', 'compose_title', true, 'smtp', 'content_section_start', 'after');
+add_output('compose', 'compose_title', true, 'smtp', 'version_upgrade_checker', 'after');
 add_output('compose', 'compose_form_start', true, 'smtp', 'compose_title', 'after');
 add_output('compose', 'compose_form_draft_list', true, 'smtp', 'compose_form_start', 'before');
 add_output('compose', 'compose_form_content', true, 'smtp', 'compose_form_start', 'after');
diff --git a/modules/tags/setup.php b/modules/tags/setup.php
index 03203ed5cd..8845578949 100644
--- a/modules/tags/setup.php
+++ b/modules/tags/setup.php
@@ -6,7 +6,7 @@
 output_source('tags');
 
 setup_base_page('tags');
-add_output('tags', 'tags_heading', true, 'core', 'content_section_start', 'after');
+add_output('tags', 'tags_heading', true, 'core', 'version_upgrade_checker', 'after');
 add_output('tags', 'tags_tree', true, 'core', 'tags_heading', 'after');
 add_output('tags', 'tags_form', true, 'core', 'tags_tree', 'after');
 

From 94ba7358e4c94e562010fc959d8bf8b5578925a5 Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sat, 22 Nov 2025 20:39:46 +0200
Subject: [PATCH 02/10] refactor the version checker to fetch all releases from
 a remote (github) to ensure accuracy in the alerts

TODO: - allow users to hide the alert for the session lifetime
---
 lib/version.php                   | 28 +++++++---------------
 modules/advanced_search/setup.php |  2 +-
 modules/core/output_modules.php   |  4 ++--
 releases.json                     | 39 +++++++++++++++++++++++++++++++
 4 files changed, 50 insertions(+), 23 deletions(-)
 create mode 100644 releases.json

diff --git a/lib/version.php b/lib/version.php
index a905194428..9e53ff11ae 100644
--- a/lib/version.php
+++ b/lib/version.php
@@ -1,28 +1,16 @@
 <?php
 
-define('CYPHT_VERSION', '3.0');
-define('CYPHT_BRANCH', 'dev'); // stable, beta, dev
+define('CYPHT_VERSION', '2.5.0');
 
-$installedVersion = env('CYPHT_INSTALLED_VERSION');
+// $releases = json_decode(file_get_contents('https://github.com/cypht-org/cypht/blob/master/releases.json?raw=true'), true);
+$releases = json_decode(file_get_contents(APP_PATH.'releases.json'), true); // TODO: This should be replaced by the line above in production
+$latestRelease = end($releases['release']);
 
-$needUpgrade = false;
-
-if (! $installedVersion && CYPHT_BRANCH !== 'dev') {
-    $needUpgrade = true;
-}
-
-if ($installedVersion && version_compare($installedVersion, CYPHT_VERSION, '<')) {
+if (version_compare(CYPHT_VERSION, $latestRelease['version'], '<')) {
     $needUpgrade = true;
-}
-
-$fileContent = file_get_contents(APP_PATH . '.env');
-if ($fileContent) {
-    if (strpos($fileContent, 'CYPHT_INSTALLED_VERSION=') === false) {
-        $fileContent .= "\nCYPHT_INSTALLED_VERSION=" . CYPHT_VERSION . "\n";
-    } else {
-        $fileContent = preg_replace('/CYPHT_INSTALLED_VERSION=.*/', 'CYPHT_INSTALLED_VERSION=' . CYPHT_VERSION, $fileContent);
-    }
-    file_put_contents(APP_PATH . '.env', $fileContent);
+} else {
+    $needUpgrade = false;
 }
 
 define('CYPHT_NEED_UPGRADE', $needUpgrade);
+define('CYPHT_LATEST_VERSION', $latestRelease['version']);
diff --git a/modules/advanced_search/setup.php b/modules/advanced_search/setup.php
index e36cd68f2f..6c74eb3ce8 100644
--- a/modules/advanced_search/setup.php
+++ b/modules/advanced_search/setup.php
@@ -8,7 +8,7 @@
 /* advanced search page */
 setup_base_page('advanced_search', 'core');
 add_handler('advanced_search', 'advanced_search_prepare', true, 'advanced_search', 'date', 'after');
-add_output('advanced_search', 'advanced_search_content_start', true, 'advanced_search', 'content_section_start', 'after');
+add_output('advanced_search', 'advanced_search_content_start', true, 'advanced_search', 'version_upgrade_checker', 'after');
 add_output('advanced_search', 'advanced_search_form_start', true, 'advanced_search', 'advanced_search_content_start', 'after');
 add_output('advanced_search', 'advanced_search_form_content', true, 'advanced_search', 'advanced_search_form_start', 'after');
 add_output('advanced_search', 'advanced_search_form_end', true, 'advanced_search', 'advanced_search_form_content', 'after');
diff --git a/modules/core/output_modules.php b/modules/core/output_modules.php
index e8dbe4991f..a7032e1ccc 100644
--- a/modules/core/output_modules.php
+++ b/modules/core/output_modules.php
@@ -2509,12 +2509,12 @@ protected function output() {
 class Hm_Output_version_upgrade_checker extends Hm_Output_Module {
     protected function output()
     {
-        // if (! CYPHT_NEED_UPGRADE) return '';
+        if (! CYPHT_NEED_UPGRADE) return '';
 
         return '
         <div class="alert alert-info alert-dismissible fade show d-flex align-items-center" role="alert">
             <i class="bi bi-info-circle-fill me-2"></i>
-            You are currently running Cypht version '.CYPHT_VERSION.'. A higher version is available. Please visit <a href="https://github.com/cypht-org/cypht/releases" target="_blank" class="ms-1 me-1">GitHub Releases</a> for the full list of available versions.
+            You are currently running Cypht version '.CYPHT_VERSION.'. A higher version (<b>'.CYPHT_LATEST_VERSION.'</b>) is available.
             <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
         </div>
         ';
diff --git a/releases.json b/releases.json
new file mode 100644
index 0000000000..ef27b23262
--- /dev/null
+++ b/releases.json
@@ -0,0 +1,39 @@
+{
+    "release": [
+        { "version": "1.0.0-rc1", "type": "beta" },
+        { "version": "1.0.0-rc2", "type": "beta" },
+        { "version": "1.0.0-rc3", "type": "beta" },
+        { "version": "1.0.0-rc4", "type": "beta" },
+        { "version": "1.0.0-rc5", "type": "beta" },
+        { "version": "1.0.0-rc6", "type": "beta" },
+        { "version": "1.0.0-rc7", "type": "beta" },
+        { "version": "1.0.0-rc8", "type": "beta" },
+        { "version": "1.0.0", "type": "stable" },
+        { "version": "1.1.0-rc1", "type": "beta" },
+        { "version": "1.1.0-rc2", "type": "beta" },
+        { "version": "1.1.0-rc3", "type": "beta" },
+        { "version": "1.1.0-rc4", "type": "beta" },
+        { "version": "1.1.0", "type": "stable" },
+        { "version": "1.3.0-rc1", "type": "beta" },
+        { "version": "1.3.0-rc2", "type": "beta" },
+        { "version": "1.3.0-rc3", "type": "beta" },
+        { "version": "1.3.0", "type": "stable" },
+        { "version": "1.4.0", "type": "stable" },
+        { "version": "1.4.1", "type": "stable" },
+        { "version": "1.4.2", "type": "stable" },
+        { "version": "1.4.3", "type": "stable" },
+        { "version": "2.0.0", "type": "stable" },
+        { "version": "2.0.1", "type": "stable" },
+        { "version": "2.1.0", "type": "stable" },
+        { "version": "1.4.4", "type": "stable" },
+        { "version": "2.2.0", "type": "stable" },
+        { "version": "2.3.0", "type": "stable" },
+        { "version": "2.4.0", "type": "stable" },
+        { "version": "1.4.5", "type": "stable" },
+        { "version": "1.4.6", "type": "stable" },
+        { "version": "2.4.1", "type": "stable" },
+        { "version": "2.4.2", "type": "stable" },
+        { "version": "2.5.0", "type": "stable" },
+        { "version": "2.5.1", "type": "stable" }
+    ]
+}
\ No newline at end of file

From 6a47daa52d1136814e6126c4f550523005799cba Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sun, 23 Nov 2025 16:05:46 +0200
Subject: [PATCH 03/10] allow users to hide the alert for the session lifetime

---
 modules/core/output_modules.php | 2 +-
 modules/core/site.js            | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/modules/core/output_modules.php b/modules/core/output_modules.php
index a7032e1ccc..da21776f96 100644
--- a/modules/core/output_modules.php
+++ b/modules/core/output_modules.php
@@ -2512,7 +2512,7 @@ protected function output()
         if (! CYPHT_NEED_UPGRADE) return '';
 
         return '
-        <div class="alert alert-info alert-dismissible fade show d-flex align-items-center" role="alert">
+        <div class="alert alert-info alert-dismissible fade d-flex align-items-center" role="alert" id="cypht-upgrade-alert">
             <i class="bi bi-info-circle-fill me-2"></i>
             You are currently running Cypht version '.CYPHT_VERSION.'. A higher version (<b>'.CYPHT_LATEST_VERSION.'</b>) is available.
             <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
diff --git a/modules/core/site.js b/modules/core/site.js
index 592958d9be..88297d7416 100644
--- a/modules/core/site.js
+++ b/modules/core/site.js
@@ -2605,3 +2605,10 @@ document.addEventListener("show.bs.dropdown", function (event) {
     });
 });
 
+document.getElementById("cypht-upgrade-alert")?.addEventListener("close.bs.alert", function () {
+    Hm_Utils.save_to_local_storage('cypht_upgrade_alert_dismissed', '1');
+});
+if (Hm_Utils.get_from_local_storage('cypht_upgrade_alert_dismissed') !== '1') {
+    $("#cypht-upgrade-alert").addClass("show");
+}
+

From 05d246fa718c3ba9ace7e40bb033daaf36eda7d0 Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sun, 23 Nov 2025 17:08:50 +0200
Subject: [PATCH 04/10] fix unit tests

---
 tests/phpunit/modules/core/functions.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/phpunit/modules/core/functions.php b/tests/phpunit/modules/core/functions.php
index 1ad05eaca7..076dbcab45 100644
--- a/tests/phpunit/modules/core/functions.php
+++ b/tests/phpunit/modules/core/functions.php
@@ -166,7 +166,7 @@ public function test_setup_base_page() {
         $res2 = Hm_Output_Modules::dump();
         $len2 = count($res2['foo']);
         $this->assertEquals(12, $len);
-        $this->assertEquals(19, $len2);
+        $this->assertEquals(20, $len2);
     }
     /**
      * @preserveGlobalState disabled

From b2bf1c75af4a60a161be15a780dee5842d1111bb Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sun, 23 Nov 2025 17:10:16 +0200
Subject: [PATCH 05/10] fetch releases list from remote file

---
 lib/version.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/version.php b/lib/version.php
index 9e53ff11ae..77bb762c75 100644
--- a/lib/version.php
+++ b/lib/version.php
@@ -2,8 +2,7 @@
 
 define('CYPHT_VERSION', '2.5.0');
 
-// $releases = json_decode(file_get_contents('https://github.com/cypht-org/cypht/blob/master/releases.json?raw=true'), true);
-$releases = json_decode(file_get_contents(APP_PATH.'releases.json'), true); // TODO: This should be replaced by the line above in production
+$releases = json_decode(file_get_contents('https://github.com/cypht-org/cypht/blob/master/releases.json?raw=true'), true);
 $latestRelease = end($releases['release']);
 
 if (version_compare(CYPHT_VERSION, $latestRelease['version'], '<')) {

From 0dfe590af1f9d0264e664bbbe1725899a630a11c Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sun, 23 Nov 2025 17:47:29 +0200
Subject: [PATCH 06/10] a fix to ensure that alert is still shown after
 navigating to a different page, and positionned at the top across all pages

---
 modules/contacts/setup.php      |  2 +-
 modules/core/output_modules.php |  2 +-
 modules/core/setup.php          | 10 +++++-----
 modules/core/site.js            | 16 ++++++++++------
 modules/developer/setup.php     |  4 ++--
 5 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/modules/contacts/setup.php b/modules/contacts/setup.php
index ae591dad8d..942d6165f7 100644
--- a/modules/contacts/setup.php
+++ b/modules/contacts/setup.php
@@ -11,7 +11,7 @@
 
 add_handler('contacts', 'load_contacts', true, 'contacts', 'load_user_data', 'after');
 add_handler('contacts', 'check_imported_contacts', true, 'contacts', 'load_user_data', 'after');
-add_output('contacts', 'contacts_content_start', true, 'contacts', 'content_section_start', 'after');
+add_output('contacts', 'contacts_content_start', true, 'contacts', 'version_upgrade_checker', 'after');
 add_output('contacts', 'contacts_list', true, 'contacts', 'contacts_content_start', 'after');
 add_output('contacts', 'contacts_content_end', true, 'contacts', 'contacts_list', 'after');
 add_output('settings', 'contact_auto_collect_setting', true, 'contacts', 'max_google_contacts_number', 'after');
diff --git a/modules/core/output_modules.php b/modules/core/output_modules.php
index da21776f96..fe019ad01e 100644
--- a/modules/core/output_modules.php
+++ b/modules/core/output_modules.php
@@ -2512,7 +2512,7 @@ protected function output()
         if (! CYPHT_NEED_UPGRADE) return '';
 
         return '
-        <div class="alert alert-info alert-dismissible fade d-flex align-items-center" role="alert" id="cypht-upgrade-alert">
+        <div class="alert alert-info alert-dismissible fade align-items-center" role="alert" id="cypht-upgrade-alert">
             <i class="bi bi-info-circle-fill me-2"></i>
             You are currently running Cypht version '.CYPHT_VERSION.'. A higher version (<b>'.CYPHT_LATEST_VERSION.'</b>) is available.
             <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
diff --git a/modules/core/setup.php b/modules/core/setup.php
index 5c9844ed24..08e12c92f6 100644
--- a/modules/core/setup.php
+++ b/modules/core/setup.php
@@ -69,7 +69,7 @@
 add_handler('settings', 'reload_folder_cookie', true, 'core', 'save_user_settings', 'after');
 add_handler('settings', 'privacy_settings', true, 'core', 'date', 'after');
 
-add_output('settings', 'start_settings_form', true, 'core', 'content_section_start', 'after');
+add_output('settings', 'start_settings_form', true, 'core', 'version_upgrade_checker', 'after');
 add_output('settings', 'start_search_settings', true, 'core', 'start_settings_form', 'after');
 add_output('settings', 'start_general_settings', true, 'core', 'start_search_settings', 'after');
 add_output('settings', 'language_setting', true, 'core', 'start_general_settings', 'after');
@@ -113,14 +113,14 @@
 /* message list page */
 setup_base_page('message_list');
 add_handler('message_list', 'default_sort_order_setting', true, 'core', 'load_user_data', 'after');
-add_output('message_list', 'message_list_heading', true, 'core', 'content_section_start', 'after');
+add_output('message_list', 'message_list_heading', true, 'core', 'version_upgrade_checker', 'after');
 add_output('message_list', 'message_list_start', true, 'core', 'message_list_heading', 'after');
 add_output('message_list', 'message_list_end', true, 'core', 'message_list_start', 'after');
 
 /* search page */
 setup_base_page('search');
 add_handler('search', 'default_sort_order_setting', true, 'core', 'load_user_data', 'after');
-add_output('search', 'search_content_start', true, 'core', 'content_section_start', 'after');
+add_output('search', 'search_content_start', true, 'core', 'version_upgrade_checker', 'after');
 add_output('search', 'search_form_start', true, 'core', 'search_content_start', 'after');
 add_output('search', 'search_form_content', true, 'core', 'search_form_start', 'after');
 add_output('search', 'search_form_end', true, 'core', 'search_form_content', 'after');
@@ -139,12 +139,12 @@
 
 /* message view page */
 setup_base_page('message');
-add_output('message', 'message_start', true, 'core', 'content_section_start', 'after');
+add_output('message', 'message_start', true, 'core', 'version_upgrade_checker', 'after');
 add_output('message', 'message_end', true, 'core', 'message_start', 'after');
 
 /* not-found page data and output */
 setup_base_page('notfound');
-add_output('notfound', 'notfound_content', true, 'core', 'content_section_start', 'after');
+add_output('notfound', 'notfound_content', true, 'core', 'version_upgrade_checker', 'after');
 
 /* message action ajax request */
 setup_base_ajax_page('ajax_message_action', 'core');
diff --git a/modules/core/site.js b/modules/core/site.js
index 88297d7416..b8f2815875 100644
--- a/modules/core/site.js
+++ b/modules/core/site.js
@@ -2605,10 +2605,14 @@ document.addEventListener("show.bs.dropdown", function (event) {
     });
 });
 
-document.getElementById("cypht-upgrade-alert")?.addEventListener("close.bs.alert", function () {
-    Hm_Utils.save_to_local_storage('cypht_upgrade_alert_dismissed', '1');
-});
-if (Hm_Utils.get_from_local_storage('cypht_upgrade_alert_dismissed') !== '1') {
-    $("#cypht-upgrade-alert").addClass("show");
-}
+window.addEventListener('page-change', () => {
+    document.getElementById("cypht-upgrade-alert")?.addEventListener("close.bs.alert", function () {
+        Hm_Utils.save_to_local_storage('cypht_upgrade_alert_dismissed', '1');
+    });
+    if (Hm_Utils.get_from_local_storage('cypht_upgrade_alert_dismissed') !== '1') {
+        $("#cypht-upgrade-alert").addClass("show");
+    } else {
+        $("#cypht-upgrade-alert").addClass("hide");
+    }
+})
 
diff --git a/modules/developer/setup.php b/modules/developer/setup.php
index 79a12d650b..b99fdce580 100644
--- a/modules/developer/setup.php
+++ b/modules/developer/setup.php
@@ -12,7 +12,7 @@
     /* info page */
     setup_base_page('info', 'core');
     add_handler('info', 'process_server_info', true, 'developer', 'load_user_data', 'after');
-    add_output('info', 'info_heading', true, 'developer', 'content_section_start', 'after');
+    add_output('info', 'info_heading', true, 'developer', 'version_upgrade_checker', 'after');
     add_output('info', 'server_information', true, 'developer', 'info_heading', 'after');
     add_output('info', 'server_status_start', true, 'developer', 'server_information', 'after');
     add_output('info', 'server_status_end', true, 'developer', 'server_status_start', 'after');
@@ -26,7 +26,7 @@
 
     /* developer docs */
     setup_base_page('dev', 'core');
-    add_output('dev', 'dev_content', true, 'developer', 'content_section_start', 'after');
+    add_output('dev', 'dev_content', true, 'developer', 'version_upgrade_checker', 'after');
 
     /* add pages */
     return array(

From 21fea154432678f40b62d17c2d314df96096d17e Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Sun, 23 Nov 2025 17:48:22 +0200
Subject: [PATCH 07/10] update version to the upcoming release

---
 lib/version.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/version.php b/lib/version.php
index 77bb762c75..a3a222cf84 100644
--- a/lib/version.php
+++ b/lib/version.php
@@ -1,6 +1,6 @@
 <?php
 
-define('CYPHT_VERSION', '2.5.0');
+define('CYPHT_VERSION', '2.5.2');
 
 $releases = json_decode(file_get_contents('https://github.com/cypht-org/cypht/blob/master/releases.json?raw=true'), true);
 $latestRelease = end($releases['release']);

From a04886d4014197818d1e6b44f6b0182198092b80 Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Wed, 26 Nov 2025 16:42:28 +0200
Subject: [PATCH 08/10] fetch releases data from github api

---
 lib/version.php                  | 12 ------------
 modules/core/functions.php       |  1 +
 modules/core/handler_modules.php | 28 ++++++++++++++++++++++++++++
 modules/core/output_modules.php  |  6 ++++--
 4 files changed, 33 insertions(+), 14 deletions(-)

diff --git a/lib/version.php b/lib/version.php
index a3a222cf84..80e5eb2c6e 100644
--- a/lib/version.php
+++ b/lib/version.php
@@ -1,15 +1,3 @@
 <?php
 
 define('CYPHT_VERSION', '2.5.2');
-
-$releases = json_decode(file_get_contents('https://github.com/cypht-org/cypht/blob/master/releases.json?raw=true'), true);
-$latestRelease = end($releases['release']);
-
-if (version_compare(CYPHT_VERSION, $latestRelease['version'], '<')) {
-    $needUpgrade = true;
-} else {
-    $needUpgrade = false;
-}
-
-define('CYPHT_NEED_UPGRADE', $needUpgrade);
-define('CYPHT_LATEST_VERSION', $latestRelease['version']);
diff --git a/modules/core/functions.php b/modules/core/functions.php
index 7d103186d7..16dd34fb9c 100644
--- a/modules/core/functions.php
+++ b/modules/core/functions.php
@@ -425,6 +425,7 @@ function setup_base_page($name, $source=false, $use_layout=true) {
     add_handler($name, 'save_user_data', true, $source);
     add_handler($name, 'logout', true, $source);
     add_handler($name, 'http_headers', true, $source);
+    add_handler($name, 'version_upgrade_checker', true, $source);
 
     add_output($name, 'header_start', false, $source);
     add_output($name, 'header_css', false, $source);
diff --git a/modules/core/handler_modules.php b/modules/core/handler_modules.php
index c15dd08fcd..6ab79477ae 100644
--- a/modules/core/handler_modules.php
+++ b/modules/core/handler_modules.php
@@ -1207,3 +1207,31 @@ public function process() {
         }
     }
 }
+
+class Hm_Handler_version_upgrade_checker extends Hm_Handler_Module {
+
+    public function process()
+    {
+        if ($this->session->get('latest_version')) {
+            $latestVersion = $this->session->get('latest_version');
+        } else {
+            $api = new Hm_API_Curl();
+            $data = $api->command('https://api.github.com/repos/cypht-org/cypht/releases');
+
+            if ($api->last_status == 200) {
+                $latestRelease = reset($data);
+                $latestVersion = substr($latestRelease['tag_name'], 1);
+
+                $this->session->set('latest_version', $latestVersion);
+            }
+        }
+
+        if (version_compare(CYPHT_VERSION, $latestVersion, '<')) {
+            $needUpgrade = true;
+        } else {
+            $needUpgrade = false;
+        }
+        $this->out('need_upgrade', $needUpgrade);
+        $this->out('latest_version', $latestVersion);
+    }
+}
diff --git a/modules/core/output_modules.php b/modules/core/output_modules.php
index 81b44f1265..5542921bad 100644
--- a/modules/core/output_modules.php
+++ b/modules/core/output_modules.php
@@ -2518,12 +2518,14 @@ protected function output() {
 class Hm_Output_version_upgrade_checker extends Hm_Output_Module {
     protected function output()
     {
-        if (! CYPHT_NEED_UPGRADE) return '';
+        if (! $this->get('need_upgrade')) return '';
+
+        $latestVersion = $this->get('latest_version');
 
         return '
         <div class="alert alert-info alert-dismissible fade align-items-center" role="alert" id="cypht-upgrade-alert">
             <i class="bi bi-info-circle-fill me-2"></i>
-            You are currently running Cypht version '.CYPHT_VERSION.'. A higher version (<b>'.CYPHT_LATEST_VERSION.'</b>) is available.
+            You are currently running Cypht version '.CYPHT_VERSION.'. A higher version (<b>'. $latestVersion .'</b>) is available.
             <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
         </div>
         ';

From 1666cd7aacbb229b9535f20339e1c03cddda3c7c Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Wed, 26 Nov 2025 16:51:21 +0200
Subject: [PATCH 09/10] fix unit test

---
 tests/phpunit/modules/core/functions.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/phpunit/modules/core/functions.php b/tests/phpunit/modules/core/functions.php
index 076dbcab45..b944bf43cd 100644
--- a/tests/phpunit/modules/core/functions.php
+++ b/tests/phpunit/modules/core/functions.php
@@ -165,7 +165,7 @@ public function test_setup_base_page() {
         $len =  count($res['foo']);
         $res2 = Hm_Output_Modules::dump();
         $len2 = count($res2['foo']);
-        $this->assertEquals(12, $len);
+        $this->assertEquals(13, $len);
         $this->assertEquals(20, $len2);
     }
     /**

From b9efafe15675308865e954492fffafc064e2e06f Mon Sep 17 00:00:00 2001
From: Merci Jacob <mercihabam@gmail.com>
Date: Thu, 27 Nov 2025 12:38:56 +0200
Subject: [PATCH 10/10] remove releases.json

---
 releases.json | 39 ---------------------------------------
 1 file changed, 39 deletions(-)
 delete mode 100644 releases.json

diff --git a/releases.json b/releases.json
deleted file mode 100644
index ef27b23262..0000000000
--- a/releases.json
+++ /dev/null
@@ -1,39 +0,0 @@
-{
-    "release": [
-        { "version": "1.0.0-rc1", "type": "beta" },
-        { "version": "1.0.0-rc2", "type": "beta" },
-        { "version": "1.0.0-rc3", "type": "beta" },
-        { "version": "1.0.0-rc4", "type": "beta" },
-        { "version": "1.0.0-rc5", "type": "beta" },
-        { "version": "1.0.0-rc6", "type": "beta" },
-        { "version": "1.0.0-rc7", "type": "beta" },
-        { "version": "1.0.0-rc8", "type": "beta" },
-        { "version": "1.0.0", "type": "stable" },
-        { "version": "1.1.0-rc1", "type": "beta" },
-        { "version": "1.1.0-rc2", "type": "beta" },
-        { "version": "1.1.0-rc3", "type": "beta" },
-        { "version": "1.1.0-rc4", "type": "beta" },
-        { "version": "1.1.0", "type": "stable" },
-        { "version": "1.3.0-rc1", "type": "beta" },
-        { "version": "1.3.0-rc2", "type": "beta" },
-        { "version": "1.3.0-rc3", "type": "beta" },
-        { "version": "1.3.0", "type": "stable" },
-        { "version": "1.4.0", "type": "stable" },
-        { "version": "1.4.1", "type": "stable" },
-        { "version": "1.4.2", "type": "stable" },
-        { "version": "1.4.3", "type": "stable" },
-        { "version": "2.0.0", "type": "stable" },
-        { "version": "2.0.1", "type": "stable" },
-        { "version": "2.1.0", "type": "stable" },
-        { "version": "1.4.4", "type": "stable" },
-        { "version": "2.2.0", "type": "stable" },
-        { "version": "2.3.0", "type": "stable" },
-        { "version": "2.4.0", "type": "stable" },
-        { "version": "1.4.5", "type": "stable" },
-        { "version": "1.4.6", "type": "stable" },
-        { "version": "2.4.1", "type": "stable" },
-        { "version": "2.4.2", "type": "stable" },
-        { "version": "2.5.0", "type": "stable" },
-        { "version": "2.5.1", "type": "stable" }
-    ]
-}
\ No newline at end of file