lw-lms-learndash-migration

name	lw-lms-learndash-migration
description	Plan, run, or review the LW LMS WP-CLI LearnDash migration command `wp lw-lms migrate-learndash` in lw-lms v1.6.0. Use when migrating `sfwd-courses` / `sfwd-lessons`, checking `--dry-run` / `--verbose`, verifying `_lw_lms_migrated_to` mappings, course sections, lesson order, WooCommerce product links, LearnDash video extraction, or safe reruns after partial migration.
metadata	{"wp-skills-author":"Soczó Kristóf","wp-skills-contact":"mailto:[e-mail]","wp-skills-plugin":"lw-lms","wp-skills-plugin-version-tested":"1.6.0","wp-skills-php-min":"8.2","wp-skills-last-updated":"2026-07-20"}

LW LMS LearnDash Migration

Use this for the one-time WP-CLI migration from LearnDash post types into LW LMS. The command copies course and lesson posts, maps key metadata, then builds a single LW LMS section per migrated course using LearnDash lesson order.

Verified against local lw-lms v1.6.0. Neither the v1.4.0 operational CLI release nor the v1.6.0 access-filter/source-revocation work changed the migrate-learndash command flow. Use lw-lms-wp-cli-operations for the non-migration commands.

When to use this skill

Trigger this skill when ANY of the following is true:

• The user asks to migrate from LearnDash to LW LMS.
• Code or logs mention wp lw-lms migrate-learndash, sfwd-courses, sfwd-lessons, ld_course_steps, _sfwd-courses, or _sfwd-lessons.
• You need a dry-run checklist, rerun strategy, or post-migration verification.
• A diff touches includes/CLI/Migration/.

Command

wp lw-lms migrate-learndash --dry-run --verbose
wp lw-lms migrate-learndash --verbose

The command is registered in Plugin::register_cli_commands() as lw-lms migrate-learndash. It runs only under WP-CLI.

Workflow

1. Confirm both source and target plugins are present enough for data access: LearnDash data exists in sfwd-courses; LW LMS classes are active.
2. Take a database backup. This command creates posts and writes mappings; it does not implement rollback.
3. Run --dry-run --verbose. Review course count, lesson count, and skipped items.
4. Run the real migration once.
5. Verify mappings and frontend behavior before deleting or disabling LearnDash.

What gets migrated

Source	Target	Notes
sfwd-courses posts	course posts	title, content, excerpt, status, slug, menu order, thumbnail
LearnDash course price type	_lw_lms_access_type	mapped by LearnDashData::map_access_type()
Woo product links	_lw_lms_product_ids	reads direct _related_course, _membership_product_id, and postmeta reverse lookup
kurzus-hossza	_lw_lms_duration	local/custom duration meta supported by current migrator
sfwd-lessons posts	lesson posts	title, content, excerpt, status, slug, menu order, thumbnail
lesson course_id	_lw_lms_lesson_course_id	resolved through _lw_lms_migrated_to course mapping
LearnDash video URL, Elementor video, content embeds	_lw_lms_video	extracted by VideoExtractor
ld_course_steps lesson order	_lw_lms_course_sections, _lw_lms_lesson_section_id, _lw_lms_lesson_order	one generated section per migrated course

Each migrated LearnDash post gets _lw_lms_migrated_to = <new_id>.

Rerun behavior

The command is intentionally rerunnable, but not a full synchronization tool:

• Courses are skipped if an LW LMS course with the same title already exists; the mapping is refreshed.
• Lessons are skipped if a lesson with the same title already exists for the mapped LW LMS course; the mapping is refreshed.
• SectionBuilder rebuilds a single generated section from ld_course_steps.
• It does not delete target posts, remove stale mappings, migrate quizzes, certificates, groups, assignments, user progress, enrollments, or LearnDash-specific drip rules.

Verification checklist

• Count migrated course and lesson posts against source sfwd-courses and sfwd-lessons.
• Spot-check _lw_lms_migrated_to on several source posts.
• Open several courses in wp-admin and verify access type, product IDs, duration, sections, lesson order, and thumbnails.
• Open several lessons and verify parent course, video data, and content.
• Test one migrated paid course through the LW LMS access checker and frontend.
• Check that all lessons referenced by ld_course_steps have mappings; missing mappings usually mean a lesson source post was missing or skipped unexpectedly.

Critical rules

• Always dry-run first. The real command writes posts and meta immediately.
• Do not expect a rollback. Restore from backup if the target state is wrong.
• Do not run this as a recurring sync. It is migration tooling, not an importer.
• Do not assume LearnDash progress or enrollments are migrated; current source migrates course/lesson structure and selected metadata only.
• Preserve LearnDash until verification is complete; target posts keep only _lw_lms_migrated_to reverse references on the source.

Cross-references

• Run lw-lms-backend-extend after migration when adding enrollment/progress automation to the new LMS.
• Run lw-lms-rest-frontend to validate learner-facing output against the core REST API.
• Run lw-lms-wp-cli-operations for the operational course, lesson, enrollment, revocation, and force-completion commands.
• Run wp-security-audit if modifying the migration command.

What this skill does NOT cover

• LearnDash quiz, certificate, group, assignment, or user-progress migration.
• WooCommerce order/subscription history normalization.
• Frontend rendering or REST API consumption.

References

• Command entry: includes/CLI/MigrateLearnDashCommand.php.
• Course migration: includes/CLI/Migration/CourseMigrator.php.
• Lesson migration: includes/CLI/Migration/LessonMigrator.php.
• Ordering/sections: includes/CLI/Migration/SectionBuilder.php.
• Source data helpers and mappings: includes/CLI/Migration/LearnDashData.php.
• Video extraction: includes/CLI/Migration/VideoExtractor.php.
• Official documentation: https://github.com/lwplugins/lw-lms
• Verified source paths:
  • wp-content/plugins/lw-lms/includes/Plugin.php
  • wp-content/plugins/lw-lms/includes/CLI/Migration/PostCreator.php
  • wp-content/plugins/lw-lms/includes/CLI/Migration/MigrationLogger.php