From a65b49effe8f2a7acddbf2c80ae5bf1ef7a0aa61 Mon Sep 17 00:00:00 2001
From: Miroslav Mitev <m1r0@users.noreply.github.com>
Date: Thu, 4 Jan 2024 20:40:55 +0200
Subject: [PATCH 1/4] Add HPPS instructions

---
 includes/class-sensei-settings.php | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/includes/class-sensei-settings.php b/includes/class-sensei-settings.php
index 15dfce275c..7851354a1a 100755
--- a/includes/class-sensei-settings.php
+++ b/includes/class-sensei-settings.php
@@ -1220,7 +1220,7 @@ class="sensei-settings_progress-storage-feature"
 			<div class="notice notice-info inline sensei-settings__progress-storage-settings hidden">
 				<p>
 					<?php
-					echo esc_html( __( 'Save changes to make synchronization setting available.', 'sensei-lms' ) );
+					echo esc_html( __( 'Save changes to make the feature settings available.', 'sensei-lms' ) );
 					?>
 				</p>
 			</div>
@@ -1246,6 +1246,14 @@ public function render_progress_storage_repositories( $args ) {
 		$migration_incomplete = ! $migration_scheduler || ! $migration_scheduler->is_complete();
 		?>
 		<div class="sensei-settings__progress-storage-settings" style="display: <?php echo esc_attr( $block_display ); ?>">
+			<h4><?php esc_html_e( 'Instructions', 'sensei-lms' ); ?></h4>
+			<p><?php esc_html_e( 'To enable High-Performance Progress Storage, follow these steps:', 'sensei-lms' ); ?></p>
+			<ol>
+				<li><?php esc_html_e( 'Turn on the storage synchronization.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'Wait for the data synchronization migration to complete.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'Select the "High-Performance progress storage" option.', 'sensei-lms' ); ?></li>
+			</ol>
+			<p><?php echo wp_kses_post( __( 'Find out more about the feature in the <a href="https://senseilms.com/documentation/high-performance-progress-storage/" target="_blank">docs</a>.', 'sensei-lms' ) ); ?></p>
 			<h4><?php echo esc_html( __( 'Progress storage repository', 'sensei-lms' ) ); ?></h4>
 			<p><?php echo esc_html( $args['data']['description'] ); ?></p>
 			<ul>

From 75b4487ad0fc90f267775ce492eee0d1f5704d6e Mon Sep 17 00:00:00 2001
From: Miroslav Mitev <m1r0@users.noreply.github.com>
Date: Thu, 4 Jan 2024 20:59:23 +0200
Subject: [PATCH 2/4] Add changelog

---
 changelog/add-hpps-instructions | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 changelog/add-hpps-instructions

diff --git a/changelog/add-hpps-instructions b/changelog/add-hpps-instructions
new file mode 100644
index 0000000000..c50cf26dbf
--- /dev/null
+++ b/changelog/add-hpps-instructions
@@ -0,0 +1,4 @@
+Significance: patch
+Type: changed
+
+Include instructions to the High-Performance Progress Storage settings screen

From ee779b679ef5af2d0c235bb1160989d0ec326e6c Mon Sep 17 00:00:00 2001
From: Miroslav Mitev <m1r0@users.noreply.github.com>
Date: Mon, 8 Jan 2024 22:11:47 +0200
Subject: [PATCH 3/4] Update the HPPS instructions

---
 includes/class-sensei-settings.php | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/includes/class-sensei-settings.php b/includes/class-sensei-settings.php
index 7851354a1a..1ce3f730a1 100755
--- a/includes/class-sensei-settings.php
+++ b/includes/class-sensei-settings.php
@@ -1225,6 +1225,16 @@ class="sensei-settings_progress-storage-feature"
 				</p>
 			</div>
 		<?php endif; ?>
+			<h4><?php esc_html_e( 'Instructions', 'sensei-lms' ); ?></h4>
+			<p><?php esc_html_e( 'To enable High-Performance Progress Storage, follow these steps:', 'sensei-lms' ); ?></p>
+			<ol>
+				<li><?php esc_html_e( 'Select the "Store the progress of your students in separate tables" checkbox and save the changes.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'Select the "Synchronize the student progress between storages" checkbox and save the changes.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'Wait until the "Migration complete and data synchronization enabled" message is displayed. This may take awhile and you will need to refresh the page to see the updated status.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'Select the "High-Performance progress storage (experimental)" option and save the changes.', 'sensei-lms' ); ?></li>
+				<li><?php esc_html_e( 'You are now using High-Performance Progress Storage!', 'sensei-lms' ); ?></li>
+			</ol>
+			<p><?php echo wp_kses_post( __( 'To learn more about the feature, check the <a href="https://senseilms.com/documentation/high-performance-progress-storage/" target="_blank">docs</a>.', 'sensei-lms' ) ); ?></p>
 		</div>
 		<?php
 		Sensei()->assets->enqueue( 'sensei-experimental-features-progress-storage', 'js/admin/settings/experimental-features.js', array( 'jquery' ), true );
@@ -1246,14 +1256,6 @@ public function render_progress_storage_repositories( $args ) {
 		$migration_incomplete = ! $migration_scheduler || ! $migration_scheduler->is_complete();
 		?>
 		<div class="sensei-settings__progress-storage-settings" style="display: <?php echo esc_attr( $block_display ); ?>">
-			<h4><?php esc_html_e( 'Instructions', 'sensei-lms' ); ?></h4>
-			<p><?php esc_html_e( 'To enable High-Performance Progress Storage, follow these steps:', 'sensei-lms' ); ?></p>
-			<ol>
-				<li><?php esc_html_e( 'Turn on the storage synchronization.', 'sensei-lms' ); ?></li>
-				<li><?php esc_html_e( 'Wait for the data synchronization migration to complete.', 'sensei-lms' ); ?></li>
-				<li><?php esc_html_e( 'Select the "High-Performance progress storage" option.', 'sensei-lms' ); ?></li>
-			</ol>
-			<p><?php echo wp_kses_post( __( 'Find out more about the feature in the <a href="https://senseilms.com/documentation/high-performance-progress-storage/" target="_blank">docs</a>.', 'sensei-lms' ) ); ?></p>
 			<h4><?php echo esc_html( __( 'Progress storage repository', 'sensei-lms' ) ); ?></h4>
 			<p><?php echo esc_html( $args['data']['description'] ); ?></p>
 			<ul>

From a62fe37068b03f65354c2391b1fc02b3d595cb5b Mon Sep 17 00:00:00 2001
From: Miroslav Mitev <m1r0@users.noreply.github.com>
Date: Mon, 15 Jan 2024 22:47:43 +0200
Subject: [PATCH 4/4] Change the order of the HPPS settings

---
 includes/class-sensei-settings.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/includes/class-sensei-settings.php b/includes/class-sensei-settings.php
index 1ce3f730a1..49d44149e5 100755
--- a/includes/class-sensei-settings.php
+++ b/includes/class-sensei-settings.php
@@ -860,6 +860,14 @@ public function init_fields() {
 				'default'     => false,
 				'section'     => 'sensei-experimental-features',
 			);
+			$fields['experimental_progress_storage_synchronization'] = array(
+				'name'        => '',
+				'description' => __( 'Synchronize the student progress between storages.', 'sensei-lms' ),
+				'form'        => 'render_progress_storage_synchronization',
+				'type'        => 'checkbox',
+				'default'     => false,
+				'section'     => 'sensei-experimental-features',
+			);
 			$fields['experimental_progress_storage_repository']      = array(
 				'name'        => '', // ,
 				'description' => __( 'Choose a repository to store the progress and quiz submissions of your students.', 'sensei-lms' ),
@@ -869,14 +877,6 @@ public function init_fields() {
 				'section'     => 'sensei-experimental-features',
 				'options'     => Progress_Storage_Settings::get_storage_repositories(),
 			);
-			$fields['experimental_progress_storage_synchronization'] = array(
-				'name'        => '',
-				'description' => __( 'Synchronize the student progress between storages.', 'sensei-lms' ),
-				'form'        => 'render_progress_storage_synchronization',
-				'type'        => 'checkbox',
-				'default'     => false,
-				'section'     => 'sensei-experimental-features',
-			);
 		}
 
 		/**