<?php
/**
 * Yoast SEO: a post's SEO fields and the plugin's settings.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * Yoast keeps a post's SEO fields as `_yoast_wpseo_*` post meta
 * (`WPSEO_Meta::$meta_prefix`) and deletes a field set back to its default
 * (its `update_post_metadata` filter `remove_meta_if_default`), so a reset
 * reaches the log as the field going empty. Its settings are the `wpseo`,
 * `wpseo_titles` and `wpseo_social` options. Read in Yoast's source
 * (wordpress-seo trunk, 15 Oct 2026). Term SEO (the `wpseo_taxonomy_meta`
 * option) and the network option are named deferrals. The machinery is
 * {@see SeoWatch}'s.
 */
final class Yoast implements Integration {

	public const PLUGIN = 'wordpress-seo';

	/** Watched post meta => label. */
	public const META = array(
		'_yoast_wpseo_title'                 => 'SEO title',
		'_yoast_wpseo_metadesc'              => 'meta description',
		'_yoast_wpseo_focuskw'               => 'focus keyphrase',
		'_yoast_wpseo_canonical'             => 'canonical URL',
		'_yoast_wpseo_meta-robots-noindex'   => 'noindex',
		'_yoast_wpseo_meta-robots-nofollow'  => 'nofollow',
		'_yoast_wpseo_meta-robots-adv'       => 'advanced robots',
		'_yoast_wpseo_is_cornerstone'        => 'cornerstone content',
		'_yoast_wpseo_bctitle'               => 'breadcrumb title',
		'_yoast_wpseo_opengraph-title'       => 'social title',
		'_yoast_wpseo_opengraph-description' => 'social description',
		'_yoast_wpseo_twitter-title'         => 'X title',
		'_yoast_wpseo_twitter-description'   => 'X description',
	);

	/** Watched options => label. */
	public const OPTIONS = array(
		'wpseo'        => 'Yoast SEO general',
		'wpseo_titles' => 'Yoast SEO search appearance',
		'wpseo_social' => 'Yoast SEO social',
	);

	public static function is_active(): bool {
		return Integrations::enabled( self::PLUGIN, defined( 'WPSEO_VERSION' ) );
	}

	public static function event_types(): array {
		return array(
			SeoWatch::META_UPDATED     => 'SEO Fields Updated',
			SeoWatch::SETTINGS_CHANGED => 'SEO Settings Changed',
		);
	}

	public static function register( ?bool $active = null ): void {
		if ( ! ( $active ?? self::is_active() ) ) {
			return;
		}

		SeoWatch::watch( self::PLUGIN, self::META, self::OPTIONS );
	}

	public static function post_types(): array {
		return array();
	}

	public static function internal_post_types(): array {
		return array();
	}
}