File Manager

📁 Media Files

📁 .. (Parent Directory) 📁 API/ 📁 Admin/ 📁 Exception/ 📁 MultichannelMarketing/ 📁 Notes/ 📁 Product/ 📁 Tracking/ 📁 Utilities/ 📁 View/ 🔧 AdCredits.php 🔧 AdCreditsCoupons.php 🔧 AdsCreditCurrency.php 🔧 Billing.php 🔧 CommerceIntegration.php 🔧 Compat.php 🔧 Crypto.php 🔧 FeedFileOperations.php 🔧 FeedGenerator.php 🔧 FeedRegistration.php 🔧 FeedStatusService.php 🔧 Feeds.php 🔧 Heartbeat.php 🔧 LocalFeedConfigs.php 🔧 LocaleMapper.php 🔧 Logger.php 🔧 Merchants.php 🔧 PinterestApiException.php 🔧 PinterestShippingZone.php 🔧 PinterestSyncSettings.php 🔧 PluginActivate.php 🔧 PluginHelper.php 🔧 PluginUpdate.php 🔧 ProductFeedStatus.php 🔧 ProductSync.php 🔧 ProductsXmlFeed.php 🔧 RefreshToken.php 🔧 RichPins.php 🔧 SaveToPinterest.php 🔧 Shipping.php 🔧 TrackerSnapshot.php 🔧 Tracking.php 🔧 WPConsentAPI.php

⬆️ Upload Files

📁 Create Folder

📄 Create File

💻 Terminal

📦 Extract Archive

🔧 Edit: PluginUpdate.php

PHP

Size: 10.90 KB | Modified: 2026-03-18 08:41:16

<?php
/**
 * Helper class for performing various update procedures.
 *
 * @package Automattic\WooCommerce\Pinterest
 */

declare( strict_types=1 );

namespace Automattic\WooCommerce\Pinterest;

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

use Automattic\WooCommerce\Admin\Notes\NotesUnavailableException;
use Automattic\WooCommerce\Pinterest\API\UserInteraction;
use Automattic\WooCommerce\Pinterest\API\TokenExchangeV3ToV5;
use Automattic\WooCommerce\Pinterest\Notes\FeedDeletionFailure;
use Automattic\WooCommerce\Pinterest\Notes\TokenExchangeFailure;
use Exception;
use Throwable;
/**
 * Class PluginUpdate
 *
 * 1. Check if the plugin is up to date. If yes return immediately.
 * 2. Perform update procedures.
 * 3. Bump update version string.
 */
class PluginUpdate {

/**
	 * Option name used for storing version of the plugin before the update procedure.
	 */
	const PLUGIN_UPDATE_VERSION_OPTION = PINTEREST_FOR_WOOCOMMERCE_PREFIX . '-update-version';

/**
	 * Option name used for token update retry hook.
	 */
	const TOKEN_UPDATE_RETRY_HOOK = PINTEREST_FOR_WOOCOMMERCE_PREFIX . '-token-update-retry';

/**
	 * Constructor for the PluginUpdate class.
	 */
	public function __construct() {
		add_action( self::TOKEN_UPDATE_RETRY_HOOK, array( $this, 'token_update' ), 10, 1 );
	}

/**
	 * Check if the plugin is up to date.
	 *
	 * @since 1.0.9
	 * @return boolean
	 */
	public function plugin_is_up_to_date(): bool {
		return version_compare(
			$this->get_plugin_update_version(),
			$this->get_plugin_current_version(),
			'=='
		);
	}

/**
	 * Helper function to check if update to $version is needed.
	 *
	 * @since 1.0.9
	 * @param string $version Version string for which we check if update is needed.
	 * @return boolean
	 */
	private function version_needs_update( string $version ): bool {
		return version_compare(
			$this->get_plugin_update_version(),
			$version,
			'<'
		);
	}

/**
	 * Gets the previous version of the plugin. The one before the update has
	 * happened. After the update procedure this will return the same version
	 * as get_plugin_current_version().
	 *
	 * @since 1.0.9
	 * @return string
	 */
	private function get_plugin_update_version(): string {
		return get_option( self::PLUGIN_UPDATE_VERSION_OPTION, '1.0.0' );
	}

/**
	 * Returns the version of the plugin as defined in the main plugin file.
	 *
	 * @since 1.0.9
	 * @return string
	 */
	private function get_plugin_current_version(): string {
		return PINTEREST_FOR_WOOCOMMERCE_VERSION;
	}

/**
	 * After the update has been completed bump the previous version option to
	 * the current version option.
	 *
	 * @since 1.0.9
	 * @return void
	 */
	public function update_plugin_update_version_option(): void {
		update_option(
			self::PLUGIN_UPDATE_VERSION_OPTION,
			$this->get_plugin_current_version()
		);
	}

/**
	 * List of update procedures
	 *
	 * @since 1.0.10
	 * @since 1.2.7 Updates procedures organized in an array by plugin version.
	 * @since 1.4.0 Added token_update procedure.
	 * @return array List of update procedures names.
	 */
	private function update_procedures() {
		return array(
			'1.0.9'  => array(
				'domain_verification_migration',
			),
			'1.0.10' => array(
				'feed_generation_migration',
			),
			'1.2.5'  => array(
				'ads_credits_integration',
			),
			'1.4.0'  => array(
				'token_update',
				'feed_status_migration',
			),
			'1.4.10' => array(
				'feed_deletion_notice_cleanup',
			),
			'1.4.19' => array(
				'disable_capi_for_all_merchants',
			),
		);
	}

/**
	 * Update procedures entry point.
	 *
	 * @since 1.0.9
	 * @return void
	 */
	public function maybe_update(): void {

// Return if the plugin is up to date.
		if ( $this->plugin_is_up_to_date() ) {
			return;
		}

// Run the update procedures.
		foreach ( $this->update_procedures() as $version => $update_procedures ) {

if ( ! $this->version_needs_update( $version ) ) {
				// Already up to date.
				continue;
			}

foreach ( $update_procedures as $update_procedure ) {
				$this->perform_plugin_update_procedure( $update_procedure );
			}
		}

/**
		 * Even if the update procedure has errored we still want to
		 * update the update version. This avoids problems where the
		 * update procedure will be called again and again. Update
		 * problems will need to be fixed in the next patch release
		 * in this case.
		 */
		$this->update_plugin_update_version_option();

Logger::log(
			sprintf(
				// translators: plugin version.
				__( 'Plugin updated to version: %s.', 'pinterest-for-woocommerce' ),
				$this->get_plugin_current_version()
			)
		);
	}

/**
	 * Perform update procedure.
	 *
	 * @since 1.0.9
	 * @since 1.0.10 Accepts procedure name as parameter.
	 * @since 1.2.7  Log the failed procedure.
	 * @param  string $update_procedure Name of the migration procedure.
	 * @throws Throwable Update procedure failures.
	 * @return void
	 */
	protected function perform_plugin_update_procedure( $update_procedure ): void {
		try {
			$this->{$update_procedure}();
		} catch ( Throwable $th ) {
			Logger::log(
				sprintf(
					// translators: 1: plugin version, 2: failed procedure, 3: error message.
					__( 'Plugin update to version %1$s. Procedure: %2$s. Error: %3$s', 'pinterest-for-woocommerce' ),
					$this->get_plugin_current_version(),
					$update_procedure,
					$th->getMessage()
				),
				'error',
				null,
				true
			);
		}
	}

/**
	 * Update procedure for the 1.0.9 version of the plugin.
	 *
	 * @since 1.0.9
	 * @throws Exception Verification error.
	 * @return void
	 */
	protected function domain_verification_migration(): void {

$account_data = Pinterest_For_Woocommerce()::get_setting( 'account_data' );

/**
		 * Trigger update only if the user has performed verification
		 * procedure already. Otherwise we rely on the setup wizard process.
		 */
		if ( ! ( isset( $account_data['domain_verified'] ) && isset( $account_data['verified_domains'] ) ) ) {
			return;
		}

$response = API\DomainVerification::trigger_domain_verification();
		if ( is_wp_error( $response ) ) {
			throw new Exception( $response->get_error_message() );
		}
	}

/**
	 * New style feed generator migration procedure.
	 *
	 * @return void
	 */
	protected function feed_generation_migration(): void {
		/*
		 * 1. Cancel old actions.
		 */
		as_unschedule_all_actions( PINTEREST_FOR_WOOCOMMERCE_PREFIX . '-handle-sync', array(), PINTEREST_FOR_WOOCOMMERCE_PREFIX );
		as_unschedule_all_actions( PINTEREST_FOR_WOOCOMMERCE_PREFIX . '-feed-generation', array(), PINTEREST_FOR_WOOCOMMERCE_PREFIX );

/*
		 * 2. Move feed file id to a new location.
		 */
		$feed_id = Pinterest_For_Woocommerce()::get_data( 'local_feed_id' );
		if ( $feed_id ) {
			/*
			 * 2-a. Move location id to array of ids.
			 */
			$feed_ids = array(
				Pinterest_For_Woocommerce()::get_base_country() => $feed_id,
			);
			Pinterest_For_Woocommerce()::save_data( 'local_feed_ids', $feed_ids );

/*
			 * 2-b. Move state.
			 */
			$data_prefix = PINTEREST_FOR_WOOCOMMERCE_PREFIX . '_feed_' . $feed_id . '_';

$old_state = array(
				'status'        => get_transient( $data_prefix . 'status' ),
				'current_index' => get_transient( $data_prefix . 'current_index' ),
				'last_activity' => get_transient( $data_prefix . 'last_activity' ),
				'product_count' => get_transient( $data_prefix . 'product_count' ),
				'error_message' => get_transient( $data_prefix . 'error_message' ),
			);

foreach ( $old_state as $key => $value ) {
				delete_transient( $data_prefix . $key );
			}

unset( $old_state['product_count'] );

ProductFeedStatus::set( $old_state );

/*
			 * 2-c. PINTEREST_FOR_WOOCOMMERCE_PREFIX . '_feed_dataset_' transient will be removed after WEEK_IN_SECONDS.
			 */
		}

/*
		 * 3. Clear data.
		 */
		$settings = Pinterest_For_Woocommerce()::get_settings( true, PINTEREST_FOR_WOOCOMMERCE_DATA_NAME );

if ( isset( $settings['local_feed_id'] ) ) {
			unset( $settings['local_feed_id'] );
		}

Pinterest_For_Woocommerce()::save_settings( $settings, PINTEREST_FOR_WOOCOMMERCE_DATA_NAME );

// Update done.
	}

/**
	 * Integrate Ads credit flow.
	 *
	 * @since 1.2.5
	 *
	 * @return void
	 */
	protected function ads_credits_integration(): void {
		// Set modals as dismissed and notice as not dismissed.
		update_option( PINTEREST_FOR_WOOCOMMERCE_OPTION_NAME . '_' . UserInteraction::ADS_MODAL_DISMISSED, true, false );
	}

/**
	 * Token update procedure. V3 to V5.
	 *
	 * @since 1.4.0
	 *
	 * @param int $retry_count Parameteres passed via Action Scheduler call. Number of retries left.
	 *
	 * @return void
	 */
	public function token_update( $retry_count = 3 ): void {
		// Update should only happen if the plugin is connected using the V3 token.
		$token_data   = Pinterest_For_Woocommerce()::get_data( 'token', true );
		$has_v3_token = $token_data && ! empty( $token_data['access_token'] );

if ( ! $has_v3_token ) {
			// Plugin not connected. Regular, manual connection flow will be used.
			return;
		}

if ( 'v5' === Pinterest_For_Woocommerce()::get_api_version() ) {
			// Plugin already updated.
			return;
		}

// Set API version to V3. We can use this value to detect failure in the token update procedure.
		Pinterest_For_Woocommerce()::set_api_version( 'v3' );

$updated = TokenExchangeV3ToV5::token_update();

if ( ! $updated ) {
			$this->update_failure( $retry_count );
			return;
		}
	}

/**
	 * Schedule a retry for the token update procedure.
	 *
	 * @since 1.4.0
	 *
	 * @param int $retry_count Number of retries left.
	 * @return void
	 */
	private function update_failure( $retry_count = 3 ) {
		// Show a warning banner to the merchant informing that they need to reconnect manually.
		TokenExchangeFailure::possibly_add_note();

if ( 0 === (int) $retry_count ) {
			// Retry count exceeded. Do not schedule another retry.
			return;
		}

as_schedule_single_action(
			time() + MINUTE_IN_SECONDS * 5 * ( 4 - $retry_count ),
			self::TOKEN_UPDATE_RETRY_HOOK,
			array(
				'retry_count' => $retry_count - 1,
			),
			PINTEREST_FOR_WOOCOMMERCE_PREFIX
		);
	}

/**
	 * Feed status migration for 1.4.0.
	 * Migrate from transients to options.
	 *
	 * @since 1.4.0
	 * @return void
	 */
	private function feed_status_migration(): void {

foreach ( ProductFeedStatus::STATE_PROPS as $key => $default_value ) {
			$name  = ProductFeedStatus::PINTEREST_FOR_WOOCOMMERCE_FEEDS_DATA_PREFIX . $key;
			$value = get_transient( $name );
			$value = ( false !== $value ) ? $value : $default_value;
			update_option( $name, $value );
			delete_transient( $name );
		}
	}

/**
	 * Clears all Feed Deletion Failure admin notices created by mistake.
	 *
	 * @since 1.4.10
	 * @return void
	 */
	private function feed_deletion_notice_cleanup(): void {
		try {
			FeedDeletionFailure::possibly_delete_note();
		} catch ( NotesUnavailableException $e ) {
			return;
		}
	}

/**
	 * Disable CAPI for all merchants.
	 *
	 * @since 1.4.19
	 * @return void
	 */
	protected function disable_capi_for_all_merchants(): void {
		// Set track_conversions_capi to false for all merchants.
		Pinterest_For_Woocommerce()::save_setting( 'track_conversions_capi', false );
	}
}

Supports: PHP, ASPX, HTML, JavaScript, CSS and other text-based files

📥 Download

File manager