New table to hold subscriber events

Author: ajaydsouza

CLAUDE.md

@@ -9,6 +9,7 @@ FreemKit is a WordPress plugin (v1.0.0-beta1) that bridges Freemius software lic
 ## Commands
 
 ### PHP
+
 ```bash
 composer phpcs          # Lint PHP (WordPress coding standards)
 composer phpcbf         # Auto-fix PHP code style
@@ -20,6 +21,7 @@ composer zip            # Create distribution zip
 ```
 
 ### JavaScript/CSS
+
 ```bash
 npm run build           # Build JS/CSS assets with wp-scripts
 npm run build:assets    # Minify CSS/JS and generate RTL CSS (node build-assets.js)
@@ -33,30 +35,35 @@ npm run zip             # Create plugin zip via wp-scripts
 ## Architecture
 
 ### Entry Point & Bootstrap
+
 `freemkit.php` defines constants (`FREEMKIT_VERSION`, `FREEMKIT_PLUGIN_FILE`, `FREEMKIT_PLUGIN_DIR`, `FREEMKIT_PLUGIN_URL`), loads Kit shared library classes from `vendor/convertkit/convertkit-wordpress-libraries/`, registers the autoloader, and calls `\WebberZone\FreemKit\load()` on `plugins_loaded`.
 
 **Autoloader convention:** Namespace segments become path segments under `includes/`; underscores → hyphens, lowercase, last segment prefixed with `class-`. e.g. `WebberZone\FreemKit\Admin\Settings` → `includes/admin/class-settings.php`.
 
 ### Core Components
+
 - **`Main`** (`includes/class-main.php`) — Singleton. Instantiates `Runtime`, `Kit_Credential_Hooks`, and `Language_Handler`; registers hooks via `Hook_Registry`.
 - **`Runtime`** (`includes/class-runtime.php`) — Initializes `Database`, `Kit_API`, and `Webhook_Handler` on `init`. Creates the `Admin` object when in admin context.
 - **`Webhook_Handler`** (`includes/class-webhook-handler.php`) — Core logic. Registers a REST endpoint at `freemkit/v1/webhook` (or a query-var fallback). Validates HMAC-SHA256 signatures (`x-signature` header) and webhook freshness (15-minute window). Queues events as WP transients and processes them asynchronously via WP-Cron (`freemkit_process_webhook_event`). Includes deduplication via `freemkit_webhook_seen_*` transients, and exponential-backoff retry (max 3 attempts).
 - **`Database`** (`includes/class-database.php`) — Manages the `{prefix}freemkit_subscribers` custom table, which persists subscriber records locally.
 - **`Options_API`** (`includes/class-options-api.php`) — All settings stored as a single `freemkit_settings` array in `wp_options`. Access via `Options_API::get_option($key)` / `Options_API::get_settings()`. Sensitive keys (access/refresh tokens) are encrypted at rest using AES-256-CBC (OpenSSL) or libsodium.
 
 ### Kit Integration (`includes/kit/`)
+
 - **`Kit_API`** — Wraps `ConvertKit_API_V4` to subscribe users to forms and apply tags.
 - **`Kit_Settings`** — Manages OAuth tokens (`kit_access_token`, `kit_refresh_token`). Falls back to the official Kit WordPress plugin's stored credentials if available.
 - **`Kit_Credential_Hooks`** — Listens for `freemkit_api_get_access_token` / `freemkit_api_refresh_token` / `convertkit_api_access_token_invalid` actions to keep tokens in sync.
 - **`Kit_Audit_Log`** — Logs Kit API interactions.
 
 ### Admin (`includes/admin/`)
+
 - **`Admin`** — Admin menu, settings page, subscriber list screen.
 - **`Settings`** / **`Settings_Wizard`** — Settings pages; wizard is shown on first activation. Settings include: global Kit form/tag defaults, per-plugin overrides (free and paid form IDs, tag IDs, event types), custom field mappings, webhook endpoint type (REST vs query-var).
 - **`Kit_OAuth`** — OAuth flow for connecting to Kit.
 - **`Subscribers_List`** / **`Subscribers_List_Table`** — Admin screen displaying the local `freemkit_subscribers` table.
 
 ### Utilities (`includes/util/`)
+
 - **`Hook_Registry`** — Static registry for all registered actions/filters; prevents duplicates (same pattern as CRP).
 
 ## Key Patterns

includes/admin/class-subscribers-list-table.php

@@ -72,8 +72,7 @@ public function get_columns(): array {
 			'status'     => __( 'Status', 'freemkit' ),
 			'created'    => __( 'Created', 'freemkit' ),
 			'fields'     => __( 'Fields', 'freemkit' ),
-			'tags'       => __( 'Tags', 'freemkit' ),
-			'forms'      => __( 'Forms', 'freemkit' ),
+			'plugins'    => __( 'Plugins', 'freemkit' ),
 		);
 
 		return $columns;
@@ -165,11 +164,12 @@ public function column_default( $item, $column_name ): string {
 			case 'last_name':
 				return esc_html( $item->last_name );
 
-			case 'tags':
-				return esc_html( implode( ', ', $item->tags ) );
+			case 'fields':
+				return esc_html( implode( ', ', (array) $item->fields ) );
 
-			case 'forms':
-				return esc_html( implode( ', ', $item->forms ) );
+			case 'plugins':
+				$slugs = $this->database->get_subscriber_plugin_slugs( $item->id );
+				return esc_html( implode( ', ', $slugs ) );
 
 			case 'status':
 				return esc_html( $item->status );

includes/admin/class-subscribers-list.php

@@ -97,7 +97,6 @@ public function render_page() {
 		?>
 		<div class="wrap">
 			<h1><?php esc_html_e( 'FreemKit - Subscribers', 'freemkit' ); ?></h1>
-			<a href="<?php echo esc_url( admin_url( 'options-general.php?page=freemkit_options_page' ) ); ?>" class="page-title-action"><?php esc_html_e( 'View Settings', 'freemkit' ); ?></a>
 			<?php do_action( 'freemkit_subscribers_page_header' ); ?>
 
 			<div id="poststuff">