Merge pull request #5124 from Automattic/release/4.4.1

Release 4.4.1

changelog.txt

@@ -1,5 +1,28 @@
 *** Changelog ***
 
+2022.05.16 - version 4.4.1
+* New: Add a "Date Started" reports filter for students on a course [#5076](https://github.com/Automattic/sensei/pull/5076)
+* New: Show a notice if future PHP requirements aren't met in preparation for increasing the minimum requirements to PHP 7.2 [#5088](https://github.com/Automattic/sensei/pull/5088)
+* New: Add lesson notices filters [#5087](https://github.com/Automattic/sensei/pull/5087)
+* Tweak: Apply data filters to column total values for reports [#5091](https://github.com/Automattic/sensei/pull/5091)
+* Tweak: Calculate total average progress for courses reports [#5077](https://github.com/Automattic/sensei/pull/5077)
+* Tweak: Display average total for Days to Completion in Courses report header [#5097](https://github.com/Automattic/sensei/pull/5097)
+* Tweak: Display the student FullName on the reports [#5096](https://github.com/Automattic/sensei/pull/5096)
+* Tweak: Hide the export button when there is no data [#5095](https://github.com/Automattic/sensei/pull/5095)
+* Tweak: Improve performance by fetching last activity date with the main query [#5101](https://github.com/Automattic/sensei/pull/5101)
+* Tweak: On the reports screen, show no lessons instead of all when the course has no lessons [#5090](https://github.com/Automattic/sensei/pull/5090)
+* Tweak: Only show enrolled students in reports [#5105](https://github.com/Automattic/sensei/pull/5105)
+* Tweak: Refactor students page fetching data through Gutenberg and avoiding subqueries [#5104](https://github.com/Automattic/sensei/pull/5104)
+* Tweak: Use AbortController to cancel fetch requests for unmounted components [#5065](https://github.com/Automattic/sensei/pull/5065)
+* Fix: Ensure the content filter for course content is re-added in Learning Mode [#5086](https://github.com/Automattic/sensei/pull/5086)
+* Fix: Exporting "students taking course" not affected by filters [#5120](https://github.com/Automattic/sensei/pull/5120)
+* Fix: Hide export button when no results on "Students taking course" screen [#5121](https://github.com/Automattic/sensei/pull/5121)
+* Fix: Incorrect menu item selected in the Module editor [#5117](https://github.com/Automattic/sensei/pull/5117)
+* Fix: Lesson compatibility issue with Divi [#5082](https://github.com/Automattic/sensei/pull/5082)
+* Fix: Reports date filters not accounting for the user timezone [#5113](https://github.com/Automattic/sensei/pull/5113)
+* Fix: Reports exporting does not take search into account [#5079](https://github.com/Automattic/sensei/pull/5079)
+* Fix: Student name appearing twice on student report title [#5111](https://github.com/Automattic/sensei/pull/5111)
+
 2022.05.04 - version 4.4.0
 * New: Add modal to add or remove a student from a course [#4979](https://github.com/Automattic/sensei/pull/4979), [#5038](https://github.com/Automattic/sensei/pull/5038), [#5004](https://github.com/Automattic/sensei/pull/5004), [#5040](https://github.com/Automattic/sensei/pull/5040), [#4999](https://github.com/Automattic/sensei/pull/4999), [#5023](https://github.com/Automattic/sensei/pull/5023), [#5003](https://github.com/Automattic/sensei/pull/5003), [#5029](https://github.com/Automattic/sensei/pull/5029), [#5017](https://github.com/Automattic/sensei/pull/5017), [#5046](https://github.com/Automattic/sensei/pull/5046), [#5059](https://github.com/Automattic/sensei/pull/5059)
 * New: Add student action menu to Student Management page [#4961](https://github.com/Automattic/sensei/pull/4961), [#5031](https://github.com/Automattic/sensei/pull/5031), [#5072](https://github.com/Automattic/sensei/pull/5072)

includes/class-sensei-course.php

@@ -3888,14 +3888,14 @@ public static function alter_redirect_url_after_enrolment( $url, $post ) {
 	 *
 	 * @since 4.2.0
 	 *
-	 * @deprecated x.x.x use Sensei_Reports_Overview_List_Table_Courses::get_average_days_to_completion
+	 * @deprecated 4.4.1 use Sensei_Reports_Overview_List_Table_Courses::get_average_days_to_completion
 	 *
 	 * @access private
 	 *
 	 * @return float Average days to completion, rounded to the highest integer.
 	 */
 	public function get_average_days_to_completion() {
-		_deprecated_function( __METHOD__, 'x.x.x', 'Sensei_Reports_Overview_Service_Courses::get_average_days_to_completion' );
+		_deprecated_function( __METHOD__, '4.4.1', 'Sensei_Reports_Overview_Service_Courses::get_average_days_to_completion' );
 
 		global $wpdb;
 

includes/class-sensei-lesson.php

@@ -4518,7 +4518,7 @@ public function get_take_course_url( $course_id ) {
 		 * Notice that in Learning Mode, when user is logged-in, it will not use this
 		 * filter and directly enroll the user in the course.
 		 *
-		 * @since x.x.x
+		 * @since 4.4.1
 		 * @hook sensei_lesson_take_course_url
 		 *
 		 * @param {string} $take_course_url Take course URL.

includes/reports/overview/data-provider/class-sensei-reports-overview-data-provider-courses.php

@@ -105,7 +105,7 @@ public function add_orderby_custom_field_to_query( $args, $query ) {
 	/**
 	 * Add last activity date for each course.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 * @access private
 	 *
 	 * @param array $clauses Associative array of the clauses for the query.

includes/reports/overview/data-provider/class-sensei-reports-overview-data-provider-lessons.php

@@ -114,7 +114,7 @@ public function add_days_to_complete_to_lessons_query( array $clauses ): array {
 	/**
 	 * Add the `last_activity` field to the query.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 * @access private
 	 *
 	 * @param array $clauses Associative array of the clauses for the query.

includes/reports/overview/data-provider/class-sensei-reports-overview-data-provider-students.php

@@ -89,7 +89,7 @@ public function get_items( array $filters ): array {
 	/**
 	 * Filter the users to ones enrolled in a course.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 * @access private
 	 *
 	 * @param WP_User_Query $query The user query.

includes/reports/overview/services/class-sensei-reports-overview-service-courses.php

@@ -12,7 +12,7 @@
 /**
  * Courses overview service class.
  *
- * @since x.x.x
+ * @since 4.4.1
  */
 class Sensei_Reports_Overview_Service_Courses {
 
@@ -25,7 +25,7 @@ public function __construct() {
 	/**
 	 * Get total average progress value for courses.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 * @access public
 	 *
 	 * @param array $course_ids Courses ids.
@@ -84,7 +84,7 @@ function ( $carry, $lesson ) use ( $lessons_completions ) {
 	/**
 	 * Get the average grade of the courses.
 	 *
-	 * @since x.x.x
+	 * @since 4.4.1
 	 * @access public
 	 *
 	 * @param array $course_ids Courses ids to filter by.
@@ -135,7 +135,7 @@ public function get_courses_average_grade( array $course_ids ) {
 	/**
 	 * Get average days to completion by courses.
 	 *
-	 * @since x.x.x
+	 * @since 4.4.1
 	 * @access public
 	 *
 	 * @param array $course_ids Courses ids to filter by.
@@ -171,7 +171,7 @@ public function get_average_days_to_completion( array $course_ids ) : float {
 	/**
 	 * Get all lessons completions.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 *
 	 * @return array lessons completions.
 	 */
@@ -199,7 +199,7 @@ private function get_lessons_completions(): array {
 	/**
 	 * Get lessons grouped by courses.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 *
 	 * @param array $course_ids The list of courses ids.
 	 * @return array lessons count in courses.
@@ -225,7 +225,7 @@ private function get_lessons_in_courses( $course_ids ): array {
 	/**
 	 * Get students count by courses.
 	 *
-	 * @since  x.x.x
+	 * @since  4.4.1
 	 *
 	 * @param array $course_ids The array of courses ids.
 	 * @return array students in courses.

includes/reports/overview/services/class-sensei-reports-overview-service-students.php

@@ -12,7 +12,7 @@
 /**
  * Courses overview service class.
  *
- * @since x.x.x
+ * @since 4.4.1
  */
 class Sensei_Reports_Overview_Service_Students {
 
@@ -24,7 +24,7 @@ public function __construct() {     }
 	/**
 	 * Get average grade of all lessons graded in all the courses filtered by students.
 	 *
-	 * @since x.x.x
+	 * @since 4.4.1
 	 * @access public
 	 *
 	 * @param array $user_ids user ids.

includes/sensei-functions.php

@@ -308,7 +308,7 @@ function sensei_user_registration_url( bool $return_wp_registration_url = true,
 	/**
 	 * Filter the registration URL.
 	 *
-	 * @since x.x.x
+	 * @since 4.4.1
 	 * @hook sensei_registration_url
 	 *
 	 * @param {string} $registration_url Registration URL.
@@ -352,7 +352,7 @@ function sensei_user_login_url( string $redirect = '' ) {
 	/**
 	 * Filter the login URL.
 	 *
-	 * @since x.x.x
+	 * @since 4.4.1
 	 * @hook sensei_login_url
 	 *
 	 * @param {string} $login_url Login URL.