Long Description

MigrateK2 Pro is a professional Joomla 3.x component that migrates your entire K2 content library into native Joomla articles — fully automated, with real-time progress tracking and complete rollback support. Whether you have 50 articles or 50,000, MigrateK2 Pro handles the migration safely and efficiently while preserving your content, SEO, and site structure.

Key Features

One-Click K2 Migration
- Migrate items, categories, tags, extra fields, images, and URL redirects in a single run
- Original K2 data is never modified or deleted — the migration only reads and copies
- AJAX-powered batch processing ensures the browser never times out, even with 10,000+ articles
- Idempotent design — re-running after a failure picks up exactly where it left off with no duplicates

Live Progress Bar
- Real-time visual progress indicator showing processed vs. total items (e.g. 4,521 / 10,000 — 45%)
- Phase-by-phase step indicators: Categories → Fields → Tags → Items
- Elapsed time counter keeps you informed throughout the process
- Automatic retry (up to 3 attempts) on network errors or server timeouts
- Pause and resume support — close the browser and continue later without losing progress

Complete Content Migration
- K2 Items → Joomla Articles: Title, alias, introtext, fulltext, meta description, meta keywords, author, dates, publish state, featured flag, ordering, hits, access level, and language
- K2 Categories → Joomla Categories: Full parent-child hierarchy preserved with aliases, descriptions, publish state, and access levels
- K2 Tags → Joomla Tags: Tag names, aliases, and article associations via the native content tag map
- K2 Extra Fields → Joomla Custom Fields: Field groups, individual fields with mapped types, and per-article field values
- Intelligent intro/fulltext split: If K2 fulltext is empty, introtext is automatically split at the readmore tag

Image Migration & Path Rewriting
- K2 item images copied from media/k2/items/ to a configurable Joomla folder
- All media/k2/ paths in article content and field values automatically rewritten
- K2 imagecaption mapped to Joomla intro/fulltext image caption fields
- K2 imagecredits mapped to Joomla intro/fulltext image alt text fields
- Configurable image base path via component options

301 URL Redirects for SEO
- Automatic redirect creation in com_redirect for every migrated article
- ID-based K2 URLs (/component/k2/item/123) redirected to new Joomla article URLs
- Alias-based K2 URLs (/component/k2/item/my-article) redirected to new Joomla article URLs
- 301 permanent redirects preserve search engine rankings, backlinks, and bookmarks
- All redirects tagged with "MigrateK2 Pro" for clean identification and rollback

K2 Data Export
- Download raw K2 data without running any migration
- CSV: ZIP file with one CSV per table, UTF-8 with BOM for Excel compatibility
- JSON: Single structured file with pretty-printed formatting
- SQL: INSERT statements with Joomla prefix placeholders, ready for database import
- Selective table export: Items, categories, tags, extra fields, comments, and attachments
- Quick export buttons on the dashboard for one-click full exports

Full Rollback & Reset
- One-click reset removes all migrated articles, categories, tags, custom fields, and URL redirects
- Detailed deletion report: "Removed: 16 articles, 4 categories, 7 tags, 6 custom fields, 32 redirects"
- Orphan detection: Finds and removes untracked fields (k2_ prefix) and empty field groups from partial migrations
- Progress cleared so you can start fresh
- Original K2 data is never affected by a reset

Migration Log
- Persistent log stored in a dedicated database table
- Color-coded severity levels: INFO, SUCCESS, WARNING, ERROR
- Records every phase start/completion, batch progress, category reuse, errors, and warnings
- Filterable log view in the admin panel
- One-click clear with automatic cleanup during rollback

Dashboard Overview
- System checks: K2 detection, item/category counts, media folder verification
- Content preview counters: Items, categories, tags, fields, comments, attachments
- Context-aware action buttons that change based on migration state
- Quick export buttons for CSV, JSON, and SQL
- Backup warning prominently displayed before migration

Quick Start

Installation:
1. Navigate to Extensions > Manage > Install
2. Upload com_migratek2pro_v2.0.0.zip
3. Click Upload & Install
4. Open Components > MigrateK2 Pro

Configuration:
1. Click Options in the top-right toolbar
2. Set Image Base Path (default: images/k2-migrated)
3. Enable/disable Skip Trashed (default: enabled)
4. Set Fallback User if needed
5. Click Save & Close

Running a Migration:
1. Create a full backup of your website
2. Open Components > MigrateK2 Pro
3. Click Start Migration
4. Confirm you have a backup
5. Watch the live progress bar until completion
6. Check Content > Articles to verify migrated content

Exporting K2 Data:
1. Open Components > MigrateK2 Pro
2. Click CSV, JSON, or SQL on the dashboard for a quick full export
3. Or go to View Migration Details and select specific tables to export
4. Choose format and click Download

Perfect For

• K2 to Joomla Migration - Move all K2 content to native Joomla articles with one click
• Joomla Modernization - Remove K2 dependency and use Joomla's built-in content system
• Site Upgrades - Prepare for Joomla 4/5 migration by moving off K2 while still on Joomla 3
• SEO Preservation - Maintain search rankings with automatic 301 redirects from old K2 URLs
• Content Archiving - Export K2 data as CSV, JSON, or SQL for external backup or analysis
• WordPress Migration - Export K2 data as CSV/JSON for import into WordPress or other CMS
• Large Sites - Handle 10,000+ articles with AJAX batch processing and live progress tracking
• Agency Workflows - Migrate client sites safely with full rollback and detailed logging
• Development & Testing - Reset and re-migrate as many times as needed during development
• Content Auditing - Export K2 data to spreadsheets for content inventory and analysis

Configuration Options

Component Settings (Options)
- Image Base Path: Target folder for migrated images (default: images/k2-migrated)
- Skip Trashed: Exclude trashed K2 items and categories from migration (default: Yes)
- Fallback User: User ID for articles with missing K2 authors

Migration Features
- K2 items → Joomla articles (all fields mapped)
- K2 categories → Joomla categories (full hierarchy)
- K2 tags → Joomla tags (with associations)
- K2 extra fields → Joomla custom fields (groups, fields, and values)
- K2 images → copied with path rewriting and caption preservation
- K2 URLs → 301 redirects via com_redirect

Export Features
- Three formats: CSV (ZIP), JSON, SQL
- Six exportable tables: Items, categories, tags, extra fields, comments, attachments
- Select All / individual table checkboxes
- Quick export from dashboard or selective export from migration page

Rollback Features
- Remove migrated articles, categories, tags, fields, and redirects
- Detailed deletion count report
- Orphan field and empty group detection
- Progress and log cleanup

Migration Log
- Persistent database-backed log
- Four severity levels: INFO, SUCCESS, WARNING, ERROR
- Phase tracking: preflight, categories, fields, tags, items, complete
- One-click clear with confirmation

Technical Features

Performance Optimized
- AJAX batch processing prevents browser timeouts
- Small batch sizes ensure reliable server-side execution
- Progress tracking persists across browser sessions
- Automatic retry on transient failures (up to 3 attempts)
- Resume from exact position after interruption

Data Integrity
- Mapping table tracks every K2-to-Joomla ID relationship
- Category deduplication by alias and parent ID
- Idempotent design prevents duplicate content on re-runs
- CSRF token validation on all POST requests
- Confirmation dialogs on destructive actions (reset, start)

Security Features
- Joomla CSRF token checks on every request (JSession::checkToken)
- Admin-only access — site-side stub redirects to homepage
- JavaScript confirmation dialogs before migration and reset
- Output buffer handling for clean file downloads
- No direct database access — uses Joomla's database abstraction layer

Database Architecture
- #__migratek2_progress: Migration state, phase, item offset, completion flag
- #__migratek2_mapping: K2 ID to Joomla ID relationships for all entity types
- #__migratek2_log: Timestamped activity log with severity, phase, and message
- All tables use InnoDB with utf8mb4 character set
- Clean table creation on install, clean drop on uninstall

Compatibility
- Joomla 3.10+
- PHP 7.2+
- MySQL 5.6+ / MariaDB 10.1+
- Works with all K2 versions that use standard table structure
- Uses Joomla standard MVC pattern (JModelLegacy, JControllerLegacy, JViewLegacy)

Installation

Package Installation:
1. Log in to Joomla administrator panel
2. Navigate to Extensions > Manage > Install
3. Upload com_migratek2pro_vX.x.zip
4. Click Upload & Install
5. Component, database tables, language files, and admin menu are set up automatically

System Requirements:
- Joomla 3.10 or higher
- PHP 7.2 or higher
- MySQL 5.6+ or MariaDB 10.1+
- K2 component installed with data in K2 tables
- PHP ZipArchive extension (for CSV export)
- Writable images/ directory (for image migration)

After Installation:
- Open Components > MigrateK2 Pro to access the dashboard
- The system automatically detects K2 and displays content counts
- Configure component options before running migration
- Create a full website backup before starting

Support

• Support Portal: https://support.joomlax.com
• Email Support: [email protected]
• Website: https://www.joomlax.com
• Documentation: Comprehensive documentation included — from installation to FAQs
• Migration Log: Built-in activity log for self-service troubleshooting

Why Choose MigrateK2 Pro?

Complete Migration - Every piece of K2 content is migrated: items, categories, tags, extra fields, images, captions, credits, and URL redirects. Nothing is left behind.

Safe & Reversible - Full rollback removes all migrated content cleanly. Orphan detection catches even untracked data. Your original K2 tables are never modified.

Handles Any Scale - AJAX batch processing with live progress bar, auto-retry, and resume support. Tested with 50,000+ articles without timeouts.

SEO Preserved - Automatic 301 redirects ensure old K2 URLs continue to work. No lost rankings, no broken backlinks, no 404 errors.

Export Without Migrating - Download raw K2 data as CSV, JSON, or SQL for archiving, analysis, or import into other systems — no migration needed.

Detailed Logging - Every action is recorded in a persistent, color-coded migration log. Spot errors instantly and troubleshoot with confidence.

Intuitive Interface - Clean two-panel dashboard, live progress bar with phase indicators, context-aware buttons, and prominent backup warnings. No documentation needed to get started.

Idempotent & Resumable - Re-run safely after failures. Categories are deduplicated. Progress is persisted. Close the browser and come back later — nothing is lost.

Professional Support - Backed by comprehensive documentation, built-in troubleshooting tools, and responsive email support.

Migrate your K2 content to native Joomla with confidence — preserving every article, category, tag, image, and URL while maintaining full control with real-time progress tracking, detailed logging, and complete rollback support.