文件操作 - Lesson.php

文件: /home/www/public/wp-content/plugins/tutor/classes/Lesson.php

编辑文件内容

<?php
/**
 * Manage Lesson
 *
 * @package Tutor
 * @author Themeum <support@themeum.com>
 * @link https://themeum.com
 * @since 1.0.0
 */

namespace TUTOR;

defined( 'ABSPATH' ) || exit;

use Tutor\Helpers\HttpHelper;
use Tutor\Helpers\QueryHelper;
use Tutor\Helpers\ValidationHelper;
use Tutor\Models\EnrollmentModel;
use Tutor\Models\LessonModel;
use Tutor\Traits\JsonResponse;
use WP_Post;

/**
 * Lesson class
 *
 * @since 1.0.0
 */
class Lesson extends Tutor_Base {
	use JsonResponse;

/**
	 * Preview meta key
	 *
	 * @since 4.0.0
	 * @var string
	 */
	const PREVIEW_META_KEY = '_is_preview';

/**
	 * Lesson post type
	 *
	 * @since 4.0.0
	 *
	 * @var string
	 */
	private $post_type;

/**
	 * Determine if legacy mode is enabled or not
	 *
	 * @since 4.0.0
	 *
	 * @var bool
	 */
	private $is_legacy_learning_mode = false;

/**
	 * Register hooks
	 *
	 * @since 1.0.0
	 * @since 3.7.0 param register hook added.
	 *
	 * @param bool $register_hooks register hooks or not.
	 *
	 * @return void
	 */
	public function __construct( $register_hooks = true ) {
		parent::__construct();

$this->post_type = tutor()->lesson_post_type;

$this->is_legacy_learning_mode = Options_V2::LEARNING_MODE_LEGACY === tutor_utils()->get_option( 'learning_mode' );

if ( ! $register_hooks ) {
			return;
		}

add_action( 'save_post_' . $this->lesson_post_type, array( $this, 'save_lesson_meta' ) );

add_action( 'wp_ajax_tutor_lesson_details', array( $this, 'ajax_lesson_details' ) );
		add_action( 'wp_ajax_tutor_save_lesson', array( $this, 'ajax_save_lesson' ) );
		add_action( 'wp_ajax_tutor_delete_lesson', array( $this, 'ajax_delete_lesson' ) );

add_filter( 'get_sample_permalink', array( $this, 'change_lesson_permalink' ), 10, 2 );

/**
		 * Frontend Action
		 */
		add_action( 'template_redirect', array( $this, 'mark_lesson_complete' ) );

add_action( 'wp_ajax_tutor_render_lesson_content', array( $this, 'tutor_render_lesson_content' ) );

/**
		 * For public course access
		 */
		add_action( 'wp_ajax_nopriv_tutor_render_lesson_content', array( $this, 'tutor_render_lesson_content' ) );

/**
		 * Autoplay next video
		 *
		 * @since 1.4.9
		 */
		add_action( 'wp_ajax_autoload_next_course_content', array( $this, 'autoload_next_course_content' ) );

/**
		 * Load next course item after click complete button
		 *
		 * @since 1.5.3
		 */
		add_action( 'tutor_lesson_completed_after', array( $this, 'tutor_lesson_completed_after' ), 999 );

/**
		 * Lesson comment & reply ajax handler
		 *
		 * @since 2.0.0
		 */
		add_action( 'wp_ajax_tutor_single_course_lesson_load_more', array( $this, 'ajax_single_course_lesson_load_more' ) );
		add_action( 'wp_ajax_tutor_create_lesson_comment', array( $this, 'ajax_single_course_lesson_load_more' ) );
		add_action( 'wp_ajax_tutor_delete_lesson_comment', array( $this, 'ajax_delete_lesson_comment' ) );
		add_action( 'wp_ajax_tutor_update_lesson_comment', array( $this, 'ajax_update_lesson_comment' ) );
		add_action( 'wp_ajax_tutor_reply_lesson_comment', array( $this, 'ajax_reply_lesson_comment' ) );
		add_action( 'wp_ajax_tutor_load_lesson_comments', array( $this, 'ajax_load_lesson_comments' ) );
		add_action( 'wp_ajax_tutor_load_comment_replies', array( $this, 'ajax_load_comment_replies' ) );

// Add lesson title as nav item & render single content on the learning area.
		add_action( "tutor_learning_area_nav_item_{$this->post_type}", array( $this, 'render_nav_item' ), 10, 2 );
		add_action( "tutor_single_content_{$this->post_type}", array( $this, 'render_single_content' ) );
	}

/**
	 * Manage load more & comment create
	 *
	 * @since 2.0.6
	 *
	 * @since 4.0.0 different template returned
	 *
	 * @return void  send wp json data
	 */
	public function ajax_single_course_lesson_load_more() {
		tutor_utils()->checking_nonce();

$comment_id = 0;
		$comment   = Input::post( 'comment', '', Input::TYPE_TEXTAREA );
		$lesson_id = Input::post( 'comment_post_ID', 0, Input::TYPE_INT );

if ( ! self::is_comment_enabled_for_lesson( $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

if ( 'tutor_create_lesson_comment' === Input::post( 'action' ) && strlen( $comment ) > 0 ) {
			if ( ! self::can_post_lesson_comment( $lesson_id ) ) {
				wp_send_json_error( tutor_utils()->error_message() );
				return;
			}

$comment_data = array(
				'comment_content' => $comment,
				'comment_post_ID' => $lesson_id,
				'comment_parent'  => Input::post( 'comment_parent', 0, Input::TYPE_INT ),
			);
			$comment_id   = self::create_comment( $comment_data );
			do_action( 'tutor_new_comment_added', $comment_data );
		}

if ( ! $this->is_legacy_learning_mode ) {
			$html = '';
			if ( $comment_id ) {
				ob_start();
				tutor_load_template(
					'learning-area.lesson.comment-card',
					array(
						'comment_item' => get_comment( $comment_id ),
						'lesson_id'    => $lesson_id,
						'user_id'      => get_current_user_id(),
					)
				);
				$html = ob_get_clean();
			}

$count = self::get_comments(
				array(
					'post_id' => $lesson_id,
					'parent'  => 0,
					'count'   => true,
				)
			);

wp_send_json_success(
				array(
					'html'  => $html,
					'count' => $count,
				)
			);
		}

ob_start();
		tutor_load_template( 'single.lesson.comment' );
		$html = ob_get_clean();
		wp_send_json_success( array( 'html' => $html ) );
	}

/**
	 * Delete lesson comment by AJAX
	 *
	 * @since 4.0.0
	 *
	 * @return void
	 */
	public function ajax_delete_lesson_comment() {
		tutor_utils()->check_nonce();
		$comment_id = Input::post( 'comment_id', 0, Input::TYPE_INT );
		if ( ! $comment_id ) {
			$this->response_bad_request( __( 'Invalid comment ID', 'tutor' ) );
		}

$comment = get_comment( $comment_id );
		if ( ! $comment ) {
			$this->response_bad_request( __( 'Invalid comment ID', 'tutor' ) );
		}

$lesson_id = $comment->comment_post_ID;
		$parent_id = $comment->comment_parent;
		$is_reply  = $parent_id > 0;

if ( ! self::is_comment_enabled_for_lesson( $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

if ( get_current_user_id() === (int) $comment->user_id || tutor_utils()->can_user_manage( 'lesson', $lesson_id ) ) {
			wp_delete_comment( $comment_id, true );

$total_comments = self::get_comments(
				array(
					'post_id' => $lesson_id,
					'parent'  => 0,
					'count'   => true,
				)
			);

wp_send_json_success(
				array(
					'message'    => __( 'Comment deleted successfully', 'tutor' ),
					'count'      => $total_comments,
					'is_reply'   => $is_reply,
					'parent_id'  => $parent_id,
					'comment_id' => $comment_id,
				)
			);
		} else {
			$this->response_bad_request( __( 'You are not allowed to delete this comment', 'tutor' ) );
		}
	}

/**
	 * Update lesson comment by AJAX
	 *
	 * @since 4.0.0
	 *
	 * @return void
	 */
	public function ajax_update_lesson_comment() {
		tutor_utils()->check_nonce();

$comment_id = Input::post( 'comment_id', 0, Input::TYPE_INT );
		if ( ! $comment_id ) {
			$this->response_bad_request( __( 'Invalid comment ID', 'tutor' ) );
		}

$comment = get_comment( $comment_id );
		if ( ! $comment ) {
			$this->response_bad_request( __( 'Invalid comment ID', 'tutor' ) );
		}

$comment_content = Input::post( 'comment', '', Input::TYPE_KSES_POST );
		$user_id         = get_current_user_id();
		$lesson_id       = $comment->comment_post_ID;

if ( ! self::is_comment_enabled_for_lesson( $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

if ( $user_id === (int) $comment->user_id ) {
			wp_update_comment(
				array(
					'comment_ID'      => $comment_id,
					'comment_content' => $comment_content,
				)
			);

$comment->comment_content = $comment_content;
			$is_reply                 = $comment->comment_parent > 0;

ob_start();
			tutor_load_template(
				'learning-area.lesson.comment-card',
				array(
					'comment_item' => $comment,
					'lesson_id'    => $lesson_id,
					'user_id'      => $user_id,
					'is_reply'     => $is_reply,
				)
			);
			$html = ob_get_clean();

wp_send_json_success(
				array(
					'html'       => $html,
					'is_reply'   => $is_reply,
					'parent_id'  => $is_reply ? $comment->comment_parent : 0,
					'comment_id' => $comment_id,
				)
			);
		} else {
			$this->response_bad_request( tutor_utils()->error_message() );
		}
	}

/**
	 * Saving lesson meta and assets
	 *
	 * @since 1.0.0
	 *
	 * @param integer $post_ID post ID.
	 *
	 * @return void
	 */
	public function save_lesson_meta( $post_ID ) {
		$thumbnail_id = Input::post( 'thumbnail_id', 0, Input::TYPE_INT );
		if ( $thumbnail_id ) {
			update_post_meta( $post_ID, '_thumbnail_id', $thumbnail_id );
		} else {
			delete_post_meta( $post_ID, '_thumbnail_id' );
		}

$video_source = sanitize_text_field( tutor_utils()->array_get( 'video.source', $_POST ) ); //phpcs:ignore
		if ( '-1' === $video_source ) {
			delete_post_meta( $post_ID, '_video' );
		} elseif ( $video_source ) {

// Sanitize data through helper method.
			$video = Input::sanitize_array(
				$_POST['video'] ?? array(), //phpcs:ignore
				array(
					'source_external_url' => 'esc_url',
					'source_embedded'     => 'wp_kses_post',
				),
				true
			);
			update_post_meta( $post_ID, '_video', $video );
		}

// Attachments.
		$attachments = array();
		// phpcs:disable WordPress.Security.NonceVerification.Missing
		if ( ! empty( $_POST['tutor_attachments'] ) ) {
			//phpcs:ignore -- data sanitized through helper method.
			$attachments = tutor_utils()->sanitize_array( wp_unslash( $_POST['tutor_attachments'] ) );
			$attachments = array_unique( $attachments );
		}

/**
		 * If !empty attachment then update meta else
		 * delete meta key to prevent empty data in db
		 *
		 * @since 1.8.9
		*/
		if ( ! empty( $attachments ) ) {
			update_post_meta( $post_ID, '_tutor_attachments', $attachments );
		} else {
			delete_post_meta( $post_ID, '_tutor_attachments' );
		}
	}

/**
	 * Get lesson details data.
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public function ajax_lesson_details() {
		if ( ! tutor_utils()->is_nonce_verified() ) {
			$this->response_bad_request( tutor_utils()->error_message( 'nonce' ) );
		}

$topic_id  = Input::post( 'topic_id', 0, Input::TYPE_INT );
		$lesson_id = Input::post( 'lesson_id', 0, Input::TYPE_INT );

if ( ! $topic_id || ! $lesson_id ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

if ( ! tutor_utils()->can_user_manage( 'topic', $topic_id ) || ! tutor_utils()->can_user_manage( 'lesson', $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message() );
		}

$data = LessonModel::get_lesson_details( $lesson_id );

$this->json_response(
			__( 'Lesson data fetched successfully', 'tutor' ),
			$data
		);
	}

/**
	 * Create or update lesson.
	 *
	 * @since 1.0.0
	 * @since 1.5.1 updated
	 * @since 3.0.0 refactor and response updated.
	 *
	 * @return void
	 */
	public function ajax_save_lesson() {
		if ( ! tutor_utils()->is_nonce_verified() ) {
			$this->response_bad_request( tutor_utils()->error_message( 'nonce' ) );
		}

/**
		 * Allow iframe inside lesson content to support
		 * embed video & other stuff
		 *
		 * @since 2.1.6
		 */
		add_filter( 'wp_kses_allowed_html', Input::class . '::allow_iframe', 10, 2 );

$lesson_id = Input::post( 'lesson_id', 0, Input::TYPE_INT );
		$topic_id  = Input::post( 'topic_id', 0, Input::TYPE_INT );

if ( ! $topic_id || ! tutor_utils()->can_user_manage( 'topic', $topic_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message() );
		}

$is_update = $lesson_id > 0;

$title            = Input::post( 'title' );
		$description      = Input::post( 'description', '', Input::TYPE_KSES_POST );
		$is_html_active   = Input::post( 'is_html_active' ) === 'true' ? true : false;
		$raw_html_content = Input::post( 'tutor_lesson_modal_editor', '', Input::TYPE_KSES_POST );
		$post_content     = $is_html_active ? $raw_html_content : $description;

$rules = array(
			'topic_id'  => 'required|numeric',
			'lesson_id' => 'if_input|numeric',
		);

//phpcs:ignore WordPress.Security.NonceVerification.Missing
		$params = Input::sanitize_array( $_POST, array( 'description' => 'wp_kses_post' ) );

$validation = ValidationHelper::validate( $rules, $params );
		if ( ! $validation->success ) {
			$this->json_response(
				__( 'Invalid inputs', 'tutor' ),
				$validation->errors,
				HttpHelper::STATUS_UNPROCESSABLE_ENTITY
			);
		}

$lesson_data = array(
			'post_type'      => $this->lesson_post_type,
			'post_title'     => wp_slash( $title ), // Note: Added wp_slash to support latex syntaxes.
			'post_name'      => sanitize_title( $title ),
			'post_content'   => wp_slash( $post_content ),
			'post_status'    => 'publish',
			'comment_status' => 'open',
			'post_author'    => get_current_user_id(),
			'post_parent'    => $topic_id,
		);

if ( ! $is_update ) {
			$lesson_data['menu_order'] = tutor_utils()->get_next_course_content_order_id( $topic_id );
			$lesson_id                 = wp_insert_post( $lesson_data );

if ( $lesson_id ) {
				do_action( 'tutor/lesson/created', $lesson_id );
			} else {
				$this->json_response(
					tutor_utils()->error_message(),
					null,
					HttpHelper::STATUS_INTERNAL_SERVER_ERROR
				);
			}
		} else {
			$lesson_data['ID'] = $lesson_id;

if ( ! tutor_utils()->can_user_manage( 'lesson', $lesson_id ) ) {
				$this->json_response(
					tutor_utils()->error_message(),
					null,
					HttpHelper::STATUS_FORBIDDEN
				);
			}

do_action( 'tutor/lesson_update/before', $lesson_id );
			wp_update_post( $lesson_data );
			do_action( 'tutor/lesson_update/after', $lesson_id );
		}

if ( $is_update ) {
			$this->json_response(
				__( 'Lesson updated successfully', 'tutor' ),
				$lesson_id
			);
		} else {
			$this->json_response(
				__( 'Lesson created successfully', 'tutor' ),
				$lesson_id,
				HttpHelper::STATUS_CREATED
			);
		}
	}

/**
	 * Delete Lesson from course builder by ID
	 *
	 * @since 1.0.0
	 * @since 3.0.0 refactor and update response.
	 *
	 * @return void
	 */
	public function ajax_delete_lesson() {
		tutor_utils()->check_nonce();

$lesson_id = Input::post( 'lesson_id', 0, Input::TYPE_INT );
		if ( ! $lesson_id ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

if ( ! tutor_utils()->can_user_manage( 'lesson', $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message() );
		}

$content   = __( 'Lesson', 'tutor' );
		$post_type = get_post_type( $lesson_id );
		if ( tutor()->assignment_post_type === $post_type ) {
			$content = __( 'Assignment', 'tutor' );
		}

do_action( 'tutor_before_delete_course_content', 0, $lesson_id );

wp_delete_post( $lesson_id, true );
		/* translators: %s refers to the name of the content being deleted */
		$this->json_response( sprintf( __( '%s deleted successfully', 'tutor' ), $content ) );
	}

/**
	 * Changed the URI based
	 *
	 * @since 1.0.0
	 *
	 * @param string  $uri URI.
	 * @param integer $lesson_id lesson ID.
	 *
	 * @return string
	 */
	public function change_lesson_permalink( $uri, $lesson_id ) {
		$post = get_post( $lesson_id );

if ( $post && $post->post_type === $this->lesson_post_type ) {
			$uri_base = trailingslashit( site_url() );

$sample_course = 'sample-course';
			$is_course     = tutor_utils()->get_course_id_by( 'lesson', get_the_ID() );
			if ( $is_course ) {
				$course = get_post( $is_course );
				if ( $course ) {
					$sample_course = $course->post_name;
				}
			}

$new_course_base = $uri_base . "course/{$sample_course}/lesson/%pagename%/";
			$uri[0]          = $new_course_base;
		}

return $uri;
	}

/**
	 * Mark lesson completed
	 *
	 * @since 1.0.0
	 *
	 * @return void
	 */
	public function mark_lesson_complete() {
		if ( 'tutor_complete_lesson' !== Input::post( 'tutor_action' ) ) {
			return;
		}

tutor_utils()->checking_nonce();

$user_id = get_current_user_id();

if ( ! $user_id ) {
			die( esc_html__( 'Please Sign-In', 'tutor' ) );
		}

$lesson_id = Input::post( 'lesson_id', 0, Input::TYPE_INT );
		if ( ! $lesson_id ) {
			return;
		}

$course_id = tutor_utils()->get_course_id_by( 'lesson', $lesson_id );
		if ( ! $course_id ) {
			return;
		}

if ( ! tutor_utils()->is_enrolled( $course_id ) ) {
			die( esc_html( tutor_utils()->error_message() ) );
		}

$validated = apply_filters( 'tutor_validate_lesson_complete', true, $user_id, $lesson_id );
		if ( ! $validated ) {
			return;
		}

do_action( 'tutor_lesson_completed_before', $lesson_id );
		/**
		 * Marking lesson at user meta, meta format, _tutor_completed_lesson_id_{id} and value = tutor_time();
		 */
		LessonModel::mark_lesson_complete( $lesson_id );

do_action( 'tutor_lesson_completed_email_after', $lesson_id, $user_id );
		do_action( 'tutor_lesson_completed_after', $lesson_id, $user_id );
	}

/**
	 * Render the lesson content
	 *
	 * @since 1.0.0
	 *
	 * @return void
	 */
	public function tutor_render_lesson_content() {
		tutor_utils()->checking_nonce();

$lesson_id = Input::post( 'lesson_id', 0, Input::TYPE_INT );
		if ( ! $lesson_id ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

$course_id = tutor_utils()->get_course_id_by( 'lesson', $lesson_id );

// Course must be public or current user must be enrolled to access this lesson.
		if ( ! Course_List::is_public( $course_id ) && ! EnrollmentModel::is_enrolled( $course_id ) ) {

$allowed = User::is_admin() ? true : tutor_utils()->is_instructor_of_this_course( get_current_user_id(), $course_id );

if ( ! $allowed ) {
				$this->response_bad_request( tutor_utils()->error_message() );
				exit;
			}
		}

ob_start();
		global $post;

$post = get_post( $lesson_id ); //phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
		setup_postdata( $post );
		tutor_lesson_content();
		wp_reset_postdata();

$html = ob_get_clean();

wp_send_json_success( array( 'html' => $html ) );
	}

/**
	 * Load next course item automatically
	 *
	 * @since 1.4.9
	 *
	 * @return void
	 */
	public function autoload_next_course_content() {
		tutor_utils()->checking_nonce();

$post_id   = Input::post( 'post_id', 0, Input::TYPE_INT );
		$course_id = tutor_utils()->get_course_id_by_content( $post_id );
		if ( ! $course_id || ! EnrollmentModel::is_enrolled( $course_id ) ) {
			wp_send_json_error( tutor_utils()->error_message() );
		}

$content_id = tutor_utils()->get_post_id( $post_id );
		$contents   = tutor_utils()->get_course_prev_next_contents_by_id( $content_id );

$autoload_course_content = (bool) UserPreference::get( 'auto_play_next', false, get_current_user_id() );
		$next_url                = false;
		if ( $autoload_course_content && $contents->next_id ) {
			$next_url = get_the_permalink( $contents->next_id );
		}

wp_send_json_success( array( 'next_url' => $next_url ) );
	}

/**
	 * Load next course item after click complete button
	 *
	 * @since 1.5.3
	 *
	 * @param integer $content_id content ID.
	 * @return void
	 */
	public function tutor_lesson_completed_after( $content_id ) {
		$contents                = tutor_utils()->get_course_prev_next_contents_by_id( $content_id );
		$autoload_course_content = (bool) get_tutor_option( 'autoload_next_course_content' );
		if ( $autoload_course_content ) {
			wp_safe_redirect( get_the_permalink( $contents->next_id ) );
		} else {
			wp_safe_redirect( get_the_permalink( $content_id ) );
		}
		die();
	}

/**
	 * Check user can post lesson comment.
	 *
	 * @since 4.0.0
	 *
	 * @param int $lesson_id lesson id.
	 * @param int $user_id user id. default 0 means current user id.
	 *
	 * @return bool true if user can post lesson comment, false otherwise.
	 */
	private static function can_post_lesson_comment( $lesson_id, $user_id = 0 ) {
		$course_id = tutor_utils()->get_course_id_by( 'lesson', $lesson_id );
		if ( ! $course_id ) {
			return false;
		}

$can_post = EnrollmentModel::is_enrolled( $course_id, $user_id ) || tutor_utils()->can_user_manage( 'course', $course_id, $user_id );
		return $can_post;
	}

/**
	 * Replay lesson comment
	 *
	 * @since 1.0.0
	 *
	 * @return void|null
	 */
	public function ajax_reply_lesson_comment() {
		tutor_utils()->checking_nonce();

$lesson_id      = Input::post( 'comment_post_ID', 0, Input::TYPE_INT );
		$comment_parent = Input::post( 'comment_parent', 0, Input::TYPE_INT );
		$comment        = Input::post( 'comment', '', Input::TYPE_TEXTAREA );

if ( ! $lesson_id || ! $comment_parent || 0 === strlen( $comment ) ) {
			wp_send_json_error( tutor_utils()->error_message( 'invalid_req' ) );
			return;
		}

if ( ! self::can_post_lesson_comment( $lesson_id ) ) {
			wp_send_json_error( tutor_utils()->error_message() );
			return;
		}

$parent_comment = get_comment( $comment_parent );
		if ( ! $parent_comment || (int) $parent_comment->comment_post_ID !== $lesson_id ) {
			wp_send_json_error( tutor_utils()->error_message( 'invalid_req' ) );
			return;
		}

$comment_data = array(
			'comment_content' => $comment,
			'comment_post_ID' => $lesson_id,
			'comment_parent'  => $comment_parent,
		);

if ( ! self::is_comment_enabled_for_lesson( $comment_data['comment_post_ID'] ) ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

$comment_id = self::create_comment( $comment_data );
		if ( false === $comment_id ) {
			wp_send_json_error();
			return;
		}

$reply = get_comment( $comment_id );
		do_action( 'tutor_reply_lesson_comment_thread', $comment_id, $comment_data );

if ( ! $this->is_legacy_learning_mode ) {
			$lesson_id    = $comment_data['comment_post_ID'];
			$parent_id    = $comment_data['comment_parent'];
			$comment_item = get_comment( $parent_id );
			$user_id      = get_current_user_id();

$replies = self::get_comments(
				array(
					'post_id' => $lesson_id,
					'parent'  => $parent_id,
					'order'   => 'ASC',
				)
			);

$is_first_reply = ( is_array( $replies ) ? count( $replies ) : 0 ) === 1;

ob_start();
			if ( $is_first_reply ) {
				// For the first reply, we need the wrapper and the toggle button.
				tutor_load_template(
					'learning-area.lesson.comment-replies',
					array(
						'lesson_id'    => $lesson_id,
						'comment_item' => $comment_item,
						'user_id'      => $user_id,
						'replies'      => $replies,
					)
				);
			} else {
				// Just the card for subsequent replies.
				tutor_load_template(
					'learning-area.lesson.comment-card',
					array(
						'comment_item' => get_comment( $comment_id ),
						'lesson_id'    => $lesson_id,
						'user_id'      => $user_id,
						'is_reply'     => true,
					)
				);
			}
			$html = ob_get_clean();

$total_comments = self::get_comments(
				array(
					'post_id' => $lesson_id,
					'parent'  => 0,
					'count'   => true,
				)
			);

wp_send_json_success(
				array(
					'html'           => $html,
					'count'          => $total_comments,
					'is_first_reply' => $is_first_reply,
				)
			);
		}

ob_start();
		?>
		<div class="tutor-comments-list tutor-child-comment tutor-mt-32" id="lesson-comment-<?php echo esc_attr( $reply->comment_ID ); ?>">
			<div class="comment-avatar">
				<img src="<?php echo esc_url( get_avatar_url( $reply->user_id ) ); ?>" alt="">
			</div>
			<div class="tutor-single-comment">
				<div class="tutor-actual-comment tutor-mb-12">
					<div class="tutor-comment-author">
						<span class="tutor-fs-6 tutor-fw-bold">
							<?php echo esc_html( $reply->comment_author ); ?>
						</span>
						<span class="tutor-fs-7 tutor-ml-0 tutor-ml-sm-10">
							<?php echo esc_html( human_time_diff( strtotime( $reply->comment_date ), tutor_time() ) . __( ' ago', 'tutor' ) ); ?>
						</span>
					</div>
					<div class="tutor-comment-text tutor-fs-6 tutor-mt-4">
						<?php echo esc_html( $reply->comment_content ); ?>
					</div>
				</div>
			</div>
		</div>
		<?php
		$html = ob_get_clean();
		wp_send_json_success( array( 'html' => $html ) );
	}

/**
	 * Get comments
	 *
	 * @since 2.0.6
	 * @see Checkout arguments details: https://developer.wordpress.org/reference/classes/wp_comment_query/__construct/
	 *
	 * @param array $args arguments.
	 * @return mixed  based on arguments
	 */
	public static function get_comments( array $args ) {
		$args['type'] = 'comment';
		$comments     = get_comments( $args );
		return $comments;
	}

/**
	 * Get comment replies
	 *
	 * @since 4.0.0
	 *
	 * @param int    $comment_id comment id.
	 * @param string $order order.
	 *
	 * @return mixed comment replies on success, false on failure
	 */
	public static function get_comment_replies( int $comment_id, string $order = 'DESC' ) {
		return get_comments(
			array(
				'parent' => $comment_id,
				'order'  => QueryHelper::get_valid_sort_order( $order ),
			)
		);
	}

/**
	 * Create comment
	 *
	 * @since 1.0.0
	 *
	 * @param array $request request.
	 * @return mixed comment id on success, false on failure
	 */
	public static function create_comment( array $request ) {
		$current_user = wp_get_current_user();
		$default_data = array(
			'comment_content'      => '',
			'comment_post_ID'      => '',
			'comment_parent'       => '',
			'user_id'              => $current_user->ID,
			'comment_author'       => $current_user->user_login,
			'comment_author_email' => $current_user->user_email,
			'comment_author_url'   => $current_user->user_url,
			'comment_agent'        => 'Tutor',
		);
		$comment_data = wp_parse_args( $request, $default_data );
		return wp_insert_comment( $comment_data );
	}

/**
	 * Check if lesson has content
	 *
	 * @since 3.9.0
	 *
	 * @param int $lesson_id Lesson ID.
	 *
	 * @return bool True if lesson has content, false otherwise.
	 */
	public static function has_lesson_content( $lesson_id ) {
		/**
		 * If lesson has no content, lesson tab will be hidden.
		 * To enable elementor and SCORM, only admin can see lesson tab.
		 *
		 * @since 2.2.2
		 */
		return apply_filters(
			'tutor_has_lesson_content',
			User::is_admin() || ! in_array( trim( get_the_content() ), array( null, '', '&nbsp;' ), true ),
			$lesson_id
		);
	}

/**
	 * Check if lesson has attachments
	 *
	 * @since 3.9.0
	 *
	 * @param int $lesson_id Lesson ID.
	 *
	 * @return bool True if lesson has attachments, false otherwise.
	 */
	public static function has_lesson_attachment( $lesson_id ) {
		return count( tutor_utils()->get_attachments( $lesson_id ) ) > 0;
	}

/**
	 * Check if comments are enabled for lessons
	 *
	 * @since 3.9.0
	 *
	 * @return bool True if comments are enabled, false otherwise.
	 */
	public static function is_comment_enabled() {
		return tutor_utils()->get_option( 'enable_comment_for_lesson' );
	}

/**
	 * Check if comments are enabled for lessons
	 *
	 * @since 4.0.0
	 *
	 * @param int|object $lesson Lesson ID or object. If null, current lesson will be used.
	 *
	 * @return bool True if comments are enabled, false otherwise.
	 */
	public static function is_comment_enabled_for_lesson( $lesson = null ) {
		return self::is_comment_enabled() && comments_open( $lesson );
	}

/**
	 * Check if lesson has comments
	 *
	 * @since 3.9.0
	 *
	 * @param int $lesson_id Lesson ID.
	 *
	 * @return int Number of comments for the lesson.
	 */
	public static function has_lesson_comment( $lesson_id ) {
		return (int) get_comments_number( $lesson_id );
	}

/**
	 * Get navigation items for lesson single page
	 *
	 * @since 3.9.0
	 *
	 * @param int $lesson_id Lesson ID.
	 *
	 * @return array navigation items array
	 */
	public static function get_nav_items( $lesson_id ) {
		$is_legacy = ( new self( false ) )->is_legacy_learning_mode;
		$nav_items = array();

$attachments = tutor_utils()->get_attachments( $lesson_id );

$definitions = array(
			'overview' => array(
				'condition' => self::has_lesson_content( $lesson_id ),
				'legacy'    => array(
					'label'    => __( 'Overview', 'tutor' ),
					'value'    => 'overview',
					'icon'     => 'document-text',
					'template' => 'single.lesson.parts.overview',
				),
				'default'   => array(
					'id'       => 'overview',
					'label'    => __( 'Overview', 'tutor' ),
					'icon'     => Icon::COURSES,
					'template' => 'learning-area.lesson.overview',
				),
			),
			'files'    => array(
				'condition' => tutor_utils()->count( $attachments ),
				'legacy'    => array(
					'label'    => __( 'Exercise Files', 'tutor' ),
					'value'    => 'files',
					'icon'     => 'paperclip',
					'template' => 'single.lesson.parts.files',
				),
				'default'   => array(
					'id'       => 'exercise_files',
					'label'    => __( 'Exercise Files', 'tutor' ),
					'icon'     => Icon::FILE_ATTACHEMENT,
					'template' => 'learning-area.lesson.exercise-files',
				),
			),
			'comments' => array(
				'condition' => self::is_comment_enabled_for_lesson( $lesson_id ) && is_user_logged_in(),
				'legacy'    => array(
					'label'    => __( 'Comments', 'tutor' ),
					'value'    => 'comments',
					'icon'     => 'comment',
					'template' => 'single.lesson.parts.comments',
				),
				'default'   => array(
					'id'       => 'comments',
					'label'    => __( 'Comments', 'tutor' ),
					'icon'     => Icon::COMMENTS,
					'template' => 'learning-area.lesson.comments',
				),
			),
		);

foreach ( $definitions as $key => $def ) {
			if ( empty( $def['condition'] ) ) {
				continue;
			}
			$item = $is_legacy ? $def['legacy'] : $def['default'];
			if ( null !== $item ) {
				$nav_items[ $key ] = $item;
			}
		}

$nav_items = apply_filters( 'tutor_lesson_single_nav_items', $nav_items );
		$nav_items = array_values( $nav_items );

return $nav_items;
	}

/**
	 * Return lesson title as nav item to print on the learning area
	 *
	 * @since 4.0.0
	 *
	 * @param WP_Post $lesson Lesson post object.
	 * @param bool    $can_access Can user access this content.
	 *
	 * @return void
	 */
	public function render_nav_item( $lesson, $can_access ): void {
		tutor_load_template(
			'learning-area.lesson.nav-item',
			array(
				'lesson'     => $lesson,
				'can_access' => $can_access,
			)
		);
	}

/**
	 * Render content for the a single lesson
	 *
	 * @since 4.0.0
	 *
	 * @param WP_Post $lesson Lesson post object.
	 *
	 * @return void
	 */
	public function render_single_content( $lesson ): void {
		tutor_load_template(
			'learning-area.lesson.content',
			array(
				'lesson' => $lesson,
			)
		);
	}

/**
	 * Load lesson comments
	 *
	 * @since 4.0.0
	 *
	 * @return void
	 */
	public function ajax_load_lesson_comments() {
		tutor_utils()->check_nonce();

$lesson_id    = Input::post( 'lesson_id', 0, Input::TYPE_INT );
		$current_page = Input::post( 'current_page', 1, Input::TYPE_INT );
		$offset       = Input::post( 'offset', -1, Input::TYPE_INT );
		$order        = QueryHelper::get_valid_sort_order( Input::post( 'order', 'DESC' ) );

if ( ! self::is_comment_enabled_for_lesson( $lesson_id ) ) {
			$this->response_bad_request( tutor_utils()->error_message( 'invalid_req' ) );
		}

$user_id       = get_current_user_id();
		$item_per_page = tutor_utils()->get_option( 'pagination_per_page', 10 );

$query_args = array(
			'post_id' => $lesson_id,
			'parent'  => 0,
			'number'  => $item_per_page,
			'order'   => $order,
		);

if ( $offset >= 0 ) {
			$query_args['offset'] = $offset;
		} else {
			$query_args['paged'] = $current_page;
		}

$comment_list = self::get_comments( $query_args );

// Get total comment count to determine if there are more pages.
		$total_comments = self::get_comments(
			array(
				'post_id' => $lesson_id,
				'parent'  => 0,
				'count'   => true,
			)
		);

ob_start();
		tutor_load_template(
			'learning-area.lesson.comment-list',
			compact( 'comment_list', 'lesson_id', 'user_id' )
		);
		$html = ob_get_clean();

// Calculate if there are more items.
		if ( $offset >= 0 ) {
			$items_loaded = $offset + count( $comment_list );
		} else {
			$items_loaded = $current_page * $item_per_page;
		}
		$has_more = $items_loaded < $total_comments;

wp_send_json_success(
			array(
				'html'     => $html,
				'has_more' => $has_more,
				'count'    => $total_comments,
			)
		);
	}

/**
	 * Load comment replies for dashboard.
	 *
	 * @since 4.0.0
	 *
	 * @return void
	 */
	public function ajax_load_comment_replies() {
		tutor_utils()->check_nonce();

$comment_id    = Input::post( 'comment_id', 0, Input::TYPE_INT );
		$replies_order = Input::post( 'order', 'DESC' );

if ( ! $comment_id ) {
			$this->response_bad_request( __( 'Invalid comment ID', 'tutor' ) );
		}

$user_id = get_current_user_id();
		$replies = self::get_comment_replies( $comment_id, $replies_order );

ob_start();
		tutor_load_template(
			'dashboard.discussions.comment-replies',
			array(
				'replies'       => $replies,
				'replies_order' => $replies_order,
				'user_id'       => $user_id,
			)
		);
		$html = ob_get_clean();

wp_send_json_success( array( 'html' => $html ) );
	}

/**
	 * Get lesson content type info with video duration
	 *
	 * @since 4.0.0
	 *
	 * @param WP_Post $lesson Lesson post.
	 *
	 * @return string
	 */
	public static function get_content_type_info( WP_Post $lesson ) {
		$video_info  = tutor_utils()->get_video_info( $lesson->ID );
		$lesson_type = __( 'Reading', 'tutor' );

if ( $video_info ) {
			$lesson_type = __( 'Video', 'tutor' );
			$playtime    = $video_info->playtime ?? '';

// Check if the playtime is actually a valid, positive duration.
			if ( ! empty( $playtime ) ) {
				/* translators: %s: duration in minutes */
				$lesson_type = sprintf( __( 'Video - %s mins', 'tutor' ), $playtime );
			}
		}

return $lesson_type;
	}
}

文件操作 - Lesson.php

文件: /home/www/public/wp-content/plugins/tutor/classes/Lesson.php

编辑文件内容

修改文件时间

删除文件