<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WooCommerce Admin Scheduled Updates Promotion Note Provider.

[2] Fix | Delete

*

[3] Fix | Delete

* Adds a note to the merchant's inbox promoting scheduled updates for analytics.

[4] Fix | Delete

*/

[5] Fix | Delete

[6] Fix | Delete

declare( strict_types=1 );

[7] Fix | Delete

[8] Fix | Delete

namespace Automattic\WooCommerce\Internal\Admin\Notes;

[9] Fix | Delete

[10] Fix | Delete

defined( 'ABSPATH' ) || exit;

[11] Fix | Delete

[12] Fix | Delete

use Automattic\WooCommerce\Admin\Features\Features;

[13] Fix | Delete

use Automattic\WooCommerce\Admin\Notes\Note;

[14] Fix | Delete

use Automattic\WooCommerce\Admin\Notes\NoteTraits;

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* ScheduledUpdatesPromotion

[18] Fix | Delete

*

[19] Fix | Delete

* @since 10.5.0

[20] Fix | Delete

*/

[21] Fix | Delete

class ScheduledUpdatesPromotion {

[22] Fix | Delete

/**

[23] Fix | Delete

* Note traits.

[24] Fix | Delete

*/

[25] Fix | Delete

use NoteTraits;

[26] Fix | Delete

[27] Fix | Delete

/**

[28] Fix | Delete

* Name of the note for use in the database.

[29] Fix | Delete

*/

[30] Fix | Delete

const NOTE_NAME = 'wc-admin-scheduled-updates-promotion';

[31] Fix | Delete

[32] Fix | Delete

/**

[33] Fix | Delete

* Name of the option to check.

[34] Fix | Delete

*/

[35] Fix | Delete

const OPTION_NAME = 'woocommerce_analytics_scheduled_import';

[36] Fix | Delete

[37] Fix | Delete

/**

[38] Fix | Delete

* Constructor - attach action hooks.

[39] Fix | Delete

*/

[40] Fix | Delete

public function __construct() {

[41] Fix | Delete

add_action( 'woocommerce_note_action_scheduled-updates-enable', array( $this, 'enable_scheduled_updates' ) );

[42] Fix | Delete

}

[43] Fix | Delete

[44] Fix | Delete

/**

[45] Fix | Delete

* Should this note exist?

[46] Fix | Delete

*

[47] Fix | Delete

* @return bool

[48] Fix | Delete

*/

[49] Fix | Delete

public static function is_applicable() {

[50] Fix | Delete

if ( ! Features::is_enabled( 'analytics-scheduled-import' ) ) {

[51] Fix | Delete

return false;

[52] Fix | Delete

}

[53] Fix | Delete

[54] Fix | Delete

// Get the current option value.

[55] Fix | Delete

// Note: get_option() returns false when option doesn't exist.

[56] Fix | Delete

$immediate_import = get_option( self::OPTION_NAME, false );

[57] Fix | Delete

[58] Fix | Delete

// Only show to existing sites (false/not set) that haven't migrated yet.

[59] Fix | Delete

// New sites have the option set during onboarding, so they won't see this.

[60] Fix | Delete

if ( false !== $immediate_import ) {

[61] Fix | Delete

return false;

[62] Fix | Delete

}

[63] Fix | Delete

[64] Fix | Delete

return true;

[65] Fix | Delete

}

[66] Fix | Delete

[67] Fix | Delete

/**

[68] Fix | Delete

* Get the note.

[69] Fix | Delete

*

[70] Fix | Delete

* @return Note|null

[71] Fix | Delete

*/

[72] Fix | Delete

public static function get_note() {

[73] Fix | Delete

if ( ! self::is_applicable() ) {

[74] Fix | Delete

return null;

[75] Fix | Delete

}

[76] Fix | Delete

[77] Fix | Delete

$note = new Note();

[78] Fix | Delete

[79] Fix | Delete

$note->set_title( __( 'Analytics now supports scheduled updates', 'woocommerce' ) );

[80] Fix | Delete

$note->set_content( __( 'This provides improved performance to your store, enable it in Analytics > Settings.', 'woocommerce' ) );

[81] Fix | Delete

$note->set_content_data( (object) array() );

[82] Fix | Delete

$note->set_type( Note::E_WC_ADMIN_NOTE_INFORMATIONAL );

[83] Fix | Delete

$note->set_name( self::NOTE_NAME );

[84] Fix | Delete

$note->set_source( 'woocommerce-admin' );

[85] Fix | Delete

[86] Fix | Delete

// Add "Enable" action with custom handler.

[87] Fix | Delete

$note->add_action(

[88] Fix | Delete

'scheduled-updates-enable',

[89] Fix | Delete

__( 'Enable', 'woocommerce' ),

[90] Fix | Delete

wc_admin_url(),

[91] Fix | Delete

Note::E_WC_ADMIN_NOTE_ACTIONED,

[92] Fix | Delete

true,

[93] Fix | Delete

__( 'Scheduled updates enabled', 'woocommerce' )

[94] Fix | Delete

);

[95] Fix | Delete

[96] Fix | Delete

return $note;

[97] Fix | Delete

}

[98] Fix | Delete

[99] Fix | Delete

/**

[100] Fix | Delete

* Enable scheduled updates when the action is triggered.

[101] Fix | Delete

*

[102] Fix | Delete

* @param Note $note The note being actioned.

[103] Fix | Delete

* @return void

[104] Fix | Delete

*/

[105] Fix | Delete

public function enable_scheduled_updates( $note ): void {

[106] Fix | Delete

// Verify this is our note.

[107] Fix | Delete

if ( self::NOTE_NAME !== $note->get_name() ) {

[108] Fix | Delete

return;

[109] Fix | Delete

}

[110] Fix | Delete

[111] Fix | Delete

// Update the option to enable scheduled mode.

[112] Fix | Delete

update_option( self::OPTION_NAME, 'yes' );

[113] Fix | Delete

}

[114] Fix | Delete

}

[115] Fix | Delete

[116] Fix | Delete