Add uninstall option and update settings labels

Added documentation and code to support optional database cleanup on plugin deactivation via the WP_GRAPHQL_LOGGING_UNINSTALL_PLUGIN constant. Updated admin settings field labels for clarity in the Basic Configuration tab.

Author: colinmurphy

plugins/wpgraphql-logging/README.md

@@ -48,6 +48,35 @@ Once you have the composer repository setup, please run `composer req wpengine/w
 
 Plugin should start logging data, once activated.
 
+---
+
+## Uninstallation and Data Cleanup
+
+By default, WPGraphQL Logging preserves all logged data when the plugin is deactivated to prevent accidental data loss. If you want to completely remove all plugin data (including database tables) when deactivating the plugin, you must explicitly enable this behavior.
+
+### Enabling Database Cleanup on Deactivation
+
+To enable automatic database cleanup when the plugin is deactivated, add the following constant to your `wp-config.php` file or in a must-use plugin:
+
+```php
+define( 'WP_GRAPHQL_LOGGING_UNINSTALL_PLUGIN', true );
+```
+
+> [!WARNING]
+> **Data Loss Warning**: When `WP_GRAPHQL_LOGGING_UNINSTALL_PLUGIN` is defined as `true`, deactivating the plugin will permanently delete all logged data and drop the plugin's database tables. This action is irreversible.
+
+### Manual Data Cleanup
+
+If you prefer to manually clean up data without defining the constant, you can:
+
+1. Use the plugin's admin interface to clear logs (when available)
+2. Manually drop the database table: `{$wpdb->prefix}wpgraphql_logging`
+3. Remove plugin options from the WordPress options table
+
+---
+
+@TODO add more info once we have configuration setup.
+
 @TODO add more info once we have configuration setup.
 
 

plugins/wpgraphql-logging/src/Admin/Settings/Fields/Tab/Basic_Configuration_Tab.php

@@ -110,7 +110,7 @@ public function get_fields(): array {
 		$fields[ self::EXCLUDE_QUERY ] = new Text_Input_Field(
 			self::EXCLUDE_QUERY,
 			$this->get_name(),
-			__( 'Exclude Query', 'wpgraphql-logging' ),
+			__( 'Exclude Queries', 'wpgraphql-logging' ),
 			'',
 			__( 'Comma-separated list of GraphQL query names to exclude from logging.', 'wpgraphql-logging' ),
 			__( 'e.g., __schema,SeedNode,__typename', 'wpgraphql-logging' )
@@ -119,7 +119,7 @@ public function get_fields(): array {
 		$fields[ self::ADMIN_USER_LOGGING ] = new Checkbox_Field(
 			self::ADMIN_USER_LOGGING,
 			$this->get_name(),
-			__( 'Log only for admin users', 'wpgraphql-logging' ),
+			__( 'Admin User Logging', 'wpgraphql-logging' ),
 			'',
 			__( 'Log only for admin users.', 'wpgraphql-logging' )
 		);

plugins/wpgraphql-logging/src/Plugin.php

@@ -101,9 +101,13 @@ public static function activate(): void {
 
 	/**
 	 * Deactivation callback for the plugin.
+	 *
+	 * @since 0.0.1
 	 */
 	public static function deactivate(): void {
-		// @TODO: Add configuration to determine if the table should be dropped on deactivation.
+		if ( ! defined( 'WP_GRAPHQL_LOGGING_UNINSTALL_PLUGIN' ) ) {
+    		return;
+		}
 		DatabaseEntity::drop_table();
 	}