Acuity Migration Centre

A framework hub for the Acuity migration tools. It provides one dashboard where
migration utilities are grouped by the platform you are migrating from —
WordPress, Drupal, another Backdrop structure, and so on. The hub reads no source
database and holds no import logic of its own; it is pure plumbing that the
actual importers plug into, so a site builder learns one pattern once.

What it does

• Dashboard at admin/config/acuity-migration: a calm, platform-organised
  list of cards. Each platform is a section (heading + description); the
  utilities inside come from whatever migration modules are installed.
• Categories are module-owned. The hub declares no platforms itself — a
  section appears because a module declares it (for example, Acuity WordPress -
  Migration Centre declares the WordPress category). Install a Drupal 7
  migration module that declares its category and a Drupal 7 section appears; with
  none installed, none shows.
• A shared Overview checklist widget so every utility presents its
  prerequisites (connection set? users migrated? content imported?) the same way.
• Clean admin menu. Only the hub appears in the admin bar; each utility's
  tabs are reached from its dashboard card, not from a jumbled menu flyout.

For site builders

Enable the module for a migration utility. It appears on the dashboard under its
platform. Open it to reach its Overview, which lists what it does and the
steps to run it. Platforms with no installed utilities are not shown.

For developers

Register a utility as a card:

function mymodule_acuity_migration_group_info() {
  return array(
    'myimporter' => array(
      'title' => t('My Importer'),
      'description' => t('Import widgets from the source into Backdrop.'),
      'url' => 'admin/config/acuity-migration/wordpress/myimporter',
      'category' => 'wordpress',
    ),
  );
}

Declare a platform category (usually done by the module owning that platform):

function mymodule_acuity_migration_category_info() {
  return array(
    'drupal7' => array(
      'title' => t('Drupal 7 Migrations'),
      'description' => t('A group of utilities for bringing users and content across from a Drupal 7 website.'),
      'weight' => 10,
    ),
  );
}

Render the shared prerequisite checklist on your utility's Overview tab with
acuity_migration_checklist(). See acuity_migration.api.php for the full
contract.

Requirements

Backdrop CMS 1.x. No other dependencies.

License

GPL v2 or later.