<?php
/**
 * WPAL_Features class for handling admin page functionalities in the Activity Lens plugin.
 *
 * This class manages the logic for the plugin's admin pages, including settings display,
 * data management, and form processing. It integrates with the WPAL_DB class for database
 * operations and the WPAL_LOG class for logging user activities, ensuring seamless
 * functionality within the WordPress admin environment. The class registers necessary
 * WordPress hooks to handle initialization and data export, providing a robust foundation
 * for the plugin's administrative features.
 *
 * @package Activity_Lens
 * @since 1.0.0
 */

if (!defined('ABSPATH')) {
    exit;
}

class WPAL_Features {

	/**
	 * Instance of the WPAL_DB class for database operations.
	 *
	 * Facilitates interaction with the external database to retrieve activity logs and manage
	 * data export functionality, such as CSV generation. This property enables the admin
	 * interface to display logs and handle data exports efficiently without direct database
	 * queries, ensuring encapsulation and modularity.
	 *
	 * @since 1.0.0
	 * @var WPAL_DB $wpal_db Instance of the WPAL_DB class.
	 */
	private $wpal_db;

	/**
	 * Instance of the WPAL_LOG class for logging activities.
	 *
	 * Handles the logging of user activities across the website, such as user registration
	 * or updates. This property allows the plugin to track and record user-related events
	 * in a structured manner, supporting audit trails and activity monitoring.
	 *
	 * @since 1.0.0
	 * @var WPAL_LOG $wpal_log Instance of the WPAL_LOG class.
	 */
	private $wpal_log;

	/**
	 * Constructor for initializing admin page functionalities.
	 *
	 * Initializes the WPAL_Features class by setting up dependencies and registering WordPress
	 * hooks. It assigns the provided WPAL_DB and WPAL_LOG instances to class properties and
	 * hooks the wpal_exportData method to the admin_init action to handle data export
	 * functionality. Assumes a stable database connection is verified by the parent class
	 * or plugin initialization logic before instantiation.
	 *
	 * @since 1.0.0
	 * @param WPAL_DB  $wpal_db  Instance of WPAL_DB for database operations.
	 * @param WPAL_LOG $wpal_log Instance of WPAL_LOG for logging operations.
	 */
	public function __construct( $wpal_db, $wpal_log ) {
		$this->wpal_db  = $wpal_db;
		$this->wpal_log = $wpal_log;

		add_action( 'admin_init', array( $this->wpal_db, 'wpal_exportData' ) );
	}

	/**
	 * Logs all existing WordPress users into the activity log database.
	 *
	 * Retrieves all WordPress users using the get_users function and logs their details
	 * (ID, username, email, and primary role) using the WPAL_LOG class. This method is
	 * typically called during plugin activation to populate the user log table, ensuring
	 * an initial record of all users for activity tracking purposes. Handles cases where
	 * a user may not have a role assigned.
	 *
	 * @since 1.0.0
	 */
	public function wpal_initialize_users() {
		$users = get_users();
		if($users){
			foreach ( $users as $user ) {
				$user_id    = $user->ID;
				$user_name  = $user->user_login;
				$user_email = $user->user_email;
				$user_role  = $user->roles[0];
				$this->wpal_log->wpal_user_log( $user_id, $user_name, $user_email, $user_role );
			}
		}
	}

	/**
	 * Displays the activity log table in the admin interface.
	 *
	 * Invokes the wpal_displayActivityTable method of the WPAL_DB class to render the
	 * activity log table within the WordPress admin dashboard. This method provides a
	 * user-friendly interface for administrators to view logged activities, leveraging
	 * the database operations handled by the WPAL_DB class.
	 *
	 * @since 1.0.0
	 */
	public function wpal_display_log() {
		$this->wpal_db->wpal_displayActivityTable();
	}
}
?>