Added Database entity and plugin hook class to add/drop table on activation/de-activation.

Author: colinmurphy

plugins/wpgraphql-logging/src/Admin/.gitkeep

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WPGraphQL\Logging\Hooks;
+
+use WPGraphQL\Logging\Logger\Database\DatabaseEntity;
+
+class PluginHooks {
+	/**
+	 * The single instance of the class.
+	 *
+	 * @var \WPGraphQL\Logging\Hooks\PluginHooks|null
+	 */
+	private static ?PluginHooks $instance = null;
+
+	/**
+	 * Get or create the single instance of the class.
+	 */
+	public static function init(): PluginHooks {
+		if ( null === self::$instance ) {
+			self::$instance = new self();
+			self::$instance->register();
+		}
+		return self::$instance;
+	}
+
+	/**
+	 * Activation callback for the plugin.
+	 */
+	public static function activate_plugin(): void {
+		DatabaseEntity::create_table();
+	}
+
+	/**
+	 * Deactivation callback for the plugin.
+	 */
+	public static function deactivate_plugin(): void {
+		// @TODO: Add configuration to determine if the table should be dropped on deactivation.
+		DatabaseEntity::drop_table();
+	}
+
+	/**
+	 * Register actions and filters.
+	 */
+	protected function register(): void {
+		add_action( 'wpgraphql_logging_activate', [ self::class, 'activate_plugin' ] );
+		add_action( 'wpgraphql_logging_deactivate', [ self::class, 'deactivate_plugin' ] );
+	}
+}

plugins/wpgraphql-logging/src/Events/.gitkeep

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WPGraphQL\Logging\Logger\Database;
+
+class DatabaseEntity {
+	/**
+	 * Gets the name of the logging table.
+	 *
+	 * @return string The name of the logging table.
+	 */
+	public static function get_table_name(): string {
+		global $wpdb;
+
+		return (string) apply_filters( 'wpgraphql_logging_database_name', $wpdb->prefix . 'wpgraphql_logging' );
+	}
+
+	/**
+	 * Gets the database schema for the logging table.
+	 *
+	 * @return string The SQL CREATE an TABLE statement.
+	 */
+	public static function get_schema(): string {
+		global $wpdb;
+		$table_name      = self::get_table_name();
+		$charset_collate = $wpdb->get_charset_collate();
+
+		return "
+       CREATE TABLE {$table_name} (
+          id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
+          channel VARCHAR(191) NOT NULL,
+          level SMALLINT UNSIGNED NOT NULL,
+          level_name VARCHAR(50) NOT NULL,
+          message LONGTEXT NOT NULL,
+          context JSON NULL,
+          extra JSON NULL,
+          datetime DATETIME NOT NULL,
+          INDEX channel_index (channel),
+          INDEX level_index (level),
+          INDEX datetime_index (datetime)
+       ) {$charset_collate};
+    ";
+	}
+
+	/**
+	 * Creates the logging table in the database.
+	 */
+	public static function create_table(): void {
+		require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+		$schema = self::get_schema();
+		dbDelta( $schema );
+	}
+
+	/**
+	 * Drops the logging table from the database.
+	 */
+	public static function drop_table(): void {
+		global $wpdb;
+		$table_name = self::get_table_name();
+
+		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange
+		$wpdb->query( "DROP TABLE IF EXISTS {$table_name}" );
+	}
+}

plugins/wpgraphql-logging/src/Hooks/.gitkeep

@@ -4,6 +4,8 @@
 
 namespace WPGraphQL\Logging;
 
+use WPGraphQL\Logging\Hooks\PluginHooks;
+
 /**
  * Plugin class for WPGraphQL Logging.
  *
@@ -48,7 +50,7 @@ public static function init(): self {
 	 * Initialize the plugin admin, frontend & api functionality.
 	 */
 	public function setup(): void {
-		// @TODO
+		PluginHooks::init();
 	}
 
 	/**

plugins/wpgraphql-logging/src/Hooks/PluginHooks.php

@@ -6,16 +6,23 @@
 
 
 use lucatume\WPBrowser\TestCase\WPTestCase;
+use WPGraphQL\Logging\Logger\Database\DatabaseEntity;
 
 /**
  * Test class for the activation callback.
  */
 class ActivationTest extends WPTestCase {
+
 	protected function setUp(): void {
 		parent::setUp();
 		if ( ! function_exists( 'wpgraphql_logging_activation_callback' ) ) {
 			require_once dirname( __DIR__ ) . '/activation.php';
 		}
+		$this->drop_table();
+	}
+
+	public function drop_table(): void {
+		DatabaseEntity::drop_table();
 	}
 
 	public function test_activation_callback_function_exists(): void {

plugins/wpgraphql-logging/src/Logger/.gitkeep

@@ -7,6 +7,7 @@
 use WPGraphQL\Logging\Plugin;
 use lucatume\WPBrowser\TestCase\WPTestCase;
 use ReflectionClass;
+use WPGraphQL\Logging\Logger\Database\DatabaseEntity;
 
 /**
  * Class PluginTest
@@ -52,18 +53,4 @@ public function test_clone_method_throws_error() {
 		// Verify the clone exists to ensure the operation completed
 		$this->assertInstanceOf( Plugin::class, $clone );
 	}
-
-	public function test_wakeup_method_throws_error() {
-		$this->setExpectedIncorrectUsage( 'WPGraphQL\Logging\Plugin::__wakeup' );
-
-		// Create a fresh instance
-		$reflection = new ReflectionClass( Plugin::class );
-		$plugin     = $reflection->newInstanceWithoutConstructor();
-
-		$serialized   = serialize( $plugin );
-		$unserialized = unserialize( $serialized );
-
-		// Verify the unserialized object exists
-		$this->assertInstanceOf( Plugin::class, $unserialized );
-	}
 }

plugins/wpgraphql-logging/src/Logger/Database/DatabaseEntity.php

@@ -0,0 +1,69 @@
+<?php
+
+declare( strict_types=1 );
+
+namespace WPGraphQL\Logging\Tests\Hooks;
+
+use WPGraphQL\Logging\Hooks\PluginHooks;
+use lucatume\WPBrowser\TestCase\WPTestCase;
+use ReflectionClass;
+use WPGraphQL\Logging\Logger\Database\DatabaseEntity;
+
+/**
+ * Class PluginTest
+ *
+ * Tests for the Plugin class
+ *
+ */
+class PluginHooksTest extends WPTestCase {
+
+	public function setUp(): void {
+		parent::setUp();
+		$this->drop_table();
+	}
+
+	public function drop_table(): void {
+		DatabaseEntity::drop_table();
+	}
+
+	public function test_instance_from_function_in_hwp_previews() {
+		$instance = PluginHooks::init();
+		$this->assertTrue( $instance instanceof PluginHooks );
+	}
+
+	public function test_singleton_returns_same_instance() {
+		$first  = PluginHooks::init();
+		$second = PluginHooks::init();
+		$this->assertSame( $first, $second, 'PluginHooks::instance() should always return the same instance' );
+	}
+
+	public function test_instance_creates_and_sets_up_plugin_when_not_set() {
+		$reflection       = new ReflectionClass( PluginHooks::class );
+		$instanceProperty = $reflection->getProperty( 'instance' );
+		$instanceProperty->setAccessible( true );
+		$instanceProperty->setValue( null );
+
+		$this->assertNull( $instanceProperty->getValue() );
+		$instance = PluginHooks::init();
+
+		$this->assertInstanceOf( PluginHooks::class, $instanceProperty->getValue() );
+		$this->assertSame( $instance, $instanceProperty->getValue(), 'Plugin::instance() should set the static instance property' );
+	}
+
+
+	public function test_database_table_creation() {
+		global $wpdb;
+
+		// Setup plugin and run activation hook
+		PluginHooks::init();
+		wpgraphql_logging_activation_callback();
+
+		// Check if the table now exists
+		$table_exists = $wpdb->get_var( $wpdb->prepare(
+			"SHOW TABLES LIKE %s",
+			DatabaseEntity::get_table_name()
+		) );
+
+		$this->assertEquals( DatabaseEntity::get_table_name(), $table_exists, 'Database table should be created by setup method.' );
+	}
+}