handle custom ajax callback

Author: ilicfilip

assets/js/recommendations/interactive-task.js

@@ -100,6 +100,7 @@ const prplInteractiveTaskFormListener = {
 		settingPath = false,
 		popoverId,
 		settingCallbackValue = ( settingValue ) => settingValue,
+		action = 'prpl_interactive_task_submit',
 	} = {} ) => {
 		const formElement = document.querySelector( `#${ popoverId } form` );
 
@@ -119,7 +120,7 @@ const prplInteractiveTaskFormListener = {
 			progressPlannerAjaxRequest( {
 				url: progressPlanner.ajaxUrl,
 				data: {
-					action: 'prpl_interactive_task_submit',
+					action,
 					_ajax_nonce: progressPlanner.nonce,
 					post_id: taskId,
 					setting,

assets/js/recommendations/select-timezone.js

@@ -6,11 +6,12 @@
  * Dependencies: progress-planner/recommendations/interactive-task
  */
 
-prplInteractiveTaskFormListener.siteSettings( {
+prplInteractiveTaskFormListener.settings( {
 	settingAPIKey: 'timezone',
 	setting: 'timezone',
 	taskId: 'select-timezone',
 	popoverId: 'prpl-popover-select-timezone',
+	action: 'prpl_interactive_task_submit_select-timezone',
 } );
 
 prplDocumentReady( () => {

classes/suggested-tasks/providers/class-select-timezone.php

@@ -33,6 +33,15 @@ class Select_Timezone extends Tasks_Interactive {
 	 */
 	protected $is_dismissable = true;
 
+	/**
+	 * Initialize the task.
+	 *
+	 * @return void
+	 */
+	public function init() {
+		\add_action( 'wp_ajax_prpl_interactive_task_submit_select-timezone', [ $this, 'handle_interactive_task_specific_submit' ] );
+	}
+
 	/**
 	 * Get the task URL.
 	 *
@@ -125,7 +134,7 @@ public function print_popover_form_contents() {
 		}
 		?>
 		<label>
-			<select id="gmt_offset" name="gmt_offset" data-timezone-saved="<?php echo \esc_attr( $was_tzstring_saved ); ?>">
+			<select id="timezone" name="timezone" data-timezone-saved="<?php echo \esc_attr( $was_tzstring_saved ); ?>">
 				<?php echo \wp_timezone_choice( $tzstring, \get_user_locale() ); ?>
 			</select>
 		</label>
@@ -134,4 +143,72 @@ public function print_popover_form_contents() {
 		</button>
 		<?php
 	}
+
+	/**
+	 * Handle the interactive task submit.
+	 *
+	 * This is only for interactive tasks that change non-core settings.
+	 * The $_POST data is expected to be:
+	 * - setting: (string) The setting to update.
+	 * - value: (mixed) The value to update the setting to.
+	 * - setting_path: (array) The path to the setting to update.
+	 *                         Use an empty array if the setting is not nested.
+	 *                         If the value is nested, use an array of keys.
+	 *                         Example: [ 'a', 'b', 'c' ] will update the value of $option['a']['b']['c'].
+	 * - nonce: (string) The nonce.
+	 *
+	 * @return void
+	 */
+	public function handle_interactive_task_specific_submit() {
+		// Check the nonce.
+		if ( ! \check_ajax_referer( 'progress_planner', 'nonce', false ) ) {
+			\wp_send_json_error( [ 'message' => \esc_html__( 'Invalid nonce.', 'progress-planner' ) ] );
+		}
+
+		if ( ! isset( $_POST['setting'] ) ) {
+			\wp_send_json_error( [ 'message' => \esc_html__( 'Missing setting.', 'progress-planner' ) ] );
+		}
+
+		if ( ! isset( $_POST['value'] ) ) {
+			\wp_send_json_error( [ 'message' => \esc_html__( 'Missing value.', 'progress-planner' ) ] );
+		}
+
+		if ( ! isset( $_POST['setting_path'] ) ) {
+			\wp_send_json_error( [ 'message' => \esc_html__( 'Missing setting path.', 'progress-planner' ) ] );
+		}
+
+		$timezone_string = \sanitize_text_field( \wp_unslash( $_POST['value'] ) );
+
+		if ( empty( $timezone_string ) ) {
+			\wp_send_json_error( [ 'message' => \esc_html__( 'Invalid timezone.', 'progress-planner' ) ] );
+		}
+
+		$update_options = false;
+
+		// Map UTC+- timezones to gmt_offsets and set timezone_string to empty.
+		if ( preg_match( '/^UTC[+-]/', $timezone_string ) ) {
+			// Set the gmt_offset to the value of the timezone_string, strip the UTC prefix.
+			$gmt_offset      = preg_replace( '/UTC\+?/', '', $timezone_string );
+
+			// Reset the timezone_string to empty.
+			$timezone_string = '';
+
+			$update_options = true;
+		} elseif ( in_array( $timezone_string, \timezone_identifiers_list( \DateTimeZone::ALL_WITH_BC ), true ) ) {
+			// $timezone_string is already set, reset the value for $gmt_offset.
+			$gmt_offset = '';
+
+			$update_options = true;
+		}
+
+		if ( $update_options ) {
+			\update_option( 'timezone_string', $timezone_string );
+			\update_option( 'gmt_offset', $gmt_offset );
+
+			// We're not checking for the return value of the update_option calls, because it will return false if the value is the same (for example if gmt_offset is already set to '').
+			\wp_send_json_success( [ 'message' => \esc_html__( 'Setting updated.', 'progress-planner' ) ] );
+		}
+
+		\wp_send_json_error( [ 'message' => \esc_html__( 'Failed to update setting.', 'progress-planner' ) ] );
+	}
 }