Help:Extension:FileImporter/en



The FileImporter and FileExporter extensions aim to make moving files from a local wiki to Wikimedia Commons easier. The new functionality allows to move files with all their original data intact, while documenting the move in the version history.

The FileExporter provides a link to Wikimedia Commons on the local wiki and hands over a URL to the extension FileImporter. The FileImporter is a Wikimedia Commons extension which imports the file including all data when all prerequisites are met. Technically, the files won't be "moved", but "copied".

FileImporter has been deployed to Wikimedia Commons on June 25, 2018. To make use of it, you need to activate the FileExporter in your local wiki, provided as a beta feature on first wikis on June 25, 2018.

Background

 * FileImporter and FileExporter aim to fulfil a request from the German-speaking community's Technical Wishlist and are developed by WMDE's tech team. More information can be found on the main project page on Meta.

Usage
Enabling the FileExporter: To enable the FileExporter on a local wiki, you have to be logged in and tick the checkbox for FileExporter on the beta-features preferences page. You don't have to activate the FileImporter on Wikimedia Commons.

Template Matching: Support needed
Based on the configuration file of the source wiki, the FileImporter checks the local file's templates and then processes the file accordingly. This page documents what the FileImporter does and how the configuration files work.

The configuration files are based on the CommonsHelper2 tool. They should be maintained by the communities. Please have a look at them and update them if needed.

Deployment roadmap

 * 2018-06-12: Export to test.wikipedia.org
 * FileExporter as a beta feature on mediawiki.org and [//test2.wikipedia.org/ test2.wikipedia.org].
 * (To test the export, you also need to be an auto-confirmed user on these wikis.)
 * FileImporter on [//test.wikipedia.org/ test.wikipedia.org]


 * 2018-06-25: Export to Wikimedia Commons
 * FileExporter as a beta feature on de.WP, fa.WP, ar.WP
 * exporting from mediawiki.org now to Wikimedia Commons
 * FileImporter on Wikimedia Commons
 * 2018-07-11:
 * FileExporter as a beta feature on [//wikisource.org/ wikisource]
 * Deployment of the FileExporter beta feature to other wikis: tba
 * We're improving the template matching (more info)

Links

 * Main project page on Meta
 * FileImporter extension manual
 * FileImporter configurations
 * FileExporter extension manual
 * Phabricator project
 * overview: How templates are matched with the FileImporter extension