This data migration app contains classes and utilities for importing data into Wagtail.

The importers/base.py file contains base importer classes with utilities for formating and importing page and non-page data. Child classes inherit from these, provide a couple of class variables and optionally override the format_data() method to add to the basic set of core fields, depending on what's available in the source data. The create_content_item() method creates pages in the database, so extending this may also be required depending on content. See the example news importer at importers/news.py.

Imports are run via management commands; see the management/commands folder for examples. They are run by providing the the name of the source data file and the ID of the parent page for your imported content. The data file needs to be uploaded to a location that the command can access them. By default, the commands look for files relative to manage.py. An example of running an import command using a file is:

./manage.py import_news 4 [site_name]/data_migration/data/news.json

credit @richbrennan