joomlatools/framework-migrator

A reusable component for migrations

v1.2.2 2022-03-21 09:05 UTC

This package is auto-updated.

Last update: 2024-10-15 05:00:58 UTC


README

This is a re-usable component for exporting and importing extension data for Joomlatools Framework.

Requirements

  • Joomlatools Framework 3
  • PHP 5.4 or newer
  • MySQL 5

Installation

Install using Composer. Go to the root directory of your Joomla installation in command line and execute this command:

composer require joomlatools/framework-migrator:1.*

The component will be installed in the vendor folder of the root directory of your Joomla site. The composer installer will make sure that the component is bootstrapped from that location and made available to other components extending it or just making use of it.

How to use

Include the behavior in your extension's dispatcher:

class ComFooDispatcherHttp extends ComKoowaDispatcherHttp
{
    protected function _initialize(KObjectConfig $config)
    {
        $config->append(array(
            'behaviors'  => array(
                'com:migrator.dispatcher.behavior.migratable'
            )
        ));

		parent::_initialize($config);
    }
}

This will pick the migrators from the following identifiers by default:

com://admin/foo.migrator.export
com://admin/foo.migrator.import

Alternatively you can specify different identifiers in the behavior configuration.

Then navigate to view=export or view=import in your extension to perform migrations.

Contributing

This component is an open source, community-driven project. Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Authors

See the list of contributors.

License

The joomlatools-framework-migrator component is free and open-source software licensed under the GPLv3 license.