<?php
/**
 * Registers plugin hooks after the runtime modules are loaded.
 *
 * @package AI_For_SEO
 */

// Keep extracted core modules inaccessible when WordPress has not loaded the plugin environment.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// region INITIALIZATION ======================================================================== \\
// ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯.

// Quiesce deferred file loading before WordPress can replace the active plugin directory.
add_filter( 'upgrader_pre_install', 'ai4seo_suspend_deferred_modal_loading_before_self_update', 5, 2 );

// Register the plugin language directory before other initialization callbacks.
add_action( 'init', 'ai4seo_load_language_files', 0 );

// init settings.
add_action( 'init', 'ai4seo_init_settings', 8 );
add_action( 'admin_notices', 'ai4seo_render_offer_admin_notice' );

// Invalidate content type list caches when the posts table changes.
ai4seo_add_content_type_list_cache_invalidation_hooks();

// Keep the isolated taxonomy cache coherent for admin, REST, cron and frontend mutations.
ai4seo_add_supported_taxonomy_terms_cache_invalidation_hooks();

// Local taxonomy inventory must also work in cron, REST and logged-out requests without an API account.
add_action( 'init', 'ai4seo_register_taxonomy_proxy_post_type', 9 );
add_action( 'init', 'ai4seo_schedule_taxonomy_proxy_sync', 20 );
add_action( 'init', 'ai4seo_maybe_prepare_taxonomy_generation_index', 21 );
add_action( AI4SEO_TAXONOMY_PROXY_SYNC_CRON_HOOK, 'ai4seo_taxonomy_proxy_sync_cron_job' );
add_action( AI4SEO_TAXONOMY_PROXY_CONTINUATION_CRON_HOOK, 'ai4seo_taxonomy_proxy_sync_cron_job' );
register_deactivation_hook( AI4SEO_PLUGIN_FILE, 'ai4seo_unschedule_taxonomy_proxy_sync' );

// Preserve post edits during storage migration in REST, CLI, cron and frontend requests too.
add_action( 'save_post', 'ai4seo_capture_post_state_post_change', 99, 1 );
add_action( 'pre_post_update', 'ai4seo_capture_title_order_before_change', 1, 1 );
add_action( 'before_delete_post', 'ai4seo_capture_title_order_before_change', 1, 1 );
add_action( AI4SEO_TITLE_ORDER_CRON_HOOK, 'ai4seo_title_order_cron_job' );
add_action( 'added_post_meta', 'ai4seo_capture_post_state_metadata_change', 99, 4 );
add_action( 'updated_post_meta', 'ai4seo_capture_post_state_metadata_change', 99, 4 );
add_action( 'deleted_post_meta', 'ai4seo_capture_post_state_metadata_change', 99, 4 );
add_action( 'deleted_post', 'ai4seo_capture_post_state_post_change', 99, 1 );

// Importers can change coverage exclusions without saving the post itself.
add_action( 'set_object_terms', 'ai4seo_capture_post_state_post_change', 99, 1 );
add_action( 'deleted_term_relationships', 'ai4seo_capture_post_state_post_change', 99, 1 );

// Scope the known Fix Alt Text 1.9.1 cache leak for saves in admin, REST, cron and frontend requests.
add_action( 'save_post', 'ai4seo_prepare_fix_alt_text_cache_scope', 998, 0 );
add_action( 'attachment_updated', 'ai4seo_prepare_fix_alt_text_cache_scope', 998, 0 );
add_action( 'add_attachment', 'ai4seo_prepare_fix_alt_text_cache_scope', 998, 0 );
add_action( 'saved_term', 'ai4seo_prepare_fix_alt_text_cache_scope', 998, 0 );
add_action( 'delete_term', 'ai4seo_prepare_fix_alt_text_cache_scope', 998, 0 );

// Keep the verified notification request view coherent with ordinary WordPress option writers.
add_action( 'added_option', 'ai4seo_handle_notification_option_change', PHP_INT_MIN, 1 );
add_action( 'updated_option', 'ai4seo_handle_notification_option_change', PHP_INT_MIN, 1 );
add_action( 'deleted_option', 'ai4seo_handle_notification_option_change', PHP_INT_MIN, 1 );

// Legacy metadata maintenance owns a local callback even when the API component is unavailable.
add_action( AI4SEO_ACTIVE_METADATA_MIGRATION_V235_CRON_JOB_NAME, AI4SEO_ACTIVE_METADATA_MIGRATION_V235_CRON_JOB_NAME );

// Keep local summary recovery available even when account-dependent cron initialization is unavailable.
add_action( AI4SEO_GENERATION_STATUS_SUMMARY_REBUILD_CRON_JOB_NAME, AI4SEO_GENERATION_STATUS_SUMMARY_REBUILD_CRON_JOB_NAME );

// Expire durable checkout-return state even when the initiating administrator never comes back.
add_action( AI4SEO_PURCHASE_RETURN_TOKEN_EXPIRY_CRON_HOOK, 'ai4seo_expire_purchase_return_token' );

// Mirror supported persisted third-party changes for every request type before any bootstrap early return.
add_action( 'added_post_meta', 'ai4seo_sync_third_party_postmeta_change_to_active_metadata', 10, 4 );
add_action( 'updated_post_meta', 'ai4seo_sync_third_party_postmeta_change_to_active_metadata', 10, 4 );
add_action( 'deleted_post_meta', 'ai4seo_sync_third_party_postmeta_change_to_active_metadata', 10, 4 );
add_action( 'before_delete_post', 'ai4seo_track_deleting_post_for_third_party_seo_metadata_sync' );

// Squirrly persists its snippet outside postmeta; cover both its purple Save button and WordPress post saves.
add_action( 'sq_save_seo_after', 'ai4seo_sync_squirrly_seo_editor_save_to_active_metadata' );
add_action( 'save_post', 'ai4seo_sync_squirrly_seo_post_save_to_active_metadata', 30, 2 );

// Finalize before summary reconciliation, which must itself precede the final list-cache namespace bump.
add_action( 'shutdown', 'ai4seo_finalize_third_party_seo_metadata_sync', PHP_INT_MAX - 2 );

// Close the list-cache namespace after every summary and late request mutation has finished.
add_action( 'shutdown', 'ai4seo_finalize_content_type_list_cache_version_bumps', PHP_INT_MAX );

// CRON CALL ONLY.
if ( wp_doing_cron() ) {
	// init cron jobs.
	add_action( 'init', 'ai4seo_init_cron_jobs', 10 );

	// exit here.
	return;
}

// FOR FRONTEND, LOGGED-OUT USERS. ALSO FOR: LOGGED-IN USERS, ADMIN AREA
// init plugin injections for all users for the frontend.
add_action( 'init', 'ai4seo_enqueue_frontend_scripts' );
add_action( 'init', 'ai4seo_init_frontend_injections' );

// Register whitelisted AJAX functions before permission-gated user essentials.
add_action( 'init', 'ai4seo_register_ajax_actions', 8 );

// FOR LOGGED-IN USERS. ALSO FOR: ADMIN AREA
// init (logged-in) user essentials after all plugins have been loaded, used for admin area and frontend.
add_action( 'init', 'ai4seo_init_user_essentials' );

// Elementor rebuilds its asset queues and footer, so register the primary bundle and schemas on its editor lifecycle.
add_action( 'elementor/editor/before_enqueue_scripts', 'ai4seo_enqueue_primary_assets' );
add_action( 'elementor/editor/footer', 'ai4seo_include_modal_schemas_file' );

// perform ajax nonce check.
add_action( 'admin_init', 'ai4seo_on_ajax_action', 9999 );

// not admin area -> exit here.
if ( ! ai4seo_is_function_usable( 'is_admin' ) || ! is_admin() ) {
	return;
}

// init admin essentials for the backend after all plugins have been loaded.
add_action( 'init', 'ai4seo_init_admin_area_essentials', 12 );

// on plugin deactivation.
register_deactivation_hook( AI4SEO_PLUGIN_FILE, 'ai4seo_on_deactivation' );

if ( ai4seo_does_user_need_to_accept_tos_toc_and_pp() ) {
	return;
}

// Capture install eligibility before analysis, activation, or migration writes become historical evidence.
add_action( 'init', 'ai4seo_initialize_welcome_notification_state', 1 );

// init cron jobs.
add_action( 'init', 'ai4seo_init_cron_jobs' );

// do some checks after all plugins have been loaded.
add_action( 'init', 'ai4seo_check_and_handle_plugin_update' );

// Check for unfinished analysis unless the full dashboard will choose fresh-versus-resume after counting posts.
add_action( 'init', 'ai4seo_maybe_start_posts_table_analysis_on_init', 9 );

// check for new notifications.
add_action( 'init', 'ai4seo_check_for_new_notifications', 13 );

// init admin essentials for the backend after all plugins have been loaded.
add_action( 'init', 'ai4seo_send_additional_tos_accept_details' );

// on saving a post, check if the all ceo meta tags are filled.
add_action( 'save_post', 'ai4seo_mark_post_to_be_analyzed', 20, 3 );

// add unified cache invalidation hooks for environmental-variable based caches.
ai4seo_add_invalidate_caches_hooks();

// analyze the post after it has been saved, call ai4seo_handle_posts_to_be_analyzed() at the end of the request.
add_action( 'shutdown', 'ai4seo_handle_posts_to_be_analyzed' );

// on plugin activation.
register_activation_hook( AI4SEO_PLUGIN_FILE, 'ai4seo_on_activation' );

// Register native WordPress list bulk action integrations through the opt-in gate below.
add_action( 'admin_init', 'ai4seo_register_bulk_generation_queue_bulk_actions' );

// Read-only editor shortcuts are independent of the opt-in bulk queue actions.
add_filter( 'post_row_actions', 'ai4seo_add_native_editor_row_action', 10, 2 );
add_filter( 'page_row_actions', 'ai4seo_add_native_editor_row_action', 10, 2 );
add_filter( 'media_row_actions', 'ai4seo_add_native_editor_row_action', 10, 2 );