# propertyhive/2.3.0/includes/admin/class-ph-admin-reports.php

Property Hive, version 2.3.0. 154 lines.

- Page: https://pluginprobe.com/plugins/propertyhive/2.3.0/code/includes/admin/class-ph-admin-reports.php
- Raw: https://pluginprobe.com/plugins/propertyhive/2.3.0/raw/includes/admin/class-ph-admin-reports.php
- Modified: 2026-09-16T09:29:48+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/propertyhive/2.3.0/code/includes/admin/class-ph-admin-reports.php#L10-L20`.

```php
<?php
/**
 * PropertyHive Admin Reports Class.
 *
 * @author 		PropertyHive
 * @category 	Admin
 * @package 	PropertyHive/Admin
 * @version     1.0.0
 */

if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly

if ( ! class_exists( 'PH_Admin_Reports' ) ) :

/**
 * PH_Admin_Reports
 */
// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedClassFound -- Legacy public global class PH_Admin_Reports; preserving the existing PH_* class name is required for plugin and extension compatibility.
class PH_Admin_Reports {

	/**
	 * Handles the display of the main Property Hive reports page in admin.
	 *
	 * @access public
	 * @return void
	 */
	public static function output() {

        if ( ! current_user_can( 'manage_propertyhive' ) ) {
            return;
        }

        $reports = self::get_reports();
        if ( empty( $reports ) ) {
            return;
        }
        $first_tab = array_keys( $reports );
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Authorized read-only report navigation; no state-changing action is performed.
        $current_tab = ! empty( $_GET['tab'] ) && is_string( $_GET['tab'] ) ? sanitize_title( wp_unslash( $_GET['tab'] ) ) : $first_tab[0];
        if ( ! isset( $reports[ $current_tab ] ) ) {
            $current_tab = $first_tab[0];
        }
        $report_keys = array_keys( $reports[ $current_tab ]['reports'] );
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Authorized read-only report navigation; callbacks are selected only from registered reports.
        $current_report = isset( $_GET['report'] ) && is_string( $_GET['report'] ) ? sanitize_title( wp_unslash( $_GET['report'] ) ) : current( $report_keys );

		include_once( 'reports/class-ph-admin-report.php' );
		include_once( 'views/html-admin-page-reports.php' );
	}

	/**
	 * Returns the definitions for the reports to show in admin.
	 *
	 * @return array
	 */
	public static function get_reports() 
	{
		$reports = array(
			'properties' => array(
				'title' => __( 'Properties', 'propertyhive' ),
				'reports' => array()
			)
		);

		if ( get_option('propertyhive_active_departments_sales', '') == 'yes' )
	    {
	    	$reports['properties']['reports']['sales_property_stock_analysis'] = array(
					'title'       => __( 'Sales Property Stock Analysis', 'propertyhive' ),
					'description' => '',
					'hide_title'  => true,
					'callback'    => array( __CLASS__, 'get_report' )
				);
			$reports['properties']['reports']['sales_property_popularity'] = array(
				'title'       => __( 'Sales Property Popularity', 'propertyhive' ),
				'description' => '',
				'hide_title'  => true,
				'callback'    => array( __CLASS__, 'get_report' )
			);
	    }

	    if ( get_option('propertyhive_active_departments_lettings', '') == 'yes' )
	    {
	    	$reports['properties']['reports']['lettings_property_stock_analysis'] = array(
					'title'       => __( 'Lettings Property Stock Analysis', 'propertyhive' ),
					'description' => '',
					'hide_title'  => true,
					'callback'    => array( __CLASS__, 'get_report' )
				);
			$reports['properties']['reports']['lettings_property_popularity'] = array(
				'title'       => __( 'Lettings Property Popularity', 'propertyhive' ),
				'description' => '',
				'hide_title'  => true,
				'callback'    => array( __CLASS__, 'get_report' )
			);
	    }

	    $reports['properties']['reports']['incomplete_properties'] = array(
			'title'       => __( 'Incomplete Properties', 'propertyhive' ),
			'description' => '',
			'hide_title'  => true,
			'callback'    => array( __CLASS__, 'get_report' )
		);

		/*if ( get_option('propertyhive_module_disabled_contacts', '') != 'yes' )
	    {
			$reports['applicants'] = array(
				'title'  => __( 'Applicants', 'propertyhive' ),
				'reports' => array(
					"applicant_demand_analysis" => array(
						'title'       => __( 'Applicant Demand Analysis', 'propertyhive' ),
						'description' => '',
						'hide_title'  => true,
						'callback'    => array( __CLASS__, 'get_report' )
					),
				)
			);
		}*/

		$reports = apply_filters( 'propertyhive_admin_reports', $reports );

		foreach ( $reports as $key => $report_group ) {
			if ( isset( $reports[ $key ]['charts'] ) ) {
				$reports[ $key ]['reports'] = $reports[ $key ]['charts'];
			}

			foreach ( $reports[ $key ]['reports'] as $report_key => $report ) {
				if ( isset( $reports[ $key ]['reports'][ $report_key ]['function'] ) ) {
					$reports[ $key ]['reports'][ $report_key ]['callback'] = $reports[ $key ]['reports'][ $report_key ]['function'];
				}
			}
		}

		return $reports;
	}

	/**
	 * Get a report from our reports subfolder.
	 */
	public static function get_report( $name ) {
		$name  = sanitize_title( str_replace( '_', '-', $name ) );
		$class = 'PH_Report_' . str_replace( '-', '_', $name );

		// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Existing public Property Hive extension hook ph_admin_reports_path; changing the established name would detach installed callbacks.
		include_once( apply_filters( 'ph_admin_reports_path', 'reports/class-ph-report-' . $name . '.php', $name, $class ) );

		if ( ! class_exists( $class ) )
			return;

		$report = new $class();
		$report->output_report();
	}
}

endif;
```