Add ConfigurationHelper for centralized config access

Introduces a ConfigurationHelper class to provide cached, singleton-based access to WPGraphQL Logging configuration. Refactors settings and config retrieval throughout the plugin to use this helper, improving performance, consistency, and cache management. Updates related classes and documentation to use the new approach and initializes automatic cache invalidation in the main plugin setup.

Author: colinmurphy

plugins/wpgraphql-logging/docs/ConfigurationHelper.md

@@ -0,0 +1,105 @@
+# Configuration Helper Usage Examples
+
+The `ConfigurationHelper` class provides a centralized and cached way to access WPGraphQL Logging configuration. This class implements a singleton pattern to ensure configuration is only loaded once per request and provides convenient methods for accessing different configuration sections.
+
+## Basic Usage
+
+### Getting the Configuration Helper Instance
+
+```php
+use WPGraphQL\Logging\Admin\Settings\ConfigurationHelper;
+
+$config_helper = ConfigurationHelper::get_instance();
+```
+
+### Getting Full Configuration
+
+```php
+$config_helper = ConfigurationHelper::get_instance();
+$full_config = $config_helper->get_config();
+```
+
+### Getting Configuration Sections
+
+```php
+$config_helper = ConfigurationHelper::get_instance();
+
+// Get basic configuration
+$basic_config = $config_helper->get_basic_config();
+
+// Get data management configuration
+$data_management_config = $config_helper->get_data_management_config();
+
+// Get any custom section
+$custom_section = $config_helper->get_section_config('custom_section', []);
+```
+
+### Getting Specific Settings
+
+```php
+$config_helper = ConfigurationHelper::get_instance();
+
+// Get a specific setting from a section
+$log_level = $config_helper->get_setting('basic_configuration', 'log_level', 'info');
+
+// Check if a feature is enabled
+$is_sanitization_enabled = $config_helper->is_enabled('data_management', 'data_sanitization_enabled');
+```
+
+## Migration from Direct get_option() Usage
+
+### Before (old approach):
+```php
+$full_config = get_option( WPGRAPHQL_LOGGING_SETTINGS_KEY, [] );
+$basic_config = $full_config['basic_configuration'] ?? [];
+$log_level = $basic_config['log_level'] ?? 'info';
+```
+
+### After (using ConfigurationHelper):
+```php
+$config_helper = ConfigurationHelper::get_instance();
+$log_level = $config_helper->get_setting('basic_configuration', 'log_level', 'info');
+```
+
+## Cache Management
+
+### Clearing Cache
+```php
+$config_helper = ConfigurationHelper::get_instance();
+$config_helper->clear_cache(); // Clears cache, next access will reload from DB
+```
+
+### Force Reload
+```php
+$config_helper = ConfigurationHelper::get_instance();
+$config_helper->reload_config(); // Clears cache and immediately reloads
+```
+
+## Benefits
+
+1. **Performance**: Configuration is cached in memory and only loaded once per request
+2. **Consistency**: Centralized access point prevents inconsistent configuration retrieval
+3. **Convenience**: Convenient methods for common access patterns
+4. **Cache Management**: Automatic cache invalidation when settings are updated
+5. **Type Safety**: Better type hints and documentation
+
+## Automatic Cache Invalidation
+
+The ConfigurationHelper automatically clears its cache when WordPress settings are updated. This is initialized in the main Plugin class:
+
+```php
+// This is already set up in src/Plugin.php
+ConfigurationHelper::init_cache_hooks();
+```
+
+The cache hooks listen for:
+- `update_option_{$option_key}`
+- `add_option_{$option_key}`  
+- `delete_option_{$option_key}`
+
+## Performance Notes
+
+- Configuration is cached using WordPress's `wp_cache_*` functions
+- Multiple cache groups are used for optimal performance
+- Cache duration is set to 1 hour by default
+- In-memory caching ensures subsequent accesses within the same request are instant

plugins/wpgraphql-logging/src/Admin/Settings/ConfigurationHelper.php

@@ -0,0 +1,222 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WPGraphQL\Logging\Admin\Settings;
+
+/**
+ * Configuration Helper class
+ *
+ * This class provides a centralized and cached way to access WPGraphQL Logging configuration.
+ * It implements a singleton pattern to ensure configuration is only loaded once per request
+ * and provides convenient methods for accessing different configuration sections.
+ *
+ * Usage Examples:
+ * ```php
+ * // Get the helper instance
+ * $config = ConfigurationHelper::get_instance();
+ *
+ * // Get a specific setting
+ * $log_level = $config->get_setting('basic_configuration', 'log_level', 'info');
+ *
+ * // Check if a feature is enabled
+ * $is_enabled = $config->is_enabled('data_management', 'data_sanitization_enabled');
+ *
+ * // Get an entire configuration section
+ * $basic_config = $config->get_basic_config();
+ * ```
+ *
+ * @package WPGraphQL\Logging
+ *
+ * @since 0.0.1
+ */
+class ConfigurationHelper {
+	/**
+	 * Cache group for configuration.
+	 *
+	 * @var string
+	 */
+	public const CACHE_GROUP = 'wpgraphql_logging_config';
+
+	/**
+	 * Cache duration in seconds (1 hour).
+	 *
+	 * @var int
+	 */
+	public const CACHE_DURATION = 3600;
+
+	/**
+	 * The cached configuration values.
+	 *
+	 * @var array<string, mixed>|null
+	 */
+	protected ?array $config = null;
+
+	/**
+	 * The single instance of this class.
+	 *
+	 * @var \WPGraphQL\Logging\Admin\Settings\ConfigurationHelper|null
+	 */
+	protected static ?ConfigurationHelper $instance = null;
+
+	/**
+	 * Get the singleton instance.
+	 */
+	public static function get_instance(): ConfigurationHelper {
+		if ( null === self::$instance ) {
+			self::$instance = new self();
+		}
+
+		return self::$instance;
+	}
+
+	/**
+	 * Get the full configuration array.
+	 *
+	 * @return array<string, mixed>
+	 */
+	public function get_config(): array {
+		if ( null === $this->config ) {
+			$this->load_config();
+		}
+
+		return $this->config ?? [];
+	}
+
+	/**
+	 * Get configuration for a specific section (tab).
+	 *
+	 * @param string               $section The configuration section key.
+	 * @param array<string, mixed> $default_value Default value if section not found.
+	 *
+	 * @return array<string, mixed>
+	 */
+	public function get_section_config( string $section, array $default_value = [] ): array {
+		$config = $this->get_config();
+		return $config[ $section ] ?? $default_value;
+	}
+
+	/**
+	 * Get a specific setting value from a configuration section.
+	 *
+	 * @param string $section     The configuration section key.
+	 * @param string $setting_key The setting key within the section.
+	 * @param mixed  $default_value     Default value if setting not found.
+	 */
+	public function get_setting( string $section, string $setting_key, $default_value = null ): mixed {
+		$section_config = $this->get_section_config( $section );
+		return $section_config[ $setting_key ] ?? $default_value;
+	}
+
+	/**
+	 * Get the basic configuration section.
+	 *
+	 * @return array<string, mixed>
+	 */
+	public function get_basic_config(): array {
+		return $this->get_section_config( 'basic_configuration' );
+	}
+
+	/**
+	 * Get the data management configuration section.
+	 *
+	 * @return array<string, mixed>
+	 */
+	public function get_data_management_config(): array {
+		return $this->get_section_config( 'data_management' );
+	}
+
+	/**
+	 * Check if a specific feature is enabled.
+	 *
+	 * @param string $section     The configuration section.
+	 * @param string $setting_key The setting key for the feature.
+	 */
+	public function is_enabled( string $section, string $setting_key ): bool {
+		return (bool) $this->get_setting( $section, $setting_key, false );
+	}
+
+	/**
+	 * Clear the configuration cache.
+	 * This forces a reload of the configuration on the next access.
+	 */
+	public function clear_cache(): void {
+		$this->config = null;
+		$option_key   = $this->get_option_key();
+		wp_cache_delete( $option_key, self::CACHE_GROUP );
+		wp_cache_delete( $option_key, $this->get_settings_group() );
+	}
+
+	/**
+	 * Reload the configuration from the database.
+	 * This bypasses any cache and forces a fresh load.
+	 */
+	public function reload_config(): void {
+		$this->clear_cache();
+		$this->load_config();
+	}
+
+	/**
+	 * Get the option key for the settings.
+	 */
+	public function get_option_key(): string {
+		return (string) apply_filters( 'wpgraphql_logging_settings_group_option_key', WPGRAPHQL_LOGGING_SETTINGS_KEY );
+	}
+
+	/**
+	 * Get the settings group for caching.
+	 */
+	public function get_settings_group(): string {
+		return (string) apply_filters( 'wpgraphql_logging_settings_group_settings_group', WPGRAPHQL_LOGGING_SETTINGS_GROUP );
+	}
+
+	/**
+	 * Hook into WordPress to clear cache when settings are updated.
+	 * This should be called during plugin initialization.
+	 *
+	 * @psalm-suppress PossiblyInvalidArgument
+	 */
+	public static function init_cache_hooks(): void {
+		$instance   = self::get_instance();
+		$option_key = $instance->get_option_key();
+
+		// Clear cache when the option is updated.
+		add_action( "update_option_{$option_key}", [ $instance, 'clear_cache' ] );
+		add_action( "add_option_{$option_key}", [ $instance, 'clear_cache' ] );
+		add_action( "delete_option_{$option_key}", [ $instance, 'clear_cache' ] );
+	}
+
+	/**
+	 * Load the configuration from cache or database.
+	 *
+	 * @phpcs:disable WordPressVIPMinimum.Performance.LowExpiryCacheTime.CacheTimeUndetermined
+	 */
+	protected function load_config(): void {
+		$option_key = $this->get_option_key();
+
+		$cache_duration = self::CACHE_DURATION;
+
+		// Try to get from wp_cache first (in-memory cache).
+		$cached_config = wp_cache_get( $option_key, self::CACHE_GROUP );
+		if ( is_array( $cached_config ) ) {
+			$this->config = $cached_config;
+			return;
+		}
+
+		// Try to get from the WordPress object cache (could be Redis, Memcached, etc.).
+		$cached_config = wp_cache_get( $option_key, $this->get_settings_group() );
+		if ( is_array( $cached_config ) ) {
+			$this->config = $cached_config;
+			// Store in our custom cache group for faster access next time.
+			wp_cache_set( $option_key, $cached_config, self::CACHE_GROUP, $cache_duration );
+			return;
+		}
+
+		// Load from database.
+		$this->config = (array) get_option( $option_key, [] );
+
+		// Cache the result in both cache groups.
+		wp_cache_set( $option_key, $this->config, self::CACHE_GROUP, $cache_duration );
+		wp_cache_set( $option_key, $this->config, $this->get_settings_group(), $cache_duration );
+	}
+}

plugins/wpgraphql-logging/src/Admin/Settings/Fields/Field/AbstractSettingsField.php

@@ -4,6 +4,7 @@
 
 namespace WPGraphQL\Logging\Admin\Settings\Fields\Field;
 
+use WPGraphQL\Logging\Admin\Settings\ConfigurationHelper;
 use WPGraphQL\Logging\Admin\Settings\Fields\SettingsFieldInterface;
 
 /**
@@ -84,7 +85,8 @@ public function render_field_callback( array $args ): void {
 		$tab_key      = (string) ( $args['tab_key'] ?? '' );
 		$settings_key = (string) ( $args['settings_key'] ?? '' );
 
-		$option_value = (array) get_option( $settings_key, [] );
+		$config_helper = ConfigurationHelper::get_instance();
+		$option_value  = $config_helper->get_config();
 
 		$id = $this->get_field_name( $settings_key, $tab_key, $this->get_id() );