Migrate K2 Pro

Installation

Version: 1.2.1

Installation

Installing the Component

MigrateK2 Pro is distributed as a single installable ZIP file. To install:

  1. Log in to your Joomla administrator panel
  2. Navigate to Extensions > Manage > Install
  3. Click the Upload Package File tab
  4. Drag and drop or browse for com_migratek2pro_vX.x.zip
  5. Click Upload & Install

On successful installation you will see: "Installing component was successful."

What Gets Installed

The installer automatically sets up:

  • Admin component: Controllers, models, views, helpers, and templates
  • Site stub: A front-end file that redirects visitors to the homepage (this is an admin-only component)
  • Language files: English (en-GB) translation strings for all UI text
  • Database tables: Three custom tables are created:
    • #__migratek2_progress — tracks migration state and resume position
    • #__migratek2_mapping — maps K2 IDs to Joomla IDs for rollback and deduplication
    • #__migratek2_log — stores migration activity log entries
  • Admin menu entry: "MigrateK2 Pro" appears under Components in the admin menu
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 its tables
  • PHP ZipArchive extension (for CSV export as ZIP)
  • Writable images/ directory (for image migration)
Verifying Installation
  1. Go to Extensions > Manage > Manage
  2. Search for "migratek2" — you should see com_migratek2pro listed as a Component
  3. Click Components > MigrateK2 Pro to open the dashboard
  4. The dashboard will automatically detect whether K2 is installed and display content counts
Updating

To update to a newer version, simply install the new ZIP over the existing installation. The component uses method="upgrade" so your settings, progress, and log data are preserved.

Uninstalling

To remove the component:

  1. Go to Extensions > Manage > Manage
  2. Find MigrateK2 Pro and select it
  3. Click Uninstall

This drops all three MigrateK2 tables and removes all component files. Important: Migrated Joomla content (articles, categories, tags, fields) is NOT removed during uninstall — only the component's own tables are dropped. Run a Reset before uninstalling if you want to remove migrated content.