15 Useful LearnDash Hooks to Customize Your LMS

add_action('learndash_course_completed', 'ppunch_redirect_on_course_complete', 10, 1);
function ppunch_redirect_on_course_complete($data) {
    // Define the custom landing page URL here
    $target_url = home_url('/course-complete-thank-you/');
    
    // Perform redirect if this is a standard browser request
    if (!wp_doing_ajax() && !wp_doing_cron() && !empty($target_url)) {
        wp_safe_redirect($target_url);
        exit;
    }
}

add_action('user_register', 'ppunch_auto_enroll_onboarding_course', 10, 1);
function ppunch_auto_enroll_onboarding_course($user_id) {
    $onboarding_course_id = 999; // REPLACE with your onboarding Course Post ID
    
    if (function_exists('ld_update_course_access')) {
        ld_update_course_access($user_id, $onboarding_course_id);
    }
}

add_action('learndash_quiz_completed', 'ppunch_complete_lesson_on_quiz_pass', 10, 2);
function ppunch_complete_lesson_on_quiz_pass($quiz_data, $user) {
    if (isset($quiz_data['pass']) && $quiz_data['pass'] == 1) {
        $quiz_id = $quiz_data['quiz']->ID;
        $user_id = $user->ID;
        
        // Fetch parent lesson and course IDs
        $lesson_id = learndash_get_setting($quiz_id, 'lesson');
        $course_id = learndash_get_setting($quiz_id, 'course');
        
        if (!empty($lesson_id) && !empty($course_id) && function_exists('learndash_process_mark_complete')) {
            learndash_process_mark_complete($user_id, $lesson_id, false, $course_id);
        }
    }
}

add_action('wp_login', 'ppunch_check_expiring_courses_on_login', 10, 2);
function ppunch_check_expiring_courses_on_login($user_login, $user) {
    if (!function_exists('learndash_user_get_enrolled_courses')) {
        return;
    }
    
    $user_id = $user->ID;
    $enrolled_courses = learndash_user_get_enrolled_courses($user_id);
    
    if (empty($enrolled_courses)) {
        return;
    }
    
    foreach ($enrolled_courses as $course_id) {
        $access_from = ld_course_access_from($course_id, $user_id);
        $course_duration = learndash_get_course_access_duration($course_id, $user_id);
        
        if ($access_from > 0 && $course_duration > 0) {
            $expire_date = $access_from + $course_duration;
            $time_left = $expire_date - time();
            $days_left = floor($time_left / DAY_IN_SECONDS);
            
            // Send warning email if expiring within 5 days
            if ($days_left > 0 && $days_left <= 5) {
                $to = $user->user_email;
                $subject = "Your Course Access is Expiring Soon!";
                $message = "Hello " . esc_html($user->display_name) . ",\n\nYour access to the course '" . get_the_title($course_id) . "' expires in " . $days_left . " days. Renew now to maintain access.";
                wp_mail($to, $subject, $message);
            }
        }
    }
}

add_action('init', 'ppunch_register_progress_reset_shortcode');
function ppunch_register_progress_reset_shortcode() {
    add_shortcode('ppunch_ld_reset_progress', 'ppunch_render_progress_reset_button');
}

function ppunch_render_progress_reset_button($atts) {
    $atts = shortcode_atts(['course_id' => 0], $atts, 'ppunch_ld_reset_progress');
    $course_id = intval($atts['course_id']);
    
    if (!$course_id || !is_user_logged_in()) {
        return '';
    }
    
    $user_id = get_current_user_id();
    
    // Handle Reset Action
    if (isset($_POST['ppunch_reset_nonce']) && wp_verify_nonce($_POST['ppunch_reset_nonce'], 'ppunch_reset_course_' . $course_id)) {
        delete_user_meta($user_id, '_sfwd-course_progress');
        delete_user_meta($user_id, 'course_completed_' . $course_id);
        
        wp_safe_redirect(get_permalink($course_id));
        exit;
    }
    
    ob_start();
    ?>
    <form method="post" onsubmit="return confirm('Are you sure you want to reset your progress? This cannot be undone.');">
        <?php wp_nonce_field('ppunch_reset_course_' . $course_id, 'ppunch_reset_nonce'); ?>
        <button type="submit" class="btn-primary" style="background-color: #d9534f; color: #fff; border: none; padding: 10px 20px; border-radius: 4px; cursor: pointer;">
            Reset Course Progress
        </button>
    </form>
    <?php
    return ob_get_clean();
}

add_filter('ld_lesson_access_from', 'ppunch_drip_by_registration_date', 10, 3);
function ppunch_drip_by_registration_date($access_from, $post_id, $user_id) {
    $user = get_userdata($user_id);
    if (!$user) {
        return $access_from;
    }
    
    $registration_timestamp = strtotime($user->user_registered);
    $drip_days = learndash_get_setting($post_id, 'visible_after');
    
    if ($drip_days > 0) {
        // visibility offset is calculated from user registration
        return $registration_timestamp + ($drip_days * DAY_IN_SECONDS);
    }
    
    return $access_from;
}

add_action('learndash_quiz_completed', 'ppunch_test_out_course_on_final_pass', 10, 2);
function ppunch_test_out_course_on_final_pass($quiz_data, $user) {
    if (isset($quiz_data['pass']) && $quiz_data['pass'] == 1) {
        $quiz_id = $quiz_data['quiz']->ID;
        $user_id = $user->ID;
        
        // Check custom meta to see if this is marked as a Final Exam quiz
        $is_final_exam = get_post_meta($quiz_id, '_ppunch_is_final_exam', true);
        $course_id = learndash_get_setting($quiz_id, 'course');
        
        if ($is_final_exam && !empty($course_id) && function_exists('learndash_process_mark_complete')) {
            learndash_process_mark_complete($user_id, $course_id);
        }
    }
}

add_action('learndash_course_completed', 'ppunch_chain_course_enrollment', 10, 1);
function ppunch_chain_course_enrollment($data) {
    $user_id = $data['user']->ID;
    $completed_course_id = $data['course']->ID;
    
    // completed course ID => next course ID
    $course_chain = [
        101 => 102, // E.g., when completing 101, enroll in 102
        201 => 202,
    ];
    
    if (isset($course_chain[$completed_course_id]) && function_exists('ld_update_course_access')) {
        $next_course_id = $course_chain[$completed_course_id];
        ld_update_course_access($user_id, $next_course_id);
    }
}

add_action('template_redirect', 'ppunch_auto_complete_step_on_view');
function ppunch_auto_complete_step_on_view() {
    if (!is_user_logged_in() || !function_exists('learndash_get_course_id')) {
        return;
    }
    
    if (is_singular(['sfwd-lessons', 'sfwd-topics'])) {
        $step_id = get_the_ID();
        $user_id = get_current_user_id();
        $course_id = learndash_get_course_id($step_id);
        
        if ($course_id && function_exists('learndash_process_mark_complete') && function_exists('learndash_is_item_complete')) {
            $is_completed = learndash_is_item_complete($step_id, $user_id, $course_id);
            
            if (!$is_completed) {
                learndash_process_mark_complete($user_id, $step_id, false, $course_id);
            }
        }
    }
}

add_filter('learndash_show_quiz_take_button', 'ppunch_prevent_quiz_retakes_after_pass', 10, 3);
function ppunch_prevent_quiz_retakes_after_pass($show_button, $user_id, $quiz_id) {
    if (!$show_button || empty($user_id)) {
        return $show_button;
    }
    
    // Retrieve past user attempts
    $quiz_attempts = get_user_meta($user_id, '_sfwd-quizzes', true);
    
    if (!empty($quiz_attempts) && is_array($quiz_attempts)) {
        foreach ($quiz_attempts as $attempt) {
            // Block start button if already passed once
            if ($attempt['quiz'] == $quiz_id && isset($attempt['pass']) && $attempt['pass'] == 1) {
                return false;
            }
        }
    }
    
    return $show_button;
}

add_action('learndash_shortcode_profile_before_template', 'ppunch_inject_student_stats_header', 10, 1);
function ppunch_inject_student_stats_header($user_id) {
    if (empty($user_id)) {
        return;
    }
    
    $enrolled = learndash_user_get_enrolled_courses($user_id);
    $completed = 0;
    
    if (!empty($enrolled)) {
        foreach ($enrolled as $course_id) {
            if (learndash_course_status($course_id, $user_id) === 'completed') {
                $completed++;
            }
        }
    }
    
    $total_enrolled = count($enrolled);
    
    ?>
    <div class="learndash-profile-stats-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 20px; margin-bottom: 30px;">
        <div class="stat-card" style="background: #fff; padding: 20px; border-radius: 8px; border: 1px solid rgba(0,0,0,0.05); text-align: center;">
            <span style="font-size: 0.85rem; color: #666; text-transform: uppercase; font-weight: 600; display: block; margin-bottom: 5px;">Enrolled Courses</span>
            <strong style="font-size: 2rem; color: #333;"><?php echo esc_html($total_enrolled); ?></strong>
        </div>
        <div class="stat-card" style="background: #fff; padding: 20px; border-radius: 8px; border: 1px solid rgba(0,0,0,0.05); text-align: center;">
            <span style="font-size: 0.85rem; color: #666; text-transform: uppercase; font-weight: 600; display: block; margin-bottom: 5px;">Completed Courses</span>
            <strong style="font-size: 2rem; color: #44b549;"><?php echo esc_html($completed); ?></strong>
        </div>
    </div>
    <?php
}

// 1. Add Custom Column Header
add_filter('learndash_profile_quiz_columns', 'ppunch_add_profile_quiz_custom_column', 10, 1);
function ppunch_add_profile_quiz_custom_column($columns) {
    $columns['ppunch_status'] = 'Requirements';
    return $columns;
}

// 2. Render Custom Row Cell Value
add_action('learndash_profile_quiz_row_data', 'ppunch_render_profile_quiz_custom_column_cells', 10, 3);
function ppunch_render_profile_quiz_custom_column_cells($column_key, $user_id, $quiz_attempt) {
    if ($column_key === 'ppunch_status') {
        $pass_status = isset($quiz_attempt['pass']) && $quiz_attempt['pass'] == 1 ? 'Passed' : 'Failed';
        $color = $pass_status === 'Passed' ? '#44b549' : '#d9534f';
        echo '<span style="color: ' . $color . '; font-weight: 600;">' . esc_html($pass_status) . '</span>';
    }
}

// 1. Add Custom CSV Export Header
add_filter('learndash_data_reports_headers', 'ppunch_add_custom_reporting_csv_headers', 10, 2);
function ppunch_add_custom_reporting_csv_headers($headers, $report_type) {
    if ($report_type === 'user-courses') {
        $headers['company_domain'] = 'User Domain';
    }
    return $headers;
}

// 2. Populate CSV Row Data
add_filter('learndash_data_reports_line', 'ppunch_hydrate_reporting_csv_rows', 10, 3);
function ppunch_hydrate_reporting_csv_rows($row, $raw_data, $report_type) {
    if ($report_type === 'user-courses') {
        $user_id = $raw_data->user_id ?? 0;
        $domain = '';
        
        if ($user_id) {
            $user = get_userdata($user_id);
            if ($user) {
                $email_parts = explode('@', $user->user_email);
                $domain = end($email_parts);
            }
        }
        
        $row['company_domain'] = $domain;
    }
    return $row;
}

add_filter('learndash_lesson_topics_list_sort', 'ppunch_sort_topics_alphabetically', 10, 2);
function ppunch_sort_topics_alphabetically($sort_args, $lesson_id) {
    $sort_args['orderby'] = 'title';
    $sort_args['order'] = 'ASC';
    return $sort_args;
}

add_filter('learndash_quiz_passing_percentage', 'ppunch_set_default_quiz_passing_score', 10, 2);
function ppunch_set_default_quiz_passing_score($passing_percentage, $quiz_id) {
    // Autoset default passing threshold to 75% if not yet configured
    return empty($passing_percentage) ? 75 : $passing_percentage;
}