<?php
/**
 * Activation handler.
 *
 * @package BlockSieve
 */

namespace BlockSieve\Services;

use BlockSieve\Settings\Settings;

/**
 * Runs once when the plugin is activated.
 *
 * Records the installed version in the settings option (on first activation
 * also the initial version, and every other setting's default) and exposes an action hook so
 * other code can hook into activation without editing this class.
 */
final class Activation {

	/**
	 * Plugin activation callback.
	 *
	 * @param bool $network_wide Whether the plugin is being activated for the whole network.
	 * @return void
	 */
	public static function activate( $network_wide = false ): void {
		if ( $network_wide && is_multisite() ) {
			foreach ( get_sites(
				array(
					'fields' => 'ids',
					'number' => 0,
				)
			) as $site_id ) {
				switch_to_blog( (int) $site_id );
				self::store_version();
				restore_current_blog();
			}
		} else {
			self::store_version();
		}

		/**
		 * Fires after the plugin is activated.
		 */
		do_action( 'blocksieve_activate' );
	}

	/**
	 * Persists the current plugin version, keeping any other stored settings.
	 *
	 * The first activation on a site also records it as the initial version,
	 * which later activations leave untouched.
	 *
	 * @return void
	 */
	private static function store_version(): void {
		$settings = new Settings();
		$values   = array( Settings::VERSION => BLOCKSIEVE_VERSION );

		if ( '' === $settings->initial_version() ) {
			$values[ Settings::INITIAL_VERSION ] = BLOCKSIEVE_VERSION;
		}

		$settings->update( $values );
	}
}