diff modules/contrib/migrate_plus/README.txt @ 0:4c8ae668cc8c

Initial import (non-working)
author Chris Cannam
date Wed, 29 Nov 2017 16:09:58 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/modules/contrib/migrate_plus/README.txt	Wed Nov 29 16:09:58 2017 +0000
@@ -0,0 +1,34 @@
+The migrate_plus module extends the core migration system with API enhancements
+and additional functionality, as well as providing practical examples.
+
+Extensions to base API
+======================
+* A Migration configuration entity is provided, enabling persistance of dynamic
+migration configuration.
+* A ConfigEntityDiscovery class is implemented which enables plugin configuration
+to be based on configuration entities. This is fully general - it can be used
+for any configuration entity type, not just migrations.
+* A MigrationConfigEntityPluginManager class and corresponding
+plugin.manager.config_entity_migration service is provided, to enable discovery
+and instantiation of migration plugins based on the Migration configuration
+entity.
+* A MigrationGroup configuration entity is provided, which enables migrations to
+be organized in groups, and to maintain shared configuration in one place.
+* A MigrateEvents::PREPARE_ROW event is provided to dispatch hook_prepare_row()
+invocations as events.
+* A SourcePluginExtension class is provided, enabling one to define fields and
+IDs for a source plugin via configuration rather than requiring PHP code.
+
+Plugins
+=======
+* A Url source plugin is provided, implementing a common structure for
+file-based data providers.
+* XML and JSON fetchers and parsers for the Url source plugin are provided.
+
+Examples
+========
+* The migrate_example submodule provides a fully functional and runnable
+example migration scenario demonstrating the basic concepts and most common
+techniques for SQL-based migrations.
+* The migrate_example_advanced submodule provides examples of migration from
+different kinds of sources, as well as less common techniques.