<?php
/** Activation defaults and version upgrades. */
namespace PublishRankSEO\Core;

defined( 'ABSPATH' ) || exit;

final class Installer {
	const VERSION_OPTION = 'publishrank_seo_version';

	/** Options that are only read on rare requests and should not be autoloaded. */
	private static function no_autoload() {
		return array( 'publishrank_seo_redirects', 'publishrank_seo_404_log', 'publishrank_robots_custom', 'publishrank_seo_last_invalidation', 'publishrank_indexnow_last_status', 'publishrank_indexnow_log', 'publishrank_internal_links_scan_id', 'publishrank_seo_config_snapshots' );
	}

	/** @return array<string,mixed> */
	public static function defaults() {
			return array(
				'publishrank_sitemap_endpoint'            => 'publishrank-sitemap',
				'publishrank_sitemap_aliases'             => '',
				'publishrank_seo_cache_epoch'             => time(),
				'publishrank_seo_last_invalidation'       => '',
				'publishrank_indexnow_enabled'            => 0,
				'publishrank_indexnow_key'                => wp_generate_password( 32, false, false ),
				'publishrank_indexnow_post_types'         => 'post',
				'publishrank_indexnow_key_location'       => home_url( '/publishrank-indexnow-key.txt' ),
				'publishrank_seo_news_enabled'            => 1,
				'publishrank_seo_news_window'             => 48,
				'publishrank_seo_news_include_modified'   => 1,
				'publishrank_seo_news_modified_window'    => 48,
				'publishrank_seo_news_post_types'         => 'post',
				'publishrank_seo_news_max_urls'           => 1000,
				'publishrank_seo_news_exclude_ids'        => '',
				'publishrank_seo_news_exclude_categories' => '',
				'publishrank_seo_news_stock_tickers'     => 0,
				'publishrank_seo_news_keywords'           => 1,
				'publishrank_seo_news_genre'              => '',
				'publishrank_editorial_genre'             => '',
				'publishrank_seo_title_separator'         => '|',
				'publishrank_meta_enabled'                => 1,
				'publishrank_llms_txt_override' => 0,
				'publishrank_llms_txt_override_text' => '',
				'publishrank_schema_aggregator_enabled' => 1,
				'publishrank_schema_aggregator_override' => 0,
				'publishrank_schema_aggregator_custom' => '',
				'publishrank_schema_enabled'              => 1,
				'publishrank_org_website_schema_enabled'  => 1,
				'publishrank_external_seo_handoff'        => 0,
				'publishrank_schema_default_page_type'    => 'WebPage',
				'publishrank_twitter_card'                => 'summary_large_image',
				'publishrank_facebook_app_id'             => '',
				'publishrank_home_title'                  => '',
				'publishrank_home_description'            => '',
				'publishrank_seo_description_fallback'     => 'page_type',
				'publishrank_noindex_author_archives'     => 0,
				'publishrank_noindex_date_archives'       => 0,
				'publishrank_seo_default_robots'          => 'index,follow',
				'publishrank_seo_title_template_home'     => '%%sitename%% %%page%%',
				'publishrank_seo_title_template_post'     => '%%title%% %%sep%% %%sitename%% %%page%%',
				'publishrank_seo_title_template_page'     => '%%title%% %%sep%% %%sitename%%',
				'publishrank_seo_title_template_archive'  => '%%title%% %%sep%% %%sitename%%',
				'publishrank_seo_image_sitemap'           => 1,
				'publishrank_image_license_url'           => '',
				'publishrank_seo_video_sitemap'           => 1,
				'publishrank_seo_media_post_types'        => 'all',
				// Visible footer credit is opt-in only: off until an administrator ticks the box.
				'publishrank_sitemap_post_types'          => 'post',
				'publishrank_sitemap_pages_enabled'       => 1,
				'publishrank_sitemap_cpt_enabled'         => 1,
				'publishrank_sitemap_taxonomies_enabled'  => 1,
				'publishrank_sitemap_authors_enabled'     => 1,
				'publishrank_sitemap_attachments_enabled' => 0,
				'publishrank_sitemap_stylesheet'          => 1,
				'publishrank_breadcrumbs_enabled'         => 1,
				'publishrank_breadcrumb_schema_enabled'   => 1,
				'publishrank_breadcrumb_frontend_override' => 1,
				'publishrank_breadcrumbs_separator'       => '→',
				'publishrank_breadcrumb_style' => 'plain',
				'publishrank_breadcrumb_size' => 'medium',
				'publishrank_breadcrumb_text_color' => '',
				'publishrank_breadcrumb_link_color' => '',
				'publishrank_breadcrumb_bg_color' => '',
				'publishrank_breadcrumb_placement'        => 'auto',
				'publishrank_breadcrumb_hook'             => '',
				'publishrank_breadcrumb_home_label'       => '',
				'publishrank_breadcrumb_error_mode'       => 'skip',
				'publishrank_breadcrumb_error_key'        => 'breadcrumb_error',
				'publishrank_breadcrumb_fallback_label'   => 'Home',
					'publishrank_breadcrumb_fallback_url'     => home_url( '/' ),
					'publishrank_breadcrumb_log_errors'       => 0,
					'publishrank_hide_visible_site_title'     => 1,
					'publishrank_hide_visible_site_description' => 1,
					'publishrank_override_wp_identity'        => 1,
					'publishrank_seo_publication_name'        => '',
				'publishrank_seo_publisher_name'          => '',
				'publishrank_seo_publisher_logo'          => '',
				'publishrank_identity_alternate_names'    => '',
				'publishrank_seo_publisher_type'          => 'NewsMediaOrganization',
				'publishrank_schema_org_description'      => '',
				'publishrank_schema_legal_name'           => '',
				'publishrank_schema_founder'              => '',
				'publishrank_schema_founding_date'        => '',
				'publishrank_schema_phone'                => '',
				'publishrank_schema_street_address'       => '',
				'publishrank_schema_address_locality'     => '',
				'publishrank_schema_address_region'       => '',
				'publishrank_schema_postal_code'          => '',
				'publishrank_schema_knows_about'          => '',
				'publishrank_schema_parent_organization'  => '',
				'publishrank_schema_founding_location'    => '',
				'publishrank_seo_default_social_image'    => '',
				'publishrank_seo_twitter_site'            => '',
				'publishrank_primary_url'                 => home_url( '/' ),
				'publishrank_media_host'                  => '',
				'publishrank_cdn_enabled'                 => 0,
				'publishrank_cdn_host'                    => '',
				'publishrank_video_host'                  => '',
				'publishrank_api_host'                    => '',
				'publishrank_publication_short_name'      => '',
				'publishrank_default_language'            => substr( (string) get_locale(), 0, 2 ),
				'publishrank_seo_multilingual_enabled'    => 1,
				'publishrank_seo_hreflang_map'            => '',
				'publishrank_seo_x_default_url'           => '',
				'publishrank_default_locale'              => get_locale(),
				'publishrank_timezone'                    => wp_timezone_string(),
				'publishrank_country'                     => '',
				'publishrank_copyright'                   => '',
				'publishrank_contact'                     => '',
				'publishrank_social_profiles'             => '',
				'publishrank_author_mode'                 => 'wordpress',
				'publishrank_robots_enabled'              => 1,
				'publishrank_robots_sitemaps'             => 1,
				'publishrank_robots_block_ai'             => 0,
				'publishrank_robots_custom'               => '',
				'publishrank_links_enabled'               => 1,
				'publishrank_links_follow_domains'        => '',
				'publishrank_links_nofollow_domains'      => '',
				'publishrank_links_sponsored'             => 0,
				'publishrank_internal_link_enabled'       => 1,
				'publishrank_internal_link_min_inbound'   => 1,
				'publishrank_internal_link_max_recommendations' => 5,
				'publishrank_internal_link_post_types'    => '',
				'publishrank_internal_links_scan_id'      => time(),
				'publishrank_redirect_enabled'            => 1,
				'publishrank_redirect_only_404'           => 1,
				'publishrank_redirect_preserve_query'     => 1,
				'publishrank_redirect_x_header'           => 1,
				'publishrank_redirect_max_hops'           => 10,
				'publishrank_seo_config_snapshots'        => array(),
				'publishrank_llms_txt_enabled'            => 1,
				'publishrank_llms_txt_title'              => '',
				'publishrank_llms_txt_summary'            => '',
				'publishrank_llms_txt_intro'              => '',
				'publishrank_llms_txt_home'               => 1,
				'publishrank_llms_txt_posts'              => 1,
				'publishrank_llms_txt_pages'              => 1,
				'publishrank_llms_txt_categories'         => 1,
				'publishrank_llms_txt_post_count'         => 20,
				'publishrank_llms_txt_custom'             => '',
				'publishrank_llms_full_enabled'           => 0,
				'publishrank_llms_full_words'             => 8000,
				'publishrank_llms_txt_policy'             => 1,
				'publishrank_llms_txt_authors'            => 1,
				'publishrank_llms_txt_tags'               => 0,
				'publishrank_llms_txt_cpt'                => 0,
				'publishrank_llms_txt_resources'          => 1,
				'publishrank_llms_txt_optional'           => 1,
				'publishrank_llms_full_per_post'          => 1200,
			);
	}

	/** Add any missing option without overwriting what the site owner configured. */
	public static function install_defaults() {
		$no_autoload = self::no_autoload();
		foreach ( self::defaults() as $key => $value ) {
			add_option( $key, $value, '', in_array( $key, $no_autoload, true ) ? 'no' : 'yes' );
		}
	}

	/** Activation: defaults plus every rewrite rule the plugin serves. */
	public static function activate() {
		add_option( 'publishrank_article_intel_enabled', 1, '', false );
		self::install_defaults();
		// Fresh installs must complete the setup wizard once; sites that already finished it are left alone.
		if ( ! get_option( 'publishrank_onboarding_completed_at', '' ) ) {
			update_option( 'publishrank_setup_required', 1, false );
		}
		\PublishRankSEO\InternalLinks\Store::install();
		update_option( 'publishrank_seo_cache_epoch', time(), false );
		update_option( self::VERSION_OPTION, PUBLISHRANK_SEO_VERSION, true );
		( new \PublishRankSEO\Sitemap\SitemapController() )->rewrite();
		( new \PublishRankSEO\Sitemap\SitemapStylesheet() )->rewrite();
		( new \PublishRankSEO\Indexing\IndexNow() )->rewrite();
		( new \PublishRankSEO\AI\LLMSTxt() )->rewrite();
		flush_rewrite_rules();
	}

	/** Runs once after the plugin files are updated (admin requests only). */
	public static function maybe_upgrade() {
		if ( ! is_admin() || PUBLISHRANK_SEO_VERSION === (string) get_option( self::VERSION_OPTION, '' ) ) {
			return;
		}
		$previous_version = (string) get_option( self::VERSION_OPTION, '0' );
		self::install_defaults();
		\PublishRankSEO\InternalLinks\Store::install();
		( new \PublishRankSEO\Indexing\IndexNow() )->rewrite();
		( new \PublishRankSEO\AI\LLMSTxt() )->rewrite();
		// Shard boundaries changed in 2.9.20; bump versions so old cursor checkpoints and cached XML cannot be reused.
		if ( version_compare( (string) get_option( self::VERSION_OPTION, '0' ), '2.9.20', '<' ) ) {
			\PublishRankSEO\Sitemap\Engine\SitemapCursorStore::bump_many( array( 'post', 'page', 'cpt', 'taxonomy', 'author', 'attachment', 'news', 'image', 'video' ) );
		}
		// 2.9.44: preserve the news/media cache migration for upgrades that skipped 2.9.43.
		if ( version_compare( (string) get_option( self::VERSION_OPTION, '0' ), '2.9.44', '<' ) ) {
			\PublishRankSEO\Sitemap\Engine\SitemapCursorStore::bump_many( array( 'news', 'image', 'video' ) );
		}
		// 2.9.91: output-switch normalisation and repair of template tokens damaged by older sanitizers. Safe to rerun.
		if ( version_compare( $previous_version, '2.9.91', '<' ) ) {
			self::migrate_2_9_91();
		}
			// 2.9.102: make PublishRank's visible breadcrumb trail the default after upgrade, as requested.
			// This is a one-time migration; administrators can turn it off again in the Breadcrumbs screen.
			if ( version_compare( $previous_version, '2.9.102', '<' ) ) {
			update_option( 'publishrank_breadcrumbs_enabled', 1 );
		}
		update_option( 'publishrank_seo_cache_epoch', time(), false );
		update_option( self::VERSION_OPTION, PUBLISHRANK_SEO_VERSION, true );
		flush_rewrite_rules( false );
	}

	/**
	 * 2.9.91 data migration. It never turns an output on or off: saved choices are only rewritten into the canonical 1/0 form
	 * (so a stray "false" or "off" string keeps meaning "off"), and options that never existed receive the enabled default
	 * from install_defaults() through add_option(), which cannot overwrite a saved value. Running it again changes nothing.
	 */
	public static function migrate_2_9_91() {
		foreach ( OutputSettings::keys() as $option ) {
			$sentinel = new \stdClass();
			$stored   = get_option( $option, $sentinel );
			if ( $sentinel === $stored ) {
				add_option( $option, 1 ); // Missing legacy switch: the documented default is enabled.
				continue;
			}
			$canonical = OutputSettings::is_on( $option ) ? 1 : 0;
			if ( $stored !== $canonical && $stored !== (string) $canonical ) {
				update_option( $option, $canonical );
			}
		}
		// sanitize_text_field() used to cut %%date%% to "%te%%" and %%category%% to "%tegory%%" when a template was saved.
		foreach ( array( 'publishrank_seo_title_template_home', 'publishrank_seo_title_template_post', 'publishrank_seo_title_template_page', 'publishrank_seo_title_template_archive', 'publishrank_home_title', 'publishrank_home_description' ) as $option ) {
			$value = get_option( $option, '' );
			if ( ! is_string( $value ) || false === strpos( $value, '%' ) ) {
				continue;
			}
			$fixed = preg_replace( array( '/(?<!%)%te%%/', '/(?<!%)%tegory%%/' ), array( '%%date%%', '%%category%%' ), $value );
			if ( is_string( $fixed ) && $fixed !== $value ) {
				update_option( $option, $fixed );
			}
		}
	}
}