| @@ -9,16 +9,11 @@ | ||
| 9 | 9 | */ |
| 10 | 10 | |
| 11 | 11 | namespace Tutor\Models; |
| 12 | 12 | |
| 13 | -use Tutor\Helpers\DateTimeHelper; | |
| 14 | -use TUTOR\Icon; | |
| 15 | 13 | use TUTOR\Course; |
| 16 | -use TUTOR\Lesson; | |
| 17 | 14 | use Tutor\Ecommerce\Tax; |
| 18 | -use InvalidArgumentException; | |
| 19 | 15 | use Tutor\Helpers\QueryHelper; |
| 20 | -use TUTOR\User; | |
| 21 | 16 | use TUTOR_ASSIGNMENTS\Assignments; |
| 22 | 17 | |
| 23 | 18 | /** |
| 24 | 19 | * CourseModel Class |
| @@ -49,29 +44,27 @@ | ||
| 49 | 44 | const MODE_FLEXIBLE = 'flexible'; |
| 50 | 45 | const MODE_STRICT = 'strict'; |
| 51 | 46 | |
| 52 | 47 | /** |
| 53 | - * Course attachment/downloadable resources meta key | |
| 48 | + * Course mapped with the product using this meta key | |
| 54 | 49 | * |
| 55 | 50 | * @var string |
| 56 | 51 | */ |
| 57 | - const ATTACHMENT_META_KEY = '_tutor_attachments'; | |
| 52 | + const WC_PRODUCT_META_KEY = '_tutor_course_product_id'; | |
| 58 | 53 | |
| 59 | 54 | /** |
| 60 | - * Course benefits meta key | |
| 55 | + * Course attachment/downloadable resources meta key | |
| 61 | 56 | * |
| 62 | 57 | * @var string |
| 63 | 58 | */ |
| 64 | - const BENEFITS_META_KEY = '_tutor_course_benefits'; | |
| 59 | + const ATTACHMENT_META_KEY = '_tutor_attachments'; | |
| 65 | 60 | |
| 66 | 61 | /** |
| 67 | - * The constant representing the status when a course is completed. | |
| 62 | + * Course benefits meta key | |
| 68 | 63 | * |
| 69 | - * @since 3.8.1 | |
| 70 | - * | |
| 71 | 64 | * @var string |
| 72 | 65 | */ |
| 73 | - const COURSE_COMPLETED = 'course_completed'; | |
| 66 | + const BENEFITS_META_KEY = '_tutor_course_benefits'; | |
| 74 | 67 | |
| 75 | 68 | /** |
| 76 | 69 | * Get available status list. |
| 77 | 70 | * |
| @@ -91,34 +84,8 @@ | ||
| 91 | 84 | ); |
| 92 | 85 | } |
| 93 | 86 | |
| 94 | 87 | /** |
| 95 | - * Check if a course is available for enrollment or purchase. | |
| 96 | - * | |
| 97 | - * @since 4.0.0 | |
| 98 | - * | |
| 99 | - * @param integer $course_id the course id. | |
| 100 | - * | |
| 101 | - * @return bool | |
| 102 | - */ | |
| 103 | - public static function is_course_accessible( $course_id = 0 ) { | |
| 104 | - $course = get_post( $course_id ); | |
| 105 | - if ( ! $course || ! is_object( $course ) ) { | |
| 106 | - return false; | |
| 107 | - } | |
| 108 | - | |
| 109 | - if ( ! in_array( $course->post_type, array( tutor()->course_post_type, tutor()->bundle_post_type ), true ) ) { | |
| 110 | - return false; | |
| 111 | - } | |
| 112 | - | |
| 113 | - if ( ! in_array( $course->post_status, array( self::STATUS_PUBLISH, self::STATUS_PRIVATE ), true ) ) { | |
| 114 | - return false; | |
| 115 | - } | |
| 116 | - | |
| 117 | - return true; | |
| 118 | - } | |
| 119 | - | |
| 120 | - /** | |
| 121 | 88 | * Course record count |
| 122 | 89 | * |
| 123 | 90 | * @since 2.0.7 |
| 124 | 91 | * |
| @@ -147,9 +114,9 @@ | ||
| 147 | 114 | * |
| 148 | 115 | * @return bool |
| 149 | 116 | */ |
| 150 | 117 | public static function get_post_types( $post ) { |
| 151 | - return apply_filters( 'tutor_check_course_post_type', self::POST_TYPE === get_post_type( $post ), get_post_type( $post ) ); | |
| 118 | + return apply_filters( 'tutor_check_course_post_type', get_post_type( $post ) ); | |
| 152 | 119 | } |
| 153 | 120 | |
| 154 | 121 | /** |
| 155 | 122 | * Get courses |
| @@ -272,12 +239,25 @@ | ||
| 272 | 239 | * @since 1.0.0 |
| 273 | 240 | * |
| 274 | 241 | * @param int $quiz_id quiz id. |
| 275 | 242 | * |
| 276 | - * @return mixed WP_Post|null | |
| 243 | + * @return array|bool|null|object|void | |
| 277 | 244 | */ |
| 278 | 245 | public static function get_course_by_quiz( $quiz_id ) { |
| 279 | - return get_post_parent( get_post_parent( $quiz_id ) ); | |
| 246 | + $quiz_id = tutils()->get_post_id( $quiz_id ); | |
| 247 | + $post = get_post( $quiz_id ); | |
| 248 | + | |
| 249 | + if ( $post ) { | |
| 250 | + $course = get_post( $post->post_parent ); | |
| 251 | + if ( $course ) { | |
| 252 | + if ( tutor()->course_post_type !== $course->post_type ) { | |
| 253 | + $course = get_post( $course->post_parent ); | |
| 254 | + } | |
| 255 | + return $course; | |
| 256 | + } | |
| 257 | + } | |
| 258 | + | |
| 259 | + return false; | |
| 280 | 260 | } |
| 281 | 261 | |
| 282 | 262 | /** |
| 283 | 263 | * Get courses by a instructor |
| @@ -283,9 +263,8 @@ | ||
| 283 | 263 | * Get courses by a instructor |
| 284 | 264 | * |
| 285 | 265 | * @since 1.0.0 |
| 286 | 266 | * @since 3.5.0 param $post_types added. |
| 287 | - * @since 4.0.0 params $search and $order added. | |
| 288 | 267 | * |
| 289 | 268 | * @param integer $instructor_id instructor id. |
| 290 | 269 | * @param array|string $post_status post status. |
| 291 | 270 | * @param integer $offset offset. |
| @@ -291,23 +270,12 @@ | ||
| 291 | 270 | * @param integer $offset offset. |
| 292 | 271 | * @param integer $limit limit. |
| 293 | 272 | * @param boolean $count_only count or not. |
| 294 | 273 | * @param array $post_types array of post types. |
| 295 | - * @param string $search search keyword. | |
| 296 | - * @param string $order order. | |
| 297 | 274 | * |
| 298 | 275 | * @return array|null|object |
| 299 | 276 | */ |
| 300 | - public static function get_courses_by_instructor( | |
| 301 | - $instructor_id = 0, | |
| 302 | - $post_status = array( 'publish' ), | |
| 303 | - int $offset = 0, | |
| 304 | - int $limit = PHP_INT_MAX, | |
| 305 | - $count_only = false, | |
| 306 | - $post_types = array(), | |
| 307 | - $search = '', | |
| 308 | - $order = 'DESC' | |
| 309 | - ) { | |
| 277 | + public static function get_courses_by_instructor( $instructor_id = 0, $post_status = array( 'publish' ), int $offset = 0, int $limit = PHP_INT_MAX, $count_only = false, $post_types = array() ) { | |
| 310 | 278 | global $wpdb; |
| 311 | 279 | $offset = sanitize_text_field( $offset ); |
| 312 | 280 | $limit = sanitize_text_field( $limit ); |
| 313 | 281 | $instructor_id = tutils()->get_user_id( $instructor_id ); |
| @@ -325,21 +293,8 @@ | ||
| 325 | 293 | $statuses = "'" . implode( "','", $post_status ) . "'"; |
| 326 | 294 | $where_post_status = "AND $wpdb->posts.post_status IN({$statuses}) "; |
| 327 | 295 | } |
| 328 | 296 | |
| 329 | - $search_sql = ''; | |
| 330 | - if ( ! empty( $search ) ) { | |
| 331 | - $like = '%' . $wpdb->esc_like( $search ) . '%'; | |
| 332 | - $search_sql = $wpdb->prepare( | |
| 333 | - " AND ( {$wpdb->posts}.post_title LIKE %s OR {$wpdb->posts}.post_excerpt LIKE %s ) ", | |
| 334 | - $like, | |
| 335 | - $like | |
| 336 | - ); | |
| 337 | - } | |
| 338 | - | |
| 339 | - $order = strtoupper( $order ) === 'ASC' ? 'ASC' : 'DESC'; | |
| 340 | - $order_sql = " ORDER BY $wpdb->posts.post_date {$order} "; | |
| 341 | - | |
| 342 | 297 | $select_col = $count_only ? " COUNT(DISTINCT $wpdb->posts.ID) " : " $wpdb->posts.* "; |
| 343 | 298 | $limit_offset = $count_only ? '' : " LIMIT $offset, $limit "; |
| 344 | 299 | |
| 345 | 300 | //phpcs:disable |
| @@ -344,18 +299,17 @@ | ||
| 344 | 299 | |
| 345 | 300 | //phpcs:disable |
| 346 | 301 | $query = $wpdb->prepare( |
| 347 | 302 | "SELECT $select_col |
| 348 | - FROM $wpdb->posts | |
| 303 | + FROM $wpdb->posts | |
| 349 | 304 | LEFT JOIN {$wpdb->usermeta} |
| 350 | - ON $wpdb->usermeta.user_id = %d | |
| 351 | - AND $wpdb->usermeta.meta_key = %s | |
| 352 | - AND $wpdb->usermeta.meta_value = $wpdb->posts.ID | |
| 353 | - WHERE 1 = 1 {$where_post_status} | |
| 305 | + ON $wpdb->usermeta.user_id = %d | |
| 306 | + AND $wpdb->usermeta.meta_key = %s | |
| 307 | + AND $wpdb->usermeta.meta_value = $wpdb->posts.ID | |
| 308 | + WHERE 1 = 1 {$where_post_status} | |
| 354 | 309 | AND $wpdb->posts.post_type IN ({$post_types}) |
| 355 | 310 | AND ($wpdb->posts.post_author = %d OR $wpdb->usermeta.user_id = %d) |
| 356 | - {$search_sql} | |
| 357 | - {$order_sql} {$limit_offset}", | |
| 311 | + ORDER BY $wpdb->posts.post_date DESC $limit_offset", | |
| 358 | 312 | $instructor_id, |
| 359 | 313 | '_tutor_instructor_course_id', |
| 360 | 314 | $instructor_id, |
| 361 | 315 | $instructor_id |
| @@ -541,49 +495,21 @@ | ||
| 541 | 495 | foreach ( $topic_content_ids as $content_id ) { |
| 542 | 496 | /** |
| 543 | 497 | * Delete Quiz data |
| 544 | 498 | */ |
| 545 | - if ( get_post_type( $content_id ) === $quiz_post_type ) { | |
| 546 | - // Collect file paths from all question types that store files before deleting rows (files deleted after DB for safety). | |
| 547 | - $attempts_for_quiz = QueryHelper::get_all( 'tutor_quiz_attempts', array( 'quiz_id' => $content_id ), 'attempt_id', -1 ); | |
| 548 | - $attempt_file_paths = array(); | |
| 549 | - if ( ! empty( $attempts_for_quiz ) ) { | |
| 550 | - $attempt_ids = array_map( | |
| 551 | - function ( $row ) { | |
| 552 | - return (int) $row->attempt_id; | |
| 553 | - }, | |
| 554 | - $attempts_for_quiz | |
| 555 | - ); | |
| 556 | - $attempt_file_paths = apply_filters( 'tutor_quiz/attempt_file_paths_for_deletion', array(), $attempt_ids ); | |
| 557 | - $attempt_file_paths = is_array( $attempt_file_paths ) ? array_values( array_filter( array_unique( $attempt_file_paths ) ) ) : array(); | |
| 558 | - } | |
| 559 | - | |
| 499 | + if ( get_post_type( $content_id ) === 'tutor_quiz' ) { | |
| 560 | 500 | $wpdb->delete( $wpdb->prefix . 'tutor_quiz_attempts', array( 'quiz_id' => $content_id ) ); |
| 561 | 501 | $wpdb->delete( $wpdb->prefix . 'tutor_quiz_attempt_answers', array( 'quiz_id' => $content_id ) ); |
| 562 | 502 | |
| 563 | - QuizModel::delete_files_by_paths( $attempt_file_paths ); | |
| 564 | - | |
| 565 | 503 | do_action( 'tutor_before_delete_quiz_content', $content_id, null ); |
| 566 | 504 | |
| 567 | - // Collect instructor file paths before deleting question data (e.g. draw_image / pin_image masks). | |
| 568 | - /** | |
| 569 | - * Filter to get file paths for quiz deletion. | |
| 570 | - * Pro and other add-ons register their question types via this filter. | |
| 571 | - * | |
| 572 | - * @param string[] $file_paths Paths collected so far. | |
| 573 | - * @param int $quiz_id Quiz post ID. | |
| 574 | - */ | |
| 575 | - $quiz_file_paths = apply_filters( 'tutor_quiz_quiz_file_paths_for_deletion', array(), $content_id ); | |
| 576 | - | |
| 577 | 505 | $questions_ids = $wpdb->get_col( $wpdb->prepare( "SELECT question_id FROM {$wpdb->prefix}tutor_quiz_questions WHERE quiz_id = %d ", $content_id ) ); |
| 578 | 506 | if ( is_array( $questions_ids ) && count( $questions_ids ) ) { |
| 579 | - $in_clause = QueryHelper::prepare_in_clause( $questions_ids ); | |
| 507 | + $in_question_ids = "'" . implode( "','", $questions_ids ) . "'"; | |
| 580 | 508 | //phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared |
| 581 | - $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}tutor_quiz_question_answers WHERE belongs_question_id IN({$in_clause}) " ) ); | |
| 509 | + $wpdb->query( "DELETE FROM {$wpdb->prefix}tutor_quiz_question_answers WHERE belongs_question_id IN({$in_question_ids}) " ); | |
| 582 | 510 | } |
| 583 | 511 | $wpdb->delete( $wpdb->prefix . 'tutor_quiz_questions', array( 'quiz_id' => $content_id ) ); |
| 584 | - | |
| 585 | - QuizModel::delete_files_by_paths( $quiz_file_paths ); | |
| 586 | 512 | } |
| 587 | 513 | |
| 588 | 514 | /** |
| 589 | 515 | * Delete assignment data ( Assignments, Assignment Submit, Assignment Evalutation ) |
| @@ -1189,9 +1115,9 @@ | ||
| 1189 | 1115 | ); |
| 1190 | 1116 | } |
| 1191 | 1117 | } |
| 1192 | 1118 | |
| 1193 | - return apply_filters( 'tutor_course_dropdown_options', $course_options ); | |
| 1119 | + return $course_options; | |
| 1194 | 1120 | } |
| 1195 | 1121 | |
| 1196 | 1122 | /** |
| 1197 | 1123 | * Get category dropdown options |
| @@ -1224,604 +1150,6 @@ | ||
| 1224 | 1150 | } |
| 1225 | 1151 | } |
| 1226 | 1152 | |
| 1227 | 1153 | return $category_options; |
| 1228 | - } | |
| 1229 | - | |
| 1230 | - /** | |
| 1231 | - * Retrieve all course completion records for a specific course, including meta data. | |
| 1232 | - * | |
| 1233 | - * @since 3.8.1 | |
| 1234 | - * | |
| 1235 | - * @param int $course_id The ID of the course. | |
| 1236 | - * | |
| 1237 | - * @return array Array of course completion objects with meta, empty array if none found, or on database error. | |
| 1238 | - */ | |
| 1239 | - public function get_course_completion_data_by_course_id( int $course_id ): array { | |
| 1240 | - | |
| 1241 | - global $wpdb; | |
| 1242 | - | |
| 1243 | - $where = array( | |
| 1244 | - 'comment_type' => self::COURSE_COMPLETED, | |
| 1245 | - 'comment_post_ID' => $course_id, | |
| 1246 | - 'comment_agent' => 'TutorLMSPlugin', | |
| 1247 | - ); | |
| 1248 | - | |
| 1249 | - $result = QueryHelper::get_all( $wpdb->comments, $where, 'comment_post_ID', -1 ); | |
| 1250 | - | |
| 1251 | - if ( empty( $result ) ) { | |
| 1252 | - return array(); | |
| 1253 | - } | |
| 1254 | - | |
| 1255 | - return array_map( | |
| 1256 | - function ( $item ) { | |
| 1257 | - | |
| 1258 | - return array( | |
| 1259 | - 'completion' => $item, | |
| 1260 | - 'completion_meta' => get_comment_meta( $item->comment_ID ), | |
| 1261 | - ); | |
| 1262 | - }, | |
| 1263 | - $result | |
| 1264 | - ); | |
| 1265 | - } | |
| 1266 | - | |
| 1267 | - /** | |
| 1268 | - * Return completed courses by user_id | |
| 1269 | - * | |
| 1270 | - * @since 1.0.0 | |
| 1271 | - * | |
| 1272 | - * @param int $user_id user id. | |
| 1273 | - * @param int $offset offset. | |
| 1274 | - * @param int $posts_per_page posts per page. | |
| 1275 | - * @param array $args Args to override the defaults. | |
| 1276 | - * | |
| 1277 | - * @return bool|\WP_Query | |
| 1278 | - */ | |
| 1279 | - public static function get_completed_courses_by_user( $user_id = 0, $offset = 0, $posts_per_page = -1, $args = array() ) { | |
| 1280 | - $user_id = tutor_utils()->get_user_id( $user_id ); | |
| 1281 | - $course_ids = tutor_utils()->get_completed_courses_ids_by_user( $user_id, false ); | |
| 1282 | - | |
| 1283 | - if ( count( $course_ids ) ) { | |
| 1284 | - $course_post_type = tutor()->course_post_type; | |
| 1285 | - $course_args = array( | |
| 1286 | - 'post_type' => $course_post_type, | |
| 1287 | - 'post_status' => 'publish', | |
| 1288 | - 'post__in' => $course_ids, | |
| 1289 | - 'posts_per_page' => $posts_per_page, | |
| 1290 | - 'offset' => $offset, | |
| 1291 | - 'orderby' => 'post__in', | |
| 1292 | - ); | |
| 1293 | - | |
| 1294 | - $args = apply_filters( 'tutor_get_completed_courses_by_user', $args, $user_id, $course_post_type ); | |
| 1295 | - $course_args = wp_parse_args( $args, $course_args ); | |
| 1296 | - | |
| 1297 | - return new \WP_Query( $course_args ); | |
| 1298 | - } | |
| 1299 | - | |
| 1300 | - return false; | |
| 1301 | - } | |
| 1302 | - | |
| 1303 | - /** | |
| 1304 | - * Get the active course by user | |
| 1305 | - * | |
| 1306 | - * @since 1.0.0 | |
| 1307 | - * | |
| 1308 | - * @param int $user_id user id. | |
| 1309 | - * @param int $offset offset. | |
| 1310 | - * @param int $posts_per_page posts per page. | |
| 1311 | - * @param array $args Args to override the defaults. | |
| 1312 | - * | |
| 1313 | - * @return bool|\WP_Query | |
| 1314 | - */ | |
| 1315 | - public static function get_active_courses_by_user( $user_id = 0, $offset = 0, $posts_per_page = -1, $args = array() ) { | |
| 1316 | - $user_id = tutor_utils()->get_user_id( $user_id ); | |
| 1317 | - $course_ids = tutor_utils()->get_completed_courses_ids_by_user( $user_id, false ); | |
| 1318 | - $enrolled_course_ids = tutor_utils()->get_enrolled_courses_ids_by_user( $user_id, false ); | |
| 1319 | - $active_courses = array_diff( $enrolled_course_ids, $course_ids ); | |
| 1320 | - | |
| 1321 | - if ( count( $active_courses ) ) { | |
| 1322 | - $course_post_type = tutor()->course_post_type; | |
| 1323 | - $course_args = array( | |
| 1324 | - 'post_type' => apply_filters( 'tutor_active_courses_post_types', array( $course_post_type ) ), | |
| 1325 | - 'post_status' => 'publish', | |
| 1326 | - 'post__in' => $active_courses, | |
| 1327 | - 'posts_per_page' => $posts_per_page, | |
| 1328 | - 'offset' => $offset, | |
| 1329 | - 'orderby' => 'post__in', | |
| 1330 | - ); | |
| 1331 | - | |
| 1332 | - $args = apply_filters( 'tutor_get_active_courses_by_user', $args, $user_id, $course_post_type ); | |
| 1333 | - $course_args = wp_parse_args( $args, $course_args ); | |
| 1334 | - | |
| 1335 | - return new \WP_Query( $course_args ); | |
| 1336 | - } | |
| 1337 | - | |
| 1338 | - return false; | |
| 1339 | - } | |
| 1340 | - | |
| 1341 | - /** | |
| 1342 | - * Get the enrolled courses by user | |
| 1343 | - * | |
| 1344 | - * @since 1.0.0 | |
| 1345 | - * @since 2.5.0 $filters param added to query enrolled courses with additional filters. | |
| 1346 | - * | |
| 1347 | - * @since 3.4.0 $filters replaced with $args to override the defaults. | |
| 1348 | - * | |
| 1349 | - * @param integer $user_id user id. | |
| 1350 | - * @param mixed $post_status post status. | |
| 1351 | - * @param integer $offset offset. | |
| 1352 | - * @param integer $posts_per_page post per page. | |
| 1353 | - * @param array $args Args to override the defaults. | |
| 1354 | - * | |
| 1355 | - * @return bool|\WP_Query | |
| 1356 | - */ | |
| 1357 | - public static function get_enrolled_courses_by_user( $user_id = 0, $post_status = 'publish', $offset = 0, $posts_per_page = -1, $args = array() ) { | |
| 1358 | - $user_id = tutor_utils()->get_user_id( $user_id ); | |
| 1359 | - $course_ids = array_unique( tutor_utils()->get_enrolled_courses_ids_by_user( $user_id, false ) ); | |
| 1360 | - | |
| 1361 | - if ( count( $course_ids ) ) { | |
| 1362 | - $course_post_type = tutor()->course_post_type; | |
| 1363 | - $course_args = array( | |
| 1364 | - 'post_type' => $course_post_type, | |
| 1365 | - 'post_status' => $post_status, | |
| 1366 | - 'post__in' => $course_ids, | |
| 1367 | - 'offset' => $offset, | |
| 1368 | - 'posts_per_page' => $posts_per_page, | |
| 1369 | - 'orderby' => 'post__in', | |
| 1370 | - ); | |
| 1371 | - | |
| 1372 | - $args = apply_filters( 'tutor_get_enrolled_courses_by_user', $args, $user_id, $course_post_type ); | |
| 1373 | - $course_args = wp_parse_args( $args, $course_args ); | |
| 1374 | - | |
| 1375 | - $result = new \WP_Query( $course_args ); | |
| 1376 | - | |
| 1377 | - if ( is_object( $result ) && is_array( $result->posts ) ) { | |
| 1378 | - | |
| 1379 | - // Sort courses according to the id list. | |
| 1380 | - $new_array = array(); | |
| 1381 | - | |
| 1382 | - foreach ( $course_ids as $id ) { | |
| 1383 | - foreach ( $result->posts as $post ) { | |
| 1384 | - if ( $post->ID == $id ) { | |
| 1385 | - $new_array[] = $post; | |
| 1386 | - } | |
| 1387 | - } | |
| 1388 | - } | |
| 1389 | - | |
| 1390 | - if ( count( $new_array ) ) { | |
| 1391 | - $result->posts = $new_array; | |
| 1392 | - } | |
| 1393 | - } | |
| 1394 | - | |
| 1395 | - return $result; | |
| 1396 | - } | |
| 1397 | - | |
| 1398 | - return false; | |
| 1399 | - } | |
| 1400 | - | |
| 1401 | - /** | |
| 1402 | - * Get the number of courses created by an instructor within a given date range. | |
| 1403 | - * | |
| 1404 | - * @since 4.0.0 | |
| 1405 | - * | |
| 1406 | - * If no date range is provided, returns the total course count for the instructor. | |
| 1407 | - * Course creation date is determined using the `_wp_old_date` meta value when available; otherwise, the course | |
| 1408 | - * post date is used. | |
| 1409 | - * | |
| 1410 | - * @param string|null $start_date Start date in Y-m-d format. | |
| 1411 | - * @param string|null $end_date End date in Y-m-d format. | |
| 1412 | - * @param int $user_id Course author (user) ID. | |
| 1413 | - * | |
| 1414 | - * @return int Total number of matching courses. | |
| 1415 | - */ | |
| 1416 | - public static function get_course_count_by_date( $start_date, $end_date, $user_id ) { | |
| 1417 | - | |
| 1418 | - $user_id = tutor_utils()->get_user_id( $user_id ); | |
| 1419 | - | |
| 1420 | - if ( empty( $start_date ) && empty( $end_date ) ) { | |
| 1421 | - return (int) self::get_courses_by_instructor( $user_id, array( 'publish', 'private' ), 0, PHP_INT_MAX, true ); | |
| 1422 | - } | |
| 1423 | - | |
| 1424 | - $courses = self::get_courses_by_instructor( $user_id, array( 'publish', 'private' ), 0, PHP_INT_MAX ); | |
| 1425 | - | |
| 1426 | - if ( empty( $courses ) ) { | |
| 1427 | - return 0; | |
| 1428 | - } | |
| 1429 | - | |
| 1430 | - $start_date_timestamp = strtotime( $start_date . ' 00:00:00' ); | |
| 1431 | - $end_date_timestamp = strtotime( $end_date . ' 23:59:59' ); | |
| 1432 | - | |
| 1433 | - $filtered = array_filter( | |
| 1434 | - $courses, | |
| 1435 | - function ( $course ) use ( $start_date_timestamp, $end_date_timestamp ) { | |
| 1436 | - $creation_date = get_post_meta( $course->ID, '_wp_old_date', true ); | |
| 1437 | - | |
| 1438 | - $course_creation_date = empty( $creation_date ) ? strtotime( $course->post_date_gmt ) : strtotime( $creation_date ); | |
| 1439 | - | |
| 1440 | - return $start_date_timestamp <= $course_creation_date && $end_date_timestamp >= $course_creation_date; | |
| 1441 | - } | |
| 1442 | - ); | |
| 1443 | - | |
| 1444 | - return count( $filtered ); | |
| 1445 | - } | |
| 1446 | - | |
| 1447 | - /** | |
| 1448 | - * Get topic-wise progress data for a course and a student. | |
| 1449 | - * | |
| 1450 | - * @since 4.0.0 | |
| 1451 | - * | |
| 1452 | - * @param int $course_id Course ID. | |
| 1453 | - * @param int $student_id Student ID. | |
| 1454 | - * | |
| 1455 | - * @return array[] Topic progress data. | |
| 1456 | - */ | |
| 1457 | - public static function get_course_progress_details( $course_id, $student_id ) { | |
| 1458 | - | |
| 1459 | - $topics_query = tutor_utils()->get_topics( $course_id ); | |
| 1460 | - $topic_list = array(); | |
| 1461 | - | |
| 1462 | - if ( empty( $topics_query ) || ! $topics_query->have_posts() ) { | |
| 1463 | - return $topic_list; | |
| 1464 | - } | |
| 1465 | - | |
| 1466 | - foreach ( $topics_query->posts as $topic_post ) { | |
| 1467 | - $topic_id = (int) $topic_post->ID; | |
| 1468 | - $items = array(); | |
| 1469 | - $completion_percentage = tutor_utils()->count_completed_contents_by_topic( $topic_id, $student_id ); | |
| 1470 | - $contents_query = tutor_utils()->get_course_contents_by_topic( $topic_id, -1 ); | |
| 1471 | - | |
| 1472 | - if ( ! empty( $contents_query ) && $contents_query->have_posts() ) { | |
| 1473 | - foreach ( $contents_query->posts as $content_post ) { | |
| 1474 | - $items[] = ( new self() )->build_course_progress_item( $content_post, $student_id, $course_id ); | |
| 1475 | - } | |
| 1476 | - } | |
| 1477 | - | |
| 1478 | - $topic_list[] = array( | |
| 1479 | - 'id' => $topic_id, | |
| 1480 | - 'summary' => $topic_post->post_content, | |
| 1481 | - 'title' => get_the_title( $topic_id ), | |
| 1482 | - 'items' => $items, | |
| 1483 | - 'completion_percentage' => $completion_percentage['percentage'] ?? 0, | |
| 1484 | - ); | |
| 1485 | - } | |
| 1486 | - | |
| 1487 | - wp_reset_postdata(); | |
| 1488 | - | |
| 1489 | - return $topic_list; | |
| 1490 | - } | |
| 1491 | - | |
| 1492 | - /** | |
| 1493 | - * Check if the current user has course content access | |
| 1494 | - * | |
| 1495 | - * @since 4.0.0 | |
| 1496 | - * | |
| 1497 | - * @throws InvalidArgumentException If args are invalid. | |
| 1498 | - * | |
| 1499 | - * @param array $args Array of arguments. | |
| 1500 | - * | |
| 1501 | - * `$defaults = array( | |
| 1502 | - * 'current_post_type' => '', | |
| 1503 | - * 'current_post_id' => 0, | |
| 1504 | - * 'course_id' => 0, | |
| 1505 | - * 'is_public' => false, | |
| 1506 | - * 'is_enrolled' => false, | |
| 1507 | - * );`. | |
| 1508 | - * | |
| 1509 | - * @return bool | |
| 1510 | - */ | |
| 1511 | - public static function has_course_content_access( array $args = array() ): bool { | |
| 1512 | - if ( User::is_admin() ) { | |
| 1513 | - return true; | |
| 1514 | - } | |
| 1515 | - | |
| 1516 | - $defaults = array( | |
| 1517 | - 'current_post_type' => '', | |
| 1518 | - 'current_post_id' => 0, | |
| 1519 | - 'course_id' => 0, | |
| 1520 | - 'is_public' => false, | |
| 1521 | - 'is_enrolled' => false, | |
| 1522 | - ); | |
| 1523 | - | |
| 1524 | - $args = wp_parse_args( $args, $defaults ); | |
| 1525 | - | |
| 1526 | - if ( ! $args['course_id'] || ! $args['current_post_id'] || ! $args['current_post_type'] ) { | |
| 1527 | - throw new InvalidArgumentException( __( 'Invalid argument passed', 'tutor' ) ); | |
| 1528 | - } | |
| 1529 | - | |
| 1530 | - $has_access = false; | |
| 1531 | - $user_id = get_current_user_id(); | |
| 1532 | - switch ( $args['current_post_type'] ) { | |
| 1533 | - case tutor()->lesson_post_type: | |
| 1534 | - $is_preview = (int) get_post_meta( $args['current_post_id'], Lesson::PREVIEW_META_KEY, true ); | |
| 1535 | - if ( $args['is_public'] || $is_preview ) { | |
| 1536 | - $has_access = true; | |
| 1537 | - } elseif ( $args['is_enrolled'] || tutor_utils()->has_enrolled_content_access( 'lesson' ) ) { | |
| 1538 | - $has_access = true; | |
| 1539 | - } | |
| 1540 | - break; | |
| 1541 | - case tutor()->quiz_post_type: | |
| 1542 | - case tutor()->assignment_post_type: | |
| 1543 | - if ( $user_id ) { | |
| 1544 | - $content_type = tutor()->quiz_post_type === $args['current_post_type'] ? 'quiz' : 'assignment'; | |
| 1545 | - if ( $args['is_enrolled'] || $args['is_public'] || tutor_utils()->has_enrolled_content_access( $content_type ) ) { | |
| 1546 | - $has_access = true; | |
| 1547 | - } | |
| 1548 | - } | |
| 1549 | - break; | |
| 1550 | - default: | |
| 1551 | - if ( $args['is_enrolled'] ) { | |
| 1552 | - $has_access = true; | |
| 1553 | - } | |
| 1554 | - break; | |
| 1555 | - } | |
| 1556 | - | |
| 1557 | - return apply_filters( 'tutor_course_content_access', $has_access, $args ); | |
| 1558 | - } | |
| 1559 | - | |
| 1560 | - /** | |
| 1561 | - * Build course progress item data for a specific lesson, quiz, assignment, or meeting. | |
| 1562 | - * | |
| 1563 | - * @since 4.0.0 | |
| 1564 | - * | |
| 1565 | - * @param \WP_Post $post The course content post object. | |
| 1566 | - * @param int $user_id The user ID for whom progress is being calculated. | |
| 1567 | - * @param int $course_id The course ID to which the content belongs. | |
| 1568 | - * | |
| 1569 | - * @return array Associative array of progress item data | |
| 1570 | - */ | |
| 1571 | - private function build_course_progress_item( \WP_Post $post, $user_id, $course_id ) { | |
| 1572 | - | |
| 1573 | - $base_items = array( | |
| 1574 | - 'id' => $post->ID, | |
| 1575 | - 'type' => $post->post_type, | |
| 1576 | - 'link' => esc_url_raw( get_permalink( $post->ID ) ), | |
| 1577 | - 'title' => $post->post_title, | |
| 1578 | - ); | |
| 1579 | - | |
| 1580 | - switch ( $post->post_type ) { | |
| 1581 | - case tutor()->quiz_post_type: | |
| 1582 | - $quiz_status = ''; | |
| 1583 | - $icon_name = Icon::QUIZ_2; | |
| 1584 | - $icon_class = 'tutor-text-subdued'; | |
| 1585 | - $last_attempt = ( new QuizModel() )->get_first_or_last_attempt( $post->ID, $user_id ); | |
| 1586 | - | |
| 1587 | - if ( is_object( $last_attempt ) && QuizModel::ATTEMPT_STARTED !== $last_attempt->attempt_status ) { | |
| 1588 | - $quiz_status = QuizModel::get_quiz_result( $post->ID, $user_id ); | |
| 1589 | - | |
| 1590 | - $quiz_icon_map = array( | |
| 1591 | - QuizModel::RESULT_FAIL => array( Icon::CROSS_COLORIZE, 'tutor-icon-critical' ), | |
| 1592 | - QuizModel::RESULT_PENDING => array( Icon::INFO_COLORIZE, 'tutor-icon-warning-secondary' ), | |
| 1593 | - ); | |
| 1594 | - | |
| 1595 | - if ( isset( $quiz_icon_map[ $quiz_status ] ) ) { | |
| 1596 | - list( $icon_name, $icon_class ) = $quiz_icon_map[ $quiz_status ]; | |
| 1597 | - } | |
| 1598 | - } | |
| 1599 | - | |
| 1600 | - return array_merge( | |
| 1601 | - $base_items, | |
| 1602 | - array( | |
| 1603 | - 'is_completed' => QuizModel::RESULT_PASS === $quiz_status, | |
| 1604 | - 'label' => __( 'Quiz', 'tutor' ), | |
| 1605 | - 'icon' => $icon_name, | |
| 1606 | - 'icon_class' => $icon_class, | |
| 1607 | - ) | |
| 1608 | - ); | |
| 1609 | - | |
| 1610 | - case tutor()->assignment_post_type: | |
| 1611 | - $status = ''; | |
| 1612 | - | |
| 1613 | - $is_submitted = tutor_utils()->is_assignment_submitted( $post->ID, $user_id ); | |
| 1614 | - $status = $is_submitted ? Assignments::get_assignment_result( $post->ID, $user_id ) : $status; | |
| 1615 | - | |
| 1616 | - if ( ! $is_submitted && Assignments::is_expired( $post->ID, $user_id, $course_id ) ) { | |
| 1617 | - $status = 'fail'; | |
| 1618 | - } | |
| 1619 | - | |
| 1620 | - $icon = Icon::BOOK_2; | |
| 1621 | - $icon_class = 'tutor-text-subdued'; | |
| 1622 | - | |
| 1623 | - $status_map = array( | |
| 1624 | - 'pending' => array( Icon::INFO_COLORIZE, 'tutor-icon-warning-secondary' ), | |
| 1625 | - 'fail' => array( Icon::CROSS_COLORIZE, 'tutor-icon-critical' ), | |
| 1626 | - ); | |
| 1627 | - | |
| 1628 | - if ( isset( $status_map[ $status ] ) ) { | |
| 1629 | - list( $icon, $icon_class ) = $status_map[ $status ]; | |
| 1630 | - } | |
| 1631 | - | |
| 1632 | - return array_merge( | |
| 1633 | - $base_items, | |
| 1634 | - array( | |
| 1635 | - 'is_completed' => 'pass' === $status, | |
| 1636 | - 'label' => __( 'Assignment', 'tutor' ), | |
| 1637 | - 'icon' => $icon, | |
| 1638 | - 'icon_class' => $icon_class, | |
| 1639 | - ) | |
| 1640 | - ); | |
| 1641 | - | |
| 1642 | - case tutor()->zoom_post_type: | |
| 1643 | - if ( ! tutor_utils()->is_addon_enabled( 'tutor-zoom' ) ) { | |
| 1644 | - return $base_items; | |
| 1645 | - } | |
| 1646 | - | |
| 1647 | - return array_merge( | |
| 1648 | - $base_items, | |
| 1649 | - array( | |
| 1650 | - 'label' => __( 'Zoom', 'tutor' ), | |
| 1651 | - 'icon' => Icon::ZOOM, | |
| 1652 | - 'is_completed' => \TUTOR_ZOOM\Zoom::is_zoom_lesson_done( '', $post->ID, $user_id ), | |
| 1653 | - ) | |
| 1654 | - ); | |
| 1655 | - | |
| 1656 | - case tutor()->meet_post_type: | |
| 1657 | - if ( ! tutor_utils()->is_addon_enabled( 'google-meet' ) ) { | |
| 1658 | - return $base_items; | |
| 1659 | - } | |
| 1660 | - | |
| 1661 | - return array_merge( | |
| 1662 | - $base_items, | |
| 1663 | - array( | |
| 1664 | - 'label' => __( 'Google Meet', 'tutor' ), | |
| 1665 | - 'icon' => Icon::GOOGLE_MEET, | |
| 1666 | - 'is_completed' => \TutorPro\GoogleMeet\Frontend\Frontend::is_lesson_completed( false, $post->ID, $user_id ), | |
| 1667 | - ) | |
| 1668 | - ); | |
| 1669 | - | |
| 1670 | - default: | |
| 1671 | - $video = tutor_utils()->get_video_info( $post->ID ); | |
| 1672 | - | |
| 1673 | - return array_merge( | |
| 1674 | - $base_items, | |
| 1675 | - array( | |
| 1676 | - 'video' => $video, | |
| 1677 | - 'video_play_time' => isset( $video->playtime ) ? $video->playtime : '', | |
| 1678 | - 'is_completed' => (bool) tutor_utils()->is_completed_lesson( $post->ID, $user_id ), | |
| 1679 | - 'label' => empty( $video ) ? __( 'Reading', 'tutor' ) : __( 'Video', 'tutor' ), | |
| 1680 | - 'icon' => empty( $video ) ? Icon::COURSES : Icon::VIDEO_CAMERA, | |
| 1681 | - ) | |
| 1682 | - ); | |
| 1683 | - } | |
| 1684 | - } | |
| 1685 | - | |
| 1686 | - /** | |
| 1687 | - * Calculate the total course duration for a set of courses and returns the total time in hours, minutes, and | |
| 1688 | - * seconds. | |
| 1689 | - * | |
| 1690 | - * @since 4.0.0 | |
| 1691 | - * | |
| 1692 | - * @param array<int> | int $course_ids List of course IDs or a single course ID. | |
| 1693 | - * | |
| 1694 | - * @return array{ | |
| 1695 | - * hours: int, | |
| 1696 | - * minutes: int, | |
| 1697 | - * seconds: int | |
| 1698 | - * } Total accumulated duration from all given courses. | |
| 1699 | - */ | |
| 1700 | - public static function get_total_course_duration( $course_ids ): array { | |
| 1701 | - $total_seconds = 0; | |
| 1702 | - $course_ids = is_array( $course_ids ) ? $course_ids : array( $course_ids ); | |
| 1703 | - foreach ( $course_ids as $id ) { | |
| 1704 | - $total_seconds += self::get_course_duration_in_seconds( $id ); | |
| 1705 | - } | |
| 1706 | - | |
| 1707 | - return DateTimeHelper::split_seconds_into_time_units( $total_seconds ); | |
| 1708 | - } | |
| 1709 | - | |
| 1710 | - /** | |
| 1711 | - * Calculate the estimated time spent on courses based on completion progress. | |
| 1712 | - * | |
| 1713 | - * @since 4.0.0 | |
| 1714 | - * | |
| 1715 | - * @param array<int> $course_ids List of course IDs. | |
| 1716 | - * | |
| 1717 | - * @return array{ | |
| 1718 | - * hours: int, | |
| 1719 | - * minutes: int, | |
| 1720 | - * seconds: int | |
| 1721 | - * } Total accumulated duration from all given courses. | |
| 1722 | - */ | |
| 1723 | - public static function get_total_estimated_time_spent( $course_ids ): array { | |
| 1724 | - $total_seconds = 0; | |
| 1725 | - foreach ( $course_ids as $id ) { | |
| 1726 | - $completion_percentage = tutor_utils()->is_completed_course( $id ) | |
| 1727 | - ? 100 | |
| 1728 | - : (int) tutor_utils()->get_course_completed_percent( (int) $id ); | |
| 1729 | - | |
| 1730 | - if ( 0 === $completion_percentage ) { | |
| 1731 | - continue; | |
| 1732 | - } | |
| 1733 | - $course_duration_in_seconds = self::get_course_duration_in_seconds( $id ); | |
| 1734 | - // Calculate the time spent by a user based on the course completion percentage. | |
| 1735 | - $total_seconds += (int) round( $course_duration_in_seconds * ( $completion_percentage / 100 ) ); | |
| 1736 | - } | |
| 1737 | - | |
| 1738 | - return DateTimeHelper::split_seconds_into_time_units( $total_seconds ); | |
| 1739 | - } | |
| 1740 | - | |
| 1741 | - /** | |
| 1742 | - * Get the total duration of a course in seconds. | |
| 1743 | - * | |
| 1744 | - * @since 4.0.0 | |
| 1745 | - * | |
| 1746 | - * @param int $course_id Course ID. | |
| 1747 | - * | |
| 1748 | - * @return int Course duration in seconds. | |
| 1749 | - */ | |
| 1750 | - public static function get_course_duration_in_seconds( int $course_id ): int { | |
| 1751 | - $duration = tutor_utils()->get_course_duration( $course_id, true ); | |
| 1752 | - | |
| 1753 | - return ( $duration['durationHours'] * HOUR_IN_SECONDS ) | |
| 1754 | - + ( $duration['durationMinutes'] * MINUTE_IN_SECONDS ) | |
| 1755 | - + ( $duration['durationSeconds'] ); | |
| 1756 | - } | |
| 1757 | - | |
| 1758 | - /** | |
| 1759 | - * Update the post_author of a course's content (topics, lessons, | |
| 1760 | - * quizzes and assignments) to a given user. | |
| 1761 | - * | |
| 1762 | - * @since 4.0.3 | |
| 1763 | - * | |
| 1764 | - * @param int $course_id course id. | |
| 1765 | - * @param int $author_id new author (user) id. | |
| 1766 | - * | |
| 1767 | - * @return bool | |
| 1768 | - */ | |
| 1769 | - public static function update_course_content_author( int $course_id, int $author_id ): bool { | |
| 1770 | - global $wpdb; | |
| 1771 | - | |
| 1772 | - $content_ids = get_posts( | |
| 1773 | - array( | |
| 1774 | - 'post_parent' => $course_id, | |
| 1775 | - 'post_type' => tutor()->topics_post_type, | |
| 1776 | - 'fields' => 'ids', | |
| 1777 | - 'posts_per_page' => -1, | |
| 1778 | - 'post_status' => 'any', | |
| 1779 | - ) | |
| 1780 | - ); | |
| 1781 | - | |
| 1782 | - $content_ids = is_array( $content_ids ) ? $content_ids : array(); | |
| 1783 | - $default_post_types = array( tutor()->lesson_post_type, tutor()->quiz_post_type ); | |
| 1784 | - $content_post_types = array_unique( apply_filters( 'tutor_course_contents_post_types', $default_post_types ) ); | |
| 1785 | - | |
| 1786 | - $primary_table = 'posts as course'; | |
| 1787 | - $topic_table = 'posts as topic'; | |
| 1788 | - $content_table = 'posts as content'; | |
| 1789 | - | |
| 1790 | - $joined_data = QueryHelper::get_joined_data( | |
| 1791 | - $primary_table, | |
| 1792 | - array( | |
| 1793 | - array( | |
| 1794 | - 'type' => 'INNER', | |
| 1795 | - 'table' => $topic_table, | |
| 1796 | - 'on' => 'course.ID = topic.post_parent', | |
| 1797 | - ), | |
| 1798 | - array( | |
| 1799 | - 'type' => 'INNER', | |
| 1800 | - 'table' => $content_table, | |
| 1801 | - 'on' => 'topic.ID = content.post_parent', | |
| 1802 | - ), | |
| 1803 | - ), | |
| 1804 | - array( 'content.ID' ), | |
| 1805 | - array( | |
| 1806 | - 'course.ID' => $course_id, | |
| 1807 | - 'content.post_type' => array( 'IN', $content_post_types ), | |
| 1808 | - ), | |
| 1809 | - array(), | |
| 1810 | - '', | |
| 1811 | - -1 | |
| 1812 | - ); | |
| 1813 | - | |
| 1814 | - $content_ids = array_merge( $content_ids, wp_list_pluck( $joined_data['results'], 'ID' ) ); | |
| 1815 | - $content_ids = array_filter( array_unique( array_map( 'absint', $content_ids ) ) ); | |
| 1816 | - | |
| 1817 | - if ( empty( $content_ids ) ) { | |
| 1818 | - return false; | |
| 1819 | - } | |
| 1820 | - | |
| 1821 | - return (bool) QueryHelper::update_where_in( | |
| 1822 | - $wpdb->posts, | |
| 1823 | - array( 'post_author' => $author_id ), | |
| 1824 | - implode( ',', $content_ids ) | |
| 1825 | - ); | |
| 1826 | 1154 | } |
| 1827 | 1155 | } |
