LLMS_AJAX_Handler
LLMS_AJAX_Handler class.
Description Description
Source Source
File: includes/class.llms.ajax.handler.php
class LLMS_AJAX_Handler { /** * Queue all members of a membership to be enrolled into a specific course * Triggered from the auto-enrollment tab of a membership * @param array $request array of request data * @return array * @since 3.4.0 * @version 3.15.0 */ public static function bulk_enroll_membership_into_course( $request ) { if ( empty( $request['post_id'] ) || empty( $request['course_id'] ) ) { return new WP_Error( 400, __( 'Missing required parameters', 'lifterlms' ) ); } do_action( 'llms_membership_do_bulk_course_enrollment', $request['post_id'], $request['course_id'] ); return array( 'message' => __( 'Members are being enrolled in the background. You may leave this page.', 'lifterlms' ), ); } /** * Add or remove a student from a course or membership * @since 3.0.0 * @version 3.4.0 */ public static function bulk_enroll_students( $request ) { if ( empty( $request['post_id'] ) || empty( $request['student_ids'] ) || ! is_array( $request['student_ids'] ) ) { return new WP_Error( 400, __( 'Missing required parameters', 'lifterlms' ) ); } $post_id = intval( $request['post_id'] ); foreach ( $request['student_ids'] as $id ) { llms_enroll_student( intval( $id ), $post_id, 'admin_' . get_current_user_id() ); } } /** * Move a Product Access Plan to the trash * @since 3.0.0 * @version 3.0.0 * @param array $request $_REQUEST object * @return mixed WP_Error on error, true if successful */ public static function delete_access_plan( $request ) { // shouldn't be possible if ( empty( $request['plan_id'] ) ) { die(); } if ( ! wp_trash_post( $request['plan_id'] ) ) { $err = new WP_Error(); $err->add( 'error', __( 'There was a problem deleting your access plan, please try again.', 'lifterlms' ) ); return $err; } return true; } /** * Queue a table export event * @param array $request post data ($_REQUEST) * @return array * @since 3.15.0 * @version 3.28.1 */ public static function export_admin_table( $request ) { require_once 'admin/reporting/class.llms.admin.reporting.php'; LLMS_Admin_Reporting::includes(); $handler = 'LLMS_Table_' . $request['handler']; if ( class_exists( $handler ) ) { $table = new $handler(); $file = isset( $request['filename'] ) ? $request['filename'] : null; return $table->generate_export_file( $request, $file ); } else { return false; } } /** * Reload admin tables * @param array $request post data ($_REQUEST) * @return array * @since 3.2.0 * @version 3.2.0 */ public static function get_admin_table_data( $request ) { require_once 'admin/reporting/class.llms.admin.reporting.php'; $handler = 'LLMS_Table_' . $request['handler']; LLMS_Admin_Reporting::includes(); if ( class_exists( $handler ) ) { $table = new $handler(); $table->get_results( $request ); return array( 'args' => json_encode( $table->get_args() ), 'thead' => trim( $table->get_thead_html() ), 'tbody' => trim( $table->get_tbody_html() ), 'tfoot' => trim( $table->get_tfoot_html() ), ); } else { return false; } } /** * Store data for the instructors metabox * * @since 3.13.0 * @since 3.30.3 Fixed typos. * * @param array $request $_REQUEST object. * @return array */ public static function instructors_mb_store( $request ) { // validate required params if ( ! isset( $request['store_action'] ) || ! isset( $request['post_id'] ) ) { return array( 'data' => array(), 'message' => __( 'Missing required parameters', 'lifterlms' ), 'success' => false, ); } $post = llms_get_post( $request['post_id'] ); switch ( $request['store_action'] ) { case 'load': $instructors = $post->get_instructors(); break; case 'save': $instructors = array(); foreach ( $request['rows'] as $instructor ) { foreach ( $instructor as $key => $val ) { $new_key = str_replace( array( 'llms', '_' ), '', $key ); $new_key = preg_replace( '/[0-9]+/', '', $new_key ); $instructor[ $new_key ] = $val; unset( $instructor[ $key ] ); } $instructors[] = $instructor; } $post->set_instructors( $instructors ); break; } $data = array(); foreach ( $instructors as $instructor ) { $new_instructor = array(); foreach ( $instructor as $key => $val ) { if ( 'id' === $key ) { $val = llms_make_select2_student_array( array( $instructor['id'] ) ); } $new_instructor[ '_llms_' . $key ] = $val; } $data[] = $new_instructor; } wp_send_json( array( 'data' => $data, 'message' => 'success', 'success' => true, ) ); } /** * Handle notification display & dismissal * @param array $request $_POST * @return array * @since 3.8.0 * @version 3.8.0 */ public static function notifications_heartbeart( $request ) { $ret = array( 'new' => array(), ); if ( ! empty( $request['dismissals'] ) ) { foreach ( $request['dismissals'] as $nid ) { $noti = new LLMS_Notification( $nid ); if ( get_current_user_id() == $noti->get( 'subscriber' ) ) { $noti->set( 'status', 'read' ); } } } $query = new LLMS_Notifications_Query( array( 'per_page' => 5, 'statuses' => 'new', 'types' => 'basic', 'subscriber' => get_current_user_id(), ) ); $ret['new'] = $query->get_notifications(); return $ret; } /** * Remove a course from the list of membership auto enrollment courses * called from "Auto Enrollment" tab of LLMS Membership Metaboxes * @since 3.0.0 * @version 3.0.0 */ public static function membership_remove_auto_enroll_course( $request ) { if ( empty( $request['post_id'] ) || empty( $request['course_id'] ) ) { return new WP_Error( 'error', __( 'Missing required parameters.', 'lifterlms' ) ); } $membership = new LLMS_Membership( $request['post_id'] ); if ( ! $membership->remove_auto_enroll_course( intval( $request['course_id'] ) ) ) { return new WP_Error( 'error', __( 'There was an error removing the course, please try again.', 'lifterlms' ) ); } } /** * Retrieve Students * * Used by Select2 AJAX functions to load paginated student results * Also allows querying by: * first name * last name * email * * @return json * @since ?? * @version 3.14.2 */ public static function query_students() { // grab the search term if it exists $term = array_key_exists( 'term', $_REQUEST ) ? $_REQUEST['term'] : ''; $page = array_key_exists( 'page', $_REQUEST ) ? $_REQUEST['page'] : 0; $enrolled_in = array_key_exists( 'enrolled_in', $_REQUEST ) ? sanitize_text_field( $_REQUEST['enrolled_in'] ) : null; $not_enrolled_in = array_key_exists( 'not_enrolled_in', $_REQUEST ) ? sanitize_text_field( $_REQUEST['not_enrolled_in'] ) : null; $roles = array_key_exists( 'roles', $_REQUEST ) ? sanitize_text_field( $_REQUEST['roles'] ) : null; global $wpdb; $limit = 30; $start = $limit * $page; $vars = array(); $roles_sql = ''; if ( $roles ) { $roles = explode( ',', $roles ); $roles = array_map( 'trim', $roles ); $total = count( $roles ); foreach ( $roles as $i => $role ) { $roles_sql .= "roles.meta_value LIKE '%s'"; $vars[] = '%"' . $role . '"%'; if ( $total > 1 && $i + 1 !== $total ) { $roles_sql .= ' OR '; } } $roles_sql = "JOIN $wpdb->usermeta AS roles ON $wpdb->users.ID = roles.user_id AND roles.meta_key = '{$wpdb->prefix}capabilities' AND ( $roles_sql ) "; } // there was a search query if ( $term ) { // email only if ( false !== strpos( $term, '@' ) ) { $query = "SELECT ID AS id , user_email AS email , display_name AS name FROM $wpdb->users $roles_sql WHERE user_email LIKE '%s' ORDER BY display_name LIMIT %d, %d;"; $vars = array_merge( $vars, array( '%' . $term . '%', $start, $limit, ) ); } elseif ( false !== strpos( $term, ' ' ) ) { $term = explode( ' ', $term ); $query = "SELECT users.ID AS id , users.user_email AS email , users.display_name AS name FROM $wpdb->users AS users $roles_sql LEFT JOIN wp_usermeta AS fname ON fname.user_id = users.ID LEFT JOIN wp_usermeta AS lname ON lname.user_id = users.ID WHERE ( fname.meta_key = 'first_name' AND fname.meta_value LIKE '%s' ) AND ( lname.meta_key = 'last_name' AND lname.meta_value LIKE '%s' ) ORDER BY users.display_name LIMIT %d, %d;"; $vars = array_merge( $vars, array( '%' . $term[0] . '%', // first name '%' . $term[1] . '%', // last name $start, $limit, ) ); // search for login, display name, or email } else { $query = "SELECT ID AS id , user_email AS email , display_name AS name FROM $wpdb->users $roles_sql WHERE user_email LIKE '%s' OR user_login LIKE '%s' OR display_name LIKE '%s' ORDER BY display_name LIMIT %d, %d;"; $vars = array_merge( $vars, array( '%' . $term . '%', '%' . $term . '%', '%' . $term . '%', $start, $limit, ) ); }// End if(). } else { $query = "SELECT ID AS id , user_email AS email , display_name AS name FROM $wpdb->users $roles_sql ORDER BY display_name LIMIT %d, %d;"; $vars = array_merge( $vars, array( $start, $limit, ) ); }// End if(). $res = $wpdb->get_results( $wpdb->prepare( $query, $vars ) ); if ( $enrolled_in ) { $checks = explode( ',', $enrolled_in ); $checks = array_map( 'trim', $checks ); // loop through each user foreach ( $res as $key => $user ) { // loop through each check -- this is an OR relationship situation foreach ( $checks as $id ) { // if the user is enrolled break to the next user, they can stay if ( llms_is_user_enrolled( $user->id, $id ) ) { continue 2; } } // if we get here that means the user isn't enrolled in any of the check posts // remove them from the results unset( $res[ $key ] ); } } if ( $not_enrolled_in ) { $checks = explode( ',', $enrolled_in ); $checks = array_map( 'trim', $checks ); // loop through each user foreach ( $res as $key => $user ) { // loop through each check -- this is an OR relationship situation // if the user is enrolled in any of the courses they need to be filtered out foreach ( $checks as $id ) { // if the user is enrolled break remove them and break to the next user if ( llms_is_user_enrolled( $user->id, $id ) ) { unset( $res[ $key ] ); continue 2; } } } } echo json_encode( array( 'items' => $res, 'more' => count( $res ) === $limit, 'success' => true, ) ); wp_die(); } /** * Start a Quiz Attempt * @param array $request $_POST data * required: * (string) attempt_key * or * (int) quiz_id * (int) lesson_id * * @return obj|array WP_Error on error or array containing html template of the first question * @since 3.9.0 * @version 3.16.4 */ public static function quiz_start( $request ) { $err = new WP_Error(); $student = llms_get_student(); if ( ! $student ) { $err->add( 400, __( 'You must be logged in to take quizzes.', 'lifterlms' ) ); return $err; } $attempt = false; if ( isset( $request['attempt_key'] ) && $request['attempt_key'] ) { $attempt = $student->quizzes()->get_attempt_by_key( $request['attempt_key'] ); } if ( ! $attempt || 'new' !== $attempt->get_status() ) { if ( ! isset( $request['quiz_id'] ) || ! isset( $request['lesson_id'] ) ) { $err->add( 400, __( 'There was an error starting the quiz. Please return to the lesson and begin again.', 'lifterlms' ) ); return $err; } $attempt = LLMS_Quiz_Attempt::init( absint( $request['quiz_id'] ), absint( $request['lesson_id'] ), $student->get( 'id' ) ); } $question_id = $attempt->get_first_question(); if ( ! $question_id ) { $err->add( 404, __( 'Unable to start quiz because the quiz does not contain any questions.', 'lifterlms' ) ); return $err; } $attempt->start(); $html = llms_get_template_ajax( 'content-single-question.php', array( 'attempt' => $attempt, 'question' => llms_get_post( $question_id ), ) ); $quiz = $attempt->get_quiz(); $limit = $quiz->has_time_limit() ? $quiz->get( 'time_limit' ) : false; return array( 'attempt_key' => $attempt->get_key(), 'html' => $html, 'time_limit' => $limit, 'question_id' => $question_id, 'total' => $attempt->get_count( 'questions' ), ); } /** * AJAX Quiz answer question * @param [type] $request [description] * @return [type] [description] * @since 3.9.0 * @version 3.27.0 */ public static function quiz_answer_question( $request ) { $err = new WP_Error(); $student = llms_get_student(); if ( ! $student ) { $err->add( 400, __( 'You must be logged in to take quizzes.', 'lifterlms' ) ); return $err; } $required = array( 'attempt_key', 'question_id', 'question_type' ); foreach ( $required as $key ) { if ( ! isset( $request[ $key ] ) ) { $err->add( 400, __( 'Missing required parameters. Could not proceed.', 'lifterlms' ) ); return $err; } } // $quiz_id = absint( $request['quiz_id'] ); $attempt_key = sanitize_text_field( $request['attempt_key'] ); $question_id = absint( $request['question_id'] ); $answer = array_map( 'stripslashes_deep', isset( $request['answer'] ) ? $request['answer'] : array() ); $attempt = $student->quizzes()->get_attempt_by_key( $attempt_key ); if ( ! $attempt ) { $err->add( 500, __( 'There was an error recording your answer the quiz. Please return to the lesson and begin again.', 'lifterlms' ) ); return $err; } // record the answer $attempt->answer_question( $question_id, $answer ); // get the next question $question_id = $attempt->get_next_question( $question_id ); // return html for the next question if ( $question_id ) { $html = llms_get_template_ajax( 'content-single-question.php', array( 'attempt' => $attempt, 'question' => llms_get_post( $question_id ), ) ); return array( 'html' => $html, 'question_id' => $question_id, ); } else { return self::quiz_end( $request, $attempt ); } } /** * End a quiz attempt * @param [type] $request [description] * @param [type] $attempt [description] * @return array * @since 3.9.0 * @version 3.16.0 */ public static function quiz_end( $request, $attempt = null ) { $err = new WP_Error(); if ( ! $attempt ) { $student = llms_get_student(); if ( ! $student ) { $err->add( 400, __( 'You must be logged in to take quizzes.', 'lifterlms' ) ); return $err; } if ( ! isset( $request['attempt_key'] ) ) { $err->add( 400, __( 'Missing required parameters. Could not proceed.', 'lifterlms' ) ); return $err; } $attempt = $student->quizzes()->get_attempt_by_key( sanitize_text_field( $request['attempt_key'] ) ); } // record the attempt's completion $attempt->end(); // setup a redirect $url = add_query_arg( array( 'attempt_key' => $attempt->get_key(), ), get_permalink( $attempt->get( 'quiz_id' ) ) ); return array( 'redirect' => apply_filters( 'llms_quiz_complete_redirect', $url, $attempt ), ); } /** * Remove a coupon from an order during checkout * @return string/json * @since 3.0.0 * @version 3.0.0 */ public static function remove_coupon_code( $request ) { LLMS()->session->set( 'llms_coupon', false ); $plan = new LLMS_Access_Plan( $request['plan_id'] ); ob_start(); llms_get_template( 'checkout/form-coupon.php' ); $coupon_html = ob_get_clean(); ob_start(); llms_get_template( 'checkout/form-gateways.php', array( 'coupon' => false, 'gateways' => LLMS()->payment_gateways()->get_enabled_payment_gateways(), 'selected_gateway' => LLMS()->payment_gateways()->get_default_gateway(), 'plan' => $plan, ) ); $gateways_html = ob_get_clean(); ob_start(); llms_get_template( 'checkout/form-summary.php', array( 'coupon' => false, 'plan' => $plan, 'product' => $plan->get_product(), ) ); $summary_html = ob_get_clean(); return array( 'coupon_html' => $coupon_html, 'gateways_html' => $gateways_html, 'summary_html' => $summary_html, ); } /** * Handle Select2 Search boxes for WordPress Posts by Post Type and Post Status. * * @since 3.0.0 * @since 3.32.0 Updated to use llms_filter_input(). * @since 3.32.0 Posts can be queried by post status(es) via the `$_POST['post_statuses']`. * By default only the published posts will be queried. * @return void */ public static function select2_query_posts() { global $wpdb; // grab the search term if it exists. $term = llms_filter_input( INPUT_POST, 'term', FILTER_SANITIZE_STRING ); // get the page. $page = llms_filter_input( INPUT_POST, 'page', FILTER_SANITIZE_NUMBER_INT ); // Get post type(s). $post_type = sanitize_text_field( llms_filter_input( INPUT_POST, 'post_type', FILTER_SANITIZE_STRING ) ); $post_types_array = explode( ',', $post_type ); foreach ( $post_types_array as &$str ) { $str = "'" . esc_sql( trim( $str ) ) . "'"; } $post_types = implode( ',', $post_types_array ); // Get post status(es). $post_statuses = llms_filter_input( INPUT_POST, 'post_statuses', FILTER_SANITIZE_STRING ); $post_statuses = empty( $post_statuses ) ? 'publish' : $post_statuses; $post_statuses_array = explode( ',', $post_statuses ); foreach ( $post_statuses_array as &$str ) { $str = "'" . esc_sql( trim( $str ) ) . "'"; } $post_statuses = implode( ',', $post_statuses_array ); $limit = 30; $start = $limit * $page; if ( $term ) { $like = " AND post_title LIKE '%s'"; $vars = array( '%' . $term . '%', $start, $limit ); } else { $like = ''; $vars = array( $start, $limit ); } $posts = $wpdb->get_results( $wpdb->prepare( "SELECT ID, post_title, post_type FROM $wpdb->posts WHERE post_type IN ( $post_types ) AND post_status IN ( $post_statuses ) $like ORDER BY post_title LIMIT %d, %d ", $vars ) ); $items = array(); $grouping = ( count( $post_types_array ) > 1 ); foreach ( $posts as $post ) { $item = array( 'id' => $post->ID, 'name' => $post->post_title . ' (' . __( 'ID#', 'lifterlms' ) . ' ' . $post->ID . ')', ); if ( $grouping ) { // setup an object for the optgroup if it's not already set up if ( ! isset( $items[ $post->post_type ] ) ) { $obj = get_post_type_object( $post->post_type ); $items[ $post->post_type ] = array( 'label' => $obj->labels->name, 'items' => array(), ); } $items[ $post->post_type ]['items'][] = $item; } else { $items[] = $item; } } echo json_encode( array( 'items' => $items, 'more' => count( $items ) === $limit, 'success' => true, ) ); wp_die(); } /** * Add or remove a student from a course or membership. * * @since 3.0.0 * @since 3.33.0 Handle the delete enrollment request and make sure the $request['post_id'] is not empty. * Also always return either a WP_Error on failure or a "success" array on action performed. * * @param $request array * @return WP_Error|array */ public static function update_student_enrollment( $request ) { if ( empty( $request['student_id'] ) || empty( $request['status'] ) || empty( $request['post_id'] ) ) { return new WP_Error( 400, __( 'Missing required parameters', 'lifterlms' ) ); } if ( ! in_array( $request['status'], array( 'add', 'remove', 'delete' ) ) ) { return new WP_Error( 400, __( 'Invalid status', 'lifterlms' ) ); } $student_id = intval( $request['student_id'] ); $post_id = intval( $request['post_id'] ); switch ( $request['status'] ) { case 'add': $res = llms_enroll_student( $student_id, $post_id, 'admin_' . get_current_user_id() ); break; case 'remove': $res = llms_unenroll_student( $student_id, $post_id, 'cancelled', 'any' ); break; case 'delete': $res = llms_delete_student_enrollment( $student_id, $post_id, 'any' ); break; } if ( ! $res ) { return new WP_Error( 400, sprintf( __( 'Action "%1$s" failed. Please try again', 'lifterlms' ), $request['status'] ) ); } return array( 'success' => true, ); } /** * Validate a Coupon via the Checkout Form * @return string/json * @since 3.0.0 * @version 3.0.0 */ public static function validate_coupon_code( $request ) { $error = new WP_Error(); // validate for required fields if ( empty( $request['code'] ) ) { $error->add( 'error', __( 'Please enter a coupon code.', 'lifterlms' ) ); // this shouldn't be possible... } elseif ( empty( $request['plan_id'] ) ) { $error->add( 'error', __( 'Please enter a plan ID.', 'lifterlms' ) ); } // End if(). else { $cid = llms_find_coupon( $request['code'] ); if ( ! $cid ) { $error->add( 'error', sprintf( __( 'Coupon code "%s" not found.', 'lifterlms' ), $request['code'] ) ); } else { $c = new LLMS_Coupon( $cid ); $valid = $c->is_valid( $request['plan_id'] ); if ( is_wp_error( $valid ) ) { $error = $valid; } else { LLMS()->session->set( 'llms_coupon', array( 'plan_id' => $request['plan_id'], 'coupon_id' => $c->get( 'id' ), ) ); $plan = new LLMS_Access_Plan( $request['plan_id'] ); ob_start(); llms_get_template( 'checkout/form-coupon.php', array( 'coupon' => $c, ) ); $coupon_html = ob_get_clean(); ob_start(); llms_get_template( 'checkout/form-gateways.php', array( 'coupon' => $c, 'gateways' => LLMS()->payment_gateways()->get_enabled_payment_gateways(), 'selected_gateway' => LLMS()->payment_gateways()->get_default_gateway(), 'plan' => $plan, ) ); $gateways_html = ob_get_clean(); ob_start(); llms_get_template( 'checkout/form-summary.php', array( 'coupon' => $c, 'plan' => $plan, 'product' => $plan->get_product(), ) ); $summary_html = ob_get_clean(); $success = array( 'code' => $c->get( 'title' ), 'coupon_html' => $coupon_html, 'gateways_html' => $gateways_html, 'summary_html' => $summary_html, ); }// End if(). }// End if(). } // if there are errors, return them if ( $error->get_error_messages() ) { return $error; } else { return $success; } } /** * @todo organize and docblock remaining class functions */ public static function create_section( $request ) { $section_id = LLMS_Post_Handler::create_section( $request['post_id'], $request['title'] ); $html = LLMS_Meta_Box_Course_Outline::section_tile( $section_id ); return $html; } public static function get_course_sections( $request ) { $course = new LLMS_Course( $request['post_id'] ); $sections = $course->get_sections( 'posts' ); return $sections; } public static function create_lesson( $request ) { $lesson_id = LLMS_Post_Handler::create_lesson( $request['post_id'], $request['section_id'], $request['title'], $request['excerpt'] ); $html = LLMS_Meta_Box_Course_Outline::lesson_tile( $lesson_id, $request['section_id'] ); return $html; } public static function get_lesson_options_for_select( $request ) { return LLMS_Post_Handler::get_lesson_options_for_select_list(); } public static function add_lesson_to_course( $request ) { $lesson_id = LLMS_Lesson_Handler::assign_to_course( $request['post_id'], $request['section_id'], $request['lesson_id'] ); $html = LLMS_Meta_Box_Course_Outline::lesson_tile( $lesson_id, $request['section_id'] ); return $html; } public static function get_course_section( $request ) { return new LLMS_Section( $request['section_id'] ); } public static function update_course_section( $request ) { $section = new LLMS_Section( $request['section_id'] ); return $section->set_title( $request['title'] ); } public static function get_course_lesson( $request ) { $l = new LLMS_Lesson( $request['lesson_id'] ); return array( 'id' => $l->get( 'id' ), 'title' => $l->get( 'title' ), 'excerpt' => $l->get( 'excerpt' ), ); } public static function update_course_lesson( $request ) { $post_data = array( 'title' => $request['title'], 'excerpt' => $request['excerpt'], ); $lesson = new LLMS_Lesson( $request['lesson_id'] ); return $lesson->update( $post_data ); } public static function remove_course_lesson( $request ) { $post_data = array( 'parent_course' => '', 'parent_section' => '', 'order' => '', ); $lesson = new LLMS_Lesson( $request['lesson_id'] ); return $lesson->update( $post_data ); } public static function delete_course_section( $request ) { $section = new LLMS_Section( $request['section_id'] ); return $section->delete(); } public static function update_section_order( $request ) { $updated_data; foreach ( $request['sections'] as $key => $value ) { $section = new LLMS_Section( $key ); $updated_data[ $key ] = $section->update( array( 'order' => $value, ) ); } return $updated_data; } public static function update_lesson_order( $request ) { $updated_data; foreach ( $request['lessons'] as $key => $value ) { $lesson = new LLMS_Lesson( $key ); $updated_data[ $key ] = $lesson->update( array( 'parent_section' => $value['parent_section'], 'order' => $value['order'], ) ); } return $updated_data; } /** * "API" for the Admin Builder * @param [type] $request [description] * @return [type] [description] * @since 3.13.0 * @version 3.13.0 */ public static function llms_builder( $request ) { require_once 'admin/class.llms.admin.builder.php'; return LLMS_Admin_Builder::handle_ajax( $request ); } /** * Save autoenroll courses list for a Membership * * @since 3.30.0 * @version 3.30.0 * * @param array $request $_POST data. * @return null|true */ public static function llms_save_membership_autoenroll_courses( $request ) { // Missing required fields. if ( empty( $request['post_id'] ) || ! isset( $request['courses'] ) ) { return; } // Not a membership. $membership = llms_get_post( $request['post_id'] ); if ( ! $membership || ! is_a( $membership, 'LLMS_Membership' ) ) { return; } $courses = array_map( 'absint', (array) $request['courses'] ); $membership->add_auto_enroll_courses( $courses, true ); return true; } /** * AJAX handler for creating and updating access plans via the metabox on courses & memberships * * @since 3.29.0 * @since 3.33.1 Use `wp_unslash()` before inserting access plan data. * * @param array $request $_POST data. * @return array */ public static function llms_update_access_plans( $request ) { if ( empty( $request['plans'] ) || ! is_array( $request['plans'] ) || empty( $request['post_id'] ) ) { return new WP_Error( 'error', __( 'Missing Required Parameters.', 'lifterlms' ) ); } $metabox = new LLMS_Meta_Box_Product(); $post_id = absint( $request['post_id'] ); $metabox->post = get_post( $post_id ); $errors = array(); foreach ( $request['plans'] as $raw_plan_data ) { if ( empty( $raw_plan_data ) ) { continue; } $raw_plan_data = wp_unslash( $raw_plan_data ); // Ensure we can switch plans that used to be paid to free. if ( isset( $raw_plan_data['is_free'] ) && llms_parse_bool( $raw_plan_data['is_free'] ) && ! isset( $raw_plan_data['price'] ) ) { $raw_plan_data['price'] = 0; } $raw_plan_data['product_id'] = $post_id; // retained filter for backwards compat. $raw_plan_data = apply_filters( 'llms_access_before_save_plan', $raw_plan_data, $metabox ); $plan = llms_insert_access_plan( $raw_plan_data ); if ( is_wp_error( $plan ) ) { $errors[ $raw_plan_data['menu_order'] ] = $plan; } else { // retained hook for backwards compat. do_action( 'llms_access_plan_saved', $plan, $raw_plan_data, $metabox ); } } return array( 'errors' => $errors, 'html' => $metabox->get_html(), ); } }
Expand full source code Collapse full source code View on GitHub
Changelog Changelog
Version | Description |
---|---|
3.33.1 | Update llms_update_access_plans to use wp_unslash() before inserting access plan data. |
3.33.0 | Update update_student_enrollment to handle enrollment deletion requests, make sure the input array param 'post_id' field is not empty. Also always return either a WP_Error on failure or a "success" array on requested action performed. |
3.32.0 | Update select2_query_posts to use llms_filter_input() and allows for querying posts by post status(es). |
3.30.3 | Fixed spelling errors. |
3.30.0 | Added llms_save_membership_autoenroll_courses method. |
1.0.0 | Introduced. |
Methods Methods
- add_lesson_to_course
- bulk_enroll_membership_into_course — Queue all members of a membership to be enrolled into a specific course Triggered from the auto-enrollment tab of a membership
- bulk_enroll_students — Add or remove a student from a course or membership
- create_lesson
- create_section
- delete_access_plan — Move a Product Access Plan to the trash
- delete_course_section
- export_admin_table — Queue a table export event
- get_admin_table_data — Reload admin tables
- get_course_lesson
- get_course_section
- get_course_sections
- get_lesson_options_for_select
- instructors_mb_store — Store data for the instructors metabox
- llms_builder — "API" for the Admin Builder
- llms_save_membership_autoenroll_courses — Save autoenroll courses list for a Membership
- llms_update_access_plans — AJAX handler for creating and updating access plans via the metabox on courses & memberships
- membership_remove_auto_enroll_course — Remove a course from the list of membership auto enrollment courses called from "Auto Enrollment" tab of LLMS Membership Metaboxes
- notifications_heartbeart — Handle notification display & dismissal
- query_students — Retrieve Students
- quiz_answer_question — AJAX Quiz answer question
- quiz_end — End a quiz attempt
- quiz_start — Start a Quiz Attempt
- remove_coupon_code — Remove a coupon from an order during checkout
- remove_course_lesson
- select2_query_posts — Handle Select2 Search boxes for WordPress Posts by Post Type and Post Status.
- update_course_lesson
- update_course_section
- update_lesson_order
- update_section_order
- update_student_enrollment — Add or remove a student from a course or membership.
- validate_coupon_code — Validate a Coupon via the Checkout Form
User Contributed Notes User Contributed Notes
Permalink: