/*
 * School Management Pro - API Controller
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * School Management System Pro - Capability Manager.
 *
 * Manages plugin-specific user roles and their associated capabilities,
 * utilizing WordPress transients for caching to enhance performance.
 *
 * @package SchoolManagementSystemPro
 * @subpackage Includes/Capabilities
 * @since 2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Final class SMS_Pro_Capability_Manager.
 *
 * This class is responsible for defining, generating, caching, and retrieving
 * capabilities for custom roles within the School Management System Pro plugin.
 * It is designed as a final class to prevent extension, ensuring a stable API.
 *
 * @since 2.3.0
 */
final class SMS_Pro_Capability_Manager {

	/**
	 * Prefix used for options, transients, capabilities, etc.
	 * This should match the SMS_PRO_PREFIX constant defined in the main plugin file.
	 *
	 * @since 2.3.0
	 * @var string
	 */
	private static string $prefix = 'sms_pro_'; // Default, ensure SMS_PRO_PREFIX is available globally if this changes

	/**
	 * Stores the role definitions (slug => display name) provided by the main plugin.
	 *
	 * @since 2.3.0
	 * @var array<string, string>
	 */
	private static array $role_definitions = [];

	/**
	 * Sets the plugin-defined roles and their display names.
	 *
	 * This method is intended to be called by the main plugin instance
	 * during its initialization phase, providing the roles this manager will handle.
	 *
	 * @since 2.3.0
	 * @param array<string, string> $roles An associative array where keys are role slugs
	 *                                     (e.g., 'student', 'teacher') and values are their
	 *                                     display names (e.g., 'Student', 'Teacher').
	 */
	public static function set_role_definitions( array $roles ): void {
		self::$role_definitions = $roles;
		// If SMS_PRO_PREFIX is dynamically set and needs to be fetched, do it here.
		// For now, assuming 'sms_pro_' is the fixed prefix used consistently.
		if ( defined( 'SMS_PRO_PREFIX' ) ) {
			self::$prefix = SMS_PRO_PREFIX;
		}
	}

	/**
	 * Retrieves the role definitions currently set in the manager.
	 *
	 * @since 2.3.0
	 * @return array<string, string> The array of role slugs to display names.
	 */
	public static function get_role_definitions(): array {
		return self::$role_definitions;
	}

	/**
	 * Retrieves the capabilities for a given role slug.
	 *
	 * Uses WordPress transients to cache capabilities for performance. If the cache
	 * is empty or expired, capabilities are regenerated and re-cached.
	 *
	 * @since 2.3.0
	 * @param string $role_slug The unique slug of the role (e.g., 'student').
	 * @return array<string, bool> An associative array of capabilities (capability_name => true).
	 *                             Returns a default array with 'read' => true if generation fails or
	 *                             the role is unknown in a critical way, ensuring basic WP compatibility.
	 */
	public static function get_role_capabilities( string $role_slug ): array {
		if ( empty( $role_slug ) ) {
			if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
				error_log( 'SMS_Pro_Capability_Manager::get_role_capabilities() called with an empty role slug.' );
			}
			return array( 'read' => true ); // Basic fallback
		}

		$cache_key = self::$prefix . 'role_caps_' . sanitize_key( $role_slug );
		$caps      = get_transient( $cache_key );

		if ( false === $caps || ! is_array( $caps ) ) { // Check if it's not a valid array too
			$caps = self::generate_capabilities_for_role( $role_slug );

			/**
			 * Filters the Time-To-Live (TTL) for capability cache.
			 *
			 * @since 2.3.0
			 * @param int    $ttl       The cache duration in seconds. Default is 12 hours.
			 * @param string $role_slug The slug of the role for which capabilities are being cached.
			 */
			$cache_ttl = apply_filters( self::$prefix . 'capability_cache_ttl', 12 * HOUR_IN_SECONDS, $role_slug );
			set_transient( $cache_key, $caps, (int) $cache_ttl );
		}

		// Ensure it's always an array, with 'read' as a fundamental fallback.
		return is_array( $caps ) ? $caps : array( 'read' => true );
	}

	/**
	 * Generates the definitive array of capabilities for a specific role slug.
	 *
	 * This method contains the core logic for assigning capabilities to roles.
	 * All roles receive the 'read' capability by default. Specific capabilities
	 * are added based on the role_slug. The list can be extended via a filter.
	 *
	 * @since 2.3.0
	 * @access private
	 * @param string $role_slug The slug of the role.
	 * @return array<string, bool> An associative array of capabilities.
	 */
	private static function generate_capabilities_for_role( string $role_slug ): array {
		// Ensure prefix is up-to-date, especially if SMS_PRO_PREFIX might be defined after class load.
		if ( defined( 'SMS_PRO_PREFIX' ) ) {
			self::$prefix = SMS_PRO_PREFIX;
		}
		$p    = self::$prefix;
		$caps = array( 'read' => true ); // Fundamental WordPress capability for all roles.

		$role_specific_caps = []; // Initialize to ensure it's an array.

		switch ( $role_slug ) {
			case 'student':
				$role_specific_caps = array(
					$p . 'view_own_dashboard'    => true,
					$p . 'view_own_profile'      => true,
					$p . 'edit_own_profile'      => true,
					$p . 'view_own_grades'       => true,
					$p . 'view_own_attendance'   => true,
					$p . 'access_lms_content'    => true,
					$p . 'submit_assignments'    => true,
					$p . 'view_own_timetable'    => true,
				);
				break;
			case 'parent':
				$role_specific_caps = array(
					$p . 'view_child_dashboard'  => true,
					$p . 'view_child_profile'    => true,
					$p . 'view_child_grades'     => true,
					$p . 'view_child_attendance' => true,
					$p . 'view_child_timetable'  => true,
					$p . 'communicate_with_teachers' => true,
					$p . 'view_school_events'    => true,
					$p . 'view_fee_details'      => true,
				);
				break;
			case 'teacher':
				$role_specific_caps = array(
					$p . 'view_teacher_dashboard' => true,
					$p . 'manage_own_students'    => true,
					$p . 'record_student_attendance' => true,
					$p . 'manage_student_grades'  => true,
					$p . 'create_lms_content'     => true,
					$p . 'grade_assignments'      => true,
					$p . 'communicate_with_parents' => true,
					$p . 'manage_class_timetable' => true,
				);
				break;
			case 'administrator_school':
				$role_specific_caps = array(
					$p . 'view_admin_dashboard'   => true,
					$p . 'manage_plugin_settings' => true,
					// The line for 'manage_settings' has been removed to avoid redundancy.
					$p . 'manage_all_students'    => true,
					$p . 'manage_all_staff'       => true,
					$p . 'manage_all_attendance'  => true,
					$p . 'manage_all_grades'      => true,
					$p . 'manage_lms'             => true,
					$p . 'manage_finances'        => true,
					$p . 'manage_library_resources' => true,
					$p . 'manage_transport_system' => true,
					$p . 'manage_school_inventory' => true,
					$p . 'manage_health_module'   => true,
					$p . 'manage_student_behavior' => true,
					$p . 'manage_school_events'   => true,
					$p . 'send_broadcast_messages' => true,
					$p . 'generate_all_reports'   => true,
					$p . 'access_plugin_api'      => true,
					$p . 'manage_academic_year'   => true,
					$p . 'manage_user_roles'      => true,
				);
				break;
			case 'librarian':
				$role_specific_caps = array(
					$p . 'manage_library_dashboard' => true,
					$p . 'manage_library_books'     => true,
					$p . 'manage_book_circulation'  => true,
					$p . 'generate_library_reports' => true,
				);
				break;
			case 'accountant':
				$role_specific_caps = array(
					$p . 'manage_fees_structure'    => true,
					$p . 'record_fee_payments'      => true,
					$p . 'generate_financial_reports' => true,
					$p . 'manage_expense_tracking'  => true,
				);
				break;
			case 'nurse':
				$role_specific_caps = array(
					$p . 'view_health_dashboard'   => true,
					$p . 'manage_student_health_records' => true,
					$p . 'record_medical_incidents' => true,
					$p . 'manage_medication_log'   => true,
				);
				break;
			case 'alumni':
				$role_specific_caps = array(
					$p . 'view_alumni_portal'     => true,
					$p . 'update_own_alumni_profile' => true,
					$p . 'view_alumni_directory'  => true,
					$p . 'view_alumni_events'     => true,
				);
				break;
			default:
				// If the role slug doesn't match any predefined cases,
				// it will only have the 'read' capability from $caps initialization.
				// This allows for dynamically added roles to get basic access,
				// with their specific caps potentially added via the filter below.
				break;
		}

		/**
		 * Filters the role-specific capabilities before they are merged with default capabilities.
		 *
		 * @since 2.3.0
		 * @param array  $role_specific_caps An array of capabilities specific to the role.
		 * @param string $role_slug          The slug of the role being processed.
		 */
		$role_specific_caps = apply_filters( self::$prefix . 'role_capabilities_' . $role_slug, $role_specific_caps, $role_slug );

		return array_merge( $caps, (array) $role_specific_caps ); // Ensure $role_specific_caps is an array.
	}

	/**
	 * Clears the capability cache (transients) for one or more roles.
	 *
	 * This is typically called during plugin activation, deactivation, or when
	 * role definitions or capabilities are updated programmatically.
	 *
	 * @since 2.3.0
	 * @param array<string>|string|null $role_slugs Specific role slug(s) to clear cache for.
	 *                                                If null, clears cache for all roles defined
	 *                                                in self::$role_definitions.
	 */
	public static function clear_capability_cache( $role_slugs = null ): void {
		if ( null === $role_slugs ) {
			if ( empty( self::$role_definitions ) ) {
				// Attempt to fetch from main plugin if roles haven't been set here yet.
				// This might occur if called very early, though set_role_definitions should be prioritized.
				if ( function_exists('sms_pro_get_plugin_instance') ) {
				    $plugin_instance = sms_pro_get_plugin_instance();
                    self::set_role_definitions( $plugin_instance->get_role_definitions() ); // Ensure local copy is populated
				}
                if ( empty( self::$role_definitions ) && defined( 'WP_DEBUG' ) && WP_DEBUG ) {
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
                    error_log( 'SMS_Pro_Capability_Manager::clear_capability_cache() called with null $role_slugs but internal role definitions are empty.' );
                    return;
                }
			}
			$role_slugs = array_keys( self::$role_definitions );
		} elseif ( is_string( $role_slugs ) ) {
			$role_slugs = array( $role_slugs );
		}

		if ( ! is_array( $role_slugs ) || empty( $role_slugs ) ) {
			return;
		}

		foreach ( $role_slugs as $slug ) {
			if ( ! empty( $slug ) && is_string( $slug ) ) {
				delete_transient( self::$prefix . 'role_caps_' . sanitize_key( $slug ) );
			}
		}

		/**
		 * Action hook fired after capability caches have been cleared.
		 *
		 * @since 2.3.0
		 * @param array<string> $cleared_role_slugs The slugs of the roles whose caches were cleared.
		 */
		do_action( self::$prefix . 'capability_cache_cleared', $role_slugs );
	}
}/*
 * School Management Pro - Core Include
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * School Management System Pro - Installer.
 *
 * Handles activation, deactivation, database table creation, role registration,
 * and potentially version upgrade tasks for the plugin.
 *
 * @package SchoolManagementSystemPro
 * @subpackage Includes/Lifecycle
 * @since 2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class SMS_Pro_Install.
 *
 * Contains static methods for plugin lifecycle events. This class ensures
 * that the plugin is set up correctly on activation and cleaned up (where appropriate)
 * on deactivation.
 *
 * @since 2.3.0
 */
class SMS_Pro_Install {

	/**
	 * Plugin activation routines.
	 *
	 * This static method is hooked to `register_activation_hook`. It orchestrates
	 * the creation of database tables, registration of custom user roles, and
	 * other setup tasks necessary for the plugin to function correctly.
	 *
	 * @since 2.3.0
	 * @throws Exception If critical components like the main plugin instance or
	 *                   Capability Manager are unavailable.
	 */
	public static function activate(): void {
		if ( ! function_exists( 'sms_pro_get_plugin_instance' ) ) {
			// This is a critical failure. The main plugin isn't loaded correctly.
			// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( 'SMS Pro Install Error: sms_pro_get_plugin_instance() function not found during activation. Plugin may not be correctly structured or loaded.' );
			// Optionally, could throw an Exception or `wp_die()` but that might be too aggressive for activation.
			// Allowing it to proceed might lead to partial setup; logging is crucial here.
			return; // Exit early to prevent further errors.
		}
		$plugin_instance = sms_pro_get_plugin_instance();

		// Ensure Role Definitions are passed to the Capability Manager.
		// The main plugin's instance() method should call define_internal_roles(),
		// which in turn calls SMS_Pro_Capability_Manager::set_role_definitions().
		// We explicitly fetch them here to ensure they are available for table/role creation.
		$role_definitions = $plugin_instance->get_role_definitions();
		$table_schemas    = $plugin_instance->get_table_schemas();

		if ( empty( $role_definitions ) && defined( 'WP_DEBUG' ) && WP_DEBUG ) {
			// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( 'SMS Pro Install Warning: Role definitions are empty during activation.' );
		}
		if ( empty( $table_schemas ) && defined( 'WP_DEBUG' ) && WP_DEBUG ) {
			// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( 'SMS Pro Install Warning: Table schemas are empty during activation.' );
		}

		self::create_plugin_tables( $table_schemas );
		self::register_plugin_roles( $role_definitions );

		// Clear capability cache for all plugin-defined roles.
		if ( class_exists( 'SMS_Pro_Capability_Manager' ) ) {
			SMS_Pro_Capability_Manager::clear_capability_cache( array_keys( $role_definitions ) );
		} else {
			// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( 'SMS Pro Install Error: SMS_Pro_Capability_Manager class not found during activation. Capabilities cache may not be cleared.' );
			// This would be a significant issue if SMS_Pro_Capability_Manager.php isn't included correctly.
		}

		flush_rewrite_rules();

		// Set a transient for a welcome notice or post-activation setup wizard.
		set_transient( SMS_PRO_PREFIX . 'activation_redirect', true, 30 ); // 30 seconds TTL

		/**
		 * Action hook fired after the plugin has been successfully activated and set up.
		 *
		 * @since 2.3.0
		 * @param School_Management_System_Pro $plugin_instance The main plugin instance.
		 */
		do_action( SMS_PRO_PREFIX . 'plugin_activated', $plugin_instance );
	}

	/**
	 * Plugin deactivation routines.
	 *
	 * This static method is hooked to `register_deactivation_hook`. It performs
	 * cleanup tasks such as clearing scheduled cron jobs and flushing rewrite rules.
	 * It does NOT typically remove data (like tables or options) to preserve user data.
	 *
	 * @since 2.3.0
	 */
	public static function deactivate(): void {
		// Clear capability cache.
        // Attempt to get roles if needed; main instance might not be fully available but should provide role keys.
        $role_slugs_to_clear = [];
        if ( function_exists('sms_pro_get_plugin_instance') ) {
            $plugin_instance = sms_pro_get_plugin_instance();
            $role_definitions = $plugin_instance->get_role_definitions();
            if( !empty( $role_definitions ) ) {
                 $role_slugs_to_clear = array_keys( $role_definitions );
            }
        }

		if ( class_exists( 'SMS_Pro_Capability_Manager' ) ) {
            // If we couldn't get role slugs, clear_capability_cache(null) will use its internal list if populated.
			SMS_Pro_Capability_Manager::clear_capability_cache( empty($role_slugs_to_clear) ? null : $role_slugs_to_clear );
		} else {
			if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
				error_log( 'SMS Pro Install Warning: SMS_Pro_Capability_Manager class not found during deactivation. Capabilities cache may not be cleared.' );
			}
		}

		/**
		 * Filters the list of plugin-specific cron hook names to be cleared on deactivation.
		 *
		 * @since 2.3.0
		 * @param array $cron_hooks An array of cron hook names.
		 */
		$cron_hooks = apply_filters( SMS_PRO_PREFIX . 'cron_hooks_to_clear', array() );
		if ( ! empty( $cron_hooks ) && is_array( $cron_hooks ) ) {
			foreach ( $cron_hooks as $hook_name ) {
				if ( is_string( $hook_name ) && ! empty( $hook_name ) ) {
					wp_clear_scheduled_hook( sanitize_key( $hook_name ) );
				}
			}
		}

		flush_rewrite_rules();

        $plugin_instance = function_exists('sms_pro_get_plugin_instance') ? sms_pro_get_plugin_instance() : null;
		/**
		 * Action hook fired after the plugin has been deactivated.
		 *
		 * @since 2.3.0
         * @param School_Management_System_Pro|null $plugin_instance The main plugin instance, if available.
		 */
		do_action( SMS_PRO_PREFIX . 'plugin_deactivated', $plugin_instance );
	}

	/**
	 * Creates or updates custom database tables using WordPress dbDelta function.
	 *
	 * @since 2.3.0
	 * @access private
	 * @param array<string, string> $table_schemas An associative array of table names (keys, without prefix)
	 *                                             and their SQL CREATE TABLE statements (values).
	 */
	private static function create_plugin_tables( array $table_schemas ): void {
		if ( empty( $table_schemas ) ) {
			return;
		}

		global $wpdb;
		if ( ! function_exists( 'dbDelta' ) ) {
			require_once ABSPATH . 'wp-admin/includes/upgrade.php';
		}

		$charset_collate = $wpdb->get_charset_collate();
		$db_prefix       = $wpdb->prefix; // Standard WordPress table prefix.
		$tables_log      = [];

		// Check for potential table conflicts before creating tables
		$conflict_check = self::check_table_conflicts( $table_schemas, $db_prefix );
		if ( ! empty( $conflict_check['conflicts'] ) ) {
			// Log conflicts and potentially stop activation
			foreach ( $conflict_check['conflicts'] as $table_name => $conflict_info ) {
				$tables_log[] = "CONFLICT DETECTED: Table '{$table_name}' - {$conflict_info}";
				if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
					error_log( "SMS Pro Install: Table conflict detected for {$table_name} - {$conflict_info}" );
				}
			}
			
			// In production, we might want to stop activation if conflicts are detected
			if ( ! defined( 'SMS_PRO_ALLOW_TABLE_CONFLICTS' ) || ! SMS_PRO_ALLOW_TABLE_CONFLICTS ) {
				$tables_log[] = "STOPPING ACTIVATION due to table conflicts. Set SMS_PRO_ALLOW_TABLE_CONFLICTS=true to override.";
				return;
			}
		}

		foreach ( $table_schemas as $table_key => $schema_sql ) {
			// Construct the full table name. Schema SQL should use '%prefix%sms_TABLEKEY'.
			// $table_key is like 'students', 'staff', etc.
			// So, $db_prefix . 'sms_' . $table_key (e.g., 'wp_sms_students') should match placeholder in schema.
			$table_name_for_log = $db_prefix . 'sms_' . sanitize_key( $table_key );

			// Replace placeholders in the SQL schema.
			// The SQL should look like: CREATE TABLE %prefix%sms_students (...) %charset_collate%;
			$sql = str_replace(
				array( '%prefix%sms_', '%charset_collate%' ),
				array( $db_prefix . 'sms_', $charset_collate ), // Results in 'wp_sms_students'
				$schema_sql
			);

			// dbDelta is particular about formatting. Ensure two spaces after PRIMARY KEY.
			// And ensure table names in SQL match expected WordPress format (including prefix).
			$sql = preg_replace( '/PRIMARY KEY\s?\(/', 'PRIMARY KEY  (', $sql );
            // Example: Make sure keys like `KEY idx_user_id (user_id)` are well-formed.

			$results = dbDelta( $sql ); // dbDelta expects full SQL statements for each table.

			if ( ! empty( $wpdb->last_error ) ) {
				$tables_log[] = "Table '{$table_name_for_log}': Error during dbDelta - " . $wpdb->last_error;
				if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
					// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
					error_log( "SMS Pro Install Error creating table {$table_name_for_log}: {$wpdb->last_error}. SQL: {$sql}" );
				}
			} elseif ( ! empty( $results ) ) {
				// $results array contains messages about table creation/alteration.
				// We can log these for detailed diagnostics if needed.
				$tables_log[] = "Table '{$table_name_for_log}': Processed by dbDelta. Results: " . wp_json_encode( $results );
			} else {
				$tables_log[] = "Table '{$table_name_for_log}': No changes detected by dbDelta.";
			}
		}

		if ( ! empty( $tables_log ) && defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG ) {
			$log_message = "School Management System Pro - Database Table Setup Log:\n" . implode( "\n", $tables_log );
			// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( $log_message );
		}

		/**
		 * Action hook fired after database tables have been processed by dbDelta.
		 *
		 * @since 2.3.0
		 * @param array $processed_tables_log Log of dbDelta operations.
		 */
		do_action( SMS_PRO_PREFIX . 'database_tables_created', $tables_log );
	}

	/**
	 * Check for potential table conflicts with existing plugins
	 *
	 * @since 2.3.0
	 * @access private
	 * @param array $table_schemas Array of table schemas to check
	 * @param string $db_prefix Database prefix
	 * @return array Array with conflicts if any
	 */
	private static function check_table_conflicts( array $table_schemas, string $db_prefix ): array {
		global $wpdb;
		$conflicts = array();
		
		// Common conflicting table prefixes from other school management plugins
		$conflicting_prefixes = array(
			'sms_',
			'school_',
			'student_',
			'education_',
			'academy_',
			'wpsms_',
			'school_management_',
			'student_management_'
		);
		
		foreach ( $table_schemas as $table_key => $schema_sql ) {
			$table_name = $db_prefix . 'sms_' . sanitize_key( $table_key );
			
			// Check if table already exists
			if ( $wpdb->get_var( $wpdb->prepare( "SHOW TABLES LIKE %s", $table_name ) ) ) {
				$conflicts[ $table_name ] = 'Table already exists - possible conflict with another plugin';
				continue;
			}
			
			// Check for similar table names with different prefixes
			foreach ( $conflicting_prefixes as $conflict_prefix ) {
				$conflict_table = $db_prefix . $conflict_prefix . sanitize_key( $table_key );
				if ( $wpdb->get_var( $wpdb->prepare( "SHOW TABLES LIKE %s", $conflict_table ) ) ) {
					$conflicts[ $table_name ] = "Similar table exists: {$conflict_table} - potential conflict";
					break;
				}
			}
		}
		
		return array( 'conflicts' => $conflicts );
	}

	/**
	 * Registers or updates custom user roles and their capabilities.
	 *
	 * Uses SMS_Pro_Capability_Manager to get the capabilities for each role.
	 *
	 * @since 2.3.0
	 * @access private
	 * @param array<string, string> $role_definitions An associative array of role slugs (keys)
	 *                                                and their display names (values).
	 */
	private static function register_plugin_roles( array $role_definitions ): void {
		if ( empty( $role_definitions ) ) {
			return;
		}

		if ( ! class_exists( 'SMS_Pro_Capability_Manager' ) ) {
			if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
				// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
				error_log( 'SMS Pro Install Error: SMS_Pro_Capability_Manager class not found during role registration. Roles cannot be registered.' );
			}
			return;
		}

		foreach ( $role_definitions as $slug => $name ) {
			$slug = sanitize_key( $slug );
			$name = sanitize_text_field( $name );

			if ( empty( $slug ) || empty( $name ) ) {
				continue;
			}

			// Get capabilities from the (already loaded and populated) Capability Manager.
			$capabilities = SMS_Pro_Capability_Manager::get_role_capabilities( $slug );
			$role_object  = get_role( $slug );

			if ( ! $role_object ) {
				// Role does not exist, add it.
				add_role( $slug, $name, $capabilities );
			} else {
				// Role exists, update its capabilities to ensure they are current.
				// First, remove all plugin-specific capabilities.
				foreach ( $role_object->capabilities as $cap_key => $grant ) {
					if ( strpos( $cap_key, SMS_PRO_PREFIX ) === 0 ) { // Only manage our own capabilities.
						$role_object->remove_cap( $cap_key );
					}
				}
				// Then, add the current set of capabilities for this role.
				foreach ( $capabilities as $cap_key => $grant ) {
					// We only add our own or 'read'. 'read' is handled by get_role_capabilities.
					if ( strpos( $cap_key, SMS_PRO_PREFIX ) === 0 || $cap_key === 'read' ) {
						$role_object->add_cap( $cap_key, $grant );
					}
				}
			}
		}

		/**
		 * Action hook fired after plugin roles have been registered or updated.
		 *
		 * @since 2.3.0
		 * @param array $role_definitions The definitions of roles that were processed.
		 */
		do_action( SMS_PRO_PREFIX . 'plugin_roles_registered', $role_definitions );
	}

	/**
	 * Checks for and applies plugin version upgrades.
	 *
	 * This method can be hooked to 'plugins_loaded' or 'admin_init'. It compares
	 * the current plugin version with a stored version and runs upgrade routines
	 * if necessary (e.g., schema changes, data migration, capability updates).
	 *
	 * @since 2.3.0
	 */
	public static function check_for_upgrades(): void {
		$current_plugin_version = SMS_PRO_VERSION; // Defined in main plugin file.
		$stored_version         = get_option( SMS_PRO_PREFIX . 'version', '0.0.0' );

		if ( version_compare( $stored_version, $current_plugin_version, '<' ) ) {
			// --- Example Upgrade Path ---
			// if ( version_compare( $stored_version, '2.3.0', '<' ) ) {
			//     self::upgrade_to_2_3_0();
			// }
			// if ( version_compare( $stored_version, '2.3.0', '<' ) ) {
			//     self::upgrade_to_2_3_0();
			// }

			// After all specific upgrade routines have run:
			// 1. Potentially re-register roles if capabilities changed between versions.
			if ( function_exists('sms_pro_get_plugin_instance') ) {
			    $plugin_instance = sms_pro_get_plugin_instance();
			    $role_definitions = $plugin_instance->get_role_definitions();
			    self::register_plugin_roles( $role_definitions ); // This will update capabilities.
			}

			// 2. Clear capability cache.
			if ( class_exists( 'SMS_Pro_Capability_Manager' ) ) {
				SMS_Pro_Capability_Manager::clear_capability_cache(); // Clear all
			}

			// 3. Flush rewrite rules if CPTs, taxonomies, or REST routes might have changed.
			flush_rewrite_rules();

			// 4. Update the stored version to the current plugin version.
			update_option( SMS_PRO_PREFIX . 'version', $current_plugin_version );

			/**
			 * Action hook fired after plugin upgrade routines have been completed.
			 *
			 * @since 2.3.0
			 * @param string $new_version The version upgraded to.
			 * @param string $old_version The version upgraded from.
			 */
			do_action( SMS_PRO_PREFIX . 'plugin_upgraded', $current_plugin_version, $stored_version );
		}
	}

	// --- Example Upgrade Step Methods ---
	// /**
	//  * Upgrade routines for version 2.3.0.
	//  * @since 2.3.0 (Placeholder method)
	//  */
	// private static function upgrade_to_2_3_0(): void {
	//     // Example: Add a new column to a table, update an option, migrate data.
	//     // Always backup database before running schema changes.
	//     // error_log( 'SMS Pro: Upgrading to version 2.1.0...' );
	// }

	/**
	 * Define table schemas for the plugin
	 * 
	 * @since 2.3.0
	 * @return array
	 */
	public static function get_table_schemas(): array {
		$table_schemas = array(
			'students' => "CREATE TABLE %prefix%sms_students (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				user_id bigint(20) unsigned DEFAULT NULL,
				student_id varchar(20) NOT NULL,
				first_name varchar(50) NOT NULL,
				last_name varchar(50) NOT NULL,
				email varchar(100) DEFAULT NULL,
				phone varchar(20) DEFAULT NULL,
				date_of_birth date DEFAULT NULL,
				gender enum('male','female','other') DEFAULT NULL,
				address text,
				city varchar(50) DEFAULT NULL,
				state varchar(50) DEFAULT NULL,
				postal_code varchar(20) DEFAULT NULL,
				country varchar(50) DEFAULT 'US',
				class_id bigint(20) unsigned DEFAULT NULL,
				parent_id bigint(20) unsigned DEFAULT NULL,
				enrollment_date date DEFAULT NULL,
				status enum('active','inactive','graduated','transferred') DEFAULT 'active',
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				UNIQUE KEY student_id (student_id),
				KEY user_id (user_id),
				KEY class_id (class_id),
				KEY parent_id (parent_id),
				KEY status (status)
			) %charset_collate%;",
			
			'staff' => "CREATE TABLE %prefix%sms_staff (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				user_id bigint(20) unsigned DEFAULT NULL,
				employee_id varchar(20) NOT NULL,
				first_name varchar(50) NOT NULL,
				last_name varchar(50) NOT NULL,
				email varchar(100) DEFAULT NULL,
				phone varchar(20) DEFAULT NULL,
				position varchar(100) DEFAULT NULL,
				department varchar(100) DEFAULT NULL,
				hire_date date DEFAULT NULL,
				status enum('active','inactive','terminated') DEFAULT 'active',
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				UNIQUE KEY employee_id (employee_id),
				KEY user_id (user_id),
				KEY status (status)
			) %charset_collate%;",
			
			'classes' => "CREATE TABLE %prefix%sms_classes (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				name varchar(100) NOT NULL,
				description text,
				teacher_id bigint(20) unsigned DEFAULT NULL,
				capacity int(11) DEFAULT NULL,
				schedule text,
				room_number varchar(20) DEFAULT NULL,
				academic_year varchar(20) DEFAULT NULL,
				semester varchar(20) DEFAULT NULL,
				status enum('active','inactive') DEFAULT 'active',
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				KEY teacher_id (teacher_id),
				KEY status (status)
			) %charset_collate%;",
			
			'attendance' => "CREATE TABLE %prefix%sms_attendance (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				student_id bigint(20) unsigned NOT NULL,
				class_id bigint(20) unsigned DEFAULT NULL,
				date date NOT NULL,
				status enum('present','absent','late','excused') NOT NULL DEFAULT 'present',
				time_in time DEFAULT NULL,
				time_out time DEFAULT NULL,
				notes text,
				recorded_by bigint(20) unsigned DEFAULT NULL,
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				UNIQUE KEY student_date (student_id, date),
				KEY class_id (class_id),
				KEY date (date),
				KEY status (status),
				KEY recorded_by (recorded_by)
			) %charset_collate%;",
			
			'grades' => "CREATE TABLE %prefix%sms_grades (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				student_id bigint(20) unsigned NOT NULL,
				class_id bigint(20) unsigned NOT NULL,
				assignment_name varchar(100) NOT NULL,
				assignment_type enum('homework','quiz','test','project','exam','participation') DEFAULT 'homework',
				grade decimal(5,2) DEFAULT NULL,
				max_grade decimal(5,2) DEFAULT 100.00,
				weight decimal(5,2) DEFAULT 1.00,
				due_date date DEFAULT NULL,
				submitted_date date DEFAULT NULL,
				comments text,
				graded_by bigint(20) unsigned DEFAULT NULL,
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				updated_at datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				KEY student_id (student_id),
				KEY class_id (class_id),
				KEY assignment_type (assignment_type),
				KEY due_date (due_date),
				KEY graded_by (graded_by)
			) %charset_collate%;",
			
			'logs' => "CREATE TABLE %prefix%sms_logs (
				id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
				level enum('error','warning','info','debug') NOT NULL DEFAULT 'info',
				message text NOT NULL,
				context longtext,
				created_at datetime DEFAULT CURRENT_TIMESTAMP,
				PRIMARY KEY  (id),
				KEY level (level),
				KEY created_at (created_at)
			) %charset_collate%;"
		);
		
		return apply_filters( SMS_PRO_PREFIX . 'table_schemas', $table_schemas );
	}
}/*
 * School Management Pro - Core Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Core Module for School Management System Pro.
 *
 * This file handles the registration of foundational post types and taxonomies
 * that are shared across various modules within the plugin.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/core
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Core
 *
 * Implements the core functionalities like registering shared CPTs and Taxonomies.
 */
class sms_pro_Module_Core implements SMS_Module_Interface {

	/**
	 * Constructor for the Core Module.
	 *
	 * Initializes the module and registers its hooks with WordPress.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->register_hooks();
	}

	/**
	 * Registers all the hooks for this module.
	 *
	 * This method is the central place for all WordPress action and filter hooks.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		add_action( 'init', array( $this, 'register_core_taxonomies' ), 5 );
		add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_core_submenus' ) );
	}

	/**
	 * Registers core, shared taxonomies for the plugin.
	 *
	 * Taxonomies such as 'Subjects' and 'Academic Years' are foundational
	 * and used by multiple other modules (e.g., Classes, Grading, Reports).
	 *
	 * @since 2.3.0
	 */
	public function register_core_taxonomies() {

		// Register Subject Taxonomy
		$subject_labels = array(
			'name'              => _x( 'Subjects', 'taxonomy general name', SMS_PRO_TEXT_DOMAIN ),
			'singular_name'     => _x( 'Subject', 'taxonomy singular name', SMS_PRO_TEXT_DOMAIN ),
			'search_items'      => __( 'Search Subjects', SMS_PRO_TEXT_DOMAIN ),
			'all_items'         => __( 'All Subjects', SMS_PRO_TEXT_DOMAIN ),
			'parent_item'       => __( 'Parent Subject', SMS_PRO_TEXT_DOMAIN ),
			'parent_item_colon' => __( 'Parent Subject:', SMS_PRO_TEXT_DOMAIN ),
			'edit_item'         => __( 'Edit Subject', SMS_PRO_TEXT_DOMAIN ),
			'update_item'       => __( 'Update Subject', SMS_PRO_TEXT_DOMAIN ),
			'add_new_item'      => __( 'Add New Subject', SMS_PRO_TEXT_DOMAIN ),
			'new_item_name'     => __( 'New Subject Name', SMS_PRO_TEXT_DOMAIN ),
			'menu_name'         => __( 'Subjects', SMS_PRO_TEXT_DOMAIN ),
		);

		$subject_args = array(
			'hierarchical'      => true, // e.g., 'Science' -> 'Physics'
			'labels'            => $subject_labels,
			'show_ui'           => true,
			'show_admin_column' => true,
			'query_var'         => true,
			'rewrite'           => array( 'slug' => 'subject' ),
			'show_in_rest'      => true,
			// We will associate this taxonomy with specific CPTs (like 'sms_pro_class') in their respective modules.
		);

		register_taxonomy( SMS_PRO_PREFIX . 'subject', array(), $subject_args );

		// Register Academic Year Taxonomy
		$academic_year_labels = array(
			'name'              => _x( 'Academic Years', 'taxonomy general name', SMS_PRO_TEXT_DOMAIN ),
			'singular_name'     => _x( 'Academic Year', 'taxonomy singular name', SMS_PRO_TEXT_DOMAIN ),
			'search_items'      => __( 'Search Academic Years', SMS_PRO_TEXT_DOMAIN ),
			'all_items'         => __( 'All Academic Years', SMS_PRO_TEXT_DOMAIN ),
			'edit_item'         => __( 'Edit Academic Year', SMS_PRO_TEXT_DOMAIN ),
			'update_item'       => __( 'Update Academic Year', SMS_PRO_TEXT_DOMAIN ),
			'add_new_item'      => __( 'Add New Academic Year', SMS_PRO_TEXT_DOMAIN ),
			'new_item_name'     => __( 'New Academic Year Name', SMS_PRO_TEXT_DOMAIN ),
			'menu_name'         => __( 'Academic Years', SMS_PRO_TEXT_DOMAIN ),
		);

		$academic_year_args = array(
			'hierarchical'      => false, // e.g., '2023-2024'
			'labels'            => $academic_year_labels,
			'show_ui'           => true,
			'show_admin_column' => true,
			'query_var'         => true,
			'rewrite'           => array( 'slug' => 'academic-year' ),
			'show_in_rest'      => true,
		);

		register_taxonomy( SMS_PRO_PREFIX . 'academic_year', array(), $academic_year_args );
	}

	/**
	 * Adds admin submenus for the core module functionalities.
	 *
	 * This method hooks into the main plugin's submenu filter to add
	 * management pages for core taxonomies.
	 *
	 * @param array $submenus The existing array of submenus.
	 * @return array The modified array of submenus.
	 * @since 2.3.0
	 */
	public function add_core_submenus( array $submenus ): array {
		$submenus[ SMS_PRO_PREFIX . 'subjects' ] = array(
			'parent_slug' => SMS_PRO_PREFIX . 'dashboard',
			'page_title'  => esc_html__( 'Manage Subjects', SMS_PRO_TEXT_DOMAIN ),
			'menu_title'  => esc_html__( 'Subjects', SMS_PRO_TEXT_DOMAIN ),
			'capability'  => SMS_PRO_PREFIX . 'manage_core_settings', // Example capability
			'callback'    => function() {
				// Use wp_redirect() for better security and user experience
				$url = admin_url( 'edit-tags.php?taxonomy=' . SMS_PRO_PREFIX . 'subject' );
				wp_redirect( esc_url_raw( $url ) );
				exit;
			},
			'module_slug' => 'core',
			'position'    => 30,
		);

		$submenus[ SMS_PRO_PREFIX . 'academic_years' ] = array(
			'parent_slug' => SMS_PRO_PREFIX . 'dashboard',
			'page_title'  => esc_html__( 'Manage Academic Years', SMS_PRO_TEXT_DOMAIN ),
			'menu_title'  => esc_html__( 'Academic Years', SMS_PRO_TEXT_DOMAIN ),
			'capability'  => SMS_PRO_PREFIX . 'manage_core_settings', // Example capability
			'callback'    => function() {
				// Use wp_redirect() for better security and user experience
				$url = admin_url( 'edit-tags.php?taxonomy=' . SMS_PRO_PREFIX . 'academic_year' );
				wp_redirect( esc_url_raw( $url ) );
				exit;
			},
			'module_slug' => 'core',
			'position'    => 40,
		);

		return $submenus;
	}
}/*
 * School Management Pro - Students Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Student Management.
 *
 * This file acts as the entry point for the 'students' module. It loads all necessary
 * sub-components (Admin, AJAX, Data handlers) and initializes them.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/students
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Students
 *
 * Main orchestrator for the Students module.
 */
class sms_pro_Module_Students implements SMS_Module_Interface {

	/**
	 * Instance of the Admin handler class.
	 * @var sms_pro_Students_Admin|null
	 */
	public ?sms_pro_Students_Admin $admin = null;

	/**
	 * Constructor for the Students Module.
	 *
	 * Loads dependencies and registers initial hooks.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all the necessary files for this module.
	 * @since 2.3.0
	 */
	private function load_dependencies() {
		// Data Handler (Originally CPT, now for custom table interaction)
		require_once SMS_PRO_PATH . 'modules/students/class-students-data.php';

		// Admin area handler
		require_once SMS_PRO_PATH . 'modules/students/class-students-admin.php';

		// AJAX handler
		require_once SMS_PRO_PATH . 'modules/students/class-students-ajax.php';
	}

	/**
	 * Registers all hooks for this module.
	 *
	 * Instantiates the Admin and AJAX classes, allowing them to register their own hooks.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		$this->admin = new sms_pro_Students_Admin();

		$ajax_handler = new sms_pro_Students_AJAX();
		$ajax_handler->register_hooks(); // AJAX hooks are registered within its class.
	}
}/*
 * School Management Pro - Staff Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Staff Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/staff/class-staff-admin.php

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

if ( ! class_exists( 'sms_pro_Staff_Admin' ) ) {
    /**
     * Admin class for the Staff Module.
     * Handles admin-specific functionalities, settings pages, and interactions.
     */
    class sms_pro_Staff_Admin {

        private static $module_slug = 'staff';

        public function __construct() {
            // Add hooks specific to the admin area for this module.
            // These hooks are typically added by the main module class (sms_pro_Module_Staff)
            // Example hook registration, actual calls would be in sms_pro_Module_Staff::register_hooks()
            // if ( is_admin() ) {
            //     add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ), 10, 1 );
            //     add_action( 'admin_init', array( $this, 'register_staff_settings' ) );
            // }
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers admin pages or submenus for this module via the main plugin's filter.
         * Hooked to `SMS_PRO_PREFIX . 'admin_submenus'`.
         *
         * @param array $submenus Existing submenus.
         * @return array Modified submenus.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $parent_slug = SMS_PRO_PREFIX . 'dashboard'; // Main plugin dashboard slug
        //
        //     $submenus[ SMS_PRO_PREFIX . self::$module_slug . '_overview' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Staff Management', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Staff', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_staff_overview', // Define this capability
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug, // Crucial for main plugin to know which module content to render
        //         // 'position'    => 10, // Optional: order of submenu item
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . self::$module_slug . '_settings' ] = array(
        //         'parent_slug' => $parent_slug, // Could also be under a staff-specific top-level menu if desired
        //         'page_title'  => esc_html__( 'Staff Settings', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Settings', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_staff_settings', // Define this capability
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug, // Points to a 'settings' view for 'staff'
        //         // 'position'    => 20,
        //     );
        //
        //     return $submenus;
        // }

        /**
         * Registers settings for the Staff module.
         * This method would typically be hooked to 'admin_init'.
         */
        // public function register_staff_settings() {
            // // Register a settings group
            // register_setting(
            //     SMS_PRO_PREFIX . 'staff_settings_group',          // Option group (unique identifier)
            //     SMS_PRO_PREFIX . 'staff_options',                 // Option name (stored in wp_options)
            //     array( $this, 'sanitize_staff_settings' )        // Sanitization callback
            // );
            //
            // // Add a settings section
            // add_settings_section(
            //     SMS_PRO_PREFIX . 'staff_general_section',         // ID for the section
            //     esc_html__( 'General Staff Settings', SMS_PRO_TEXT_DOMAIN ), // Title of the section
            //     array( $this, 'render_staff_general_section_info' ),// Callback for section description
            //     SMS_PRO_PREFIX . 'staff_settings_page'            // Page slug where this section is shown (must match add_submenu_page slug or custom page)
            // );
            //
            // // Add settings fields to the section
            // add_settings_field(
            //     SMS_PRO_PREFIX . 'staff_field_example',           // ID for the field
            //     esc_html__( 'Example Staff Setting', SMS_PRO_TEXT_DOMAIN ),    // Title of the field
            //     array( $this, 'render_staff_field_example_html' ),// Callback to render the field's HTML
            //     SMS_PRO_PREFIX . 'staff_settings_page',           // Page slug
            //     SMS_PRO_PREFIX . 'staff_general_section',        // Section ID
            //     array( 'label_for' => SMS_PRO_PREFIX . 'staff_field_example' ) // For <label> association
            // );
            //
            // // error_log( get_class( $this ) . ' staff settings registered.' );
        // }

        /**
         * Callback to render description for the general staff settings section.
         */
        // public function render_staff_general_section_info() {
        //    echo '<p>' . esc_html__( 'Configure general settings related to the Staff module, such as default roles or notification preferences.', SMS_PRO_TEXT_DOMAIN ) . '</p>';
        // }

        /**
         * Callback to render an example settings field's HTML.
         */
        // public function render_staff_field_example_html() {
        //    $options = get_option( SMS_PRO_PREFIX . 'staff_options' );
        //    $value = isset( $options['staff_field_example'] ) ? $options['staff_field_example'] : '';
        //    echo '<input type="text" id="' . esc_attr( SMS_PRO_PREFIX . 'staff_field_example' ) . '" name="' . esc_attr( SMS_PRO_PREFIX . 'staff_options[staff_field_example]' ) . '" value="' . esc_attr( $value ) . '" class="regular-text" />';
        //    echo '<p class="description">' . esc_html__( 'Enter a value for this example staff setting.', SMS_PRO_TEXT_DOMAIN ) . '</p>';
        // }

        /**
         * Sanitizes Staff module settings before saving to the database.
         *
         * @param array $input The input data from the settings form.
         * @return array Sanitized data.
         */
        // public function sanitize_staff_settings( $input ) {
        //    $sanitized_input = array();
        //    if ( isset( $input['staff_field_example'] ) ) {
        //        $sanitized_input['staff_field_example'] = sanitize_text_field( $input['staff_field_example'] );
        //    }
        //    // Sanitize other staff options here
        //    return $sanitized_input;
        // }

        // Other admin-specific methods for the Staff module can go here
        // e.g., handling form submissions for custom tables, displaying data views, custom metaboxes for staff CPTs.

    } // END class sms_pro_Staff_Admin
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Staff_Admin.' );
    }
}/*
 * School Management Pro - Staff Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Parents Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Parents Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/parents/class-parents-admin.php

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

if ( ! class_exists( 'sms_pro_Parents_Admin' ) ) {
    /**
     * Admin class for the Parents Module.
     */
    class sms_pro_Parents_Admin {

        private static $module_slug = 'parents';

        public function __construct() {
            // Admin hooks are added by sms_pro_Module_Parents
            // if ( is_admin() ) {
            //     add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ) );
            // }
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers admin submenus for the Parents module.
         *
         * @param array $submenus Existing submenus.
         * @return array Modified submenus.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $parent_slug = SMS_PRO_PREFIX . 'dashboard';
        //
        //     $submenus[ SMS_PRO_PREFIX . 'parents' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Manage Parents', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Parents', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_parents', // For School Admins
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     return $submenus;
        // }
        
        // This class could also add meta boxes to the User Edit screen for users with the 'parent' role,
        // for instance, to manage linked students.
        // add_action( 'show_user_profile', array( $this, 'display_parent_meta_fields' ) );
        // add_action( 'edit_user_profile', array( $this, 'display_parent_meta_fields' ) );
        // add_action( 'user_new_form', array( $this, 'display_parent_meta_fields' ) );
        // add_action( 'personal_options_update', array( $this, 'save_parent_meta_fields' ) );
        // add_action( 'edit_user_profile_update', array( $this, 'save_parent_meta_fields' ) );

    } // END class sms_pro_Parents_Admin
}/*
 * School Management Pro - Classes Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Class Management.
 *
 * This file is the primary entry point for the 'classes' module, responsible for
 * loading and initializing its components, including Admin UI, Data handling, and
 * providing an API for other modules to consume class data.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/classes
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Classes
 *
 * Orchestrator for the Classes module.
 */
class sms_pro_Module_Classes implements SMS_Module_Interface {

	/**
	 * Constructor for the Classes Module.
	 *
	 * Loads dependencies and registers hooks.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 * @since 2.3.0
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/classes/';

		// Data Handler for database interactions.
		require_once $module_path . 'class-classes-data.php';

		// Admin area handler for menus and pages (requires WP_List_Table).
		if ( is_admin() ) {
			require_once $module_path . 'class-classes-admin.php';
		}

		// AJAX handler (optional, but good practice).
		require_once $module_path . 'class-classes-ajax.php';
	}

	/**
	 * Registers module hooks.
	 *
	 * Instantiates handler classes and sets up a filter for other modules.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		if ( is_admin() ) {
			$admin_handler = new sms_pro_Classes_Admin();
			$admin_handler->register_hooks();
		}

		$ajax_handler = new sms_pro_Classes_AJAX();
		$ajax_handler->register_hooks();
		
		// This filter allows other modules (like Attendance) to get a list of classes.
		add_filter( SMS_PRO_PREFIX . 'get_all_classes', array( 'sms_pro_Classes_Data', 'get_all_classes' ) );
	}
}/*
 * School Management Pro - Attendance Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Attendance Management.
 *
 * This file serves as the entry point for the 'attendance' module, loading
 * its core components like Admin UI, Data handling, and AJAX services.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/attendance
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Attendance
 *
 * Main class for the Attendance module.
 */
class sms_pro_Module_Attendance implements SMS_Module_Interface {

	/**
	 * Constructor for the Attendance Module.
	 *
	 * Loads module dependencies and registers initial hooks with WordPress.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads the required files for this module to function.
	 * @since 2.3.0
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/attendance/';
		
		// Data handler for database interactions.
		require_once $module_path . 'class-attendance-data.php';

		// Admin area handler for menus and pages.
		require_once $module_path . 'class-attendance-admin.php';

		// AJAX handler for dynamic operations.
		require_once $module_path . 'class-attendance-ajax.php';
	}

	/**
	 * Registers module hooks.
	 *
	 * Instantiates the Admin and AJAX classes, which then register their own specific hooks.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		$admin_handler = new sms_pro_Attendance_Admin();
		$admin_handler->register_hooks();

		$ajax_handler = new sms_pro_Attendance_AJAX();
		$ajax_handler->register_hooks();
	}
}/*
 * School Management Pro - Grading Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Grade Management.
 *
 * This file is the entry point for the 'grading' module. It initializes the admin
 * interface for grade entry, data handlers, and AJAX services.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/grading
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Grading
 */
class sms_pro_Module_Grading implements SMS_Module_Interface {

	/**
	 * Constructor for the Grading Module.
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/grading/';
		
		require_once $module_path . 'class-grading-data.php';

		if ( is_admin() ) {
			require_once $module_path . 'class-grading-admin.php';
		}
		
		require_once $module_path . 'class-grading-ajax.php';
	}

	/**
	 * Registers all hooks for this module.
	 */
	public function register_hooks() {
		if ( is_admin() ) {
			$admin_handler = new sms_pro_Grading_Admin();
			$admin_handler->register_hooks();
		}
		
		$ajax_handler = new sms_pro_Grading_AJAX();
		$ajax_handler->register_hooks();
	}
}/*
 * School Management Pro - LMS Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - LMS Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/lms/class-lms-admin.php

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

if ( ! class_exists( 'sms_pro_Lms_Admin' ) ) {
    /**
     * Admin class for the LMS Module.
     */
    class sms_pro_Lms_Admin {

        private static $module_slug = 'lms';

        public function __construct() {
            // Admin hooks are added by sms_pro_Module_Lms
            // if ( is_admin() ) {
            //     add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ) );
            //     add_action( 'admin_init', array( $this, 'register_lms_settings' ) );
            // }
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers admin submenus for the LMS module.
         *
         * @param array $submenus Existing submenus.
         * @return array Modified submenus.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $parent_slug = SMS_PRO_PREFIX . 'dashboard';
        //
        //     $submenus[ SMS_PRO_PREFIX . 'lms_courses' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'LMS Courses', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Courses', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_lms_courses',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . 'lms_quizzes' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'LMS Quizzes', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Quizzes', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_lms_quizzes',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . 'lms_settings' ] = array(
        //         'parent_slug' => 'options-general.php',
        //         'page_title'  => esc_html__( 'LMS Settings', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'LMS', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_lms_settings',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     return $submenus;
        // }

        /**
         * Registers settings for the LMS module.
         */
        // public function register_lms_settings() {
        //     register_setting(
        //         SMS_PRO_PREFIX . 'lms_settings_group',
        //         SMS_PRO_PREFIX . 'lms_options',
        //         array( $this, 'sanitize_lms_settings' )
        //     );
        //
        //     add_settings_section(
        //         SMS_PRO_PREFIX . 'lms_general_section',
        //         esc_html__( 'General LMS Settings', SMS_PRO_TEXT_DOMAIN ), null,
        //         SMS_PRO_PREFIX . 'lms_settings' // Page slug
        //     );
        //
        //     add_settings_field(
        //         'allow_course_retakes',
        //         esc_html__( 'Allow Course Retakes', SMS_PRO_TEXT_DOMAIN ),
        //         array( $this, 'render_field_html' ),
        //         SMS_PRO_PREFIX . 'lms_settings',
        //         SMS_PRO_PREFIX . 'lms_general_section',
        //         array( 'id' => 'allow_course_retakes', 'type' => 'checkbox' )
        //     );
        // }

        /**
        * Renders a generic settings field's HTML.
        */
        // public function render_field_html( $args ) {
        //     $options = get_option( SMS_PRO_PREFIX . 'lms_options', array() );
        //     $id = $args['id'];
        //     $type = $args['type'] ?? 'text';
        //     $value = $options[$id] ?? ( $args['default'] ?? '' );
        //     if ($type === 'checkbox') {
        //          echo '<input type="checkbox" id="' . esc_attr($id) . '" name="' . esc_attr(SMS_PRO_PREFIX . 'lms_options['.$id.']') . '" value="1" ' . checked(1, $value, false) . ' />';
        //     } else {
        //         echo '<input type="' . esc_attr($type) . '" id="' . esc_attr($id) . '" name="' . esc_attr( SMS_PRO_PREFIX . 'lms_options['.$id.']' ) . '" value="' . esc_attr( $value ) . '" class="regular-text" />';
        //     }
        // }

        /**
         * Sanitizes LMS settings.
         */
        // public function sanitize_lms_settings( $input ) {
        //    $sanitized_input = array();
        //    $sanitized_input['allow_course_retakes'] = isset( $input['allow_course_retakes'] ) ? 1 : 0;
        //    return $sanitized_input;
        // }
        
    } // END class sms_pro_Lms_Admin
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Lms_Admin.' );
    }
}/*
 * School Management Pro - LMS Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/lms/class-lms-ajax.php

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

if ( ! class_exists( 'sms_pro_Lms_Ajax' ) ) {
    /**
     * AJAX handler class for the LMS Module.
     */
    class sms_pro_Lms_Ajax {

        private static $module_slug = 'lms';

        public function __construct() {
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . self::$module_slug . '_enroll_student', array( $this, 'handle_enroll_student' ) );
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . self::$module_slug . '_complete_lesson', array( $this, 'handle_complete_lesson' ) );
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Example AJAX handler for a student to enroll in a course.
         */
        // public function handle_enroll_student() {
        //     $nonce_action = SMS_PRO_PREFIX . self::$module_slug . '_enroll_student_nonce';
        //     if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_key( $_POST['nonce'] ), $nonce_action ) ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Nonce verification failed.', SMS_PRO_TEXT_DOMAIN ) ), 403 );
        //     }
        //
        //     if ( ! is_user_logged_in() || ! current_user_can( 'student' ) ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Only logged-in students can enroll in courses.', SMS_PRO_TEXT_DOMAIN ) ), 403 );
        //     }
        //
        //     if ( ! current_user_can( SMS_PRO_PREFIX . 'enroll_in_lms_courses' ) ) { // Define this meta capability
        //         wp_send_json_error( array( 'message' => esc_html__( 'You do not have permission to enroll in courses.', SMS_PRO_TEXT_DOMAIN ) ), 403 );
        //     }
        //
        //     $student_user_id = get_current_user_id();
        //     $course_id = isset( $_POST['course_id'] ) ? absint( $_POST['course_id'] ) : 0;
        //
        //     if ( ! $course_id ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Invalid Course ID provided.', SMS_PRO_TEXT_DOMAIN ) ) );
        //     }
        //
        //     // Perform DB operation to add a row to `wp_sms_lms_enrollments` table.
        //     // Make sure to check if the student is already enrolled first!
        //     // global $wpdb;
        //     // $table_name = $wpdb->prefix . 'sms_lms_enrollments';
        //     // ... logic to insert ...
        //
        //     // if( $enrollment_failed ) {
        //     //      wp_send_json_error( array('message' => 'Enrollment failed.') );
        //     // }
        //
        //     wp_send_json_success( array(
        //         'message' => esc_html__( 'Successfully enrolled in the course!', SMS_PRO_TEXT_DOMAIN ),
        //         'course_id' => $course_id
        //     ) );
        // }

    } // END class sms_pro_Lms_Ajax
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Lms_Ajax.' );
    }
}/*
 * School Management Pro - LMS Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/lms/class-lms-cpt.php

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

if ( ! class_exists( 'sms_pro_Lms_CPT' ) ) {
    /**
     * CPT handler for the LMS Module.
     * NOTE: The main plugin defines extensive custom tables for LMS data. 
     * These CPTs should be seen as potential UI wrappers or for content that benefits from the CPT structure (like rich text editing for lessons),
     * rather than replacing the custom tables for relational data like enrollments or quiz attempts.
     * The core logic for the LMS would primarily interact with the `wp_sms_lms_*` tables directly.
     */
    class sms_pro_Lms_CPT {
        
        const CPT_COURSE     = 'sms_course';
        const CPT_LESSON     = 'sms_lesson';
        const CPT_QUIZ       = 'sms_quiz';
        const CPT_ASSIGNMENT = 'sms_assignment';

        const TAXONOMY_COURSE_CATEGORY = 'sms_course_category';

        public function __construct() {
            // Hooks are added by sms_pro_Module_Lms
            // add_action( 'init', array( $this, 'register_cpts' ), 5 );
            // add_action( 'init', array( $this, 'register_taxonomies' ), 5 );
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers CPTs for the LMS module.
         */
        // public function register_cpts() {
        //     // Course CPT
        //     if ( ! post_type_exists( self::CPT_COURSE ) ) {
        //         $course_labels = array( 'name' => _x( 'Courses', 'post type general name', SMS_PRO_TEXT_DOMAIN ), 'singular_name' => _x( 'Course', 'post type singular name', SMS_PRO_TEXT_DOMAIN ), /* ... more labels */ );
        //         $course_args = array(
        //             'labels'             => $course_labels,
        //             'public'             => true,
        //             'show_ui'            => true,
        //             'show_in_menu'       => SMS_PRO_PREFIX . 'lms_courses', // Match the submenu slug
        //             'rewrite'            => array( 'slug' => 'courses', 'with_front' => false ),
        //             'capability_type'    => array( 'sms_pro_course', 'sms_pro_courses' ),
        //             'map_meta_cap'       => true,
        //             'has_archive'        => true,
        //             'hierarchical'       => true, // Allows parent/child courses
        //             'supports'           => array( 'title', 'editor', 'thumbnail', 'excerpt', 'author', 'page-attributes' ),
        //             'menu_icon'          => 'dashicons-welcome-learn-more',
        //             'show_in_rest'       => true,
        //             'rest_base'          => 'courses',
        //         );
        //         register_post_type( self::CPT_COURSE, $course_args );
        //     }
        //
        //     // Lesson CPT - would be associated with a Course CPT
        //     if ( ! post_type_exists( self::CPT_LESSON ) ) {
        //          $lesson_labels = array( 'name' => _x( 'Lessons', 'post type general name', SMS_PRO_TEXT_DOMAIN ), 'singular_name' => _x( 'Lesson', 'post type singular name', SMS_PRO_TEXT_DOMAIN ), /* ... */ );
        //          $lesson_args = array( 'labels' => $lesson_labels, 'public' => true, 'show_ui' => true, /* ... more args, likely not shown in main menu but accessible through course editor */ );
        //          // register_post_type( self::CPT_LESSON, $lesson_args );
        //     }
        // }

        /**
         * Registers Taxonomies for the LMS module.
         */
        // public function register_taxonomies() {
        //     if ( ! taxonomy_exists( self::TAXONOMY_COURSE_CATEGORY ) ) {
        //         $cat_labels = array('name' => _x('Course Categories', 'taxonomy general name', SMS_PRO_TEXT_DOMAIN), /*...*/);
        //         $cat_args = array(
        //             'hierarchical'      => true,
        //             'labels'            => $cat_labels,
        //             'show_ui'           => true,
        //             'show_admin_column' => true,
        //             'rewrite'           => array( 'slug' => 'course-category' ),
        //             'show_in_rest'      => true,
        //         );
        //         register_taxonomy( self::TAXONOMY_COURSE_CATEGORY, array( self::CPT_COURSE ), $cat_args );
        //     }
        // }
    } // END class sms_pro_Lms_CPT
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Lms_CPT.' );
    }
}/*
 * School Management Pro - Communication Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Communication.
 *
 * This file is the entry point for the 'communication' module. It loads the
 * Custom Post Type definitions and initializes the admin interface and sending logic.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/communication
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Communication
 *
 * Orchestrator for the Communication module.
 */
class sms_pro_Module_Communication implements SMS_Module_Interface {

	/**
	 * Constructor for the Communication Module.
	 *
	 * Loads dependencies and registers initial hooks.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 * @since 2.3.0
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/communication/';
		
		// This class defines the Custom Post Type and taxonomies.
		require_once $module_path . 'class-communication-cpt.php';

		// This class handles the admin menu and UI modifications.
		if ( is_admin() ) {
			require_once $module_path . 'class-communication-admin.php';
		}
		
		// AJAX handler for future use.
		require_once $module_path . 'class-communication-ajax.php';
	}

	/**
	 * Registers module hooks.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		$cpt_handler = new sms_pro_Communication_CPT();
		$cpt_handler->register_hooks();

		if ( is_admin() ) {
			$admin_handler = new sms_pro_Communication_Admin();
			$admin_handler->register_hooks();
		}
		
		$ajax_handler = new sms_pro_Communication_AJAX();
		$ajax_handler->register_hooks();

		// The core hook that sends the notification when a notice is published.
		add_action( 'transition_post_status', array( $this, 'send_notification_on_publish' ), 10, 3 );
	}

	/**
	 * Sends the email notification when a 'sms_pro_notice' is published.
	 *
	 * @param string  $new_status The new status of the post.
	 * @param string  $old_status The old status of the post.
	 * @param WP_Post $post       The post object.
	 */
	public function send_notification_on_publish( string $new_status, string $old_status, WP_Post $post ) {
		if ( 'publish' !== $new_status || 'publish' === $old_status || SMS_PRO_PREFIX . 'notice' !== $post->post_type ) {
			return;
		}

		$recipient_groups = get_the_terms( $post->ID, SMS_PRO_PREFIX . 'recipient_group' );
		if ( ! $recipient_groups || is_wp_error( $recipient_groups ) ) {
			return;
		}
		
		$email_list = [];
		foreach ( $recipient_groups as $group ) {
			// In a real module, you'd have more complex logic to translate the group slug to user emails.
			// Example: slug 'parents-class-1a' would query for parents linked to students in class 1-A.
			switch ( $group->slug ) {
				case 'all-teachers':
					$users = get_users( ['role' => 'teacher', 'fields' => 'user_email'] );
					$email_list = array_merge( $email_list, $users );
					break;
				case 'all-parents':
					$users = get_users( ['role' => 'parent', 'fields' => 'user_email'] );
					$email_list = array_merge( $email_list, $users );
					break;
				case 'all-students':
					$users = get_users( ['role' => 'student', 'fields' => 'user_email'] );
					$email_list = array_merge( $email_list, $users );
					break;
			}
		}

		$email_list = array_unique( $email_list );
		if ( empty($email_list) ) {
			return;
		}

		$subject = $post->post_title;
		$message = apply_filters( 'the_content', $post->post_content );
		$headers = array('Content-Type: text/html; charset=UTF-8');
		
		// Use BCC to protect recipient privacy
		wp_mail( get_option('admin_email'), $subject, $message, $headers, [], array( 'Bcc' => implode( ',', $email_list ) ) );
	}
}/*
 * School Management Pro - Events Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Event Management.
 *
 * This file is the entry point for the 'events' module, loading CPT definitions,
 * admin UI, and frontend shortcodes for displaying events.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/events
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Events
 *
 * Orchestrator for the Events module.
 */
class sms_pro_Module_Events implements SMS_Module_Interface {

	/**
	 * Constructor for the Events Module.
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/events/';
		
		require_once $module_path . 'class-events-cpt.php';

		if ( is_admin() ) {
			require_once $module_path . 'class-events-admin.php';
		}
		
		require_once $module_path . 'class-events-ajax.php';
	}

	/**
	 * Registers all hooks for this module.
	 */
	public function register_hooks() {
		$cpt_handler = new sms_pro_Events_CPT();
		$cpt_handler->register_hooks();

		if ( is_admin() ) {
			$admin_handler = new sms_pro_Events_Admin();
			$admin_handler->register_hooks();
		}
		
		$ajax_handler = new sms_pro_Events_AJAX();
		$ajax_handler->register_hooks();

		// Register a simple shortcode to display an event list.
		add_shortcode( SMS_PRO_PREFIX . 'events_list', array( $this, 'render_events_list_shortcode' ) );
	}
	
	/**
	 * Renders the [sms_pro_events_list] shortcode.
	 *
	 * @param array $atts Shortcode attributes.
	 * @return string The HTML output for the event list.
	 */
	public function render_events_list_shortcode( $atts ) {
		$atts = shortcode_atts(
			array(
				'count' => 5,
				'category' => '', // Comma-separated list of category slugs.
				'show' => 'upcoming', // 'upcoming', 'past', or 'all'
			),
			$atts,
			SMS_PRO_PREFIX . 'events_list'
		);

		$query_args = array(
			'post_type' => SMS_PRO_PREFIX . 'event',
			'posts_per_page' => absint( $atts['count'] ),
			'post_status' => 'publish',
			'meta_key' => '_sms_pro_event_start_datetime',
			'orderby' => 'meta_value',
		);

		// Handle date query based on 'show' attribute.
		if ($atts['show'] === 'upcoming') {
			$query_args['order'] = 'ASC';
			$query_args['meta_query'][] = array(
				'key' => '_sms_pro_event_start_datetime',
				'value' => current_time('mysql'),
				'compare' => '>=',
				'type' => 'DATETIME'
			);
		} elseif ($atts['show'] === 'past') {
			$query_args['order'] = 'DESC';
			$query_args['meta_query'][] = array(
				'key' => '_sms_pro_event_start_datetime',
				'value' => current_time('mysql'),
				'compare' => '<',
				'type' => 'DATETIME'
			);
		}

		// Handle category filtering.
		if ( ! empty( $atts['category'] ) ) {
			$query_args['tax_query'][] = array(
				'taxonomy' => SMS_PRO_PREFIX . 'event_category',
				'field' => 'slug',
				'terms' => array_map('sanitize_title', explode(',', $atts['category'])),
			);
		}

		$events_query = new WP_Query( $query_args );

		ob_start();

		if ( $events_query->have_posts() ) {
			echo '<div class="sms-pro-events-list-wrapper">';
			while ( $events_query->have_posts() ) {
				$events_query->the_post();
				// Use the template locator to make this overridable by a theme
				$template = sms_pro_get_plugin_instance()->locate_template('frontend/single-event-summary.php');
				if ( $template ) {
					include $template;
				} else {
					// Fallback in case template is missing
					$start = get_post_meta( get_the_ID(), '_sms_pro_event_start_datetime', true );
					echo '<h3>' . get_the_title() . '</h3>';
					echo '<p><em>' . esc_html( date_i18n( 'F j, Y, g:i a', strtotime( $start ) ) ) . '</em></p>';
					echo '<div>' . get_the_excerpt() . '</div>';
				}
			}
			echo '</div>';
		} else {
			echo '<p>' . esc_html__( 'No events found.', SMS_PRO_TEXT_DOMAIN ) . '</p>';
		}

		wp_reset_postdata();
		
		return ob_get_clean();
	}
}/*
 * School Management Pro - Finance Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Finance Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/finance/class-finance-admin.php

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

if ( ! class_exists( 'sms_pro_Finance_Admin' ) ) {
    /**
     * Admin class for the Finance Module.
     * Handles admin-specific functionalities like invoicing, payment tracking, and settings.
     */
    class sms_pro_Finance_Admin {

        private static $module_slug = 'finance';

        public function __construct() {
            // Admin hooks are added by the main module class (sms_pro_Module_Finance)
            // if ( is_admin() ) {
            //     add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ), 10, 1 );
            //     add_action( 'admin_init', array( $this, 'register_finance_settings' ) );
            // }
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers admin submenus for this module via the main plugin's filter.
         *
         * @param array $submenus Existing submenus.
         * @return array Modified submenus.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $parent_slug = SMS_PRO_PREFIX . 'dashboard'; // Main plugin dashboard slug
        //
        //     $submenus[ SMS_PRO_PREFIX . 'finance_invoices' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Invoices & Payments', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Invoices', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_invoices',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . 'finance_expenses' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Expense Management', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Expenses', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_expenses',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . 'finance_settings' ] = array(
        //         'parent_slug' => 'options-general.php', // Common to place settings under the WP Settings menu
        //         'page_title'  => esc_html__( 'School Finance Settings', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Finance', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_finance_settings',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     return $submenus;
        // }

        /**
         * Registers settings for the Finance module using the Settings API.
         * This method would be hooked to 'admin_init'.
         */
        // public function register_finance_settings() {
        //     register_setting(
        //         SMS_PRO_PREFIX . 'finance_settings_group',
        //         SMS_PRO_PREFIX . 'finance_options',
        //         array( $this, 'sanitize_finance_settings' )
        //     );
        //
        //     add_settings_section(
        //         SMS_PRO_PREFIX . 'finance_general_section',
        //         esc_html__( 'General Finance Settings', SMS_PRO_TEXT_DOMAIN ),
        //         null,
        //         SMS_PRO_PREFIX . 'finance_settings' // Page slug where section appears
        //     );
        //
        //     add_settings_field(
        //         'currency_symbol',
        //         esc_html__( 'Currency Symbol', SMS_PRO_TEXT_DOMAIN ),
        //         array( $this, 'render_field_html' ),
        //         SMS_PRO_PREFIX . 'finance_settings',
        //         SMS_PRO_PREFIX . 'finance_general_section',
        //         array( 'id' => 'currency_symbol', 'type' => 'text', 'default' => '$' )
        //     );
        //
        //     add_settings_field(
        //         'payment_gateway_api_key',
        //         esc_html__( 'Payment Gateway API Key', SMS_PRO_TEXT_DOMAIN ),
        //         array( $this, 'render_field_html' ),
        //         SMS_PRO_PREFIX . 'finance_settings',
        //         SMS_PRO_PREFIX . 'finance_general_section',
        //         array( 'id' => 'payment_gateway_api_key', 'type' => 'password' )
        //     );
        //
        //     // error_log( get_class( $this ) . ' finance settings registered.' );
        // }
        //
        /**
        * Generic callback to render a settings field's HTML.
        */
        // public function render_field_html( $args ) {
        //     $options = get_option( SMS_PRO_PREFIX . 'finance_options', array() );
        //     $id = $args['id'];
        //     $type = $args['type'] ?? 'text';
        //     $value = isset($options[$id]) ? $options[$id] : ( $args['default'] ?? '' );
        //     echo '<input type="' . esc_attr($type) . '" id="' . esc_attr($id) . '" name="' . esc_attr( SMS_PRO_PREFIX . 'finance_options['.$id.']' ) . '" value="' . esc_attr( $value ) . '" class="regular-text" />';
        //     if (!empty($args['description'])) {
        //          echo '<p class="description">' . esc_html($args['description']) . '</p>';
        //     }
        // }
        //
        /**
         * Sanitizes Finance module settings.
         */
        // public function sanitize_finance_settings( $input ) {
        //    $sanitized_input = array();
        //    if ( isset( $input['currency_symbol'] ) ) {
        //        $sanitized_input['currency_symbol'] = sanitize_text_field( $input['currency_symbol'] );
        //    }
        //    if ( isset( $input['payment_gateway_api_key'] ) ) {
        //        $sanitized_input['payment_gateway_api_key'] = sanitize_text_field( $input['payment_gateway_api_key'] );
        //    }
        //    return $sanitized_input;
        // }

    } // END class sms_pro_Finance_Admin
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Finance_Admin.' );
    }
}/*
 * School Management Pro - Finance Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Finance Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/finance/class-finance-cpt.php

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

if ( ! class_exists( 'sms_pro_Finance_CPT' ) ) {
    /**
     * Custom Post Type handler class for the Finance Module.
     * NOTE: Given the plugin's schema uses custom tables (sms_invoices, sms_expenses, etc.),
     * using CPTs for these may be redundant. They are provided here as a pattern placeholder.
     * You might use them for frontend display or search integration while the core data remains in your tables.
     */
    class sms_pro_Finance_CPT {
        
        // Define CPT and Taxonomy slugs. You might not need all of these if using custom tables primarily.
        const CPT_INVOICE = 'sms_invoice';
        const CPT_EXPENSE = 'sms_expense';
        
        const TAXONOMY_FEE_TYPE = 'sms_fee_type';       // Mirrors your sms_fee_types table data for easier UI filtering.
        const TAXONOMY_EXPENSE_CAT = 'sms_expense_cat'; // Mirrors your sms_expense_categories table.
        const TAXONOMY_PAY_STATUS = 'sms_payment_status';// e.g., Paid, Unpaid, Partial, Overdue

        public function __construct() {
            // Registration hooks are typically called from sms_pro_Module_Finance::register_hooks()
            // add_action( 'init', array( $this, 'register_cpts' ), 5 );
            // add_action( 'init', array( $this, 'register_taxonomies' ), 5 );
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers Custom Post Types for the Finance module.
         */
        // public function register_cpts() {
        //     // Invoice CPT - Could be used to create user-facing invoice "pages".
        //     if ( ! post_type_exists( self::CPT_INVOICE ) ) {
        //         $invoice_labels = array( 'name' => _x( 'Invoices', 'post type general name', SMS_PRO_TEXT_DOMAIN ), /* ... more labels */ );
        //         $invoice_args = array(
        //             'labels'             => $invoice_labels,
        //             'public'             => false, // Invoices are private
        //             'show_ui'            => true,
        //             'show_in_menu'       => SMS_PRO_PREFIX . 'finance_invoices', // Menu page slug
        //             'rewrite'            => false,
        //             'capability_type'    => array( 'sms_pro_invoice', 'sms_pro_invoices' ),
        //             'map_meta_cap'       => true,
        //             'supports'           => array( 'title', 'editor', 'author', 'custom-fields' ), // Title: "Invoice #123 for Student Name"
        //             'show_in_rest'       => true,
        //             'rest_base'          => 'invoices',
        //         );
        //         register_post_type( self::CPT_INVOICE, $invoice_args );
        //     }
        // }

        /**
         * Registers Taxonomies for the Finance module.
         */
        // public function register_taxonomies() {
        //     // Payment Status Taxonomy
        //     if ( ! taxonomy_exists( self::TAXONOMY_PAY_STATUS ) ) {
        //         $status_labels = array('name' => _x('Payment Statuses', 'taxonomy general name', SMS_PRO_TEXT_DOMAIN), /* ... */);
        //         $status_args = array(
        //             'hierarchical'      => true,
        //             'labels'            => $status_labels,
        //             'show_ui'           => true,
        //             'show_admin_column' => true,
        //             'rewrite'           => array( 'slug' => 'payment-status' ),
        //             'show_in_rest'      => true,
        //             'capabilities'      => array( 'manage_terms'  => SMS_PRO_PREFIX . 'manage_payment_statuses' ),
        //         );
        //         register_taxonomy( self::TAXONOMY_PAY_STATUS, array( self::CPT_INVOICE ), $status_args );
        //     }
        // }
    } // END class sms_pro_Finance_CPT
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Finance_CPT.' );
    }
}/*
 * School Management Pro - Library Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Library Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Library Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Library Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Transport Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Transport Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Transport Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Transport Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Inventory Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Inventory Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/inventory/class-inventory-admin.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Inventory_Admin' ) ) {
    /**
     * Admin class for the Inventory Module.
     */
    class sms_pro_Inventory_Admin {
        public function __construct() {
            // add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ) );
            // add_action( 'add_meta_boxes_' . sms_pro_Inventory_CPT::CPT_ITEM, array($this, 'add_item_meta_boxes') );
            // add_action( 'save_post_' . sms_pro_Inventory_CPT::CPT_ITEM, array($this, 'save_item_meta_data') );
        }

        /**
         * Registers admin submenus for the Inventory module.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $cpt_menu_slug = 'edit.php?post_type=' . sms_pro_Inventory_CPT::CPT_ITEM;
        //
        //     $submenus[ SMS_PRO_PREFIX . 'inventory_dashboard' ] = array(
        //         'parent_slug' => SMS_PRO_PREFIX . 'dashboard',
        //         'page_title'  => esc_html__( 'Inventory Dashboard', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Inventory', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_inventory',
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => 'inventory',
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . 'inventory_issue_return' ] = array(
        //         'parent_slug' => $cpt_menu_slug,
        //         'page_title'  => esc_html__( 'Issue / Return Items', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Issue / Return', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_inventory_circulation',
        //         'callback'    => array( $this, 'render_issue_return_page' ), // This would need its own page and template
        //     );
        //
        //     return $submenus;
        // }
        
        /**
         * Example function to render the dedicated page for issuing/returning items.
         */
        // public function render_issue_return_page() {
        //     // Locate and include a specific template for this complex UI.
        //     $template = School_Management_System_Pro::instance()->locate_template('admin/inventory/issue-return-page.php');
        //     if ($template) include $template;
        // }
        
    }
}/*
 * School Management Pro - Inventory Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/inventory/class-inventory-ajax.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Inventory_Ajax' ) ) {
    /**
     * AJAX handler class for the Inventory Module.
     */
    class sms_pro_Inventory_Ajax {

        public function __construct() {
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . 'inventory_issue_item', array( $this, 'handle_issue_item' ) );
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . 'inventory_search_items', array( $this, 'handle_search_items' ) );
        }

        /**
         * Example AJAX handler to search for available inventory items.
         */
        // public function handle_search_items() {
        //     check_ajax_referer( 'your_admin_nonce_action', 'nonce' );
        //     if ( ! current_user_can( SMS_PRO_PREFIX . 'manage_inventory_circulation' ) ) {
        //         wp_send_json_error( [ 'message' => esc_html__( 'Permission denied.', SMS_PRO_TEXT_DOMAIN ) ], 403 );
        //     }
        //
        //     $search_term = isset( $_POST['search'] ) ? sanitize_text_field( $_POST['search'] ) : '';
        //     
        //     // DB LOGIC to query `wp_sms_inventory_items` where name/item_code LIKE $search_term AND quantity_available > 0.
        //     // $results = ...
        //
        //     // Placeholder data
        //     $results = [
        //         ['id' => 501, 'name' => 'Box of A4 Paper', 'available' => 50],
        //         ['id' => 502, 'name' => 'Scientific Calculator', 'available' => 15],
        //     ];
        //     wp_send_json_success( $results );
        // }
        
        /**
         * Example AJAX handler for issuing an item.
         */
        // public function handle_issue_item() {
        //     check_ajax_referer( 'your_admin_nonce_action', 'nonce' );
        //     if ( ! current_user_can( SMS_PRO_PREFIX . 'manage_inventory_circulation' ) ) {
        //         wp_send_json_error( [ 'message' => esc_html__( 'Permission denied.', SMS_PRO_TEXT_DOMAIN ) ], 403 );
        //     }
        //
        //     $item_id = isset( $_POST['item_id'] ) ? absint( $_POST['item_id'] ) : 0;
        //     $user_id = isset( $_POST['user_id'] ) ? absint( $_POST['user_id'] ) : 0;
        //     $quantity = isset( $_POST['quantity'] ) ? absint( $_POST['quantity'] ) : 1;
        //
        //     if( !$item_id || !$user_id || $quantity < 1 ) {
        //         wp_send_json_error( ['message' => 'Invalid data.'] );
        //     }
        //
        //     // DB LOGIC (CRITICAL: SHOULD BE A TRANSACTION)
        //     // 1. Get current `quantity_available` from `wp_sms_inventory_items` for $item_id.
        //     // 2. Check if requested quantity <= available. If not, error.
        //     // 3. Insert a record into `wp_sms_inventory_issues` with status 'issued'.
        //     // 4. DECREMENT `quantity_available` in `wp_sms_inventory_items`.
        //
        //     wp_send_json_success( ['message' => 'Item issued successfully!'] );
        // }
    }
}/*
 * School Management Pro - Inventory Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/inventory/class-inventory-cpt.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Inventory_CPT' ) ) {
    /**
     * CPT handler for the Inventory Module.
     */
    class sms_pro_Inventory_CPT {
        
        const CPT_ITEM = 'sms_item';
        const CPT_SUPPLIER = 'sms_supplier';
        
        const TAXONOMY_CATEGORY = 'sms_item_category';
        const TAXONOMY_LOCATION = 'sms_item_location';

        public function __construct() {
            // add_action( 'init', array( $this, 'register_cpts' ), 5 );
            // add_action( 'init', array( $this, 'register_taxonomies' ), 5 );
        }

        /**
         * Registers CPTs for the Inventory module.
         */
        // public function register_cpts() {
        //     $cpts = [
        //         self::CPT_ITEM => ['singular' => 'Item', 'plural' => 'Items', 'icon' => 'dashicons-archive', 'menu_slug' => SMS_PRO_PREFIX . 'inventory_dashboard'],
        //         self::CPT_SUPPLIER => ['singular' => 'Supplier', 'plural' => 'Suppliers', 'icon' => 'dashicons-store', 'menu_slug' => SMS_PRO_PREFIX . 'inventory_dashboard'],
        //     ];
        //     
        //     foreach($cpts as $slug => $details) {
        //         if (post_type_exists($slug)) continue;
        //         $labels = ['name' => _x($details['plural'], 'post type general name', SMS_PRO_TEXT_DOMAIN), 'singular_name' => _x($details['singular'], 'post type singular name', SMS_PRO_TEXT_DOMAIN) /* ... */ ];
        //         $args = [
        //             'labels' => $labels, 'public' => false, 'show_ui' => true,
        //             'show_in_menu' => $details['menu_slug'], 'menu_icon' => $details['icon'],
        //             'capability_type' => ['sms_pro_'.strtolower($details['singular']), 'sms_pro_'.strtolower($details['plural'])], 'map_meta_cap' => true,
        //             'supports' => ['title', 'editor', 'thumbnail', 'custom-fields'], 'rewrite' => false
        //         ];
        //         register_post_type($slug, $args);
        //     }
        // }

        /**
         * Registers Taxonomies for the Inventory module.
         */
        // public function register_taxonomies() {
        //     register_taxonomy(self::TAXONOMY_CATEGORY, [self::CPT_ITEM], ['hierarchical' => true, 'labels' => ['name'=>'Categories'], 'show_admin_column' => true]);
        //     register_taxonomy(self::TAXONOMY_LOCATION, [self::CPT_ITEM], ['hierarchical' => true, 'labels' => ['name'=>'Locations'], 'show_admin_column' => true]);
        // }
    }
}/*
 * School Management Pro - Behavior Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Student Behavior Management.
 *
 * This file is the primary loader for the 'behavior' module, initializing all its
 * necessary components, such as the Admin UI, Data Handler, and AJAX services.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/behavior
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Behavior
 *
 * Orchestrator for the Behavior module.
 */
class sms_pro_Module_Behavior implements SMS_Module_Interface {

	/**
	 * Constructor for the Behavior Module.
	 *
	 * Loads dependencies and registers initial hooks.
	 * @since 2.3.0
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 * @since 2.3.0
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/behavior/';
		
		require_once $module_path . 'class-behavior-data.php';

		if ( is_admin() ) {
			require_once $module_path . 'class-behavior-admin.php';
		}
		
		require_once $module_path . 'class-behavior-ajax.php';
	}

	/**
	 * Registers module hooks.
	 *
	 * Instantiates handler classes, allowing them to set up their own hooks.
	 * @since 2.3.0
	 */
	public function register_hooks() {
		if ( is_admin() ) {
			$admin_handler = new sms_pro_Behavior_Admin();
			$admin_handler->register_hooks();
		}
		
		$ajax_handler = new sms_pro_Behavior_AJAX();
		$ajax_handler->register_hooks();
	}
}/*
 * School Management Pro - Health Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Health Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/health/class-health-admin.php

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

if ( ! class_exists( 'sms_pro_Health_Admin' ) ) {
    /**
     * Admin class for the Health Module.
     * Handles admin-specific functionalities, settings pages, and interactions.
     */
    class sms_pro_Health_Admin {

        private static $module_slug = 'health';

        public function __construct() {
            // Add hooks specific to the admin area for this module.
            // These hooks are typically added by the main module class (sms_pro_Module_Health)
            // Example hook registration, actual calls would be in sms_pro_Module_Health::register_hooks()
            // if ( is_admin() ) {
            //     add_filter( SMS_PRO_PREFIX . 'admin_submenus', array( $this, 'add_submenu_pages' ), 10, 1 );
            //     add_action( 'admin_init', array( $this, 'register_health_settings' ) );
            // }
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Registers admin pages or submenus for this module via the main plugin's filter.
         * Hooked to `SMS_PRO_PREFIX . 'admin_submenus'`.
         *
         * @param array $submenus Existing submenus.
         * @return array Modified submenus.
         */
        // public function add_submenu_pages( array $submenus ): array {
        //     $parent_slug = SMS_PRO_PREFIX . 'dashboard'; // Main plugin dashboard slug
        //
        //     $submenus[ SMS_PRO_PREFIX . self::$module_slug . '_records' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Health Records', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Health Records', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_health_records', // Define this capability
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug, // Crucial for main plugin to know which module content to render
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . self::$module_slug . '_incidents' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Medical Incidents', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Incidents', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_medical_incidents', // Define this capability
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     $submenus[ SMS_PRO_PREFIX . self::$module_slug . '_settings' ] = array(
        //         'parent_slug' => $parent_slug,
        //         'page_title'  => esc_html__( 'Health Settings', SMS_PRO_TEXT_DOMAIN ),
        //         'menu_title'  => esc_html__( 'Settings (Health)', SMS_PRO_TEXT_DOMAIN ),
        //         'capability'  => SMS_PRO_PREFIX . 'manage_health_settings', // Define this capability
        //         'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
        //         'module_slug' => self::$module_slug,
        //     );
        //
        //     return $submenus;
        // }

        /**
         * Registers settings for the Health module.
         * This method would typically be hooked to 'admin_init'.
         */
        // public function register_health_settings() {
        //     register_setting(
        //         SMS_PRO_PREFIX . 'health_settings_group',
        //         SMS_PRO_PREFIX . 'health_options',
        //         array( $this, 'sanitize_health_settings' )
        //     );
        //
        //     add_settings_section(
        //         SMS_PRO_PREFIX . 'health_general_section',
        //         esc_html__( 'General Health Settings', SMS_PRO_TEXT_DOMAIN ),
        //         array( $this, 'render_health_general_section_info' ),
        //         SMS_PRO_PREFIX . 'health_settings_page' // Match a page slug from add_submenu_pages
        //     );
        //
        //     add_settings_field(
        //         SMS_PRO_PREFIX . 'health_nurse_email',
        //         esc_html__( 'School Nurse Email', SMS_PRO_TEXT_DOMAIN ),
        //         array( $this, 'render_health_nurse_email_html' ),
        //         SMS_PRO_PREFIX . 'health_settings_page',
        //         SMS_PRO_PREFIX . 'health_general_section',
        //         array( 'label_for' => SMS_PRO_PREFIX . 'health_nurse_email' )
        //     );
        //
        //     // error_log( get_class( $this ) . ' health settings registered.' );
        // }

        /**
         * Callback to render description for the general health settings section.
         */
        // public function render_health_general_section_info() {
        //    echo '<p>' . esc_html__( 'Configure general settings related to the Health module, such as emergency contact protocols or notification settings for incidents.', SMS_PRO_TEXT_DOMAIN ) . '</p>';
        // }

        /**
         * Callback to render the nurse email settings field HTML.
         */
        // public function render_health_nurse_email_html() {
        //    $options = get_option( SMS_PRO_PREFIX . 'health_options' );
        //    $value = isset( $options['health_nurse_email'] ) ? $options['health_nurse_email'] : '';
        //    echo '<input type="email" id="' . esc_attr( SMS_PRO_PREFIX . 'health_nurse_email' ) . '" name="' . esc_attr( SMS_PRO_PREFIX . 'health_options[health_nurse_email]' ) . '" value="' . esc_attr( $value ) . '" class="regular-text" />';
        //    echo '<p class="description">' . esc_html__( 'Enter the email address for the school nurse or health officer for notifications.', SMS_PRO_TEXT_DOMAIN ) . '</p>';
        // }

        /**
         * Sanitizes Health module settings before saving to the database.
         *
         * @param array $input The input data from the settings form.
         * @return array Sanitized data.
         */
        // public function sanitize_health_settings( $input ) {
        //    $sanitized_input = array();
        //    if ( isset( $input['health_nurse_email'] ) ) {
        //        $sanitized_input['health_nurse_email'] = sanitize_email( $input['health_nurse_email'] );
        //    }
        //    // Sanitize other health options here
        //    return $sanitized_input;
        // }

    } // END class sms_pro_Health_Admin
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Health_Admin.' );
    }
}/*
 * School Management Pro - Health Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/health/class-health-ajax.php

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

if ( ! class_exists( 'sms_pro_Health_Ajax' ) ) {
    /**
     * AJAX handler class for the Health Module.
     * Handles AJAX requests related to health functionalities like recording incidents or updating records.
     */
    class sms_pro_Health_Ajax {

        private static $module_slug = 'health';

        public function __construct() {
            // AJAX actions are typically registered by the main module class (sms_pro_Module_Health)
            // Example registration (actual call in sms_pro_Module_Health::register_hooks()):
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . self::$module_slug . '_log_incident', array( $this, 'handle_log_medical_incident' ) );
            // add_action( 'wp_ajax_' . SMS_PRO_PREFIX . self::$module_slug . '_get_student_summary', array( $this, 'handle_get_student_health_summary' ) );
            // error_log( get_class( $this ) . ' constructed.' );
        }

        /**
         * Example AJAX handler to log a medical incident.
         * Requires logged-in user with appropriate capability (e.g., school nurse or admin).
         */
        // public function handle_log_medical_incident() {
        //     $nonce_action = SMS_PRO_PREFIX . self::$module_slug . '_log_incident_nonce';
        //     if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_key( $_POST['nonce'] ), $nonce_action ) ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Nonce verification failed.', SMS_PRO_TEXT_DOMAIN ) ), 403 );
        //     }
        //
        //     if ( ! current_user_can( SMS_PRO_PREFIX . 'log_medical_incident' ) ) { // Define this capability
        //         wp_send_json_error( array( 'message' => esc_html__( 'You do not have permission to log medical incidents.', SMS_PRO_TEXT_DOMAIN ) ), 403 );
        //     }
        //
        //     // Sanitize and validate input data from $_POST
        //     // E.g., student_id, incident_description, incident_date, treatment_given, etc.
        //     $student_id = isset( $_POST['student_id'] ) ? absint( $_POST['student_id'] ) : 0;
        //     $description = isset( $_POST['description'] ) ? sanitize_textarea_field( $_POST['description'] ) : '';
        //
        //     if ( ! $student_id || empty( $description ) ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Required fields are missing (Student ID, Description).', SMS_PRO_TEXT_DOMAIN ) ) );
        //     }
        //
        //     // Perform database operation to save the incident (e.g., to 'wp_sms_medical_incidents' table)
        //     // global $wpdb;
        //     // $table_name = $wpdb->prefix . 'sms_medical_incidents';
        //     // $result = $wpdb->insert( $table_name, array(
        //     //     'student_id' => $student_id,
        //     //     'incident_datetime' => current_time('mysql'), // Or from POST
        //     //     'description_of_incident' => $description,
        //     //     'reported_by_user_id' => get_current_user_id(),
        //     //     // ... other fields
        //     // ) );
        //
        //     // if ( $result === false ) {
        //     //     wp_send_json_error( array( 'message' => esc_html__( 'Failed to log medical incident. Database error.', SMS_PRO_TEXT_DOMAIN ) ) );
        //     // }
        //
        //     // Simulate success for placeholder
        //     $incident_id = rand(100,999); // Placeholder for actual ID
        //
        //     wp_send_json_success( array(
        //         'message' => esc_html__( 'Medical incident logged successfully.', SMS_PRO_TEXT_DOMAIN ),
        //         'incident_id' => $incident_id
        //     ) );
        // }

        /**
         * Example AJAX handler to fetch a student's health summary (e.g., allergies, conditions).
         * Requires logged-in user with appropriate capability.
         */
        // public function handle_get_student_health_summary() {
        //     // Nonce and capability checks similar to handle_log_medical_incident
        //     // Ensure the user (e.g., nurse, teacher with permission, parent for own child) can view this.
        //
        //     $student_id = isset( $_POST['student_id'] ) ? absint( $_POST['student_id'] ) : 0;
        //     if ( ! $student_id ) {
        //         wp_send_json_error( array( 'message' => esc_html__( 'Student ID not provided.', SMS_PRO_TEXT_DOMAIN ) ) );
        //     }
        //
        //     // Fetch data from `wp_sms_student_health_records`
        //     // $health_record = ...; // Your DB query
        //
        //     // Dummy data
        //     // $summary_data = array(
        //     //     'student_name' => 'Demo Student',
        //     //     'blood_group' => 'O+',
        //     //     'allergies' => array( array('allergen' => 'Peanuts', 'reaction' => 'Anaphylaxis') ),
        //     //     'conditions' => array( array('condition' => 'Asthma', 'severity' => 'Mild') )
        //     // );
        //
        //     // wp_send_json_success( array(
        //     //     'message' => esc_html__( 'Student health summary retrieved.', SMS_PRO_TEXT_DOMAIN ),
        //     //     'data'    => $summary_data
        //     // ) );
        //     wp_send_json_error( array( 'message' => 'Not implemented yet.' ) ); // Placeholder
        // }

    } // END class sms_pro_Health_Ajax
} else {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'School Management System Pro: Attempted to re-define class sms_pro_Health_Ajax.' );
    }
}/*
 * School Management Pro - Health Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Reports Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/*
 * School Management Pro - Reports Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/reports/class-reports-admin.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Reports_Admin' ) ) {
    /**
     * Admin class for the Reports Module.
     * Manages the admin UI for selecting and generating reports.
     */
    class sms_pro_Reports_Admin {
        
        private $report_types = [];

        public function __construct() {}

        /**
         * Registers admin page for generating reports.
         */
        public function add_submenu_pages( array $submenus ): array {
            $submenus[ SMS_PRO_PREFIX . 'reports' ] = array(
                'parent_slug' => SMS_PRO_PREFIX . 'dashboard',
                'page_title'  => esc_html__( 'Generate Reports', SMS_PRO_TEXT_DOMAIN ),
                'menu_title'  => esc_html__( 'Reports', SMS_PRO_TEXT_DOMAIN ),
                'capability'  => SMS_PRO_PREFIX . 'view_reports',
                'callback'    => array( School_Management_System_Pro::instance(), 'render_admin_module_page' ),
                'module_slug' => 'reports',
            );
            return $submenus;
        }
        
        /**
         * Get the list of available report types.
         * This can be filtered by other modules to add their own reports.
         *
         * @return array The array of available report types.
         */
        public function get_report_types() : array {
            if ( empty( $this->report_types ) ) {
                $reports = [
                    'academic' => [
                        'label' => __('Academic', SMS_PRO_TEXT_DOMAIN),
                        'reports' => [
                            'student_grades' => __('Student Grades Report', SMS_PRO_TEXT_DOMAIN),
                            'class_performance' => __('Class Performance Summary', SMS_PRO_TEXT_DOMAIN),
                        ]
                    ],
                    'attendance' => [
                        'label' => __('Attendance', SMS_PRO_TEXT_DOMAIN),
                        'reports' => [
                            'daily_attendance' => __('Daily Attendance Sheet', SMS_PRO_TEXT_DOMAIN),
                            'monthly_attendance' => __('Monthly Attendance Summary', SMS_PRO_TEXT_DOMAIN),
                            'absentee_report' => __('Absentee Report', SMS_PRO_TEXT_DOMAIN),
                        ]
                    ],
                    'financial' => [
                        'label' => __('Financial', SMS_PRO_TEXT_DOMAIN),
                        'reports' => [
                            'fee_collection' => __('Fee Collection Report', SMS_PRO_TEXT_DOMAIN),
                            'outstanding_fees' => __('Outstanding Fees Report', SMS_PRO_TEXT_DOMAIN),
                            'expense_summary' => __('Expense Summary', SMS_PRO_TEXT_DOMAIN),
                        ]
                    ],
                ];
                
                $this->report_types = apply_filters( SMS_PRO_PREFIX . 'report_types', $reports );
            }
            return $this->report_types;
        }
    }
}/*
 * School Management Pro - Reports Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/reports/class-reports-ajax.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Reports_Ajax' ) ) {
    /**
     * AJAX handler class for the Reports Module.
     */
    class sms_pro_Reports_Ajax {

        public function __construct() {
            add_action( 'wp_ajax_' . SMS_PRO_PREFIX . 'reports_generate', array( $this, 'handle_generate_report' ) );
        }

        /**
         * AJAX handler to generate and return report data.
         */
        public function handle_generate_report() {
            check_ajax_referer( 'your_admin_nonce', 'nonce' );
            if ( ! current_user_can( SMS_PRO_PREFIX . 'view_reports' ) ) {
                wp_send_json_error( [ 'message' => esc_html__( 'Permission denied.', SMS_PRO_TEXT_DOMAIN ) ], 403 );
            }

            $report_type = isset( $_POST['report_type'] ) ? sanitize_key( $_POST['report_type'] ) : '';
            $start_date = isset( $_POST['start_date'] ) ? sanitize_text_field( $_POST['start_date'] ) : '';
            $class_id = isset( $_POST['class_id'] ) ? absint( $_POST['class_id'] ) : 0;
            // ... get other params
            
            if( empty($report_type) ) {
                wp_send_json_error( [ 'message' => esc_html__( 'Report type not specified.', SMS_PRO_TEXT_DOMAIN ) ] );
            }

            global $wpdb;
            $report_data = [];

            switch( $report_type ) {
                case 'monthly_attendance':
                    // DB LOGIC to query `wp_sms_attendance` for the given class and date range.
                    // Aggregate data to show counts of 'present', 'absent', 'late' for each student.
                    // Example Structure:
                    $report_data = [
                        'headers' => ['Student Name', 'Present', 'Absent', 'Late'],
                        'rows' => [
                            ['John Doe', 20, 1, 1],
                            ['Jane Smith', 22, 0, 0],
                        ]
                    ];
                    break;

                case 'outstanding_fees':
                    // DB LOGIC to query `wp_sms_invoices` table.
                    // SELECT student_name, title, amount, amount_paid FROM invoices WHERE status IN ('unpaid', 'partial')
                    $report_data = [
                        'headers' => ['Student Name', 'Invoice Title', 'Amount Due'],
                        'rows' => [
                            ['John Doe', 'Term 1 Fees', 500.00],
                            ['Peter Jones', 'Library Fine', 15.50],
                        ]
                    ];
                    break;
                
                // Add more cases for other report types
                
                default:
                    wp_send_json_error( ['message' => esc_html__('Invalid report type requested.', SMS_PRO_TEXT_DOMAIN)] );
                    break;
            }

            wp_send_json_success( ['report' => $report_data] );
        }
    }
}/*
 * School Management Pro - Reports Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
// FILE: modules/reports/class-reports-cpt.php

if ( ! defined( 'ABSPATH' ) ) exit;

if ( ! class_exists( 'sms_pro_Reports_CPT' ) ) {
    /**
     * CPT handler for the Reports Module.
     *
     * NOTE: THIS IS A THEORETICAL IMPLEMENTATION FOR PATTERN CONSISTENCY.
     * A "report" is a temporary data output, not a piece of content, so it does not fit
     * the Custom Post Type model. CPTs are for creating persistent, editable content items.
     * All report generation is handled via admin pages and AJAX.
     * This file can be considered empty or removed in a final build.
     */
    class sms_pro_Reports_CPT {
        public function __construct() {}
    }
}/*
 * School Management Pro - Settings Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Settings Module for School Management System Pro.
 *
 * This class handles the rendering of the settings page content.
 * The registration of the submenu item itself is now handled by the main plugin's menu loader
 * to centralize menu management.
 *
 * @package     School_Management_System_Pro
 * @subpackage  Modules/Settings
 * @author      Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since       2.3.0
 */

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

// Correctly implements the module interface defined in the main plugin file.
class sms_pro_Module_Settings implements SMS_Module_Interface {

	/**
	 * The main plugin instance.
	 * @var School_Management_System_Pro
	 */
	private $main_plugin;

	/**
	 * The settings admin handler.
	 * @var sms_pro_Settings_Admin
	 */
	private $settings_admin;

	/**
	 * Constructor for sms_pro_Module_Settings.
	 * Dependencies are injected by the main plugin loader.
	 *
	 * @param School_Management_System_Pro $main_plugin    The main plugin object.
	 * @param sms_pro_Settings_Admin      $settings_admin The object that provides tab/field definitions.
	 */
	public function __construct( School_Management_System_Pro $main_plugin, sms_pro_Settings_Admin $settings_admin ) {
		$this->main_plugin    = $main_plugin;
		$this->settings_admin = $settings_admin;

		// Immediately call register_hooks() upon instantiation as is the new best practice.
		$this->register_hooks();
	}

	/**
	 * Required by the SMS_Module_Interface.
	 * This is where you will add any actions or filters specific to the settings module.
	 */
	public function register_hooks(): void {
		// This filter renders the content WHEN the settings page is accessed.
		// The main plugin's menu router triggers this filter based on the 'module_slug'.
		add_filter( SMS_PRO_PREFIX . 'render_admin_page_content_settings', array( $this, 'render_module_admin_page_content' ), 10, 3 );
	}

	/**
	 * Renders the settings page content, hooked into a filter.
	 * The signature now matches the filter it hooks into, which is called by the main plugin's router.
	 *
	 * @param string                       $output      The current output, which we will replace.
	 * @param string                       $page_slug   The slug of the page being rendered.
	 * @param School_Management_System_Pro $main_plugin The instance of the main plugin.
	 * @return string The HTML content of the settings page.
	 */
	public function render_module_admin_page_content( string $output, string $page_slug, School_Management_System_Pro $main_plugin ): string {
		// The capability check is now recommended to be handled in the main menu router before this function is even called.
		// However, a secondary check here provides robust security.
		if ( ! current_user_can( SMS_PRO_PREFIX . 'manage_settings' ) ) { // Using the specific capability.
			wp_die( esc_html__( 'You do not have sufficient permissions to access this page.', SMS_PRO_TEXT_DOMAIN ) );
		}

		ob_start();

		$settings_tabs = $this->settings_admin->get_settings_tabs();
		$current_tab   = isset( $_GET['tab'] ) ? sanitize_key( $_GET['tab'] ) : 'general';

		// If the requested tab doesn't exist, default to the first available tab.
		if ( ! array_key_exists( $current_tab, $settings_tabs ) ) {
			$current_tab = ! empty( $settings_tabs ) ? key( $settings_tabs ) : 'general';
		}

		// Locate and include the admin settings page template.
		$template_path = $this->main_plugin->locate_template( 'settings/admin/admin-settings-page.php' );

		if ( $template_path ) {
			include $template_path;
		} else {
			// A more user-friendly error message if the template is missing.
			echo '<div class="wrap"><h1>' . esc_html__( 'Settings', SMS_PRO_TEXT_DOMAIN ) . '</h1><div class="notice notice-error"><p>' . esc_html__( 'Critical Error: The admin settings template file (admin-settings-page.php) could not be found.', SMS_PRO_TEXT_DOMAIN ) . '</p></div></div>';
		}

		return ob_get_clean();
	}
}/*
 * School Management Pro - Fees Module
 * This file is autoloaded by the plugin. Do not access directly.
 */
/**
 * Main Module file for Fees Management.
 *
 * This file is the entry point for the 'fees' module, responsible for initializing
 * the admin interface, data handling classes, and AJAX services for managing
 * student fees, invoices, and payments.
 *
 * @package    School_Management_System_Pro
 * @subpackage School_Management_System_Pro/modules/fees
 * @author     Yakobo Abeld Chusi <abel@yakobochusi.site>
 * @since      2.3.0
 */

// Prevent direct file access for security.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class sms_pro_Module_Fees
 */
class sms_pro_Module_Fees implements SMS_Module_Interface {

	/**
	 * Constructor for the Fees Module.
	 */
	public function __construct() {
		$this->load_dependencies();
		$this->register_hooks();
	}

	/**
	 * Loads all necessary files for this module.
	 */
	private function load_dependencies() {
		$module_path = SMS_PRO_PATH . 'modules/fees/';
		
		require_once $module_path . 'class-fees-data.php';

		if ( is_admin() ) {
			require_once $module_path . 'class-fees-admin.php';
		}
		
		require_once $module_path . 'class-fees-ajax.php';
	}

	/**
	 * Registers all hooks for this module.
	 */
	public function register_hooks() {
		if ( is_admin() ) {
			$admin_handler = new sms_pro_Fees_Admin();
			$admin_handler->register_hooks();
		}
		
		$ajax_handler = new sms_pro_Fees_AJAX();
		$ajax_handler->register_hooks();
	}
}