<?php

[0] Fix | Delete

[1] Fix | Delete

namespace Automattic\WooCommerce\Blocks\Patterns;

[2] Fix | Delete

[3] Fix | Delete

use Automattic\WooCommerce\Admin\Features\Features;

[4] Fix | Delete

use WP_Upgrader;

[5] Fix | Delete

[6] Fix | Delete

/**

[7] Fix | Delete

* PTKPatterns class.

[8] Fix | Delete

*

[9] Fix | Delete

* @internal

[10] Fix | Delete

*/

[11] Fix | Delete

class PTKPatternsStore {

[12] Fix | Delete

const OPTION_NAME = 'ptk_patterns';

[13] Fix | Delete

const LAST_FETCH_PATTERNS_REQUEST_OPTION_NAME = 'last_fetch_patterns_request';

[14] Fix | Delete

[15] Fix | Delete

const CATEGORY_MAPPING = array(

[16] Fix | Delete

'testimonials' => 'reviews',

[17] Fix | Delete

);

[18] Fix | Delete

[19] Fix | Delete

/**

[20] Fix | Delete

* PatternsToolkit instance.

[21] Fix | Delete

*

[22] Fix | Delete

* @var PTKClient $ptk_client

[23] Fix | Delete

*/

[24] Fix | Delete

private PTKClient $ptk_client;

[25] Fix | Delete

[26] Fix | Delete

/**

[27] Fix | Delete

* Constructor for the class.

[28] Fix | Delete

*

[29] Fix | Delete

* @param PTKClient $ptk_client An instance of PatternsToolkit.

[30] Fix | Delete

*/

[31] Fix | Delete

public function __construct( PTKClient $ptk_client ) {

[32] Fix | Delete

$this->ptk_client = $ptk_client;

[33] Fix | Delete

[34] Fix | Delete

if ( Features::is_enabled( 'pattern-toolkit-full-composability' ) ) {

[35] Fix | Delete

// We want to flush the cached patterns when:

[36] Fix | Delete

// - The WooCommerce plugin is deactivated.

[37] Fix | Delete

// - The `woocommerce_allow_tracking` option is disabled.

[38] Fix | Delete

//

[39] Fix | Delete

// We also want to re-fetch the patterns and update the cache when:

[40] Fix | Delete

// - The `woocommerce_allow_tracking` option changes to enabled.

[41] Fix | Delete

// - The WooCommerce plugin is activated (if `woocommerce_allow_tracking` is enabled).

[42] Fix | Delete

// - The WooCommerce plugin is updated.

[43] Fix | Delete

[44] Fix | Delete

add_action( 'woocommerce_activated_plugin', array( $this, 'flush_or_fetch_patterns' ), 10, 2 );

[45] Fix | Delete

add_action( 'update_option_woocommerce_allow_tracking', array( $this, 'flush_or_fetch_patterns' ), 10, 2 );

[46] Fix | Delete

add_action( 'deactivated_plugin', array( $this, 'flush_cached_patterns' ), 10, 2 );

[47] Fix | Delete

add_action( 'upgrader_process_complete', array( $this, 'fetch_patterns_on_plugin_update' ), 10, 2 );

[48] Fix | Delete

[49] Fix | Delete

// This is the scheduled action that takes care of flushing and re-fetching the patterns from the PTK API.

[50] Fix | Delete

add_action( 'fetch_patterns', array( $this, 'fetch_patterns' ) );

[51] Fix | Delete

}

[52] Fix | Delete

}

[53] Fix | Delete

[54] Fix | Delete

/**

[55] Fix | Delete

* Resets the cached patterns when the `woocommerce_allow_tracking` option is disabled.

[56] Fix | Delete

* Resets and fetch the patterns from the PTK when it is enabled (if the scheduler

[57] Fix | Delete

* is initialized, it's done asynchronously via a scheduled action).

[58] Fix | Delete

*

[59] Fix | Delete

* @return void

[60] Fix | Delete

*/

[61] Fix | Delete

public function flush_or_fetch_patterns() {

[62] Fix | Delete

if ( $this->allowed_tracking_is_enabled() ) {

[63] Fix | Delete

$this->schedule_fetch_patterns();

[64] Fix | Delete

return;

[65] Fix | Delete

}

[66] Fix | Delete

[67] Fix | Delete

$this->flush_cached_patterns();

[68] Fix | Delete

}

[69] Fix | Delete

[70] Fix | Delete

/**

[71] Fix | Delete

* Schedule an async action to fetch the PTK patterns when the scheduler is initialized.

[72] Fix | Delete

*

[73] Fix | Delete

* @return void

[74] Fix | Delete

*/

[75] Fix | Delete

private function schedule_fetch_patterns() {

[76] Fix | Delete

if ( did_action( 'action_scheduler_init' ) ) {

[77] Fix | Delete

$this->schedule_action_if_not_pending( 'fetch_patterns' );

[78] Fix | Delete

} else {

[79] Fix | Delete

add_action(

[80] Fix | Delete

'action_scheduler_init',

[81] Fix | Delete

function () {

[82] Fix | Delete

$this->schedule_action_if_not_pending( 'fetch_patterns' );

[83] Fix | Delete

}

[84] Fix | Delete

);

[85] Fix | Delete

}

[86] Fix | Delete

}

[87] Fix | Delete

[88] Fix | Delete

/**

[89] Fix | Delete

* Check if the last request was more than one day ago.

[90] Fix | Delete

*

[91] Fix | Delete

* @param int $last_request The last request time.

[92] Fix | Delete

* @return bool

[93] Fix | Delete

*/

[94] Fix | Delete

private function is_older_than_one_day( $last_request ) {

[95] Fix | Delete

$current_time = time();

[96] Fix | Delete

return abs( $last_request - $current_time ) > DAY_IN_SECONDS;

[97] Fix | Delete

}

[98] Fix | Delete

[99] Fix | Delete

/**

[100] Fix | Delete

* Schedule an action if it's not already pending.

[101] Fix | Delete

*

[102] Fix | Delete

* @param string $action The action name to schedule.

[103] Fix | Delete

* @return void

[104] Fix | Delete

*/

[105] Fix | Delete

private function schedule_action_if_not_pending( $action ) {

[106] Fix | Delete

$last_request = get_option( self::LAST_FETCH_PATTERNS_REQUEST_OPTION_NAME );

[107] Fix | Delete

// The most efficient way to check for an existing action is to use `as_has_scheduled_action`, but in unusual

[108] Fix | Delete

// cases where another plugin has loaded a very old version of Action Scheduler, it may not be available to us.

[109] Fix | Delete

[110] Fix | Delete

$has_scheduled_action = function_exists( 'as_has_scheduled_action' ) ? 'as_has_scheduled_action' : 'as_next_scheduled_action';

[111] Fix | Delete

if ( call_user_func( $has_scheduled_action, $action ) || ( is_numeric( $last_request ) && ! $this->is_older_than_one_day( $last_request ) ) ) {

[112] Fix | Delete

return;

[113] Fix | Delete

}

[114] Fix | Delete

[115] Fix | Delete

as_schedule_single_action( time(), $action );

[116] Fix | Delete

update_option( self::LAST_FETCH_PATTERNS_REQUEST_OPTION_NAME, time(), false );

[117] Fix | Delete

}

[118] Fix | Delete

[119] Fix | Delete

/**

[120] Fix | Delete

* Get the patterns from the Patterns Toolkit cache.

[121] Fix | Delete

*

[122] Fix | Delete

* @return array

[123] Fix | Delete

*/

[124] Fix | Delete

public function get_patterns() {

[125] Fix | Delete

$patterns = get_option( self::OPTION_NAME );

[126] Fix | Delete

[127] Fix | Delete

// Only if the transient is not set, we schedule fetching the patterns from the PTK.

[128] Fix | Delete

if ( false === $patterns || ! $this->ptk_client->is_valid_schema( $patterns ) ) {

[129] Fix | Delete

$this->schedule_fetch_patterns();

[130] Fix | Delete

return array();

[131] Fix | Delete

}

[132] Fix | Delete

[133] Fix | Delete

return $patterns;

[134] Fix | Delete

}

[135] Fix | Delete

[136] Fix | Delete

/**

[137] Fix | Delete

* Filter the patterns that have external dependencies.

[138] Fix | Delete

*

[139] Fix | Delete

* @param array $patterns The patterns to filter.

[140] Fix | Delete

* @return array

[141] Fix | Delete

*/

[142] Fix | Delete

private function filter_patterns( array $patterns ) {

[143] Fix | Delete

return array_values(

[144] Fix | Delete

array_filter(

[145] Fix | Delete

$patterns,

[146] Fix | Delete

function ( $pattern ) {

[147] Fix | Delete

if ( ! isset( $pattern['ID'] ) ) {

[148] Fix | Delete

return true;

[149] Fix | Delete

}

[150] Fix | Delete

[151] Fix | Delete

if ( isset( $pattern['post_type'] ) && 'wp_block' !== $pattern['post_type'] ) {

[152] Fix | Delete

return false;

[153] Fix | Delete

}

[154] Fix | Delete

[155] Fix | Delete

if ( $this->has_external_dependencies( $pattern ) ) {

[156] Fix | Delete

return false;

[157] Fix | Delete

}

[158] Fix | Delete

[159] Fix | Delete

return true;

[160] Fix | Delete

}

[161] Fix | Delete

)

[162] Fix | Delete

);

[163] Fix | Delete

}

[164] Fix | Delete

[165] Fix | Delete

/**

[166] Fix | Delete

* Re-fetch the patterns when the WooCommerce plugin is updated.

[167] Fix | Delete

*

[168] Fix | Delete

* @param WP_Upgrader $upgrader_object WP_Upgrader instance.

[169] Fix | Delete

* @param array $options Array of bulk item update data.

[170] Fix | Delete

*

[171] Fix | Delete

* @return void

[172] Fix | Delete

*/

[173] Fix | Delete

public function fetch_patterns_on_plugin_update( $upgrader_object, $options ) {

[174] Fix | Delete

if ( 'update' === $options['action'] && 'plugin' === $options['type'] && isset( $options['plugins'] ) ) {

[175] Fix | Delete

foreach ( $options['plugins'] as $plugin ) {

[176] Fix | Delete

if ( str_contains( $plugin, 'woocommerce.php' ) ) {

[177] Fix | Delete

$this->schedule_fetch_patterns();

[178] Fix | Delete

}

[179] Fix | Delete

}

[180] Fix | Delete

}

[181] Fix | Delete

}

[182] Fix | Delete

[183] Fix | Delete

/**

[184] Fix | Delete

* Reset the cached patterns to fetch them again from the PTK.

[185] Fix | Delete

*

[186] Fix | Delete

* @return void

[187] Fix | Delete

*/

[188] Fix | Delete

public function flush_cached_patterns() {

[189] Fix | Delete

delete_option( self::OPTION_NAME );

[190] Fix | Delete

delete_option( self::LAST_FETCH_PATTERNS_REQUEST_OPTION_NAME );

[191] Fix | Delete

}

[192] Fix | Delete

[193] Fix | Delete

/**

[194] Fix | Delete

* Reset the cached patterns and fetch them again from the PTK API.

[195] Fix | Delete

*

[196] Fix | Delete

* @return void

[197] Fix | Delete

*/

[198] Fix | Delete

public function fetch_patterns() {

[199] Fix | Delete

if ( ! $this->allowed_tracking_is_enabled() ) {

[200] Fix | Delete

return;

[201] Fix | Delete

}

[202] Fix | Delete

[203] Fix | Delete

$this->flush_cached_patterns();

[204] Fix | Delete

[205] Fix | Delete

$patterns = $this->ptk_client->fetch_patterns(

[206] Fix | Delete

array(

[207] Fix | Delete

// This is the site where the patterns are stored. Despite the 'wpcomstaging.com' domain suggesting a staging environment, this URL points to the production environment where stable versions of the patterns are maintained.

[208] Fix | Delete

'site' => 'wooblockpatterns.wpcomstaging.com',

[209] Fix | Delete

'categories' => array(

[210] Fix | Delete

'_woo_intro',

[211] Fix | Delete

'_woo_featured_selling',

[212] Fix | Delete

'_woo_about',

[213] Fix | Delete

'_woo_reviews',

[214] Fix | Delete

'_woo_social_media',

[215] Fix | Delete

'_woo_woocommerce',

[216] Fix | Delete

'_dotcom_imported_intro',

[217] Fix | Delete

'_dotcom_imported_about',

[218] Fix | Delete

'_dotcom_imported_services',

[219] Fix | Delete

'_dotcom_imported_reviews',

[220] Fix | Delete

),

[221] Fix | Delete

)

[222] Fix | Delete

);

[223] Fix | Delete

[224] Fix | Delete

if ( is_wp_error( $patterns ) ) {

[225] Fix | Delete

wc_get_logger()->warning(

[226] Fix | Delete

sprintf(

[227] Fix | Delete

// translators: %s is a generated error message.

[228] Fix | Delete

__( 'Failed to get WooCommerce patterns from the PTK: "%s"', 'woocommerce' ),

[229] Fix | Delete

$patterns->get_error_message()

[230] Fix | Delete

),

[231] Fix | Delete

);

[232] Fix | Delete

return;

[233] Fix | Delete

}

[234] Fix | Delete

[235] Fix | Delete

$patterns = $this->filter_patterns( $patterns );

[236] Fix | Delete

$patterns = $this->map_categories( $patterns );

[237] Fix | Delete

[238] Fix | Delete

update_option( self::OPTION_NAME, $patterns, false );

[239] Fix | Delete

}

[240] Fix | Delete

[241] Fix | Delete

/**

[242] Fix | Delete

* Check if the user allowed tracking.

[243] Fix | Delete

*

[244] Fix | Delete

* @return bool

[245] Fix | Delete

*/

[246] Fix | Delete

private function allowed_tracking_is_enabled(): bool {

[247] Fix | Delete

return 'yes' === get_option( 'woocommerce_allow_tracking' );

[248] Fix | Delete

}

[249] Fix | Delete

[250] Fix | Delete

/**

[251] Fix | Delete

* Change the categories of the patterns to match the ones used in the CYS flow

[252] Fix | Delete

*

[253] Fix | Delete

* @param array $patterns The patterns to map categories for.

[254] Fix | Delete

* @return array The patterns with the categories mapped.

[255] Fix | Delete

*/

[256] Fix | Delete

private function map_categories( array $patterns ) {

[257] Fix | Delete

return array_map(

[258] Fix | Delete

function ( $pattern ) {

[259] Fix | Delete

if ( isset( $pattern['categories'] ) ) {

[260] Fix | Delete

foreach ( $pattern['categories'] as $key => $category ) {

[261] Fix | Delete

if ( isset( $category['slug'] ) && isset( self::CATEGORY_MAPPING[ $key ] ) ) {

[262] Fix | Delete

$new_category = self::CATEGORY_MAPPING[ $key ];

[263] Fix | Delete

unset( $pattern['categories'][ $key ] );

[264] Fix | Delete

$pattern['categories'][ $new_category ]['slug'] = $new_category;

[265] Fix | Delete

$pattern['categories'][ $new_category ]['title'] = ucfirst( $new_category );

[266] Fix | Delete

}

[267] Fix | Delete

}

[268] Fix | Delete

}

[269] Fix | Delete

[270] Fix | Delete

return $pattern;

[271] Fix | Delete

},

[272] Fix | Delete

$patterns

[273] Fix | Delete

);

[274] Fix | Delete

}

[275] Fix | Delete

[276] Fix | Delete

/**

[277] Fix | Delete

* Check if the pattern has external dependencies.

[278] Fix | Delete

*

[279] Fix | Delete

* @param array $pattern The pattern to check.

[280] Fix | Delete

*

[281] Fix | Delete

* @return bool

[282] Fix | Delete

*/

[283] Fix | Delete

private function has_external_dependencies( $pattern ) {

[284] Fix | Delete

if ( ! isset( $pattern['dependencies'] ) || ! is_array( $pattern['dependencies'] ) ) {

[285] Fix | Delete

return false;

[286] Fix | Delete

}

[287] Fix | Delete

[288] Fix | Delete

foreach ( $pattern['dependencies'] as $dependency ) {

[289] Fix | Delete

if ( 'woocommerce' !== $dependency ) {

[290] Fix | Delete

return true;

[291] Fix | Delete

}

[292] Fix | Delete

}

[293] Fix | Delete

[294] Fix | Delete

return false;

[295] Fix | Delete

}

[296] Fix | Delete

}

[297] Fix | Delete

[298] Fix | Delete