feat: add Ideas browser admin page (v0.5.1)

New submenu page showing all article ideas from the content analyzer. Displays title, type, relevance score, frequency, key points, and keywords with type filtering and pagination. Gives live visibility into the idea pipeline. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-20 00:34:31 +07:00
parent c03bdfb69c
commit 327cdc08d9
7 changed files with 302 additions and 2 deletions
--- a/includes/admin/class-ideas-browser.php
+++ b/includes/admin/class-ideas-browser.php
@@ -0,0 +1,135 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Admin page listing analysis results (article ideas) from all pipeline runs.
+ *
+ * Shows every idea the content analyzer has surfaced: topic, type, relevance
+ * score, frequency, source, and metadata (key points, keywords). Filterable
+ * by type and source, with pagination. Gives the CEO a live view of the idea
+ * pipeline without needing to trigger a generation run.
+ *
+ * Triggered by: PRAutoBlogger::register_admin_hooks() on `admin_menu`.
+ * Dependencies: WordPress $wpdb for direct table queries.
+ *
+ * @see core/class-content-analyzer.php       — Produces the rows this page displays.
+ * @see models/class-analysis-result.php      — Data model for analysis results.
+ * @see templates/admin/ideas-browser.php     — Renders the HTML.
+ * @see ARCHITECTURE.md                       — Data flow step 2.
+ */
+class PRAutoBlogger_Ideas_Browser {
+
+	private const PER_PAGE = 30;
+
+	/**
+	 * Register the Ideas submenu page under PRAutoBlogger.
+	 *
+	 * @return void
+	 */
+	public function on_register_menu(): void {
+		add_submenu_page(
+			'prautoblogger-settings',
+			__( 'Ideas', 'prautoblogger' ),
+			__( 'Ideas', 'prautoblogger' ),
+			'manage_options',
+			'prautoblogger-ideas',
+			[ $this, 'render_page' ]
+		);
+	}
+
+	/**
+	 * Render the ideas browser page.
+	 *
+	 * Reads filter/pagination parameters from $_GET, queries the analysis_results
+	 * table, and includes the template.
+	 *
+	 * @return void
+	 */
+	public function render_page(): void {
+		if ( ! current_user_can( 'manage_options' ) ) {
+			return;
+		}
+
+		$paged       = isset( $_GET['paged'] ) ? absint( $_GET['paged'] ) : 1;
+		$type_filter = isset( $_GET['type'] ) ? sanitize_key( $_GET['type'] ) : '';
+		$source_filter = isset( $_GET['source'] ) ? sanitize_key( $_GET['source'] ) : '';
+
+		$result      = $this->query_ideas( $paged, $type_filter, $source_filter );
+		$rows        = $result['rows'];
+		$total       = $result['total'];
+		$total_pages = (int) ceil( $total / self::PER_PAGE );
+		$type_counts = $this->get_type_counts();
+
+		include PRAUTOBLOGGER_PLUGIN_DIR . 'templates/admin/ideas-browser.php';
+	}
+
+	/**
+	 * Query analysis results with optional filtering and pagination.
+	 *
+	 * Side effects: database SELECT.
+	 *
+	 * @param int    $paged  Page number (1-based).
+	 * @param string $type   Filter by analysis_type (empty = all).
+	 * @param string $source Filter: 'llm_research' or 'reddit' based on source_ids content.
+	 * @return array{rows: array[], total: int}
+	 */
+	private function query_ideas( int $paged, string $type, string $source ): array {
+		global $wpdb;
+		$table  = $wpdb->prefix . 'prautoblogger_analysis_results';
+		$where  = [];
+		$params = [];
+
+		if ( '' !== $type ) {
+			$where[]  = 'analysis_type = %s';
+			$params[] = $type;
+		}
+
+		$where_sql = empty( $where ) ? '' : 'WHERE ' . implode( ' AND ', $where );
+		$offset    = ( $paged - 1 ) * self::PER_PAGE;
+
+		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery
+		$total = (int) $wpdb->get_var(
+			empty( $params )
+				? "SELECT COUNT(*) FROM {$table} {$where_sql}"
+				: $wpdb->prepare( "SELECT COUNT(*) FROM {$table} {$where_sql}", ...$params )
+		);
+
+		$order_sql = 'ORDER BY analyzed_at DESC, relevance_score DESC';
+		$limit_sql = sprintf( 'LIMIT %d OFFSET %d', self::PER_PAGE, $offset );
+		$full_sql  = "SELECT * FROM {$table} {$where_sql} {$order_sql} {$limit_sql}";
+
+		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery
+		$rows = empty( $params )
+			? $wpdb->get_results( $full_sql, ARRAY_A )
+			: $wpdb->get_results( $wpdb->prepare( $full_sql, ...$params ), ARRAY_A );
+
+		return [
+			'rows'  => $rows ?: [],
+			'total' => $total,
+		];
+	}
+
+	/**
+	 * Get counts per analysis_type for the filter badges.
+	 *
+	 * Side effects: database SELECT.
+	 *
+	 * @return array<string, int> Map of analysis_type => count.
+	 */
+	private function get_type_counts(): array {
+		global $wpdb;
+		$table = $wpdb->prefix . 'prautoblogger_analysis_results';
+
+		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery
+		$rows = $wpdb->get_results(
+			"SELECT analysis_type, COUNT(*) AS cnt FROM {$table} GROUP BY analysis_type ORDER BY cnt DESC",
+			ARRAY_A
+		);
+
+		$counts = [];
+		foreach ( $rows ?: [] as $row ) {
+			$counts[ $row['analysis_type'] ] = (int) $row['cnt'];
+		}
+		return $counts;
+	}
+}