From 19d75ab7b21389b0393649edce34f6a777926377 Mon Sep 17 00:00:00 2001
From: magdev <magdev3.0@gmail.com>
Date: Mon, 2 Feb 2026 21:09:14 +0100
Subject: [PATCH] feat: Add option to disable early mode (v0.4.2)

- Add wp_prometheus_disable_early_mode option in admin settings
- Support WP_PROMETHEUS_DISABLE_EARLY_MODE environment variable
- Add Early Mode section in Metrics tab with status indicator
- Allow users to enable wp_prometheus_collect_metrics hook

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 CHANGELOG.md                     |  13 ++++++
 CLAUDE.md                        |  18 +++++++++
 languages/wp-prometheus-de_CH.mo | Bin 18211 -> 20435 bytes
 languages/wp-prometheus-de_CH.po |  42 +++++++++++++++++++-
 languages/wp-prometheus.pot      |  42 +++++++++++++++++++-
 src/Admin/Settings.php           |  66 +++++++++++++++++++++++++++++++
 wp-prometheus.php                |  16 +++++++-
 7 files changed, 193 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 29220c3..adc7bd9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.2] - 2026-02-02
+
+### Added
+
+- Option to disable early mode in admin settings (Metrics tab)
+- Support for `WP_PROMETHEUS_DISABLE_EARLY_MODE` environment variable
+- Early mode status display in settings
+
+### Changed
+
+- Early mode can now be disabled for users who need the `wp_prometheus_collect_metrics` hook for custom metrics
+- Updated translations with new early mode strings (English and German)
+
 ## [0.4.1] - 2026-02-02
 
 ### Fixed
diff --git a/CLAUDE.md b/CLAUDE.md
index f6c518f..8fadf55 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -291,6 +291,24 @@ add_action( 'wp_prometheus_collect_metrics', function( $collector ) {
 
 ## Session History
 
+### 2026-02-02 - Early Mode Toggle (v0.4.2)
+
+- Added option to disable early mode for users who need extensibility
+- Implementation:
+  - Added `wp_prometheus_disable_early_mode` WordPress option
+  - Added `WP_PROMETHEUS_DISABLE_EARLY_MODE` environment variable support
+  - Option check in `wp_prometheus_early_metrics_check()` before early interception
+  - Environment variable accepts `1`, `true`, `yes`, `on` (case-insensitive)
+- Admin UI in Metrics tab:
+  - "Early Mode" section with description of functionality
+  - Checkbox to disable early metrics interception
+  - Environment override notice when env var is set
+  - Current status indicator showing early mode state
+- **Key Learning**: Balancing compatibility vs extensibility
+  - Early mode fixes memory issues but disables `wp_prometheus_collect_metrics` hook
+  - Users with custom metrics need the hook, so early mode must be optional
+  - Default remains enabled (safe) with explicit opt-out for advanced users
+
 ### 2026-02-02 - Plugin Compatibility Fix (v0.4.1)
 
 - Fixed memory exhaustion (1GB limit) when wp-fedistream (Twig-based) plugin is active
diff --git a/languages/wp-prometheus-de_CH.mo b/languages/wp-prometheus-de_CH.mo
index 94f2636acd300111c1b56c1eedef8c4ec5706627..0ec05dd725ad892890268fba3a35f9cf469e1577 100644
GIT binary patch
delta 6589
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
Ht;+j9-j!8S

delta 4698
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

diff --git a/languages/wp-prometheus-de_CH.po b/languages/wp-prometheus-de_CH.po
index aa79840..4dd24e4 100644
--- a/languages/wp-prometheus-de_CH.po
+++ b/languages/wp-prometheus-de_CH.po
@@ -3,7 +3,7 @@
 # This file is distributed under the GPL v2 or later.
 msgid ""
 msgstr ""
-"Project-Id-Version: WP Prometheus 0.4.0\n"
+"Project-Id-Version: WP Prometheus 0.4.2\n"
 "Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/magdev/wp-prometheus/issues\n"
 "POT-Creation-Date: 2026-02-02T00:00:00+00:00\n"
 "PO-Revision-Date: 2026-02-02T00:00:00+00:00\n"
@@ -879,3 +879,43 @@ msgstr "APCu funktioniert. Speicher: %s belegt."
 #: src/Metrics/StorageFactory.php
 msgid "APCu fetch operation returned unexpected value."
 msgstr "APCu-Abrufoperation hat unerwarteten Wert zurueckgegeben."
+
+#: src/Admin/Settings.php
+msgid "Early Mode"
+msgstr "Fruehzeitiger Modus"
+
+#: src/Admin/Settings.php
+msgid "Early mode intercepts /metrics requests before full WordPress initialization. This prevents memory exhaustion issues caused by some plugins (e.g., Twig-based themes/plugins) but disables the wp_prometheus_collect_metrics hook for custom metrics."
+msgstr "Der fruehzeitige Modus faengt /metrics-Anfragen vor der vollstaendigen WordPress-Initialisierung ab. Dies verhindert Speichererschoepfungsprobleme, die durch einige Plugins verursacht werden (z.B. Twig-basierte Themes/Plugins), deaktiviert jedoch den wp_prometheus_collect_metrics-Hook fuer benutzerdefinierte Metriken."
+
+#: src/Admin/Settings.php
+msgid "Early mode is configured via WP_PROMETHEUS_DISABLE_EARLY_MODE environment variable. Admin settings will be ignored."
+msgstr "Der fruehzeitige Modus ist ueber die Umgebungsvariable WP_PROMETHEUS_DISABLE_EARLY_MODE konfiguriert. Admin-Einstellungen werden ignoriert."
+
+#: src/Admin/Settings.php
+msgid "Disable Early Mode"
+msgstr "Fruehzeitigen Modus deaktivieren"
+
+#: src/Admin/Settings.php
+msgid "Disable early metrics interception"
+msgstr "Fruehzeitige Metriken-Abfangung deaktivieren"
+
+#: src/Admin/Settings.php
+msgid "When disabled, metrics are collected through normal WordPress template loading. This enables the wp_prometheus_collect_metrics hook for custom metrics but may cause issues with some plugins."
+msgstr "Wenn deaktiviert, werden Metriken ueber das normale WordPress-Template-Laden erfasst. Dies aktiviert den wp_prometheus_collect_metrics-Hook fuer benutzerdefinierte Metriken, kann jedoch Probleme mit einigen Plugins verursachen."
+
+#: src/Admin/Settings.php
+msgid "Early mode is active (this request was served via early interception)"
+msgstr "Fruehzeitiger Modus ist aktiv (diese Anfrage wurde ueber fruehzeitige Abfangung verarbeitet)"
+
+#: src/Admin/Settings.php
+msgid "Early mode is disabled"
+msgstr "Fruehzeitiger Modus ist deaktiviert"
+
+#: src/Admin/Settings.php
+msgid "Early mode is enabled (active for /metrics requests)"
+msgstr "Fruehzeitiger Modus ist aktiviert (aktiv fuer /metrics-Anfragen)"
+
+#: src/Admin/Settings.php
+msgid "Clear all accumulated runtime metric data (HTTP requests, database queries). This is useful for testing or starting fresh."
+msgstr "Alle gesammelten Laufzeit-Metrikdaten loeschen (HTTP-Anfragen, Datenbank-Abfragen). Dies ist nuetzlich zum Testen oder fuer einen Neuanfang."
diff --git a/languages/wp-prometheus.pot b/languages/wp-prometheus.pot
index 52a8a1c..2e86aa8 100644
--- a/languages/wp-prometheus.pot
+++ b/languages/wp-prometheus.pot
@@ -2,7 +2,7 @@
 # This file is distributed under the GPL v2 or later.
 msgid ""
 msgstr ""
-"Project-Id-Version: WP Prometheus 0.4.0\n"
+"Project-Id-Version: WP Prometheus 0.4.2\n"
 "Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/magdev/wp-prometheus/issues\n"
 "POT-Creation-Date: 2026-02-02T00:00:00+00:00\n"
 "MIME-Version: 1.0\n"
@@ -876,3 +876,43 @@ msgstr ""
 #: src/Metrics/StorageFactory.php
 msgid "APCu fetch operation returned unexpected value."
 msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early Mode"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early mode intercepts /metrics requests before full WordPress initialization. This prevents memory exhaustion issues caused by some plugins (e.g., Twig-based themes/plugins) but disables the wp_prometheus_collect_metrics hook for custom metrics."
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early mode is configured via WP_PROMETHEUS_DISABLE_EARLY_MODE environment variable. Admin settings will be ignored."
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Disable Early Mode"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Disable early metrics interception"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "When disabled, metrics are collected through normal WordPress template loading. This enables the wp_prometheus_collect_metrics hook for custom metrics but may cause issues with some plugins."
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early mode is active (this request was served via early interception)"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early mode is disabled"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Early mode is enabled (active for /metrics requests)"
+msgstr ""
+
+#: src/Admin/Settings.php
+msgid "Clear all accumulated runtime metric data (HTTP requests, database queries). This is useful for testing or starting fresh."
+msgstr ""
diff --git a/src/Admin/Settings.php b/src/Admin/Settings.php
index 8ee4167..0761488 100644
--- a/src/Admin/Settings.php
+++ b/src/Admin/Settings.php
@@ -118,6 +118,12 @@ class Settings {
 			'sanitize_callback' => array( $this, 'sanitize_metrics' ),
 		) );
 
+		register_setting( 'wp_prometheus_metrics_settings', 'wp_prometheus_disable_early_mode', array(
+			'type'              => 'boolean',
+			'sanitize_callback' => 'rest_sanitize_boolean',
+			'default'           => false,
+		) );
+
 		// Auth token section.
 		add_settings_section(
 			'wp_prometheus_auth_section',
@@ -420,6 +426,66 @@ class Settings {
 			<span id="wp-prometheus-reset-spinner" class="spinner" style="float: none;"></span>
 		</p>
 		<div id="wp-prometheus-reset-message" style="display: none; margin-top: 10px;"></div>
+
+		<hr style="margin: 30px 0;">
+
+		<?php $this->render_early_mode_section(); ?>
+		<?php
+	}
+
+	/**
+	 * Render early mode section.
+	 *
+	 * @return void
+	 */
+	private function render_early_mode_section(): void {
+		$disabled       = get_option( 'wp_prometheus_disable_early_mode', false );
+		$env_override   = false !== getenv( 'WP_PROMETHEUS_DISABLE_EARLY_MODE' );
+		$early_active   = defined( 'WP_PROMETHEUS_EARLY_METRICS' ) && WP_PROMETHEUS_EARLY_METRICS;
+		?>
+		<h3><?php esc_html_e( 'Early Mode', 'wp-prometheus' ); ?></h3>
+		<p class="description">
+			<?php esc_html_e( 'Early mode intercepts /metrics requests before full WordPress initialization. This prevents memory exhaustion issues caused by some plugins (e.g., Twig-based themes/plugins) but disables the wp_prometheus_collect_metrics hook for custom metrics.', 'wp-prometheus' ); ?>
+		</p>
+
+		<?php if ( $env_override ) : ?>
+			<div class="notice notice-info inline" style="padding: 12px; margin: 15px 0;">
+				<strong><?php esc_html_e( 'Environment Override Active', 'wp-prometheus' ); ?></strong>
+				<p><?php esc_html_e( 'Early mode is configured via WP_PROMETHEUS_DISABLE_EARLY_MODE environment variable. Admin settings will be ignored.', 'wp-prometheus' ); ?></p>
+			</div>
+		<?php endif; ?>
+
+		<table class="form-table" role="presentation">
+			<tr>
+				<th scope="row"><?php esc_html_e( 'Disable Early Mode', 'wp-prometheus' ); ?></th>
+				<td>
+					<label>
+						<input type="checkbox" name="wp_prometheus_disable_early_mode" value="1"
+							<?php checked( $disabled ); ?>
+							<?php disabled( $env_override ); ?>>
+						<?php esc_html_e( 'Disable early metrics interception', 'wp-prometheus' ); ?>
+					</label>
+					<p class="description">
+						<?php esc_html_e( 'When disabled, metrics are collected through normal WordPress template loading. This enables the wp_prometheus_collect_metrics hook for custom metrics but may cause issues with some plugins.', 'wp-prometheus' ); ?>
+					</p>
+				</td>
+			</tr>
+			<tr>
+				<th scope="row"><?php esc_html_e( 'Current Status', 'wp-prometheus' ); ?></th>
+				<td>
+					<?php if ( $early_active ) : ?>
+						<span class="dashicons dashicons-yes-alt" style="color: green;"></span>
+						<?php esc_html_e( 'Early mode is active (this request was served via early interception)', 'wp-prometheus' ); ?>
+					<?php elseif ( $disabled || $env_override ) : ?>
+						<span class="dashicons dashicons-dismiss" style="color: gray;"></span>
+						<?php esc_html_e( 'Early mode is disabled', 'wp-prometheus' ); ?>
+					<?php else : ?>
+						<span class="dashicons dashicons-yes-alt" style="color: green;"></span>
+						<?php esc_html_e( 'Early mode is enabled (active for /metrics requests)', 'wp-prometheus' ); ?>
+					<?php endif; ?>
+				</td>
+			</tr>
+		</table>
 		<?php
 	}
 
diff --git a/wp-prometheus.php b/wp-prometheus.php
index f2d4ee1..3f06af6 100644
--- a/wp-prometheus.php
+++ b/wp-prometheus.php
@@ -3,7 +3,7 @@
  * Plugin Name: WP Prometheus
  * Plugin URI: https://src.bundespruefstelle.ch/magdev/wp-prometheus
  * Description: Prometheus metrics endpoint for WordPress with extensible hooks for custom metrics.
- * Version: 0.4.1
+ * Version: 0.4.2
  * Requires at least: 6.4
  * Requires PHP: 8.3
  * Author: Marco Graetsch
@@ -37,6 +37,18 @@ function wp_prometheus_early_metrics_check(): void {
         return;
     }
 
+    // Check if early mode is disabled via environment variable.
+    $env_disable = getenv( 'WP_PROMETHEUS_DISABLE_EARLY_MODE' );
+    if ( false !== $env_disable && in_array( strtolower( $env_disable ), array( '1', 'true', 'yes', 'on' ), true ) ) {
+        return;
+    }
+
+    // Check if early mode is disabled via option.
+    // We can use get_option() here because WordPress core is already loaded.
+    if ( get_option( 'wp_prometheus_disable_early_mode', false ) ) {
+        return;
+    }
+
     // Check if autoloader exists.
     $autoloader = __DIR__ . '/vendor/autoload.php';
     if ( ! file_exists( $autoloader ) ) {
@@ -118,7 +130,7 @@ wp_prometheus_early_metrics_check();
  *
  * @var string
  */
-define( 'WP_PROMETHEUS_VERSION', '0.4.1' );
+define( 'WP_PROMETHEUS_VERSION', '0.4.2' );
 
 /**
  * Plugin file path.