Full Journal Transfer

This plugin allows you to import and export all the content of a journal.

Compatibility

The latest release of this plugin is compatible with the following PKP applications:

OJS 3.3.0

Note: This plugin is designed for the export and import of journals within the same version of OJS. Example: from 3.3.0-16 to 3.3.0-16. For best results, it is recommended to use OJS version 3.3.0-16 or newer.

Plugin Download

To download the plugin, go to the Releases page and download the tar.gz package of the latest release compatible with your website.

Installation

Enter the administration area of your OJS website through the Dashboard.
Navigate to Settings> Website> Plugins> Upload a new plugin.
Under Upload file select the file fullJournalTransfer.tar.gz.
Click Save and the plugin will be installed on your website.

Instructions for use

Command line

Export

Export a journal to a tar.gz file containing the xml and file directory by executing the command in the application's root directory:

php tools/importExport.php FullJournalImportExportPlugin export [targzFileName] [journal_path]

Import

To import a journal from tar.gz file, execute the command in the application's root directory:

php tools/importExport.php FullJournalImportExportPlugin import [targzFileName] [user_name]

⚠️ During the import process, a "Journal Registration" email is sent to all imported users. For testing purposes, we strongly recommend to disable the email functionality in the config.inc.php file before running the import script.

Obs.: Journals containing substantial data will consume a large memory resources. In such instances, employ the PHP parameter -d memory_limit=-1 during import/export operations.

Troubleshooting

This plugin uses features from the users and the native import/export plugin. If the execution does not work as expected, test with the PKP import/export plugins to resolve any problems before proceeding with this one.

Imported/Exported Journal Content

Using PKP native import/export:

Users and User Roles
Articles
Issues

Added:

Journal data
Navigation Menus
Plugins Configs
Sections
Review Forms
Review Assignments
Review Rounds
Review Files
Reviewer Files
Reviewer Comments
Revision Files
Stage Assignments
Editor Decisions
Discussions
Metrics

Running Tests

Unit Tests

To execute the unit tests, run the following command from root of the PKP Application directory:

lib/pkp/lib/vendor/phpunit/phpunit/phpunit -c lib/pkp/tests/phpunit-env2.xml plugins/importexport/fullJournalTransfer/tests

Credits

This plugin was idealized and sponsored by the Brazilian Institute of Information in Science and Technology (IBICT) for OJS version 2.x.

Funding for version 3.3 comes from the Federal University of São Paulo (Unifesp) and Federal University of Recôncavo da Bahia (UFRB).

Developed by Lepidus Tecnologia.

License

This plugin is licensed under the GNU General Public License v3.0