Skip to content

backdrop-contrib/acuity_migration

Repository files navigation

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.

About

Framework hub for the Acuity migration tools: a categorised dashboard other importers register on. WordPress and Backdrop importers plug in here; the hub itself reads no source database.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors