Astra_Update_Blog_Archive::execute( array $args )

	public function execute( $args ) {
		$updated         = false;
		$update_messages = array();

		if ( isset( $args['blog_layout'] ) && ! empty( $args['blog_layout'] ) ) {
			$blog_layout   = sanitize_text_field( $args['blog_layout'] );
			$valid_layouts = array( 'blog-layout-classic', 'blog-layout-4', 'blog-layout-5', 'blog-layout-6' );
			if ( ! in_array( $blog_layout, $valid_layouts, true ) ) {
				return Astra_Abilities_Response::error(
					/* translators: %s: layout value */
					sprintf( __( 'Invalid blog_layout: %s.', 'astra' ), $blog_layout ),
					__( 'Valid options: blog-layout-classic, blog-layout-4, blog-layout-5, blog-layout-6', 'astra' )
				);
			}

			$layout_labels = array(
				'blog-layout-classic' => 'Classic Layout',
				'blog-layout-4'       => 'Grid',
				'blog-layout-5'       => 'List',
				'blog-layout-6'       => 'Cover',
			);

			astra_update_option( 'blog-layout', $blog_layout );
			$updated           = true;
			$update_messages[] = sprintf( 'Blog layout set to %s', $layout_labels[ $blog_layout ] );
		}

		if ( isset( $args['posts_per_page'] ) ) {
			$posts_per_page = absint( $args['posts_per_page'] );
			if ( $posts_per_page < 1 || $posts_per_page > 500 ) {
				return Astra_Abilities_Response::error(
					/* translators: %d: posts per page value */
					sprintf( __( 'Invalid posts_per_page: %d.', 'astra' ), $posts_per_page ),
					__( 'Value must be between 1 and 500.', 'astra' )
				);
			}

			astra_update_option( 'blog-post-per-page', $posts_per_page );
			$updated           = true;
			$update_messages[] = sprintf( 'Posts per page set to %d', $posts_per_page );
		}

		if ( isset( $args['sidebar_layout'] ) && ! empty( $args['sidebar_layout'] ) ) {
			$sidebar_layout = sanitize_text_field( $args['sidebar_layout'] );
			$valid_sidebars = array( 'no-sidebar', 'left-sidebar', 'right-sidebar' );
			if ( ! in_array( $sidebar_layout, $valid_sidebars, true ) ) {
				return Astra_Abilities_Response::error(
					/* translators: %s: sidebar layout value */
					sprintf( __( 'Invalid sidebar_layout: %s.', 'astra' ), $sidebar_layout ),
					__( 'Valid options: no-sidebar, left-sidebar, right-sidebar', 'astra' )
				);
			}

			$sidebar_labels = array(
				'no-sidebar'    => 'No Sidebar',
				'left-sidebar'  => 'Left Sidebar',
				'right-sidebar' => 'Right Sidebar',
			);

			astra_update_option( 'site-sidebar-layout', $sidebar_layout );
			$updated           = true;
			$update_messages[] = sprintf( 'Sidebar layout set to %s', $sidebar_labels[ $sidebar_layout ] );
		}

		if ( isset( $args['sidebar_style'] ) && ! empty( $args['sidebar_style'] ) ) {
			$sidebar_style = sanitize_text_field( $args['sidebar_style'] );
			$valid_styles  = array( 'unboxed', 'boxed' );
			if ( ! in_array( $sidebar_style, $valid_styles, true ) ) {
				return Astra_Abilities_Response::error(
					/* translators: %s: sidebar style value */
					sprintf( __( 'Invalid sidebar_style: %s.', 'astra' ), $sidebar_style ),
					__( 'Valid options: unboxed, boxed', 'astra' )
				);
			}

			$style_labels = array(
				'unboxed' => 'Unboxed',
				'boxed'   => 'Boxed',
			);

			astra_update_option( 'site-sidebar-style', $sidebar_style );
			$updated           = true;
			$update_messages[] = sprintf( 'Sidebar style set to %s', $style_labels[ $sidebar_style ] );
		}

		if ( isset( $args['sidebar_width'] ) ) {
			$sidebar_width = absint( $args['sidebar_width'] );
			if ( $sidebar_width < 15 || $sidebar_width > 50 ) {
				return Astra_Abilities_Response::error(
					/* translators: %d: sidebar width value */
					sprintf( __( 'Invalid sidebar_width: %d.', 'astra' ), $sidebar_width ),
					__( 'Value must be between 15 and 50 (percentage).', 'astra' )
				);
			}

			astra_update_option( 'site-sidebar-width', $sidebar_width );
			$updated           = true;
			$update_messages[] = sprintf( 'Sidebar width set to %d%%', $sidebar_width );
		}

		if ( ! $updated ) {
			return Astra_Abilities_Response::error(
				__( 'No changes specified.', 'astra' ),
				__( 'Please provide at least one setting to update (blog_layout, posts_per_page, sidebar_layout, sidebar_style, or sidebar_width).', 'astra' )
			);
		}

		$message = implode( ', ', $update_messages ) . '.';

		return Astra_Abilities_Response::success(
			$message,
			array(
				'updated' => true,
			)
		);
	}