From 5f8be013b2d487f6907bc8c193d21495214da08c Mon Sep 17 00:00:00 2001
From: Oleksandr Zhyian <oleksandr.zhyian@gmail.com>
Date: Tue, 22 Oct 2024 15:00:54 +0300
Subject: [PATCH] feat: add post views column to admin post table

---
 inc/class-statify-counter-column.php | 117 +++++++++++++++++++++++++++
 inc/class-statify.php                |   1 +
 statify.php                          |   1 +
 3 files changed, 119 insertions(+)
 create mode 100644 inc/class-statify-counter-column.php

diff --git a/inc/class-statify-counter-column.php b/inc/class-statify-counter-column.php
new file mode 100644
index 0000000..e443cfd
--- /dev/null
+++ b/inc/class-statify-counter-column.php
@@ -0,0 +1,117 @@
+<?php
+/**
+ * Statify: Statify_Counter_Column class
+ *
+ * This file contains the derived class for the counter column in the post table.
+ *
+ * @package Statify
+ */
+
+// Quit if accessed outside WP context.
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Statify_Counter_Column
+ *
+ * This class manages the counter column in the post table to display the number of views for each post.
+ */
+class Statify_Counter_Column extends Statify {
+
+	public const COLUMN_NAME = 'counter-column';
+	public const SUPPORTED_POST_TYPE = array(
+		'post',
+		'page',
+	);
+
+	/**
+	 * Initializes the counter column in the post table.
+	 *
+	 * This method adds the necessary actions to register the counter column and manage its display.
+	 *
+	 * @return void
+	 */
+	public static function init(): void {
+
+		// Filter user_can_see_stats.
+		if ( ! self::user_can_see_stats() ) {
+			return;
+		}
+
+		/**
+		 * Filters the post types that will display the Statify counter column.
+		 *
+		 * @param array $post_types Array of post types.
+		 */
+		$post_types = apply_filters( 'statify_counter_post_types', self::SUPPORTED_POST_TYPE );
+
+		foreach ( $post_types as $post_type ) {
+			add_action( "manage_edit-{$post_type}_columns", array( __CLASS__, 'register_counter_column' ) );
+			add_action( "manage_{$post_type}_posts_custom_column", array( __CLASS__, 'manage_counter_column' ), 10, 2 );
+		}
+	}
+
+	/**
+	 * Registers the counter column in the post columns.
+	 *
+	 * This method adds the counter column to the post edit screen.
+	 *
+	 * @param array $columns An array of existing columns.
+	 *
+	 * @return array Updated array of columns with the counter column added.
+	 */
+	public static function register_counter_column( array $columns ): array {
+
+		$columns[ self::COLUMN_NAME ] = __( 'Views', 'statify' );
+
+		return $columns;
+	}
+
+	/**
+	 * Manages the display of the counter column for a given post.
+	 *
+	 * This method retrieves and displays the view count for the specified post in the counter column.
+	 *
+	 * @param string $column_name The name of the column being managed.
+	 * @param int    $post_id    The ID of the post for which the column is being displayed.
+	 *
+	 * @return void
+	 */
+	public static function manage_counter_column( string $column_name, int $post_id ): void {
+
+		if ( self::COLUMN_NAME !== $column_name ) {
+			return;
+		}
+
+		$permalink = (string) get_permalink( $post_id );
+
+		if ( ! $permalink ) {
+			return;
+		}
+
+		$target = wp_parse_url( $permalink, PHP_URL_PATH );
+
+		echo esc_html( self::post_counter_value( $target ) );
+	}
+
+	/**
+	 * Retrieves the view count for a specific target.
+	 *
+	 * This method queries the database to count the number of views for the given target URL.
+	 *
+	 * @param string $target The target URL path for which the view count is to be retrieved.
+	 *
+	 * @return int The number of views for the specified target.
+	 */
+	private static function post_counter_value( string $target ): int {
+		global $wpdb;
+
+		$sql = $wpdb->prepare(
+			"SELECT COUNT(*) FROM `$wpdb->statify` WHERE `target` = %s",
+			$target
+		);
+
+		$result = $wpdb->get_var( $sql );
+
+		return (int) $result;
+	}
+}
diff --git a/inc/class-statify.php b/inc/class-statify.php
index d940a4e..82b99e3 100755
--- a/inc/class-statify.php
+++ b/inc/class-statify.php
@@ -75,6 +75,7 @@ public static function init(): void {
 			add_filter( 'plugin_row_meta', array( 'Statify_Backend', 'add_meta_link' ), 10, 2 );
 			add_filter( 'plugin_action_links_' . STATIFY_BASE, array( 'Statify_Backend', 'add_action_link' ) );
 			add_action( 'admin_init', array( 'Statify_Settings', 'register_settings' ) );
+			add_action( 'admin_init', array( 'Statify_Counter_Column', 'init' ) );
 			add_action( 'admin_menu', array( 'Statify_Settings', 'add_admin_menu' ) );
 			add_action( 'update_option_statify', array( 'Statify_Settings', 'action_update_options' ), 10, 2 );
 		} else {    // Frontend.
diff --git a/statify.php b/statify.php
index 1c4623a..64c1599 100644
--- a/statify.php
+++ b/statify.php
@@ -75,6 +75,7 @@ function statify_autoload( $class ) {
 		'Statify_Settings',
 		'Statify_Table',
 		'Statify_Cron',
+		'Statify_Counter_Column',
 	);
 
 	if ( in_array( $class, $plugin_classes, true ) ) {