<?php

[0] Fix | Delete

[1] Fix | Delete

namespace Elementor\Modules\Checklist;

[2] Fix | Delete

[3] Fix | Delete

use Elementor\Modules\Checklist\Steps\Assign_Homepage;

[4] Fix | Delete

use Elementor\Modules\Checklist\Steps\Create_Pages;

[5] Fix | Delete

use Elementor\Modules\Checklist\Steps\Setup_Header;

[6] Fix | Delete

use Elementor\Modules\Checklist\Steps\Add_Logo;

[7] Fix | Delete

use Elementor\Modules\Checklist\Steps\Step_Base;

[8] Fix | Delete

use Elementor\Modules\Checklist\Steps\Set_Fonts_And_Colors;

[9] Fix | Delete

[10] Fix | Delete

if ( ! defined( 'ABSPATH' ) ) {

[11] Fix | Delete

exit; // Exit if accessed directly.

[12] Fix | Delete

}

[13] Fix | Delete

[14] Fix | Delete

class Steps_Manager {

[15] Fix | Delete

/** @var Step_Base[] $step_instances */

[16] Fix | Delete

private array $step_instances = [];

[17] Fix | Delete

[18] Fix | Delete

private static array $step_ids = [

[19] Fix | Delete

Add_Logo::STEP_ID,

[20] Fix | Delete

Set_Fonts_And_Colors::STEP_ID,

[21] Fix | Delete

Create_Pages::STEP_ID,

[22] Fix | Delete

Setup_Header::STEP_ID,

[23] Fix | Delete

Assign_Homepage::STEP_ID,

[24] Fix | Delete

];

[25] Fix | Delete

[26] Fix | Delete

private Checklist_Module_Interface $module;

[27] Fix | Delete

[28] Fix | Delete

public function __construct( Checklist_Module_Interface $module ) {

[29] Fix | Delete

$this->module = $module;

[30] Fix | Delete

$this->register_steps();

[31] Fix | Delete

[32] Fix | Delete

add_action( 'elementor/init', function() {

[33] Fix | Delete

$this->filter_steps();

[34] Fix | Delete

} );

[35] Fix | Delete

}

[36] Fix | Delete

[37] Fix | Delete

/**

[38] Fix | Delete

* Gets formatted and ordered array of step ( step data, is_marked_completed and is_completed )

[39] Fix | Delete

*

[40] Fix | Delete

* @return array

[41] Fix | Delete

*/

[42] Fix | Delete

public function get_steps_for_frontend(): array {

[43] Fix | Delete

$formatted_steps = [];

[44] Fix | Delete

[45] Fix | Delete

foreach ( self::$step_ids as $step_id ) {

[46] Fix | Delete

$instance = $this->step_instances[ $step_id ];

[47] Fix | Delete

$instance->maybe_immutably_mark_as_completed();

[48] Fix | Delete

[49] Fix | Delete

$step = [

[50] Fix | Delete

Step_Base::MARKED_AS_COMPLETED_KEY => $instance->is_marked_as_completed(),

[51] Fix | Delete

Step_Base::IMMUTABLE_COMPLETION_KEY => $instance->is_immutable_completed(),

[52] Fix | Delete

Step_Base::ABSOLUTE_COMPLETION_KEY => $instance->is_absolute_completed(),

[53] Fix | Delete

'config' => $this->get_step_config( $step_id ),

[54] Fix | Delete

];

[55] Fix | Delete

[56] Fix | Delete

$formatted_steps[] = $step;

[57] Fix | Delete

}

[58] Fix | Delete

[59] Fix | Delete

return $formatted_steps;

[60] Fix | Delete

}

[61] Fix | Delete

[62] Fix | Delete

public function update_step( string $step_id, array $data ): void {

[63] Fix | Delete

$step = $this->get_step_by_id( $step_id );

[64] Fix | Delete

[65] Fix | Delete

if ( ! $step ) {

[66] Fix | Delete

return;

[67] Fix | Delete

}

[68] Fix | Delete

[69] Fix | Delete

$step->update_step( $data );

[70] Fix | Delete

}

[71] Fix | Delete

[72] Fix | Delete

/**

[73] Fix | Delete

* Marks a step as completed, returns true if the step was found and marked or false otherwise

[74] Fix | Delete

*

[75] Fix | Delete

* @param string $step_id

[76] Fix | Delete

*

[77] Fix | Delete

* @return void

[78] Fix | Delete

*/

[79] Fix | Delete

public function mark_step_as_completed( string $step_id ): void {

[80] Fix | Delete

$this->update_step( $step_id, [ Step_Base::MARKED_AS_COMPLETED_KEY => true ] );

[81] Fix | Delete

}

[82] Fix | Delete

[83] Fix | Delete

/**

[84] Fix | Delete

* Unmarks a step as completed, returns true if the step was found and unmarked or false otherwise

[85] Fix | Delete

*

[86] Fix | Delete

* @param string $step_id

[87] Fix | Delete

*

[88] Fix | Delete

* @return void

[89] Fix | Delete

*/

[90] Fix | Delete

public function unmark_step_as_completed( string $step_id ): void {

[91] Fix | Delete

$this->update_step( $step_id, [ Step_Base::MARKED_AS_COMPLETED_KEY => false ] );

[92] Fix | Delete

}

[93] Fix | Delete

[94] Fix | Delete

/**

[95] Fix | Delete

* Maybe marks a step as completed (depending on if source allows it), returns true if the step was found and marked or false otherwise

[96] Fix | Delete

*

[97] Fix | Delete

* @param $step_id

[98] Fix | Delete

*

[99] Fix | Delete

* @return void

[100] Fix | Delete

*/

[101] Fix | Delete

public function maybe_set_step_as_immutable_completed( string $step_id ): void {

[102] Fix | Delete

$step = $this->get_step_by_id( $step_id );

[103] Fix | Delete

[104] Fix | Delete

if ( ! $step ) {

[105] Fix | Delete

return;

[106] Fix | Delete

}

[107] Fix | Delete

[108] Fix | Delete

$step->maybe_immutably_mark_as_completed();

[109] Fix | Delete

}

[110] Fix | Delete

[111] Fix | Delete

public function get_step_by_id( string $step_id ): ?Step_Base {

[112] Fix | Delete

return $this->step_instances[ $step_id ] ?? null;

[113] Fix | Delete

}

[114] Fix | Delete

[115] Fix | Delete

/**

[116] Fix | Delete

* @return array

[117] Fix | Delete

*/

[118] Fix | Delete

public function get_step_config( $step_id ): array {

[119] Fix | Delete

$step_instance = $this->step_instances[ $step_id ];

[120] Fix | Delete

[121] Fix | Delete

return $step_instance

[122] Fix | Delete

? [

[123] Fix | Delete

'id' => $step_instance->get_id(),

[124] Fix | Delete

'title' => $step_instance->get_title(),

[125] Fix | Delete

'description' => $step_instance->get_description(),

[126] Fix | Delete

'learn_more_text' => $step_instance->get_learn_more_text(),

[127] Fix | Delete

'learn_more_url' => $step_instance->get_learn_more_url(),

[128] Fix | Delete

Step_Base::IS_COMPLETION_IMMUTABLE => $step_instance->get_is_completion_immutable(),

[129] Fix | Delete

'cta_text' => $step_instance->get_cta_text(),

[130] Fix | Delete

'cta_url' => $step_instance->get_cta_url(),

[131] Fix | Delete

'image_src' => $step_instance->get_image_src(),

[132] Fix | Delete

'promotion_data' => $step_instance->get_promotion_data(),

[133] Fix | Delete

]

[134] Fix | Delete

: [];

[135] Fix | Delete

}

[136] Fix | Delete

[137] Fix | Delete

/**

[138] Fix | Delete

* Getting the step instances array based on source's order

[139] Fix | Delete

*

[140] Fix | Delete

* @return void

[141] Fix | Delete

*/

[142] Fix | Delete

private function register_steps(): void {

[143] Fix | Delete

foreach ( self::$step_ids as $step_id ) {

[144] Fix | Delete

$step_instance = $this->get_step_instance( $step_id );

[145] Fix | Delete

[146] Fix | Delete

if ( $step_instance && ! isset( $this->step_instances[ $step_id ] ) ) {

[147] Fix | Delete

$this->step_instances[ $step_id ] = $step_instance;

[148] Fix | Delete

}

[149] Fix | Delete

}

[150] Fix | Delete

}

[151] Fix | Delete

[152] Fix | Delete

/**

[153] Fix | Delete

* Returns the steps config from source

[154] Fix | Delete

*

[155] Fix | Delete

* @return array

[156] Fix | Delete

*/

[157] Fix | Delete

public static function get_step_ids(): array {

[158] Fix | Delete

return self::$step_ids;

[159] Fix | Delete

}

[160] Fix | Delete

[161] Fix | Delete

/**

[162] Fix | Delete

* Using step data->id, instantiates and returns the step class or null if the class does not exist

[163] Fix | Delete

*

[164] Fix | Delete

* @param $step_data

[165] Fix | Delete

*

[166] Fix | Delete

* @return Step_Base|null

[167] Fix | Delete

*/

[168] Fix | Delete

private function get_step_instance( string $step_id ): ?Step_Base {

[169] Fix | Delete

$class_name = '\\Elementor\\Modules\\Checklist\\Steps\\' . $step_id;

[170] Fix | Delete

[171] Fix | Delete

if ( ! class_exists( $class_name ) ) {

[172] Fix | Delete

return null;

[173] Fix | Delete

}

[174] Fix | Delete

[175] Fix | Delete

/** @var Step_Base $step */

[176] Fix | Delete

return new $class_name( $this->module, $this->module->get_wordpress_adapter(), $this->module->get_elementor_adapter() );

[177] Fix | Delete

}

[178] Fix | Delete

[179] Fix | Delete

private function filter_steps() {

[180] Fix | Delete

$step_ids = [];

[181] Fix | Delete

$filtered_steps = apply_filters( 'elementor/checklist/steps', $this->step_instances );

[182] Fix | Delete

[183] Fix | Delete

foreach ( $filtered_steps as $step_id => $step_instance ) {

[184] Fix | Delete

if ( ! $step_instance instanceof Step_Base ) {

[185] Fix | Delete

continue;

[186] Fix | Delete

}

[187] Fix | Delete

[188] Fix | Delete

if ( ! $step_instance->is_visible() ) {

[189] Fix | Delete

continue;

[190] Fix | Delete

}

[191] Fix | Delete

[192] Fix | Delete

$this->step_instances[ $step_id ] = $step_instance;

[193] Fix | Delete

$step_ids[] = $step_id;

[194] Fix | Delete

}

[195] Fix | Delete

[196] Fix | Delete

self::$step_ids = $step_ids;

[197] Fix | Delete

}

[198] Fix | Delete

}

[199] Fix | Delete

[200] Fix | Delete